AWSリソースの作成

ソースコードの準備ができたので、次はデプロイ先となるAWSリソースを用意します。CI/CDパイプラインは「コードをビルドしてどこかにデプロイする」という流れなので、デプロイ先のインフラが存在しないと動作確認ができません。

今回利用するAWSリソース(VPC、ECR、ECSクラスタなど)はCloudFormationテンプレートにより一括で作成します。本章の主軸はCI/CDパイプラインの構築であり、AWSインフラの構築自体は本質ではないためです。なお、CI/CDパイプラインで重要な「GitHub ActionsからAWSへ接続するためのIAMロール」は、後の自動デプロイのセクションで手動で作成します。IAMロールの信頼関係や権限の設定は今回のハンズオンの重要な学びの一つであるため、あえて手動で体験してもらう形にしています。

📝 CloudFormationとは
CloudFormationは、AWSのリソースをテンプレート(YAML/JSON)で定義し、自動的に作成・管理できるサービスです。手動でリソースを一つずつ作成する代わりに、テンプレートをアップロードするだけで必要なリソースをまとめて構築できます。なお、本章ではCloudFormationテンプレートの内容を理解する必要はありません。テンプレートをそのままアップロードして環境を構築してください。

CloudFormationで作成されるリソースは以下のとおりです。

リソース 名前 説明
VPC cicd-handson-vpc 10.0.0.0/16のアドレス範囲を持つ仮想ネットワーク
パブリックサブネット cicd-handson-public-subnet ECSタスクを配置するサブネット
インターネットゲートウェイ cicd-handson-igw パブリックサブネットからのインターネットアクセス用
ルートテーブル cicd-handson-rt パブリックサブネット用のルーティング設定
セキュリティグループ cicd-handson-ecs-sg ECSタスク用(HTTP:8000を許可)
ECRリポジトリ test-repository コンテナイメージを格納するリポジトリ
ECSクラスター test-cluster ECSサービスを管理する論理グループ
タスク実行ロール ecsTaskExecutionRole-cicd-handson ECSタスクがCloudWatch Logsなどを操作するためのIAMロール
タスク定義 test-task ECSタスクの定義(イメージURI、CPU/メモリなど)
ECSサービス test-service タスク定義を元にECSタスクを実行・管理するサービス
CloudWatch Logs /ecs/test-task ECSタスクのログ出力先

1. テンプレートファイルの準備

まず、CloudFormationにアップロードするテンプレートファイルを用意します。以下のボタンからテンプレートファイルをダウンロードしてください。

ファイルがダウンロードできたら、次のステップに進みます。

2. CloudFormationスタックの作成

AWSマネジメントコンソールでCloudFormationのダッシュボードを開きます。検索バーに「CloudFormation」と入力し、サービスを選択してください。

CloudFormationのダッシュボードが表示されたら、スタックの作成 > 新しいリソースを使用(標準)をクリックします。

2.1 ステップ1: テンプレートの指定

テンプレートの指定画面が表示されます。下記表に従い、設定を行ってください。

設定項目 値 設定の基準
テンプレートの準備 既存のテンプレートを選択 事前に作成したテンプレートファイルを使用するため
テンプレートソース テンプレートファイルのアップロード ローカルのテンプレートファイルを直接アップロードするため
テンプレートファイルのアップロード 先ほど保存したcicd-handson.yml ハンズオン環境を構築するテンプレートを指定するため

設定後、次へをクリックしてください。

2.2 ステップ2: スタックの詳細を指定

スタックの詳細を指定する画面が表示されます。下記表に従い、設定を行ってください。

設定項目 値 設定の基準
スタック名 cicd-handson スタックを識別するための名前

今回のテンプレートにはパラメータが定義されていないため、スタック名以外の入力はありません。設定後、次へをクリックしてください。

2.3 ステップ3: スタックオプションの設定

スタックオプションの設定画面が表示されます。基本的な設定はデフォルトのままで問題ありませんが、画面下部に「The following resource(s) require capabilities: [AWS::IAM::Role]」という警告が表示されます。これは、今回のテンプレートにIAMロール(ecsTaskExecutionRole-cicd-handson)が含まれているため、IAMリソースの作成を承認する必要があるというメッセージです。

「AWS CloudFormation によって IAM リソースがカスタム名で作成される場合があることを承認します。」にチェックを入れてから、次へをクリックしてください。

2.4 ステップ4: 確認と作成

確認画面が表示されます。設定内容を確認し、送信をクリックします。

2.5 スタックの作成完了を確認

スタックの作成が開始されます。画面にはステータスがCREATE_IN_PROGRESSと表示され、リソースが順番に作成されていきます。完了まで数分かかります。

ステータスがCREATE_COMPLETEに変わったら、環境構築は完了です。画面を更新してもCREATE_COMPLETEにならない場合は、もう少し待ってから再度更新してください。

3. リソースの確認

CloudFormationでスタックの作成が完了したら、実際にどのようなリソースが作成されたのかを確認しておきましょう。ここで各リソースの役割を把握しておくことで、この後のワークフロー作成時に「なぜこのターゲットグループやECRを指定するのか」が理解しやすくなります。

CloudFormationでは、スタックから作成されたリソースをまとめて確認できるリソースタブが用意されています。AWSマネジメントコンソールを個別に開いて回る必要がないため、まずはこの画面で作成されたリソースを一覧で確認します。

CloudFormationのスタック一覧でcicd-handsonスタックをクリックし、上部のリソースタブを選択してください。スタックから作成されたリソースが一覧で表示されます。

以下のリソースがすべて作成されていること、ステータスがCREATE_COMPLETEになっていることを確認してください。

論理ID 物理ID リソースタイプ
VPC cicd-handson-vpc AWS::EC2::VPC
PublicSubnet cicd-handson-public-subnet AWS::EC2::Subnet
InternetGateway cicd-handson-igw AWS::EC2::InternetGateway
RouteTable cicd-handson-rt AWS::EC2::RouteTable
SecurityGroup cicd-handson-ecs-sg AWS::EC2::SecurityGroup
ECRRepository test-repository AWS::ECR::Repository
ECSCluster test-cluster AWS::ECS::Cluster
TaskExecutionRole ecsTaskExecutionRole-cicd-handson AWS::IAM::Role
TaskDefinition test-task AWS::ECS::TaskDefinition
ECSService test-service AWS::ECS::Service
LogGroup /ecs/test-task AWS::Logs::LogGroup

各リソースの物理IDをクリックすると、そのリソースの管理画面(VPCコンソールやECSコンソールなど)に直接遷移できます。気になるリソースがあれば、実際に遷移して中身を確認してみてください。

リソース一覧にすべてのリソースが表示され、全てCREATE_COMPLETEになっていれば、環境構築は正常に完了しています。