

Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用工作流程引導 AWS CDK 應用程式
<a name="cdk-boot-action"></a>

本節說明如何使用 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 bootstrap' 動作](#cdk-boot-action-when-to-use)
+ [「AWS CDK bootstrap」動作的運作方式](#cdk-boot-action-how-it-works)
+ ["AWS CDK bootstrap" 動作使用的 CDK CLI 版本](#cdk-boot-action-cdk-version)
+ [「AWS CDK bootstrap」動作所使用的執行期映像](#cdk-boot-action-runtime)
+ [範例：引導 AWS CDK 應用程式](cdk-boot-action-example-workflow.md)
+ [新增 'AWS CDK bootstrap' 動作](cdk-boot-action-add.md)
+ ['AWS CDK bootstrap' 變數](cdk-boot-action-variables.md)
+ [「AWS CDK 引導」動作 YAML](cdk-boot-action-ref.md)

## 何時使用 'AWS CDK bootstrap' 動作
<a name="cdk-boot-action-when-to-use"></a>

如果您有部署 AWS CDK 應用程式的工作流程，而且您想要同時部署 （並視需要更新） 引導堆疊，請使用此動作。在此情況下，您會將**AWS CDK 引導**操作新增至與部署 AWS CDK 應用程式相同的工作流程。

如果符合下列任一條件，**請勿使用**此動作：
+ 您已使用另一個機制部署引導堆疊，而且想要保持完整 （無更新）。
+ 您想要使用[自訂引導範本，該範本](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-customizing)不受**AWS CDK 引導**動作支援。

## 「AWS CDK bootstrap」動作的運作方式
<a name="cdk-boot-action-how-it-works"></a>

**AWS CDK 引導運作**方式如下：

1. 在執行時間，如果您指定 動作的 1.0.7 版或更早版本，動作會將最新的 CDK CLI （也稱為 AWS CDK Tookit) 下載至 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 bootstrap" 動作使用的 CDK CLI 版本
<a name="cdk-boot-action-cdk-version"></a>

下表顯示不同版本的**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 bootstrap' 動作版本 | AWS CDK CLI 版本 | 
| --- | --- | 
| 1.0.0 – 1.0.7 | 最新 | 
| 1.0.8 或更新版本 | 2.99.1 | 

## 「AWS CDK bootstrap」動作所使用的執行期映像
<a name="cdk-boot-action-runtime"></a>

下表顯示 CodeCatalyst 用來執行不同版本**AWS CDK 引導**操作的執行期環境映像。影像包含不同的預先安裝工具集。如需詳細資訊，請參閱[作用中映像](build-images.md#build-curated-images)。

**注意**  
我們建議您將**AWS CDK 引導**操作升級至 2.x 版，以利用 2024 年 3 月映像中可用的最新工具。若要升級動作，`aws/cdk-bootstrap@v2`請在工作流程定義檔案中將其`Identifier`屬性設定為 。如需詳細資訊，請參閱[「AWS CDK 部署」動作 YAML](cdk-dep-action-ref.md)。


| 'AWS CDK bootstrap' 動作版本 | 執行期環境映像 | 
| --- | --- | 
| 1.x | 2022 年 11 月影像 | 
| 2.x | 2024 年 3 月影像 | 