Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「CodeCatalyst から移行する方法」を参照してください。
ワークフローを使用した AWS CDK アプリのデプロイ
このセクションでは、ワークフローを使用して AWS アカウントに AWS Cloud Development Kit (AWS CDK) アプリをデプロイする方法について説明します。これを行うには、[AWS CDK デプロイ] アクションをワークフローに追加する必要があります。[AWS CDK デプロイ] アクションは AWS Cloud Development Kit (AWS CDK) アプリを合成して AWS にデプロイします。アプリが AWS に既に存在する場合、アクションは必要に応じてアプリを更新します。
AWS CDK を使用してアプリを記述する一般的な情報については、「AWS Cloud Development Kit (AWS CDK) デベロッパーガイド」の「AWS CDK とは?」を参照してください。
トピック
「AWS CDK デプロイ」アクションを使用するタイミング
AWS CDK を使用してアプリケーションを開発し、自動継続的統合と配信 (CI/CD) ワークフローの一部として自動的にデプロイする場合は、このアクションを使用します。例えば、誰かが AWS CDK アプリソースに関連するプルリクエストをマージするたびに、AWS CDK アプリを自動的にデプロイできます。
「AWS CDK デプロイ」アクションの仕組み
「AWS CDK デプロイ」は次のように機能します。
-
実行時に、アクションのバージョン 1.0.12 以前を指定した場合、アクションは最新の CDK CLI (Tookit とも呼ばれます) AWS CDK を CodeCatalyst [ランタイム環境イメージ] にダウンロードします。
バージョン 1.0.13 以降を指定した場合、アクションは 特定のバージョン の CDK CLI にバンドルされるため、ダウンロードは行われません。
-
アクションは CDK CLI を使用して
cdk deployコマンドを実行します。このコマンドは AWS CDK アプリを合成して AWS にデプロイします。このコマンドの詳細については、「AWS Cloud Development Kit (AWS CDK) デベロッパーガイド」の「AWS CDK ツールキット (cdk コマンド)」を参照してください。
「AWS CDK デプロイ」アクションで使用される CDK CLI バージョン
次の表は、[AWS CDK デプロイ] アクションのさまざまなバージョンでデフォルトで使用されている CDK CLI のバージョンを示しています。
注記
デフォルトを上書きできる場合があります。詳細については、「「AWS CDK デプロイ」アクション YAML」の「CdkCliVersion」を参照してください。
| 「AWS CDK デプロイ」アクションバージョン | AWS CDK CLI バージョン |
|---|---|
|
1.0.0~1.0.12 |
最新 |
|
1.10.13 以降 |
2.99.1 |
「AWS CDK デプロイ」アクションで使用されるランタイムイメージ
次の表は、CodeCatalyst が [AWS CDK デプロイ] アクションのさまざまなバージョンを実行するために使用するランタイム環境イメージを示しています。イメージには、プリインストールされたさまざまなツールのセットが含まれています。詳細については、「アクティブなイメージ」を参照してください。
注記
2024 年 3 月のイメージで利用可能な最新のツールを利用するには、[AWS CDK デプロイ] アクションをバージョン 2.x にアップグレードすることをお勧めします。アクションをアップグレードするには、ワークフロー定義ファイルの Identifier プロパティを aws/cdk-deploy@v2 に設定します。詳細については、「「AWS CDK デプロイ」アクション YAML」を参照してください。
| 「AWS CDK デプロイ」アクションバージョン | ランタイム環境イメージ |
|---|---|
|
1.x |
2022 年 11 月のイメージ |
|
2.x |
2024 年 3 月のイメージ |
アクションはいくつのスタックをデプロイできますか?
[AWS CDK デプロイ] は 1 つのスタックのみをデプロイできます。AWS CDK アプリケーションが複数のスタックで構成されている場合は、ネストされたスタックを使用して親スタックを作成し、このアクションを使用して親をデプロイする必要があります。