ワークフローを使用して AWS CDK アプリをブートストラップする - Amazon CodeCatalyst

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ワークフローを使用して AWS CDK アプリをブートストラップする

このセクションでは、CodeCatalyst ワークフローを使用して AWS CDK アプリケーションをブートストラップする方法について説明します。これを行うには、[AWS CDK ブートストラップ] アクションをワークフローに追加する必要があります。[AWS CDK ブートストラップ] アクションは、[最新のテンプレート] を使用して、 AWS 環境でブートストラップスタックをプロビジョニングします。ブートストラップスタックが既に存在する場合、アクションは必要に応じてそれを更新します。にブートストラップスタックがあること AWS は、 AWS CDK アプリケーションをデプロイするための前提条件です。

ジョブのブックマークの詳細については、「AWS Cloud Development Kit (AWS CDK) デベロッパーガイド」 の「ジョブ ブックマーク」を参照してください。

AWS CDK 「ブートストラップ」アクションを使用するタイミング

AWS CDK アプリケーションをデプロイするワークフローがあり、ブートストラップスタックを同時にデプロイ (および必要に応じて更新) する場合は、このアクションを使用します。この場合、 AWS CDK アプリをデプロイするワークフローと同じワークフローにAWS CDK ブートストラップアクションを追加します。

次のいずれかに当てはまる場合は、このアクションを使用しないでください

  • 既に別のメカニズムを使用してブートストラップスタックをデプロイしており、そのままにしたい (更新なし)。

  • カスタムブートストラップテンプレート を使用します。これはブート[AWS CDK ストラップ] アクションではサポートされていません。

AWS CDK 「ブートストラップ」アクションの仕組み

[AWS CDK ブートストラップ] は次のように動作します。

  1. 実行時に、 アクションのバージョン 1.0.7 以前を指定した場合、アクションは最新の CDK CLI (Tookit とも呼ばれます) AWS CDK を CodeCatalyst ビルドイメージにダウンロードします。

    バージョン 1.0.8 以降を指定した場合、アクションは 特定のバージョン の CDK CLI にバンドルされるため、ダウンロードは行われません。

  2. アクションは CDK CLI を使用して cdk bootstrap コマンドを実行します。このコマンドは、「AWS Cloud Development Kit (AWS CDK) デベロッパーガイド」の「ブートストラップ」トピックで説明されているブートストラップタスクを実行します。

「AWS CDK ブートストラップ」アクションで使用される CDK CLI バージョン

次の表は、[AWS CDK ブートストラップ] アクションのさまざまなバージョンでデフォルトで使用されている CDK CLI のバージョンを示しています。

注記

デフォルトを上書きできる場合があります。詳細については、「「AWS CDK ブートストラップ」アクション YAML」の「CdkCliVersion」を参照してください。

「AWS CDK ブートストラップ」アクションバージョン AWS CDK CLI バージョン

1.0.0~1.0.7

最新

1.0.8 以降

2.99.1

AWS CDK 「ブートストラップ」アクションで使用されるランタイムイメージ

次の表は、CodeCatalyst が [AWS CDK ブートストラップ] アクションのさまざまなバージョンを実行するために使用するランタイム環境イメージを示しています。イメージには、プリインストールされたさまざまなツールのセットが含まれています。詳細については、「アクティブなイメージ」を参照してください。

注記

2024 年 3 月のイメージで利用可能な最新のツールを利用するには、[AWS CDK ブートストラップ] アクションをバージョン 2.x にアップグレードすることをお勧めします。アクションをアップグレードするには、ワークフロー定義ファイルの Identifier プロパティを aws/cdk-bootstrap@v2 に設定します。詳細については、「「AWS CDK デプロイ」アクション YAML」を参照してください。

「AWS CDK ブートストラップ」アクションバージョン ランタイム環境イメージ

1.x

2022 年 11 月のイメージ

2.x

2024 年 3 月のイメージ