テーマ別の解説テーマ: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内の実行を分ける
- user data → cloud-initEC2は入力を保持し、OS側の仕組みが解釈する。
- cloud-init → rootで実行AL2023の初回起動を想定。通常のSSHログインとは別。
- rootで実行 → ログと成果物スクリプトを渡しただけで成功とは判断しない。
- user data
- 起動時に渡す設定やスクリプト。
- cloud-init
- OS側で初期設定を行う仕組み。
- rootで実行
- この形式のシェルスクリプトを実行。
- ログと成果物
- 処理した事実と目的の結果を確認。
通常のAL2023のuser dataシェルスクリプトは、初回の起動サイクルでrootとして実行されます。rootはOS内の強い権限です。対話入力を待つ処理を入れず、スクリプト内にsudoを重ねません。再起動のたびに必ず走る仕組みではなく、実行頻度は初期化方式と設定に依存します。
例:外部通信せず、完了を示すファイルを作る
新しい実習用AL2023で、/var/lib/infra-lessonが他用途に使われていないことを前提にします。例は専用ディレクトリとstatus.txtを作り、固定の完了文字列を書きます。パッケージ追加、公開サーバー起動、AWS API、秘密の読取りは行いません。既存システムへ無条件に貼り付けないでください。
#!/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/bash | Bashで解釈する形式 | シェル形式のuser data。cloud-configやWindows形式ではない |
| set -eu | 未定義変数や失敗を見逃しにくくする | 失敗した変更を自動で元に戻す機能ではない |
| umask / install | ファイル作成時の権限と専用ディレクトリを設定 | ディレクトリはroot用。既存の他用途と競合させない |
| printf / chmod | 固定文字列を保存し、ファイルを0640にする | status.txtは上書き。同じ内容の追記を増やさない |
| 最後のprintf | 標準出力へ完了マーカーを出す | 秘密や顧客データをログへ出さない |
渡す前と、起動後に確認すること
- OS/AMI、cloud-init、Bash、作成先と副作用を確認する。スクリプト全文を読んでから扱う。
- 実施する場合はEC2起動設定の詳細にあるUser dataへ平文のシェル例を渡す。通常のコンソール入力はBase64化を任せ、二重に符号化しない。
- 起動と初期化の完了を待ち、承認された接続方法でインスタンスを確認する。runningだけを初期化成功としない。
- /var/log/cloud-init-output.logのエラーと完了マーカーを確認し、成果物の内容・所有者・権限も確認する。
- 実習後は必要データと残資源を照合して片付ける。ログを問い合わせへ送る場合も、秘密や実環境の値を取り除く。
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選択すると、正誤と理由が表示されます。
再実行の落とし穴:編集・再起動と実行は同じではない
| 見えたこと | 確認すること |
|---|---|
| 停止してuser dataを直し、開始したがファイルが変わらない | 通常の初回だけの実行条件。編集しただけで再実行されるとは限らない |
| ログに途中の失敗があり、最後のマーカーがない | 失敗したコマンドと、その前に作られたファイルや権限 |
| SSHのec2-userではファイルを読めない | root所有・0640とディレクトリ0750。この例の権限設計を確認 |
| 同じスクリプトを手動で走らせたい | 既存状態・上書き先・権限・副作用を再確認。初回起動と同条件とは限らない |
冪等(べきとう)は、同じ入力を繰り返しても意図した状態が崩れないようにする考え方です。この例は固定値の上書きで追記の重複を避けますが、すべての初期化処理が安全に再実行できるわけではありません。失敗前の変更を元に戻す処理も別に必要です。
選択すると、正誤と理由が表示されます。
秘密を入れない。OSのrootとAWSの権限も分ける
rootで動くことは、AWSのAPIを自由に実行できるという意味ではありません。AWS APIを使う処理では、必要な権限のIAMロールとインスタンスプロファイル等を別に確認します。鍵をスクリプトへ直書きする方法で代用しません。
確認して、自分の言葉で説明する
- 入力を解釈するOS側の仕組みと、実行する権限を説明する。
- 実行条件・ログ・成果物を分けて確認する。
- 再実行の副作用と秘密の保護を確認する。
理解を確かめる: user dataへ渡せば、どのAMIでも同じ処理が走る?
走るとは限らない。OSと初期化方式、形式、実行条件に依存する。
この例はAL2023・cloud-init・Bashと新規の実習用パスへ限定しています。条件を変えるときは、実行主体と副作用を改めて確認します。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件Linuxのシェル形式、通常の初回/root実行、符号化・ログと編集/実行の区別。Windowsや全独自AMIへ一般化しない。
参照した本文EC2への入力と、OS内の実行を分ける 再実行の落とし穴:編集・再起動と実行は同じではない 秘密を入れない。OSのrootとAWSの権限も分ける
確認した内容・条件AL2023のcloud-initによる入力解釈とOS初期化。例は頻度変更やパッケージ操作をしない。
参照した本文EC2への入力と、OS内の実行を分ける
確認した内容・条件メタデータ/user dataの参照とパスワード・長期鍵の埋込みを避ける境界。本教材は取得しない。
確認した内容・条件AWS APIに使う一時的なロール権限とインスタンスプロファイル。OSのrootとは別。