INFRASTRUCTURE LEARNINGインフラ学習
インフラ大全インフラ大全IT INFRASTRUCTURE / LEARNING
インフラ学習ガイド
教材・演習を探す/

Escで閉じる · 検索語は送信しません

LEARNINGEN

テーマ別の解説テーマ:EC2:作成と運用の手順

EC2 user data入門:起動時の実行条件・安全な例・ログの確認

user dataは、EC2へ起動時の設定情報や処理を渡す仕組みです。EC2が文字列を受け取り、OS側の初期化処理が解釈して実行します。ここではAmazon Linux 2023のcloud-initとBashスクリプトに限定し、ファイルを1つ作る例で、実行主体・初回起動・結果確認を分けて学びます。

この教材で学ぶこと

user dataが誰の権限でいつ実行されるかを説明し、秘密を入れない小さな初期化処理と、ログ・成果物による確認方法を理解する。

先に知っておくこと

EC2の作成・接続と、Linuxのファイル・権限の基本。実行例は新しい実習用AL2023インスタンスを想定。Windowsや独自AMIへ一般化しない。サイトからコードを実行・AWSへ接続する機能はない。

EC2への入力と、OS内の実行を分ける

AL2023の例:渡した文字列をcloud-initが処理する
AL2023の例:渡した文字列をcloud-initが処理する1: user data — EC2は入力を保持し、OS側の仕組みが解釈する。 — cloud-init. 2: cloud-init — AL2023の初回起動を想定。通常のSSHログインとは別。 — rootで実行. 3: rootで実行 — スクリプトを渡しただけで成功とは判断しない。 — ログと成果物123user datacloud-initrootで実行ログと成果物AL2023の例:渡した文字列をcloud-initが処理する1: user data — EC2は入力を保持し、OS側の仕組みが解釈する。 — cloud-init. 2: cloud-init — AL2023の初回起動を想定。通常のSSHログインとは別。 — rootで実行. 3: rootで実行 — スクリプトを渡しただけで成功とは判断しない。 — ログと成果物123user datacloud-initrootで実行ログと成果物
  1. user data → cloud-initEC2は入力を保持し、OS側の仕組みが解釈する。
  2. cloud-init → rootで実行AL2023の初回起動を想定。通常のSSHログインとは別。
  3. rootで実行 → ログと成果物スクリプトを渡しただけで成功とは判断しない。
user data
起動時に渡す設定やスクリプト。
cloud-init
OS側で初期設定を行う仕組み。
rootで実行
この形式のシェルスクリプトを実行。
ログと成果物
処理した事実と目的の結果を確認。

通常のAL2023のuser dataシェルスクリプトは、初回の起動サイクルでrootとして実行されます。rootはOS内の強い権限です。対話入力を待つ処理を入れず、スクリプト内にsudoを重ねません。再起動のたびに必ず走る仕組みではなく、実行頻度は初期化方式と設定に依存します。

例:外部通信せず、完了を示すファイルを作る

新しい実習用AL2023で、/var/lib/infra-lessonが他用途に使われていないことを前提にします。例は専用ディレクトリとstatus.txtを作り、固定の完了文字列を書きます。パッケージ追加、公開サーバー起動、AWS API、秘密の読取りは行いません。既存システムへ無条件に貼り付けないでください。

AL2023の初回起動用。作成先と上書きするファイルを確認して使う
#!/bin/bash
set -eu
umask 027
install -d -m 0750 /var/lib/infra-lesson
printf '%s\n' 'initialization complete' > /var/lib/infra-lesson/status.txt
chmod 0640 /var/lib/infra-lesson/status.txt
printf '%s\n' 'lesson-bootstrap: complete'
何が変わるかを、行ごとに確認する
部分意味この例の境界
#!/bin/bashBashで解釈する形式シェル形式のuser data。cloud-configやWindows形式ではない
set -eu未定義変数や失敗を見逃しにくくする失敗した変更を自動で元に戻す機能ではない
umask / installファイル作成時の権限と専用ディレクトリを設定ディレクトリはroot用。既存の他用途と競合させない
printf / chmod固定文字列を保存し、ファイルを0640にするstatus.txtは上書き。同じ内容の追記を増やさない
最後のprintf標準出力へ完了マーカーを出す秘密や顧客データをログへ出さない

渡す前と、起動後に確認すること

  1. OS/AMI、cloud-init、Bash、作成先と副作用を確認する。スクリプト全文を読んでから扱う。
  2. 実施する場合はEC2起動設定の詳細にあるUser dataへ平文のシェル例を渡す。通常のコンソール入力はBase64化を任せ、二重に符号化しない。
  3. 起動と初期化の完了を待ち、承認された接続方法でインスタンスを確認する。runningだけを初期化成功としない。
  4. /var/log/cloud-init-output.logのエラーと完了マーカーを確認し、成果物の内容・所有者・権限も確認する。
  5. 実習後は必要データと残資源を照合して片付ける。ログを問い合わせへ送る場合も、秘密や実環境の値を取り除く。
接続後の読み取り例。root用のファイルなのでsudoで確認する
sudo cat /var/lib/infra-lesson/status.txt
sudo ls -ld /var/lib/infra-lesson
sudo ls -l /var/lib/infra-lesson/status.txt
sudo tail -n 40 /var/log/cloud-init-output.log

選択すると、正誤と理由が表示されます。

EC2はrunningです。user dataのファイル作成も成功と判断できる?
答えと理由を読む

正解:ログと成果物を確認する · EC2の状態と初期化処理の結果は別です。この例では完了マーカーとファイルの内容・権限を確認します。

再実行の落とし穴:編集・再起動と実行は同じではない

期待した結果がないとき、変更を増やす前に事実を確認する
見えたこと確認すること
停止してuser dataを直し、開始したがファイルが変わらない通常の初回だけの実行条件。編集しただけで再実行されるとは限らない
ログに途中の失敗があり、最後のマーカーがない失敗したコマンドと、その前に作られたファイルや権限
SSHのec2-userではファイルを読めないroot所有・0640とディレクトリ0750。この例の権限設計を確認
同じスクリプトを手動で走らせたい既存状態・上書き先・権限・副作用を再確認。初回起動と同条件とは限らない

冪等(べきとう)は、同じ入力を繰り返しても意図した状態が崩れないようにする考え方です。この例は固定値の上書きで追記の重複を避けますが、すべての初期化処理が安全に再実行できるわけではありません。失敗前の変更を元に戻す処理も別に必要です。

選択すると、正誤と理由が表示されます。

通常の初回だけの設定で、user dataを編集して再起動しました。修正版が実行されたと断定できる?
答えと理由を読む

正解:実行条件とログを確かめる · user dataの入力値の変更と、OS側の再実行は別です。OSや初期化設定と実行記録を確認して判断します。

秘密を入れない。OSのrootとAWSの権限も分ける

rootで動くことは、AWSのAPIを自由に実行できるという意味ではありません。AWS APIを使う処理では、必要な権限のIAMロールとインスタンスプロファイル等を別に確認します。鍵をスクリプトへ直書きする方法で代用しません。

確認して、自分の言葉で説明する

  1. 入力を解釈するOS側の仕組みと、実行する権限を説明する。
  2. 実行条件・ログ・成果物を分けて確認する。
  3. 再実行の副作用と秘密の保護を確認する。
理解を確かめる: user dataへ渡せば、どのAMIでも同じ処理が走る?

走るとは限らない。OSと初期化方式、形式、実行条件に依存する。

この例はAL2023・cloud-init・Bashと新規の実習用パスへ限定しています。条件を変えるときは、実行主体と副作用を改めて確認します。

出典と確認した条件

説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。