

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

# 在 CodeDeploy 中使用應用程式
<a name="applications"></a>

設定執行個體之後，但在可以部署修訂之前，您必須在 CodeDeploy 中建立應用程式。*應用程式*只是 CodeDeploy 使用的名稱或容器，以確保在部署期間參考正確的修訂、部署組態和部署群組。

使用下表中的資訊中的後續步驟：


| 運算平台 | 案例 | 後續步驟的資訊 | 
| --- | --- | --- | 
|  **EC2/現場部署**  |  我尚未建立執行個體。  |  請參閱[使用 CodeDeploy 的執行個體](instances.md)，然後返回此頁面。  | 
|  **EC2/現場部署**  | 我已建立執行個體，但沒有完成標記。 |  請參閱[CodeDeploy 中部署群組的標記執行個體](instances-tagging.md)，然後返回此頁面。  | 
|   **EC2/現場部署**、**AWS Lambda** 和 **Amazon ECS**   |  我尚未建立應用程式。  |  請參閱[使用 CodeDeploy 建立應用程式](applications-create.md)   | 
|   **EC2/現場部署**、**AWS Lambda** 和 **Amazon ECS**   |  我已經建立一個應用程式，但尚未建立部署群組。  |  請參閱 [使用 CodeDeploy 建立部署群組](deployment-groups-create.md)。  | 
|   **EC2/現場部署**、**AWS Lambda** 和 **Amazon ECS**   | 我已經建立一個應用程式及部署群組，但尚未建立應用程式修訂版。 | 請參閱 [使用 CodeDeploy 的應用程式修訂](application-revisions.md)。 | 
|   **EC2/現場部署**、**AWS Lambda** 和 **Amazon ECS**   | 我已經建立一個應用程式及部署群組，並且已經上傳我的應用程式修訂版。我可以開始部署。 | 請參閱[使用 CodeDeploy 建立部署](deployments-create.md)。 | 

**Topics**
+ [建立應用程式](applications-create.md)
+ [檢視應用程式詳細資訊](applications-view-details.md)
+ [建立通知規則](notification-rule-create.md)
+ [重新命名應用程式](applications-rename.md)
+ [刪除應用程式](applications-delete.md)

# 使用 CodeDeploy 建立應用程式
<a name="applications-create"></a>

*應用程式*只是 CodeDeploy 使用的名稱或容器，以確保在部署期間參考正確的修訂、部署組態和部署群組。您可以使用 CodeDeploy 主控台、 AWS CLI、CodeDeploy APIs或 CloudFormation 範本來建立應用程式。

您的程式碼或應用程式修訂版會透過稱為部署的程序安裝到執行個體。CodeDeploy 支援兩種部署類型：
+ **就地部署**：部署群組中每個執行個體上的應用程式會停止、安裝最新的應用程式修訂版，並啟動和驗證應用程式的新版本。您可以使用負載平衡器，讓每個執行個體在其部署期間取消註冊，然後在部署完成後還原至服務。只有使用 EC2/現場部署運算平台的部署才能使用就地部署。如需就地部署的詳細資訊，請參閱 [就地部署概觀](welcome.md#welcome-deployment-overview-in-place)。
+ **藍/綠部署**：部署的行為取決於您使用的運算平台：
  + **EC2/現場部署運算平台上的藍/綠**：部署群組 （原始環境） 中的執行個體會使用下列步驟，以不同的一組執行個體 （替代環境） 取代：
    + 為取代環境佈建執行個體。
    + 最新的應用程式修訂版會安裝在取代執行個體上。
    + 對於應用程式測試和系統驗證等活動，會發生選用的等待時間。
    + 替換環境中的執行個體會向一或多個 Elastic Load Balancing 負載平衡器註冊，導致流量重新路由至它們。原始環境中的執行個體會取消註冊，並可終止或繼續執行以供其他使用。
**注意**  
如果您使用 EC2/現場部署運算平台，請注意，藍/綠部署僅適用於 Amazon EC2 執行個體。
  + ** AWS Lambda 或 Amazon ECS 運算平台上的藍/綠**：流量會根據 **Canary**、**線性**或**all-at-once**組態遞增轉移。
  + **透過 進行藍/綠部署 CloudFormation**：流量會從您目前的資源轉移到已更新的資源，做為 CloudFormation 堆疊更新的一部分。目前僅支援 ECS 藍/綠部署。

  如需藍/綠部署的詳細資訊，請參閱 [藍/綠部署概觀](welcome.md#welcome-deployment-overview-blue-green)。

當您使用 CodeDeploy 主控台建立應用程式時，您可以同時設定其第一個部署群組。當您使用 AWS CLI 建立應用程式時，您會在不同的步驟中建立其第一個部署群組。

若要檢視已註冊至您 AWS 帳戶的應用程式清單，請參閱 [使用 CodeDeploy 檢視應用程式詳細資訊](applications-view-details.md)。如需使用 CloudFormation 範本建立應用程式的詳細資訊，請參閱 [CloudFormation CodeDeploy 參考的 範本](reference-cloudformation-templates.md)。

 這兩種部署類型不適用於所有目的地。下表列出哪些部署類型可用於部署至三種類型的部署目的地。


****  

| 部署目的地 | 就地 | 藍/綠 | 
| --- | --- | --- | 
| Amazon EC2  | 是 | 是 | 
| 現場部署 | 是 | 否 | 
| 無伺服器 AWS Lambda 函數 | 否 | 是 | 
| Amazon ECS 應用程式 | 否 | 是 | 



**Topics**
+ [建立就地部署的應用程式 （主控台）](applications-create-in-place.md)
+ [建立藍/綠部署的應用程式 （主控台）](applications-create-blue-green.md)
+ [為 Amazon ECS 服務部署建立應用程式 （主控台）](applications-create-ecs.md)
+ [建立 AWS Lambda 函數部署的應用程式 （主控台）](applications-create-lambda.md)
+ [建立應用程式 (CLI)](applications-create-cli.md)

# 建立就地部署的應用程式 （主控台）
<a name="applications-create-in-place"></a>

若要使用 CodeDeploy 主控台為就地部署建立應用程式：

 

**警告**  
如果發生下列情況，請勿採用這些步驟：  
您尚未準備好要在 CodeDeploy 部署中使用的執行個體。若要設定您的執行個體，請遵循[使用 CodeDeploy 的執行個體](instances.md)中的說明，然後遵循本主題中的步驟。
您希望建立使用自訂部署組態的應用程式，但您尚未建立部署組態。請遵循[使用 CodeDeploy 建立部署組態](deployment-configurations-create.md)中的說明，再返回本主題中的步驟。
您沒有信任 CodeDeploy 且具有最低必要信任和許可的服務角色。若要使用必要的許可建立及設定服務角色，請遵循[步驟 2：建立 CodeDeploy 的服務角色](getting-started-create-service-role.md)中的說明，再返回本主題中的步驟。
您想要在 Elastic Load Balancing 中為就地部署選取 Classic Load Balancer、Application Load Balancer 或 Network Load Balancer，但尚未建立。

若要使用 CodeDeploy 主控台建立就地部署的應用程式：

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy) 開啟 CodeDeploy 主控台。
**注意**  
使用您在 中設定的相同使用者登入[CodeDeploy 入門](getting-started-codedeploy.md)。

1. 在導覽窗格中，展開 **Deploy (部署)**，然後選擇 **Getting started (入門)**。

1. 選擇**建立應用程式**。

1. **Application name (應用程式名稱)** 中輸入您應用程式的名稱。

1. 在 **Compute Platform (運算平台)** 中，選擇 **EC2/On-premises (EC2/現場部署)**。

1. 選擇**建立應用程式**。

1. 在您的應用程式頁面，從 **Deployment groups (部署群組)** 標籤中，選擇 **Create deployment group (建立部署群組)**。

1. 在 **Deployment group name (部署群組名稱)** 中，輸入描述部署群組的名稱。
**注意**  
如果您想要使用與其他部署群組相同的設定 （包括部署群組名稱；標籤、Amazon EC2 Auto Scaling 群組名稱或兩者；以及部署組態），請在此頁面指定這些設定。雖然這個新的部署群組和現有的部署群組具有相同的名稱，但 CodeDeploy 會將它們視為單獨的部署群組，因為它們各自與不同的應用程式相關聯。

1. 在**服務角色**中，選擇授予 CodeDeploy 存取目標執行個體的服務角色。

1. 在 **Deployment type (部署類型)** 中，選擇 **In-place (就地)**。

1. 在 **Environment configuration (環境資訊)** 中，選取下列任何項目：

   1. **Amazon EC2 Auto Scaling 群組**：輸入或選擇要部署應用程式修訂版的 Amazon EC2 Auto Scaling 群組名稱。當新的 Amazon EC2 執行個體作為 Amazon EC2 Auto Scaling 群組的一部分啟動時，CodeDeploy 可以自動將您的修訂部署到新的執行個體。您最多可以將 10 個 Amazon EC2 Auto Scaling 群組新增至部署群組。

   1. **Amazon EC2 執行個體**或**內部部署執行個體**：在**金鑰**和**值**欄位中，輸入您用來標記執行個體之金鑰/值對的值。您最多可以在單一標籤群組內標記 10 個金鑰值對。

      1. 您可以在**值**欄位中使用萬用字元來識別以特定模式標記的所有執行個體，例如類似的 Amazon EC2 執行個體、成本中心和群組名稱等。例如，如果您在**金鑰**欄位中選擇**名稱**並在**GRP-\$1a****值**欄位中輸入 ，CodeDeploy 會識別符合該模式的所有執行個體，例如 **GRP-1a**、 **GRP-2a**和 **GRP-XYZ-a**。

      1. **Value (值)** 欄位區分大小寫。

      1. 若要從清單中移除一個金鑰值對，請選擇 **Remove tag (移除標籤)**。

      隨著 CodeDeploy 找到符合每個指定鍵值對或 Amazon EC2 Auto Scaling 群組名稱的執行個體，它會顯示相符執行個體的數量。選擇數字即可查看有關於執行個體的詳細資訊。

      如果您想要強化部署到執行個體的條件，請選擇 **Add tag group (新增標籤群組)** 以建立標籤群組。您可以建立最多三個標籤群組，每個標籤群組最多包含 10 個金鑰值對。當您在部署群組中使用多個標籤群組，只有所有標籤群組識別出的執行個體會包含在部署群組中。這表示一個執行個體至少有一個標籤必須符合部署群組中的每個群組。

      如需使用標籤群組來強化部署群組的相關資訊，請參閱[CodeDeploy 中部署群組的標記執行個體](instances-tagging.md)。

1. 在 **Deployment settings (部署設定)** 中，選擇部署組態以控制應用程式部署到執行個體的速度，例如一次一個或一次全部。如需部署組態的詳細資訊，請參閱[在 CodeDeploy 中使用部署組態](deployment-configurations.md)。

1. （選用） 在**負載平衡器**中，選取**啟用負載平衡**，然後從清單中選取 Classic Load Balancer、Application Load Balancer 目標群組和 Network Load Balancer 目標群組，以在 CodeDeploy 部署期間管理執行個體的流量。您可以選取最多 10 個 Classic Load Balancer 和 10 個目標群組，總共 20 個項目。確定您要部署的 Amazon EC2 執行個體已向選取的負載平衡器 (Classic Load Balancer) 或目標群組 (Application Load Balancer 和 Network Load Balancer) 註冊。

   在部署期間，原始執行個體會從選取的負載平衡器和目標群組取消註冊，以防止流量在部署期間路由到這些執行個體。部署完成時，每個執行個體都會重新註冊*所有*選取的 Classic Load Balancer 和目標群組。

   如需 CodeDeploy 部署負載平衡器的詳細資訊，請參閱 [將 CodeDeploy 與 Elastic Load Balancing 整合](integrations-aws-elastic-load-balancing.md)。

1. （選用） 展開**進階**，並設定您要包含在部署中的任何選項，例如 Amazon SNS 通知觸發、Amazon CloudWatch 警示或自動轉返。

   如需詳細資訊，請參閱[設定部署群組的進階選項](deployment-groups-configure-advanced-options.md)。

1. 選擇 **Create deployment group (建立部署群組)**。

在下一個步驟中，您要準備一個修訂版本，以便將其部署至應用程式和部署群組。如需說明，請參閱[使用 CodeDeploy 的應用程式修訂](application-revisions.md)。

# 建立藍/綠部署的應用程式 （主控台）
<a name="applications-create-blue-green"></a>

若要使用 CodeDeploy 主控台建立藍/綠部署的應用程式：

**注意**  
 AWS Lambda 運算平台的部署一律是藍/綠部署。您未指定部署類型選項。

**警告**  
如果發生下列情況，請勿採用這些步驟：  
在藍/綠部署程序期間，您沒有已安裝 CodeDeploy 代理程式的執行個體要取代。若要設定您的執行個體，請遵循[使用 CodeDeploy 的執行個體](instances.md)中的說明，然後遵循本主題中的步驟。
您希望建立使用自訂部署組態的應用程式，但您尚未建立部署組態。請遵循[使用 CodeDeploy 建立部署組態](deployment-configurations-create.md)中的說明，再返回本主題中的步驟。
您沒有信任 CodeDeploy 的服務角色，至少要信任 中所述的信任和許可[步驟 2：建立 CodeDeploy 的服務角色](getting-started-create-service-role.md)。若要建立及設定服務角色，請遵循[步驟 2：建立 CodeDeploy 的服務角色](getting-started-create-service-role.md)中的說明，再返回本主題中的步驟。
您尚未在 Elastic Load Balancing 中建立 Classic Load Balancer、Application Load Balancer 或 Network Load Balancer，以註冊替換環境中的執行個體。如需詳細資訊，請參閱[在 Elastic Load Balancing 中為 CodeDeploy Amazon EC2 部署設定負載平衡器](deployment-groups-create-load-balancer.md)。

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy) 開啟 CodeDeploy 主控台。
**注意**  
使用您在 中設定的相同使用者登入[CodeDeploy 入門](getting-started-codedeploy.md)。

1. 在導覽窗格中，展開 **Deploy (部署)**，然後選擇 **Getting started (入門)**。

1. **Application name (應用程式名稱)** 中輸入您應用程式的名稱。

1. 在 **Compute platform (運算平台)** 中，選擇 **EC2/On-Premises (EC2/現場部署)**。

1. 選擇**建立應用程式**。

1. 在您的應用程式頁面，從 **Deployment groups (部署群組)** 標籤中，選擇 **Create deployment group (建立部署群組)**。

1. 在 **Deployment group name (部署群組名稱)** 中，輸入描述部署群組的名稱。
**注意**  
如果您想要使用與其他部署群組相同的設定 （包括部署群組名稱標籤、Amazon EC2 Auto Scaling 群組名稱和部署組態），請在此頁面選擇這些設定。雖然這個新的部署群組和現有的部署群組具有相同的名稱，但 CodeDeploy 會將它們視為單獨的部署群組，因為每個群組都與單獨的應用程式相關聯。

1. 在**服務角色**中，選擇授予 CodeDeploy 存取目標執行個體的服務角色。

1. 在 **Deployment type (部署類型)** 中，選擇 **Blue/green (藍/綠)**。

1. 在 **Environment configuration (環境組態中)** 中，選擇為您的替換環境提供執行個體的方法：

   1. **自動複製 Amazon EC2 Auto Scaling 群組**：CodeDeploy 會透過複製您指定的群組來建立 Amazon EC2 Auto Scaling 群組。

   1. **手動佈建執行個體**：直到建立部署，您才能為您的替換環境指定執行個體。開始部署之前，您必須建立執行個體。在這個選項中，您要改為指定欲取代的執行個體。

1. 根據您在步驟 10 中所做的選擇，執行下列任一作業：
   + 如果您選擇**自動複製 Amazon EC2 Auto Scaling 群組**：在 **Amazon EC2 Auto Scaling 群組**中，選擇或輸入您要用作替代環境中執行個體之 Amazon EC2 Auto Scaling 群組範本的 Amazon EC2 Auto Scaling 群組名稱。您選擇的 Amazon EC2 Auto Scaling 群組中目前運作狀態良好的執行個體數量會在取代環境中建立。
   + 如果您選擇**手動佈建執行個體**：啟用 **Amazon EC2 Auto Scaling 群組**、**Amazon EC2 執行個體**或兩者，以指定要新增至此部署群組的執行個體。輸入 Amazon EC2 標籤值或 Amazon EC2 Auto Scaling 群組名稱，以識別原始環境中的執行個體 （也就是您要取代或正在執行目前應用程式修訂版的執行個體）。

1. 在**負載平衡器**中，選取**啟用負載平衡**，然後從清單中選取您要註冊替代 Amazon EC2 執行個體的 Classic Load Balancer、Application Load Balancer 目標群組和 Network Load Balancer 目標群組。每個替換執行個體都會向*所有*選取的 Classic Load Balancer 和目標群組註冊。您可以選取最多 10 個 Classic Load Balancer 和 10 個目標群組，總共 20 個項目。

   流量會根據您選擇的流量重新路由和**部署組態設定**，從原始執行個體**重新路由**至替代執行個體。

   如需 CodeDeploy 部署負載平衡器的詳細資訊，請參閱 [將 CodeDeploy 與 Elastic Load Balancing 整合](integrations-aws-elastic-load-balancing.md)。

1. 在 **Deployment settings (部署設定)** 中，檢閱重新路由流量至替換環境的預設選項、要用於部署的部署組態，以及部署後處理原始環境中執行個體的方式。

   若您想要變更設定，請繼續下一個步驟。否則，請跳至步驟 15。

1. 若要變更藍/綠部署的部署設定，請變更下列任何設定。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/codedeploy/latest/userguide/applications-create-blue-green.html)

1. （選用） 在**進階**中，設定您要包含在部署中的選項，例如 Amazon SNS 通知觸發、Amazon CloudWatch 警示或自動轉返。

   如需在部署群組中指定進階選項的相關資訊，請參閱[設定部署群組的進階選項](deployment-groups-configure-advanced-options.md)。

1. 選擇 **Create deployment group (建立部署群組)**。

在下一個步驟中，您要準備一個修訂版本，以便將其部署至應用程式和部署群組。如需說明，請參閱[使用 CodeDeploy 的應用程式修訂](application-revisions.md)。

# 為 Amazon ECS 服務部署建立應用程式 （主控台）
<a name="applications-create-ecs"></a>

 您可以使用 CodeDeploy 主控台為 Amazon ECS 服務部署建立應用程式。

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy) 開啟 CodeDeploy 主控台。
**注意**  
使用您在 中設定的相同使用者登入[CodeDeploy 入門](getting-started-codedeploy.md)。

1. 在導覽窗格中，展開**部署**，然後選擇**開始使用**。

1. 在 **Create application (建立應用程式)** 頁面，選擇 **Use CodeDeploy (使用 CodeDeploy)**。

1. **Application name (應用程式名稱)** 中輸入您應用程式的名稱。

1. 從**運算平台**中，選擇 **Amazon ECS**。

1. 選擇**建立應用程式**。

1. 在您的應用程式頁面，從 **Deployment groups (部署群組)** 標籤中，選擇 **Create deployment group (建立部署群組)**。如需為 Amazon ECS 部署建立部署群組所需的詳細資訊，請參閱 [開始 Amazon ECS 部署之前](deployment-steps-ecs.md#deployment-steps-prerequisites-ecs)。

1. 在 **Deployment group name (部署群組名稱)** 中，輸入描述部署群組的名稱。
**注意**  
如果您想使用用於其他部署群組的相同設定 (包括部署群組名稱和部署組態)，請在本頁面上選擇這些設定。雖然這個新群組和現有群組的名稱可能相同，但 CodeDeploy 會將它們視為單獨的部署群組，因為每個群組都與單獨的應用程式相關聯。

1. 在**服務角色**中，選擇授予 CodeDeploy 存取 Amazon ECS 的服務角色。如需詳細資訊，請參閱[步驟 2：建立 CodeDeploy 的服務角色](getting-started-create-service-role.md)。

1.  從**負載平衡器名稱**中，選擇為 Amazon ECS 服務提供流量的負載平衡器名稱。

1.  從**生產接聽程式連接埠**中，選擇為 Amazon ECS 服務提供生產流量的接聽程式連接埠和通訊協定。

1.  （選用） 從**測試接聽程式連接埠**中，選擇測試接聽程式的連接埠和通訊協定，以便在部署期間將流量提供給 Amazon ECS 服務中的替代任務集。您可以在`AfterAllowTestTraffic`掛鉤期間執行的 AppSpec 檔案中指定一或多個 Lambda 函數。函數可以執行驗證測試。如果驗證測試失敗，則會觸發部署轉返。如果驗證測試成功，則會觸發部署生命週期中的下一個勾點 `BeforeAllowTraffic`。如果未指定測試接聽程式連接埠，則`AfterAllowTestTraffic`掛鉤期間不會發生任何情況。如需詳細資訊，請參閱[Amazon ECS 部署的 AppSpec 'hooks' 區段](reference-appspec-file-structure-hooks.md#appspec-hooks-ecs)。

1. 從 **Target group 1 name (目標群組 1 名稱)** 和 **Target group 2 name (目標群組 2 名稱)** 中，選擇在部署期間用來路由流量的目標群組。CodeDeploy 會將一個目標群組繫結至 Amazon ECS 服務的原始任務集，並將另一個目標群組繫結至其替代任務集。如需詳細資訊，請參閱 [Application Load Balancer 的目標群組](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html)。

1.  選擇**立即重新路由流量**或**指定何時重新路由流量**，以判斷何時將流量重新路由至更新的 Amazon ECS 服務。

    如果您選擇**立即重新路由流量**，則部署會在佈建替代任務集之後自動重新路由流量。

    如果您選擇**指定重新路由流量的時間**，請選擇成功佈建替代任務集後要等待的天數、小時數和分鐘數。在此等待期間，會在 AppSpec 檔案中指定的 Lambda 函數中執行驗證測試。如果等待時間在流量重新路由之前過期，則部署狀態會變更為 `Stopped`。

1.  對於**原始修訂終止**，選擇成功部署後在 Amazon ECS 服務中原始任務集終止之前要等待的天數、小時數和分鐘數。

1. （選用） 在**進階**中，設定您要包含在部署中的任何選項，例如 Amazon SNS 通知觸發、Amazon CloudWatch 警示或自動轉返。

   如需詳細資訊，請參閱[設定部署群組的進階選項](deployment-groups-configure-advanced-options.md)。

# 建立 AWS Lambda 函數部署的應用程式 （主控台）
<a name="applications-create-lambda"></a>

您可以使用 CodeDeploy 主控台來建立 AWS Lambda 函數部署的應用程式。

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy) 開啟 CodeDeploy 主控台。
**注意**  
使用您在 中設定的相同使用者登入[CodeDeploy 入門](getting-started-codedeploy.md)。

1. 在導覽窗格中，展開**部署**，然後選擇**開始使用**。

1. 在 **Create application (建立應用程式)** 頁面，選擇 **Use CodeDeploy (使用 CodeDeploy)**。

1. 以 **Application name (應用程式的名稱)** 輸入您應用程式的名稱。

1. 從 **Compute platform (運算平台)**，選擇 **AWS Lambda**。

1. 選擇**建立應用程式**。

1. 在您的應用程式頁面，從 **Deployment groups (部署群組)** 標籤中，選擇 **Create deployment group (建立部署群組)**。

1. 在 **Deployment group name (部署群組名稱)** 中，輸入描述部署群組的名稱。
**注意**  
如果您想使用用於其他部署群組的相同設定 (包括部署群組名稱和部署組態)，請在本頁面上選擇這些設定。雖然這個新的部署群組和現有的部署群組可能具有相同的名稱，但 CodeDeploy 會將它們視為單獨的部署群組，因為每個群組都與單獨的應用程式相關聯。

1. 在**服務角色**中，選擇授予 CodeDeploy 存取權的服務角色 AWS Lambda。如需詳細資訊，請參閱[步驟 2：建立 CodeDeploy 的服務角色](getting-started-create-service-role.md)。

1.  如果您想要使用預先定義的部署組態，請從 **Deployment configuration (部署組態)** 中選擇一個，然後跳到步驟 12。若要建立自訂組態，請繼續下一個步驟。

   如需部署組態的詳細資訊，請參閱[AWS Lambda 運算平台上的部署組態](deployment-configurations.md#deployment-configuration-lambda)。

1. 若要建立自訂組態，請選擇 **Create deployment configuration (建立部署組態)**，然後執行下列動作：

   1. 對於 **Deployment configuration name (部署組態名稱)**，為組態輸入名稱。

   1. 在 **Type (類型)** 中，選擇組態類型。若選擇 **Canary (Canary)**，系統會在兩次遞增中逐漸轉移流量。若選擇 **Linear (線性)**，流量以相等增量轉移，每個增量之間分鐘數相等。

   1. 對於**Step (步驟)**，輸入要轉移的 1 到 99 之間的流量百分比。如果您的組態類型為 **Canary**，這是在第一個增量轉移的流量百分比。剩餘的流量會在第二個增量之選定間隔後轉移。如果組態類型為 **Linear (線性)**，則代表每個間隔開始時轉移的流量百分比。

   1. 在 **Interval (間隔)** 中，輸入分鐘數。如果組態類型是 **Canary (Canary)**，這就代表第一次和第二次流量轉移時間隔的分鐘數。如果您的組態類型是 **Linear (線性)**，這是每個增量轉移之間的分鐘數。
**注意**  
 AWS Lambda 部署的長度上限為兩天或 2，880 分鐘。因此，Canary 組態的 **Interval (間隔)** 最大指定值為 2,800 分鐘。線性組態的最大值取決於 **Step (步驟)** 的值。例如，如果線性流量轉移的步驟百分比是 25%，則有四個流量移位。最大間隔值為 2,880 除以 4，或是 720 分鐘。

   1. 選擇 **Create deployment configuration (建立部署組態)**。

1. （選用） 在**進階**中，設定您要包含在部署中的任何選項，例如 Amazon SNS 通知觸發、Amazon CloudWatch 警示或自動轉返。

   如需詳細資訊，請參閱[設定部署群組的進階選項](deployment-groups-configure-advanced-options.md)。

1. 選擇 **Create deployment group (建立部署群組)**。

# 建立應用程式 (CLI)
<a name="applications-create-cli"></a>

若要使用 AWS CLI 建立應用程式，請呼叫 [create-application](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-application.html) 命令，指定唯一代表應用程式的名稱。（在 AWS 帳戶中，CodeDeploy 應用程式名稱每個區域只能使用一次。 您可以在不同的區域中重複使用應用程式名稱。)

使用 AWS CLI 建立應用程式後，下一個步驟是建立部署群組，指定要部署修訂的執行個體。如需說明，請參閱[使用 CodeDeploy 建立部署群組](deployment-groups-create.md)。

在您建立部署群組後，下一步是準備要部署到應用程式和部署群組的修訂版。如需說明，請參閱[使用 CodeDeploy 的應用程式修訂](application-revisions.md)。

# 使用 CodeDeploy 檢視應用程式詳細資訊
<a name="applications-view-details"></a>

您可以使用 CodeDeploy 主控台 AWS CLI、 或 CodeDeploy APIs 來檢視與 AWS 您的帳戶相關聯的所有應用程式的詳細資訊。

**Topics**
+ [檢視應用程式詳細資訊 （主控台）](#applications-view-details-console)
+ [檢視應用程式詳細資訊 (CLI)](#applications-view-details-cli)

## 檢視應用程式詳細資訊 （主控台）
<a name="applications-view-details-console"></a>

若要使用 CodeDeploy 主控台檢視應用程式詳細資訊：

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy) 開啟 CodeDeploy 主控台。
**注意**  
使用您在 中設定的相同使用者登入[CodeDeploy 入門](getting-started-codedeploy.md)。

1. 在導覽窗格中，展開**部署**，然後選擇**開始使用**。

1. 要查看其他應用程式的詳細資訊，請選擇清單中的應用程式名稱。

## 檢視應用程式詳細資訊 (CLI)
<a name="applications-view-details-cli"></a>

若要使用 AWS CLI 來檢視應用程式詳細資訊，請呼叫 **get-application**命令、 **batch-get-application**命令或 **list-applications**命令。

若要檢視單一應用程式的詳細資訊，請呼叫 [get-application](https://docs.aws.amazon.com/cli/latest/reference/deploy/get-application.html) 命令，並指定應用程式名稱。

若要檢視多個應用程式的詳細資訊，請呼叫 [batch-get-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/batch-get-applications.html) 命令，指定多個應用程式名稱。

若要檢視應用程式名稱清單，請呼叫 [list-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html) 命令。

# 建立通知規則
<a name="notification-rule-create"></a>

您可以使用通知規則，在部署應用程式發生變更時通知使用者，例如部署成功和部署失敗。通知規則會同時指定用於傳送通知的事件和 Amazon SNS 主題。如需詳細資訊，請參閱[什麼是通知？](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/welcome.html)

您可以使用 主控台或 AWS CLI 來建立 的通知規則 AWS CodeDeploy。<a name="notification-rule-create-console"></a>

# 建立通知規則 (主控台)
<a name="notification-rule-create-console"></a>

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/codedeploy/](https://console.aws.amazon.com/codedeploy/) 開啟 CodeDeploy 主控台。

1. 選擇 **Application (應用程式)**，然後選擇要新增通知的應用程式。

1. 在應用程式頁面上，選擇 **Notify (通知)**，然後選擇 **Create notification rule (建立通知規則)**。您也可以移至應用程式的 **Settings (設定)** 頁面，然後選擇 **Create notification rule (建立通知規則)**。

1. 在 **Notification name (通知名稱)** 中，輸入規則的名稱。

1. 如果您只希望提供給 Amazon EventBridge 的資訊包含在通知中，請在 **Detail type (詳細資訊類型)** 中，選擇 **Basic (基本)**。如果您想要包含提供給 Amazon EventBridge 的資訊，以及 CodeDeploy 或通知管理員可能提供的資訊，請選擇**完整**。

   如需詳細資訊，請參閱[了解通知內容和安全性](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/security.html#security-notifications)。

1.  在 **Events that trigger notifications (觸發通知的事件)** 中，選取您要傳送通知的事件。    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/codedeploy/latest/userguide/notification-rule-create.html)

1. 在 **Targets (目標)** 中，選擇 **Create SNS topic (建立 SNS 主題)**。
**注意**  
當您建立主題時，會為您套用允許 CodeDeploy 發佈事件至主題的政策。使用專為 CodeDeploy 通知建立的主題，也有助於確保您只將使用者新增至要查看此部署應用程式相關通知之主題的訂閱清單。

   在 **codestar-notifications-** 字首之後，輸入主題的名稱，然後選擇 **Submit (提交)**。
**注意**  
如果您要使用現有 Amazon SNS 主題而非建立新主題，請在 **Targets (目標)** 中選擇其 ARN。請確定主題具有適當的存取政策，而且訂閱者清單只包含允許查看部署應用程式相關資訊的使用者。如需詳細資訊，請參閱[設定通知的現有 Amazon SNS 主題](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/set-up-sns.html)和[了解通知內容和安全性](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/security.html#security-notifications)。

1. 若要完成建立規則，請選擇 **Submit (提交)**。

1. 您必須為使用者訂閱規則的 Amazon SNS 主題，才能接收通知。如需詳細資訊，請參閱[訂閱使用者成為目標的 Amazon SNS 主題](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/subscribe-users-sns.html)。您也可以在聊天應用程式中設定通知與 Amazon Q Developer 之間的整合，將通知傳送至 Amazon Chime 聊天室或 Slack 頻道。如需詳細資訊，請參閱[在聊天應用程式中設定通知與 Amazon Q Developer 之間的整合](https://docs.aws.amazon.com/codestar-notifications/latest/userguide/notifications-chatbot.html)。<a name="notification-rule-create-cli"></a>

# 建立通知規則 (AWS CLI)
<a name="notification-rule-create-cli"></a>

1. 在終端機或命令提示字元中，執行 **create-notification rule** 命令以產生 JSON 架構：

   ```
   aws codestar-notifications create-notification-rule --generate-cli-skeleton > rule.json
   ```

   您可以將檔案命名為任何您想要的名稱。在此範例中，檔案命名為 *rule.json*。

1. 在純文字編輯器中開啟 JSON 檔案，並進行編輯，以包含規則所需的資源、事件類型和 Amazon SNS 目標。下列範例顯示 ID **MyNotificationRule** 為 *123456789012* AWS 之帳戶中名為 *MyDeploymentApplication* 之應用程式的通知規則。部署成功時，通知會以完整詳細資訊類型傳送至名為 *codestar-notifications-MyNotificationTopic* 的 Amazon SNS 主題：

   ```
   {
       "Name": "MyNotificationRule",
       "EventTypeIds": [
           "codedeploy-application-deployment-succeeded"
       ],
       "Resource": "arn:aws:codebuild:us-east-2:123456789012:MyDeploymentApplication",
       "Targets": [
           {
               "TargetType": "SNS",
               "TargetAddress": "arn:aws:sns:us-east-2:123456789012:codestar-notifications-MyNotificationTopic"
           }
       ],
       "Status": "ENABLED",
       "DetailType": "FULL"
   }
   ```

   儲存檔案。

1. 在終端機或命令列中，再次執行 **create-notification-rule** 命令，使用您剛編輯的檔案建立通知規則：

   ```
   aws codestar-notifications create-notification-rule --cli-input-json  file://rule.json
   ```

1. 如果成功，此命令會傳回通知規則的 ARN，如下所示：

   ```
   {
       "Arn": "arn:aws:codestar-notifications:us-east-1:123456789012:notificationrule/dc82df7a-EXAMPLE"
   }
   ```

# 重新命名 CodeDeploy 應用程式
<a name="applications-rename"></a>

您可以使用 AWS CLI 或 CodeDeploy APIs來變更應用程式的名稱。

若要檢視應用程式名稱清單，請使用 AWS CLI 呼叫 [list-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html) 命令。

如需使用 AWS CLI 變更應用程式名稱的資訊，請參閱 [update-application](https://docs.aws.amazon.com/cli/latest/reference/deploy/update-application.html)。

如需有關使用 CodeDeploy APIs變更應用程式名稱的資訊，請參閱 [API\$1UpdateApplication](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_UpdateApplication.html)。

# 在 CodeDeploy 中刪除應用程式
<a name="applications-delete"></a>

您可以使用 CodeDeploy 主控台 AWS CLI、 或 CodeDeploy API 動作來刪除應用程式。如需使用 CodeDeploy API 動作的相關資訊，請參閱 [DeleteApplication](https://docs.aws.amazon.com/codedeploy/latest/APIReference/API_DeleteApplication.html)。

**警告**  
刪除應用程式會從 CodeDeploy 系統移除應用程式的相關資訊，包括所有相關部署群組資訊和部署詳細資訊。刪除為 EC2/現場部署建立的應用程式並不會從執行個體移除任何應用程式修訂，也不會從 Amazon S3 儲存貯體刪除修訂。刪除為 EC2/現場部署建立的應用程式不會終止任何 Amazon EC2 執行個體或取消註冊任何現場部署執行個體。這個操作無法復原。

**Topics**
+ [刪除應用程式 （主控台）](#applications-delete-console)
+ [刪除應用程式 (AWS CLI)](#applications-delete-cli)

## 刪除應用程式 （主控台）
<a name="applications-delete-console"></a>

若要使用 CodeDeploy 主控台刪除應用程式：

1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy) 開啟 CodeDeploy 主控台。
**注意**  
使用您在 中設定的相同使用者登入[CodeDeploy 入門](getting-started-codedeploy.md)。

1. 在導覽窗格中，展開**部署**，然後選擇**應用程式**。

1. 在應用程式清單中，選擇您要刪除的應用程式。

   隨即出現頁面，其中包含應用程式的詳細資訊。

1. 選擇右上角的**刪除應用程式**。

1. 出現提示時，輸入 **delete** 以確認您想要刪除應用程式，然後選擇**刪除**。

## 刪除應用程式 (AWS CLI)
<a name="applications-delete-cli"></a>

若要使用 AWS CLI 刪除應用程式，請呼叫 [delete-application](https://docs.aws.amazon.com/cli/latest/reference/deploy/delete-application.html) 命令，並指定應用程式名稱。若要檢視應用程式名稱清單，請呼叫 [list-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html) 命令。