Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # ワークフローを使用して AWS CDK アプリをブートストラップする このセクションでは、CodeCatalyst ワークフローを使用して AWS CDK アプリケーションをブートストラップする方法について説明します。これを行うには、**[AWS CDK ブートストラップ]** アクションをワークフローに追加する必要があります。**[AWS CDK ブートストラップ]** アクションは、[[最新のテンプレート]](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-template) を使用して、 AWS 環境でブートストラップスタックをプロビジョニングします。ブートストラップスタックが既に存在する場合、アクションは必要に応じてそれを更新します。にブートストラップスタックがあること AWS は、 AWS CDK アプリケーションをデプロイするための前提条件です。 ジョブのブックマークの詳細については、「*AWS Cloud Development Kit (AWS CDK) デベロッパーガイド*」 の「[ジョブ ブックマーク](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html)」を参照してください。 **Topics** + [AWS CDK 「ブートストラップ」アクションを使用するタイミング](#cdk-boot-action-when-to-use) + [AWS CDK 「ブートストラップ」アクションの仕組み](#cdk-boot-action-how-it-works) + [AWS CDK 「ブートストラップ」アクションで使用される CDK CLI バージョン](#cdk-boot-action-cdk-version) + [AWS CDK 「ブートストラップ」アクションで使用されるランタイムイメージ](#cdk-boot-action-runtime) + [例: AWS CDK アプリケーションのブートストラップ](cdk-boot-action-example-workflow.md) + [AWS CDK 「ブートストラップ」アクションの追加](cdk-boot-action-add.md) + [「AWS CDK ブートストラップ」変数](cdk-boot-action-variables.md) + [「AWS CDK ブートストラップ」アクション YAML](cdk-boot-action-ref.md) ## AWS CDK 「ブートストラップ」アクションを使用するタイミング AWS CDK アプリケーションをデプロイするワークフローがあり、ブートストラップスタックを同時にデプロイ (および必要に応じて更新) する場合は、このアクションを使用します。この場合、**AWS CDK ブートストラップ**アクションを、 AWS CDK アプリケーションをデプロイするワークフローと同じワークフローに追加します。 次のいずれかに当てはまる場合は、このアクションを**使用しないでください**。 + 既に別のメカニズムを使用してブートストラップスタックをデプロイしており、そのままにしたい (更新なし)。 + [カスタムブートストラップテンプレート](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-customizing) を使用します。これはブート**[AWS CDK ストラップ]** アクションではサポートされていません。 ## AWS CDK 「ブートストラップ」アクションの仕組み **[AWS CDK ブートストラップ]** は次のように動作します。 1. 実行時に、 アクションのバージョン 1.0.7 以前を指定した場合、アクションは最新の CDK CLI (Tookit とも呼ばれます) AWS CDK を CodeCatalyst [ビルドイメージ](build-images.md)にダウンロードします。 バージョン 1.0.8 以降を指定した場合、アクションは [特定のバージョン](cdk-dep-action.md#cdk-dep-action-cdk-version) の CDK CLI にバンドルされるため、ダウンロードは行われません。 1. アクションは CDK CLI を使用して `cdk bootstrap` コマンドを実行します。このコマンドは、「*AWS Cloud Development Kit (AWS CDK) デベロッパーガイド*」の「[ブートストラップ](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html)」トピックで説明されているブートストラップタスクを実行します。 ## AWS CDK 「ブートストラップ」アクションで使用される CDK CLI バージョン 次の表は、**[AWS CDK ブートストラップ]** アクションのさまざまなバージョンでデフォルトで使用されている CDK CLI のバージョンを示しています。 **注記** デフォルトを上書きできる場合があります。詳細については、「[「AWS CDK ブートストラップ」アクション YAML](cdk-boot-action-ref.md)」の「[CdkCliVersion](cdk-boot-action-ref.md#cdk.boot.cdk.cli.version)」を参照してください。 | 「AWS CDK ブートストラップ」アクションバージョン | AWS CDK CLI バージョン | | --- | --- | | 1.0.0～1.0.7 | 最新 | | 1.0.8 以降 | 2.99.1 | ## AWS CDK 「ブートストラップ」アクションで使用されるランタイムイメージ 次の表は、CodeCatalyst が **[AWS CDK ブートストラップ]** アクションのさまざまなバージョンを実行するために使用するランタイム環境イメージを示しています。イメージには、プリインストールされたさまざまなツールのセットが含まれています。詳細については、「[アクティブなイメージ](build-images.md#build-curated-images)」を参照してください。 **注記** 2024 年 3 月のイメージで利用可能な最新のツールを利用するには、**[AWS CDK ブートストラップ]** アクションをバージョン 2.x にアップグレードすることをお勧めします。アクションをアップグレードするには、ワークフロー定義ファイルの `Identifier` プロパティを `aws/cdk-bootstrap@v2` に設定します。詳細については、「[「AWS CDK デプロイ」アクション YAML](cdk-dep-action-ref.md)」を参照してください。 | 「AWS CDK ブートストラップ」アクションバージョン | ランタイム環境イメージ | | --- | --- | | 1.x | 2022 年 11 月のイメージ | | 2.x | 2024 年 3 月のイメージ | # 例: AWS CDK アプリケーションのブートストラップ 「**AWS CDK ** ブートストラップアクションを含むワークフローについては、「[ワークフローを使用した AWS CDK アプリケーションのデプロイ](cdk-dep-action.md)」の「[例: AWS CDK アプリケーションのデプロイ](cdk-dep-action-example-workflow.md)」を参照してください。 # AWS CDK 「ブートストラップ」アクションの追加 次の手順を使用して、「**AWS CDK ブートストラップ**」アクションをワークフローに追加します。 **[開始する前に]** 「**AWS CDK ブートストラップ**」アクションを使用する前に、 AWS CDK アプリケーションの準備が整っていることを確認してください。ブートストラップアクションは、ブートストラップの前に AWS CDK アプリケーションを合成します。アプリケーションは、 AWS CDKでサポートされている任意のプログラミング言語で記述できます。 AWS CDK アプリファイルが次の場所で使用可能であることを確認します。 + CodeCatalyst [[ソースリポジトリ]](source.md)、または + 別のワークフローアクションによって生成された CodeCatalyst [出力アーティファクト](workflows-working-artifacts.md) ------ #### [ Visual ] **ビジュアルエディタを使用してAWS CDK 「ブートストラップ」アクションを追加するには** 1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。 1. プロジェクトを選択します。 1. ナビゲーションペインで **[CI/CD]**、**[ワークフロー]** の順に選択します。 1. ワークフローの名前を選択します。ワークフローが定義されているソースリポジトリまたはブランチ名でフィルタリングすることも、ワークフロー名またはステータスでフィルタリングすることもできます。 1. **[編集]** を選択します。 1. **[ビジュアル]** を選択します。 1. 左上で **[\$1 アクション]** を選択してアクションカタログを開きます。 1. ドロップダウンリストから、**[Amazon CodeCatalyst]** を選択します。 1. 「**AWS CDK ブートストラップ**」アクションを検索し、次のいずれかを実行します。 + プラス記号 (**\$1**) を選択してワークフロー図にアクションを追加し、設定ペインを開きます。 または + 「**AWS CDK ブートストラップ**」を選択します。[アクションの詳細] ダイアログボックスが表示されます。このダイアログボックスで、次の操作を行います。 + (任意) **[ソースを表示]** を選択して、[アクションのソースコードを表示します](workflows-view-source.md#workflows-view-source.title)。 + **[ワークフローに追加]** を選択して、ワークフロー図にアクションを追加し、設定ペインを開きます。 1. **[入力]**、**[設定]**、**[出力]** タブで、必要に応じてフィールドに入力します。各フィールドの説明については、「[「AWS CDK ブートストラップ」アクション YAML](cdk-boot-action-ref.md)」を参照してください。このリファレンスでは、各フィールド (および対応する YAML プロパティ値) について、YAML エディタとビジュアルエディタの両方で表示される詳細情報を提供しています。 1. (オプション) **[検証]** を選択して、コミットする前にワークフローの YAML コードを検証します。 1. **[コミット]** を選択し、コミットメッセージを入力し、再度 **[コミット]** を選択します。 **注記** **[AWS CDK ブートストラップ]** アクションが `npm install` エラーで失敗した場合、エラーを修正する方法については、「[「npm install」エラーを解決するにはどうすればよいですか?](troubleshooting-workflows.md#troubleshooting-workflows-npm)」を参照してください。 ------ #### [ YAML ] **YAML エディタを使用してAWS CDK 「ブートストラップ」アクションを追加するには** 1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。 1. プロジェクトを選択します。 1. ナビゲーションペインで **[CI/CD]**、**[ワークフロー]** の順に選択します。 1. ワークフローの名前を選択します。ワークフローが定義されているソースリポジトリまたはブランチ名でフィルタリングすることも、ワークフロー名またはステータスでフィルタリングすることもできます。 1. **[編集]** を選択します。 1. **[YAML]** を選択します。 1. 左上で **[\$1 アクション]** を選択してアクションカタログを開きます。 1. ドロップダウンリストから、**[Amazon CodeCatalyst]** を選択します。 1. **[AWS CDK ブートストラップ]** アクションを検索し、**[\$1]** を選択してワークフロー図に追加し、設定ペインを開きます。 1. 必要に応じて、YAML コードのプロパティを変更します。使用可能な各プロパティの説明は、「[「AWS CDK ブートストラップ」アクション YAML](cdk-boot-action-ref.md)」に記載されています。 1. (オプション) **[検証]** を選択して、ワークフローの YAML コードをコミットする前に検証します。 1. **[コミット]** を選択し、コミットメッセージを入力し、再度 **[コミット]** を選択します。 **注記** **[AWS CDK ブートストラップ]** アクションが `npm install` エラーで失敗した場合、エラーを修正する方法については、「[「npm install」エラーを解決するにはどうすればよいですか?](troubleshooting-workflows.md#troubleshooting-workflows-npm)」を参照してください。 ------ # 「AWS CDK ブートストラップ」変数 **[AWS CDK ブートストラップ]** アクションは、実行時に次の変数を生成して設定します。これらは*事前定義済み変数*と呼ばれます。 ワークフローでこれらの変数を参照する方法については、「[事前定義済み変数の使用](workflows-using-predefined-variables.md)」を参照してください | キー | 値 | | --- | --- | | deployment-platform | デプロイプラットフォームの名前。 `AWS:CloudFormation` にハードコードされています。 | | リージョン | ワークフローの実行中に AWS CDK ブートストラップスタック AWS リージョン がデプロイされた のリージョンコード。 例: `us-west-2` | | stack-id | デプロイされた AWS CDK ブートストラップスタックの Amazon リソースネーム (ARN)。 例: `arn:aws:cloudformation:us-west-2:111122223333:stack/codecatalyst-cdk-bootstrap-stack/6aad4380-100a-11ec-a10a-03b8a84d40df` | | SKIP-DEPLOYMENT | の値は、ワークフローの実行中に AWS CDK ブートストラップスタックのデプロイがスキップされた`true`ことを示します。前回のデプロイ以降にスタックに変更がない場合、スタックのデプロイはスキップされます。 この変数は、値が `true` の場合にのみ生成されます。 `true` にハードコードされています。 | # 「AWS CDK ブートストラップ」アクション YAML 以下は、**[AWS CDK ブートストラップ]** アクションの YAML 定義です。このアクションの使用方法については、「[ワークフローを使用して AWS CDK アプリをブートストラップする](cdk-boot-action.md)」を参照してください。 このアクション定義は、より広範なワークフロー定義ファイル内のセクションとして存在します。ファイルの詳細については、「[ワークフロー YAML 定義](workflow-reference.md)」を参照してください。 **注記** 後続の YAML プロパティのほとんどには、対応する UI 要素がビジュアルエディタにあります。UI 要素を検索するには、**[Ctrl\$1F]** を使用します。要素は、関連付けられた YAML プロパティとともに一覧表示されます。 ``` # The workflow definition starts here. # See 最上位プロパティ for details. Name: MyWorkflow SchemaVersion: 1.0 Actions: # The action definition starts here. CDKBootstrapAction\$1nn: Identifier: aws/cdk-bootstrap@v2 DependsOn: - action-name Compute: Type: EC2 | Lambda Fleet: fleet-name Timeout: timeout-minutes Inputs: # Specify a source or an artifact, but not both. Sources: - source-name-1 Artifacts: - artifact-name Outputs: Artifacts: - Name: cdk_bootstrap_artifacts Files: - "cdk.out/**/*" Environment: Name: environment-name Connections: - Name: account-connection-name Role: iam-role-name Configuration: Region: us-west-2 CdkCliVersion: version ``` ## CDKBootstrapAction (必須) アクションの名前を指定します。すべてのアクション名は、ワークフロー内で一意である必要があります。アクション名で使用できるのは、英数字 (a～z、A～Z、0～9)、ハイフン (-)、アンダースコア (\$1) のみです。スペースは使用できません。引用符を使用して、アクション名の特殊文字とスペースを有効にすることはできません。 デフォルト: `CDKBootstrapAction_nn`。 対応する UI: [設定] タブ/**[アクション表示名]** ## Identifier (*CDKBootstrapAction*/**Identifier**) (必須) アクションを識別します。バージョンを変更したい場合でない限り、このプロパティを変更しないでください。詳細については、「[使用するアクションバージョンの指定](workflows-action-versions.md)」を参照してください。 **注記** `aws/cdk-bootstrap@v2` を指定すると、Node.js 18 などの新しいツールを含む [2024 年](build-images.md#build.default-image) 3 月の画像でアクションが実行されます。`aws/cdk-bootstrap@v1` を指定すると、Node.js 16 などの古いツールを含む [2022 年 11 月のイメージ](build-images.md#build.previous-image)でアクションが実行されます。 デフォルト: `aws/cdk-bootstrap@v2`。 対応する UI: ワークフロー図/CDKBootstrapAction\$1nn/**aws/cdk-bootstrap@v2** ラベル ## DependsOn (*CDKBootstrapAction*/**DependsOn**) (オプション) このアクションを実行するために正常に実行する必要があるアクション、アクショングループ、またはゲートを指定します。 「DependsOn」機能の詳細については、「[アクションの順序付け](workflows-depends-on.md)」を参照してください。 対応する UI: [入力] タブ/**[依存 - オプション]** ## Compute (*CDKBootstrapAction*/**Compute**) (オプション) ワークフローアクションの実行に使用されるコンピューティングエンジンです。コンピューティングはワークフローレベルまたはアクションレベルで指定できますが、両方を指定することはできません。ワークフローレベルで指定すると、コンピューティング設定はワークフローで定義されたすべてのアクションに適用されます。ワークフローレベルでは、同じインスタンスで複数のアクションを実行することもできます。詳細については、「[アクション間でのコンピューティングの共有する](compute-sharing.md)」を参照してください。 対応する UI: *[なし]* ## Type (*CDKBootstrapAction*/Compute/**Type**) ([Compute](#cdk.boot.computename) が含まれている場合は必須) コンピューティングエンジンのタイプです。次のいずれかの値を使用できます。 + **EC2** (ビジュアルエディタ) または `EC2` (YAML エディタ) アクション実行時の柔軟性を目的として最適化されています。 + **Lambda** (ビジュアルエディタ) または `Lambda` (YAML エディタ) アクションの起動速度を最適化しました。 コンピューティングタイプの詳細については、「[コンピューティングタイプ](workflows-working-compute.md#compute.types)」を参照してください。 対応する UI: [設定] タブ/[高度な設定 - オプション]/**[コンピューティングタイプ]** ## Fleet (*CDKBootstrapAction*/Compute/**Fleet**) (オプション) ワークフローまたはワークフローアクションを実行するマシンまたはフリートを指定します。オンデマンドフリートでは、アクションが開始すると、ワークフローは必要なリソースをプロビジョニングし、アクションが完了するとマシンは破棄されます。オンデマンドフリートの例: `Linux.x86-64.Large`、`Linux.x86-64.XLarge`。オンデマンドフリートの詳細については、「[オンデマンドフリートのプロパティ](workflows-working-compute.md#compute.on-demand)」を参照してください。 プロビジョニングされたフリートでは、ワークフローアクションを実行するように専用マシンのセットを設定します。これらのマシンはアイドル状態のままで、アクションをすぐに処理できます。プロビジョニングされたフリートの詳細については、「[プロビジョニングされたフリートのプロパティ](workflows-working-compute.md#compute.provisioned-fleets)」を参照してください。 `Fleet` を省略した場合、デフォルトは `Linux.x86-64.Large` です。 対応する UI: [設定] タブ/[高度な設定 - オプション]/**[コンピューティングフリート]** ## Timeout (*CDKBootstrapAction*/**Timeout**) (必須) CodeCatalyst がアクションを終了するまでにアクションを実行できる時間を分単位 (YAML エディタ) または時間分単位 (ビジュアルエディタ) で指定します。最小値は 5 分で、最大値は [CodeCatalyst のワークフローのクォータ](workflows-quotas.md) で記述されています。デフォルトのタイムアウトは、最大タイムアウトと同じです。 対応する UI: [設定] タブ/**[タイムアウト - オプション]** ## Inputs (*CDKBootstrapAction*/**Inputs**) (オプション) `Inputs` セクションでは、ワークフローの実行中に **[AWS CDK ブートストラップ]** アクションに必要なデータを定義します。 対応する UI: **[入力]** タブ **注記** **[AWS CDK ブートストラップ]** アクションごとに 1 つの入力 (ソースまたはアーティファクト) のみが許可されます。 ## Sources (*CDKBootstrapAction*/Inputs/**Sources**) ( AWS CDK アプリがソースリポジトリに保存されている場合は必須) AWS CDK アプリがソースリポジトリに保存されている場合は、そのソースリポジトリのラベルを指定します。**[AWS CDK ブートストラップ]** アクションは、ブートストラッププロセスを開始する前に、このリポジトリ内のアプリケーションを合成します。現在、サポートされているリポジトリラベルは `WorkflowSource` のみです。 AWS CDK アプリがソースリポジトリに含まれていない場合は、別のアクションによって生成されたアーティファクトに存在する必要があります。 sources の詳細については、「[ワークフローへのソースリポジトリの接続](workflows-sources.md)」を参照してください。 対応する UI: 入力タブ/**ソース - オプション** ## Artifacts - input (*CDKBootstrapAction*/Inputs/**Artifacts**) ( AWS CDK アプリが前のアクションの[出力アーティファクト](workflows-working-artifacts-output.md)に保存されている場合に必要です) AWS CDK アプリが前のアクションによって生成されたアーティファクトに含まれている場合は、ここでそのアーティファクトを指定します。**[AWS CDK ブートストラップ]** アクションは、ブートストラッププロセスを開始する前に、指定されたアーティファクト内のアプリケーションを CloudFormation テンプレートに合成します。 AWS CDK アプリがアーティファクトに含まれていない場合は、ソースリポジトリに存在する必要があります。 アーティファクトの詳細 (例を含む) については、「[アクション間でのアーティファクトとファイルの共有](workflows-working-artifacts.md)」を参照してください。 対応する UI: 入力タブ/**アーティファクト - オプション** ## Outputs (*CDKBootstrapAction*/**Outputs**) (オプション) ワークフローの実行中にアクションによって出力されるデータを定義します。 対応する UI: **[出力]** タブ ## Artifacts - output (*CDKBootstrapAction*/Outputs/**Artifacts**) (オプション) アクションによって生成されたアーティファクトを指定します。このアーティファクトは、他のアクションの入力として参照できます。 アーティファクトの詳細 (例を含む) については、「[アクション間でのアーティファクトとファイルの共有](workflows-working-artifacts.md)」を参照してください。 対応する UI: [出力] タブ/**[アーティファクト]** ## Name (*CDKBootstrapAction*/Outputs/Artifacts/**Name**) ([Artifacts - output](#cdk.boot.outputs.artifacts) が含まれている場合は必須) 実行時に**AWS CDK ブートストラップ**アクションによって合成される CloudFormation テンプレートを含むアーティファクトの名前を指定します。デフォルト値は `cdk_bootstrap_artifacts` です。アーティファクトを指定しない場合、アクションはテンプレートを合成しますが、アーティファクトには保存されません。テストまたはトラブルシューティングの目的で、合成されたテンプレートをアーティファクトに保存して、その記録を保持することを検討してください。 対応する UI: [出力] タブ/[アーティファクト]/[アーティファクトを追加]/**[ビルドアーティファクト名]** ## Files (*CDKBootstrapAction*/Outputs/Artifacts/**Files**) ([Artifacts - output](#cdk.boot.outputs.artifacts) が含まれている場合は必須) アーティファクトに含めるファイルを指定します。 AWS CDK アプリの合成 CloudFormation されたテンプレートを含める`"cdk.out/**/*"`には、 を指定する必要があります。 **注記** `cdk.out` は、合成されたファイルが保存されるデフォルトのディレクトリです。`cdk.json` ファイルで `cdk.out` 以外の出力ディレクトリを指定した場合は、`cdk.out` の代わりに、ここでそのディレクトリを指定します。 対応する UI: [出力] タブ/[アーティファクト]/[アーティファクトを追加]/**[ビルドで生成されるファイル]** ## Environment (*CDKBootstrapAction*/**Environment**) (必須) アクションで使用する CodeCatalyst 環境を指定します。アクションは、選択した環境で指定された AWS アカウント およびオプションの Amazon VPC に接続します。アクションは、環境で指定されたデフォルトの IAM ロールを使用して に接続し AWS アカウント、[Amazon VPC 接続](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-vpcs.add.html)で指定された IAM ロールを使用して Amazon VPC に接続します。 **注記** デフォルトの IAM ロールにアクションに必要なアクセス許可がない場合は、別のロールを使用するようにアクションを設定できます。詳細については、「[アクションの IAM ロールの変更](deploy-environments-switch-role.md)」を参照してください。 環境タグ付けの詳細については、「[AWS アカウント と VPCs へのデプロイ](deploy-environments.md)」と「[環境を作成する](deploy-environments-creating-environment.md)」を参照してください。 対応する UI: [設定] タブ/**[環境]** ## Name (*CDKBootstrapAction*/Environment/**Name**) ([Environment](#cdk.boot.environment) が含まれている場合は必須) アクションに関連付ける既存の環境の名前を指定します。 対応する UI: [設定] タブ/**[環境]** ## Connections (*CDKBootstrapAction*/Environment/**Connections**) (新しいバージョンのアクションでは任意。古いバージョンでは必須) アクションに関連付けるアカウント接続を指定します。`Environment` で最大 1 つのアカウント接続を指定できます。 アカウント接続を指定しない場合: + アクションは、CodeCatalyst コンソールの環境で指定された AWS アカウント 接続とデフォルトの IAM ロールを使用します。アカウント接続とデフォルトの IAM ロールを環境に追加する方法については、「[環境を作成する](deploy-environments-creating-environment.md)」を参照してください。 + デフォルトの IAM ロールには、アクションに必要なポリシーとアクセス許可が含まれている必要があります。これらのポリシーとアクセス許可を確認するには、アクションの YAML 定義ドキュメントの **[ロール]** プロパティの説明を参照してください。 アカウント接続の詳細については、「[接続された AWS リソースへのアクセスを許可する AWS アカウント](ipa-connect-account.md)」を参照してください。アカウント接続を環境に追加する方法については、「[環境を作成する](deploy-environments-creating-environment.md)」を参照してください。 対応する UI: アクションのバージョンに応じて、次のいずれか。 + (新しいバージョン) [設定] タブ/[環境]/[*my-environment* の内容]/3 つのドットメニュー/**[ロールを切り替える]** + (旧バージョン) [設定] タブ/「環境/アカウント/ロール」/**[AWS アカウント接続]** ## Name (*CDKBootstrapAction*/Environment/Connections/**Name**) ([Connections](#cdk.boot.environment.connections) が含まれている場合は必須) アカウント接続の名前を指定します。 対応する UI: アクションのバージョンに応じて、次のいずれか。 + (新しいバージョン) [設定] タブ/[環境]/[*my-environment* の内容]/3 つのドットメニュー/**[ロールを切り替える]** + (旧バージョン) [設定] タブ/「環境/アカウント/ロール」/**[AWS アカウント接続]** ## Role (*CDKBootstrapAction*/Environment/Connections/**Role**) ([Connections](#cdk.boot.environment.connections) が含まれている場合は必須) **AWS CDK ブートストラップ**アクションがブートストラップスタックにアクセスして AWS 追加するために使用する IAM ロールの名前を指定します。[ロールを CodeCatalyst スペース に追加](ipa-connect-account-addroles.md)し、ロールに次のポリシーが含まれていることを確認します。 IAM ロールを指定しない場合、アクションは CodeCatalyst コンソールの [[環境]](deploy-environments.md) に記載されているデフォルトの IAM ロールを使用します。環境でデフォルトのロールを使用する場合は、適切なポリシーがあることを確認してください。 必要に応じて、このアクションで `CodeCatalystWorkflowDevelopmentRole-spaceName` ロールを使用できます。このロールの詳細については、「[アカウントとスペース用の **CodeCatalystWorkflowDevelopmentRole-*spaceName*** ロールを作成する](ipa-iam-roles.md#ipa-iam-roles-service-create)」を参照してください。`CodeCatalystWorkflowDevelopmentRole-spaceName` ロールにはフルアクセス許可があり、セキュリティ上のリスクをもたらす可能性があることを理解してください。このロールは、セキュリティが懸念されないチュートリアルやシナリオでのみ使用することをお勧めします。 対応する UI: アクションのバージョンに応じて、次のいずれか。 + (新しいバージョン) [設定] タブ/[環境]/[*my-environment* の内容]/3 つのドットメニュー/**[ロールを切り替える]** + (旧バージョン) [設定] タブ/「環境/アカウント/ロール」/**[ロール]** ## Configuration (*CDKBootstrapAction*/**Configuration**) (必須) アクションの設定プロパティを定義できるセクション。 対応する UI: **[設定]** タブ ## Region (*CDKBootstrapAction*/Configuration/**Region**) (必須) ブートストラップスタックをデプロイする AWS リージョン を指定します。このリージョンは、 AWS CDK アプリがデプロイされているリージョンと一致する必要があります。リージョンコードの一覧については、「[リージョンエンドポイント](https://docs.aws.amazon.com/general/latest/gr/rande.html#region-names-codes)」を参照してください。 対応する UI: [設定] タブ/**[リージョン]** ## CdkCliVersion (*CDKBootstrapAction*/Configuration/**CdkCliVersion**) (オプション) このプロパティは、**[AWS CDK デプロイ]** アクションのバージョン 1.0.13 以降、および **[AWS CDK ブートストラップ]** アクションのバージョン 1.0.8 以降で使用できます。 次のいずれかを指定します。 + このアクションで使用する AWS Cloud Development Kit (AWS CDK) コマンドラインインターフェイス (CLI) のフルバージョン (ツールキットとも呼ばれ AWS CDK ます）。例えば、`2.102.1` などです。アプリケーションのビルドとデプロイ時に一貫性と安定性を確保するため、フルバージョンを指定することを検討してください。 または + `latest`。CDK CLI の最新の機能と修正を活用するには、`latest` を指定することを検討してください。 アクションは、指定されたバージョンの CLI (または最新バージョン) AWS CDK を CodeCatalyst [ビルドイメージ](build-images.md)にダウンロードし、このバージョンを使用して CDK アプリケーションのデプロイまたは環境のブートストラップ AWS に必要なコマンドを実行します。 使用できるサポートされている CDK CLI バージョンの一覧については、[[AWS CDK バージョン]](https://docs.aws.amazon.com/cdk/api/versions.html) を参照してください。 このプロパティを省略すると、アクションは次のいずれかのトピックで説明されているデフォルトの AWS CDK CLI バージョンを使用します。 + [AWS CDK 「デプロイ」アクションで使用される CDK CLI バージョン](cdk-dep-action.md#cdk-dep-action-cdk-version) + [AWS CDK 「ブートストラップ」アクションで使用される CDK CLI バージョン](cdk-boot-action.md#cdk-boot-action-cdk-version) 対応する UI: 設定タブ/**AWS CDK CLI バージョン**