AWS CDK と GitLab を使用して、Amazon ECS Anywhere 上のハイブリッドワークロード用に CI/CD パイプラインを設定する

AWS CDK のバージョンを検証します。

次のコマンドを実行して、AWS CDK Toolkit のバージョンを検証します。

cdk --version

このパターンには、バージョン 2.27.0 以降が必要です。以前のバージョンを使用している場合は、「AWS CDK ドキュメント」の指示に従って更新してください。

npm バージョンを検証します。

次のコマンドを実行して、npm のバージョンを検証します。

npm --version

このパターンには、バージョン 7.20.3 以降が必要です。以前のバージョンを使用している場合は、「npm ドキュメント」の指示に従って更新してください。

AWS 認証情報を設定します。

認証情報を設定するには、aws configure のコマンドを実行し、プロンプトに従ってください。

$aws configure
AWS Access Key ID [None]: <your-access-key-ID>
AWS Secret Access Key [None]: <your-secret-access-key>
Default region name [None]: <your-Region-name>
Default output format [None]:

AWS SAM コードリポジトリを複製します。

環境を起動します。

次ののコマンドを実行して、使用したいアカウントと AWS リージョンに AWS CloudFormation テンプレートをデプロイします。

cdk bootstrap <account-number>/<Region>

詳細については、AWS CDK ドキュメントの「ブートストラップ」を参照してください。

パッケージの依存関係をインストールし、TypeScript ファイルをコンパイルします。

パッケージの依存関係をインストールし、次のコマンドを実行して TypeScript ファイルをコンパイルします。

$cd EcsAnywhereCdk
$npm install
$npm fund 

これらのコマンドは、すべてのパッケージをサンプルリポジトリからインストールします。詳細については、npm ドキュメントの「npm ci」と「npm install」を参照してください。これらのコマンドを入力したときに、紛失したパッケージに関するエラーが表示された場合は、このパターンの[トラブルシューティング]のセクションを参照してください。

プロジェクトをビルドします。

プロジェクトコードをビルドするには、以下のコマンドを入力します。

npm run build

プロジェクトの構築とデプロイの詳細については、AWS CDK ドキュメントの「初めての AWS CDK アプリケーション」を参照してください。

Amazon ECS Anywhere 向けインフラストラクチャスタックをデプロイします

スタックの作成と出力を検証します。

VM をセットアップします

Vagrantfile が配置されているルートディレクトリから vagrant up コマンドを実行して Vagrant VM を作成します。詳細については、「Vagrant ドキュメント」を参照してください。

VM を外部インスタンスとして登録します。

これにより、VM が Amazon ECS Anywhere の外部インスタンスとして設定され、Amazon ECS クラスターに登録されます。詳細については、Amazon ECS のドキュメントの「クラスターへの外部インスタンスの登録」を参照してください。問題が発生した場合は、「トラブルシューティング」セクションを参照してください。

Amazon ECS Anywhere と外部 VM のステータスを検証してください。

VM が Amazon ECS コントロールプレーンに接続され、稼働していることを検証するには、以下のコマンドを使用します。

$aws ssm describe-instance-information
$aws ecs list-container-instances --cluster $CLUSTER_NAME

AWS CodeCommit リポジトリにブランチを作成します。

最初のリポジトリのコミットを作成して、CodeCommit リポジトリに main というブランチを作成します。AWS のドキュメントに従って、CodeCommit にコミットを作成することができます。コマンドの例を次に示します。

aws codecommit put-file \
  --repository-name EcsAnywhereRepo \
  --branch-name main \
  --file-path README.md \
  --file-content "Test" \
  --name "Dev Ops" \
  --email "devops@example.com" \
  --commit-message "Adding README."

リポジトリのミラーリングを設定します。

GitLab リポジトリを外部ソースとの間でミラーリングできます。　 ソースとして使用するリポジトリを選択できます。ブランチ、タグ、コミットは自動的に同期されます。アプリケーションをホストする GitLab リポジトリと CodeCommit リポジトリの間でプッシュミラーを設定します。手順については、「GitLab から CodeCommit へのプッシュミラーの設定」（GitLab ドキュメント）を参照してください。

CI/CD パイプラインスタックをデプロイする

次のコマンドを実行して、EcsAnywherePipelineStack スタックをデプロイします。

$cdk  deploy EcsAnywherePipelineStack

CI/CD パイプラインをテストします。

リソースをクリーンアップして削除します。

このパターンが完了したら、作成した概念実証リソースを削除する必要があります。クリーンアップするには、次のコマンドを実行します。

$cdk destroy EcsAnywherePipelineStack
$cdk destroy EcsAnywhereInfraStack