テンプレートから、はじめてリソースを作る

手順に迷ったときや、用語の意味を確かめたいときに開きましょう。

※ リンク切れの場合は、ページタイトルで検索してください。

今回はネットワーク図の代わりに、実際に使うテンプレートそのものを確認します。次の内容をこのままコピーして使います。

AWSTemplateFormatVersion: "2010-09-09"
Description: はじめての CloudFormation スタック - S3 バケットを1つ作成する

Resources:
  MyFirstBucket:
    Type: AWS::S3::Bucket

Outputs:
  BucketName:
    Description: 作成されたバケットの名前
    Value: !Ref MyFirstBucket

このテンプレートの読み方を 2 点だけ押さえておきましょう。① Resources の配下に、作りたいリソースの種類（Type）を書くことで、AWS にそのリソースを作るよう指示します。今回は AWS::S3::Bucket（S3 バケット）が 1 つ定義されています。② Outputs では、作られたリソースの情報を出力できるため、スタック作成後に画面上でバケット名をすぐ確認できます。

以下の要件を満たし、テンプレートどおりにバケットが作られたことを確認してください。

「テンプレートを準備する → スタックを作成する → 完了を待つ → 結果を確認する」という順番で進みます。

1. マネジメントコンソールにサインインし、リージョンを合わせる

   ブラウザで AWS マネジメントコンソールにサインインし、画面右上のリージョンが「アジアパシフィック（東京）ap-northeast-1」になっていることを確認します。

2. CloudFormation コンソールを開き、スタックの作成を始める

   画面上部の検索バーに CloudFormation と入力して開きます。「スタックの作成」→「新しいリソースを使用（標準）」を選びます。

3. テンプレートを CloudFormation Designer に貼り付ける

   「テンプレートの準備」で「テンプレートが用意されている」を選びます。「Application Composer で表示」ではなく「テンプレートをデザイナーで表示」（CloudFormation Designer）を開き、上記の YAML テンプレートをそのまま貼り付けます。デザイナーの画面から「テンプレートを使用してスタックを作成」のような操作で、スタック作成に進みます。

   コピーはそのまま、改行や空白に注意

   貼り付けるときに、インデント（行頭の空白）が崩れないように気をつけましょう。YAML はインデントの崩れがそのままエラーの原因になります。

4. スタック名を入力する

   スタック名を自由に決めて入力します（例：my-first-stack）。今回のテンプレートにはパラメータが無いので、そのまま次へ進みます。

5. オプションの設定を確認し、スタックの作成を開始する

   「スタックオプションの設定」はデフォルトのまま「次へ」を繰り返し、最後の確認画面で「送信」してスタックの作成を開始します。

6. 作成完了を待ち、リソースを確認する

   スタックのステータスが「CREATE_COMPLETE」になるまで待ちます。「リソース」タブを開き、AWS::S3::Bucket のエントリを確認します。物理 ID（バケット名）をクリックすると、S3 コンソールに移動し、同じバケットが存在することを確認できます。

   ステータスの更新には少し時間がかかる

   作成中は「CREATE_IN_PROGRESS」と表示されます。数十秒〜数分待って、画面を更新（リロード）しながら進行を確認しましょう。

初学者がよく引っかかる箇所を先回りでまとめました。答えそのものは載せていませんが、「どこを見直せばよいか」の手がかりとして使ってください。

要件の再確認ではなく、画面のどこを見れば達成を確認できるかをまとめました。CloudFormation コンソールと S3 コンソールを開いて、次を順に確かめましょう。

• スタックのステータスが CREATE_COMPLETE になっている。
• 「リソース」タブに AWS::S3::Bucket のエントリがあり、物理 ID がバケット名になっている。
• S3 コンソールに、同じ名前のバケットが存在している。
• 「出力」タブに BucketName の値が表示されている。

手を動かすことに加えて、次の問いに自分の言葉で答えられるようにしておくと、理解がより深まります。

1. 今回作ったスタックを削除すると、中で作られたバケットはどうなると思いますか。試す前に予想してみましょう。
   ヒント

   テンプレートとリソースの状態は結びついている、という考え方を思い出してみましょう。スタックという単位で管理されているリソースは、スタックの削除に合わせてどうなるか、を考えてみてください。
2. 同じテンプレートを使って、もう 1 つ別のスタック名で作ったらどうなるでしょうか。再現性という観点から考えてみましょう。
   ヒント

   テンプレートは「設計図」であり、スタックはその設計図から実際に作られた「実体」です。同じ設計図から、別の実体をいくつ作れるか、という観点で考えてみましょう。
3. このテンプレートに EC2 や VPC など他のリソースも追記していくと、今まで個別にコンソールで作っていた構成全体を、1 つのテンプレートで表現できそうです。それは運用上どんな利点がありそうでしょうか。
   ヒント

   「構成全体を 1 つのテキストとして保存・共有できる」「同じ構成を別の環境にも再現できる」「変更の履歴を残せる」など、コンソール操作だけでは難しかったことができるようになる、という観点で考えてみましょう。

作ったものを片づけます。スタックを削除すると、関連するリソースも合わせて削除されます。

1. スタックを削除する：CloudFormation コンソールでスタックを選び、「削除」を実行する。関連する S3 バケットも自動的に削除される。バケットの中にオブジェクトが残っていると、スタックの削除に失敗することがあるため、先にバケットを空にしてから削除する。