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

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

# 使用工作流程部署 AWS CDK 應用程式
<a name="cdk-dep-action"></a>

本節說明如何使用工作流程將 AWS Cloud Development Kit (AWS CDK) 應用程式部署到您的 AWS 帳戶。若要達成此目的，您必須將**AWS CDK 部署**動作新增至工作流程。**AWS CDK 部署**動作會合成您的 AWS Cloud Development Kit (AWS CDK) 應用程式並將其部署到其中 AWS。如果您的應用程式已存在於 中 AWS，則動作會視需要更新它。

如需使用 撰寫應用程式的一般資訊 AWS CDK，請參閱[什麼是 AWS CDK？](https://docs.aws.amazon.com/cdk/v2/guide/home.html) 《 *AWS Cloud Development Kit (AWS CDK) 開發人員指南*》中的 。

**Topics**
+ [何時使用 'AWS CDK deploy' 動作](#cdk-dep-action-when-to-use)
+ [「AWS CDK 部署」動作的運作方式](#cdk-dep-action-how-it-works)
+ [「AWS CDK 部署」動作使用的 CDK CLI 版本](#cdk-dep-action-cdk-version)
+ [「AWS CDK 部署」動作使用的執行期映像](#cdk-dep-action-runtime)
+ [動作可以部署多少個堆疊？](#cdk-dep-action-how-many-stacks)
+ [範例：部署 AWS CDK 應用程式](cdk-dep-action-example-workflow.md)
+ [新增「AWS CDK 部署」動作](cdk-dep-action-add.md)
+ [「AWS CDK 部署」變數](cdk-dep-action-variables.md)
+ [「AWS CDK 部署」動作 YAML](cdk-dep-action-ref.md)

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

如果您已使用 開發應用程式 AWS CDK，且現在想要將其自動部署為自動化持續整合和交付 (CI/CD) 工作流程的一部分，請使用此動作。例如，您可能想要在有人合併與 AWS CDK 應用程式來源相關的提取請求時自動部署 AWS CDK 應用程式。

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

**AWS CDK 部署**的運作方式如下：

1. 在執行時間，如果您指定 動作的 1.0.12 版或更早版本，動作會將最新的 CDK CLI （也稱為 AWS CDK Tookit) 下載至 CodeCatalyst [執行時間環境映像](#cdk-dep-action-runtime)。

   如果您指定 1.0.13 版或更新版本，動作會隨附[特定版本的](#cdk-dep-action-cdk-version) CDK CLI，因此不會進行下載。

1. 動作會使用 CDK CLI 來執行 `cdk deploy`命令。此命令會合成您的 AWS CDK 應用程式並將其部署到其中 AWS。如需此命令的詳細資訊，請參閱《 *AWS Cloud Development Kit (AWS CDK) 開發人員指南*》中的 [AWS CDK Toolkit (cdk 命令）](https://docs.aws.amazon.com/cli/latest/reference/s3/sync.html) 主題。

## 「AWS CDK 部署」動作使用的 CDK CLI 版本
<a name="cdk-dep-action-cdk-version"></a>

下表顯示部署**AWS CDK **動作不同版本預設使用的 CDK CLI 版本。

**注意**  
您可能可以覆寫預設值。如需詳細資訊，請參閱 [「AWS CDK 部署」動作 YAML](cdk-dep-action-ref.md) 中的 [CdkCliVersion](cdk-dep-action-ref.md#cdk.dep.cdk.cli.version)。


| 「AWS CDK 部署」動作版本 | AWS CDK CLI 版本 | 
| --- | --- | 
|  1.0.0 – 1.0.12  |  最新  | 
|  1.0.13 或更新版本  |  2.99.1  | 

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

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

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


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

## 動作可以部署多少個堆疊？
<a name="cdk-dep-action-how-many-stacks"></a>

**AWS CDK 部署**只能部署單一堆疊。如果您的 AWS CDK 應用程式包含多個堆疊，您必須建立具有巢狀堆疊的父堆疊，並使用此動作部署父堆疊。