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

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

# 新增「AWS CDK 部署」動作
<a name="cdk-dep-action-add"></a>

 使用下列指示將**AWS CDK 部署**動作新增至您的工作流程。

**開始之前**

在您可以將**AWS CDK 部署**動作新增至工作流程之前，請先完成下列任務：

1. **準備好 AWS CDK 應用程式**。您可以使用 AWS CDK v1 或 v2，以 支援的任何程式設計語言撰寫 AWS CDK 應用程式 AWS CDK。確保您的 AWS CDK 應用程式檔案可用於：
   + CodeCatalyst [來源儲存庫](source.md)，或 
   + 由另一個工作流程動作產生的 CodeCatalyst [輸出成品](workflows-working-artifacts.md) 

1. **引導您的 AWS 環境**。若要引導，您可以：
   + 使用 *AWS Cloud Development Kit (AWS CDK) 開發人員指南*中[如何引導](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html#bootstrapping-howto)所述的其中一種方法。
   + 使用**AWS CDK 引導**操作。您可以在與**AWS CDK 部署**相同的工作流程中新增此動作，或在不同的工作流程中新增此動作。只要確定引導操作在執行**AWS CDK 部署**動作之前至少執行一次，以便有必要的資源。如需**AWS CDK 引導**操作的詳細資訊，請參閱 [使用工作流程引導 AWS CDK 應用程式](cdk-boot-action.md)。

     如需引導的詳細資訊，請參閱《 *AWS Cloud Development Kit (AWS CDK) 開發人員指南*》中的[引導](https://docs.aws.amazon.com/cdk/v2/guide/bootstrapping.html)。

------
#### [ Visual ]

**使用視覺化編輯器新增「AWS CDK 部署」動作**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 選擇您的專案。

1. 在導覽窗格中，選擇 **CI/CD**，然後選擇**工作流程**。

1. 選擇工作流程的名稱。您可以依定義工作流程的來源儲存庫或分支名稱進行篩選，或依工作流程名稱或狀態進行篩選。

1. 選擇**編輯**。

1. 選擇**視覺化**。

1. 在左上角，選擇 **\+ 動作**以開啟動作目錄。

1. 從下拉式清單中，選擇 **Amazon CodeCatalyst**。

1. 搜尋**AWS CDK 部署**動作，並執行下列其中一項操作：
   + 選擇加號 (**\+**) 將動作新增至工作流程圖表，並開啟其組態窗格。

     或
   + 選擇**AWS CDK 部署**。動作詳細資訊對話方塊隨即出現。在此對話方塊中：
     + （選用） 選擇**下載**[以檢視動作的原始程式碼](workflows-view-source.md#workflows-view-source.title)。
     + 選擇**新增至工作流程**，將動作新增至工作流程圖表，然後開啟其組態窗格。

1. 在**輸入**和**組態**索引標籤中，根據您的需求完成欄位。如需每個欄位的說明，請參閱 [「AWS CDK 部署」動作 YAML](cdk-dep-action-ref.md)。此參考提供在 YAML 和視覺化編輯器中顯示的每個欄位 （和對應的 YAML 屬性值） 的詳細資訊。

1. （選用） 選擇**驗證**以在遞交之前驗證工作流程的 YAML 程式碼。

1. 選擇**遞交**，輸入遞交訊息，然後再次選擇**遞交**。
**注意**  
如果您的**AWS CDK 部署**動作失敗並發生錯誤`npm install`，請參閱 以取得如何修正錯誤[如何修正「npm 安裝」錯誤？](troubleshooting-workflows.md#troubleshooting-workflows-npm)的資訊。

------
#### [ YAML ]

**使用 YAML 編輯器新增「AWS CDK 部署」動作**

1. 在 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/) 開啟 CodeCatalyst 主控台。

1. 選擇您的專案。

1. 在導覽窗格中，選擇 **CI/CD**，然後選擇**工作流程**。

1. 選擇工作流程的名稱。您可以依定義工作流程的來源儲存庫或分支名稱進行篩選，或依工作流程名稱或狀態進行篩選。

1. 選擇**編輯**。

1. 選擇 **YAML**。

1. 在左上角，選擇 **\+ 動作**以開啟動作目錄。

1. 從下拉式清單中，選擇 **Amazon CodeCatalyst**。

1. 搜尋**AWS CDK 部署**動作，並執行下列其中一項操作：
   + 選擇加號 (**\+**) 將動作新增至工作流程圖表，並開啟其組態窗格。

     或
   + 選擇**AWS CDK 部署**。動作詳細資訊對話方塊隨即出現。在此對話方塊中：
     + （選用） 選擇**下載**[以檢視動作的原始程式碼](workflows-view-source.md#workflows-view-source.title)。
     + 選擇**新增至工作流程**，將動作新增至工作流程圖表，然後開啟其組態窗格。

1. 根據您的需求修改 YAML 程式碼中的屬性。中會提供每個可用屬性的說明[「AWS CDK 部署」動作 YAML](cdk-dep-action-ref.md)。

1. （選用） 選擇**驗證**以在遞交之前驗證工作流程的 YAML 程式碼。

1. 選擇**遞交**，輸入遞交訊息，然後再次選擇**遞交**。
**注意**  
如果您的**AWS CDK 部署**動作失敗並發生錯誤`npm install`，請參閱 以取得如何修正錯誤[如何修正「npm 安裝」錯誤？](troubleshooting-workflows.md#troubleshooting-workflows-npm)的資訊。

------