對 Amazon EC2 Auto Scaling 問題進行故障診斷

1. 執行以下任意一項：

   • 呼叫 delete-deployment-group命令來刪除與 Auto Scaling 群組相關聯的部署群組，這會導致活動訊號逾時。

   • 使用非空的 Auto Scaling 群組名稱清單呼叫 update-deployment-group命令，以分離所有 CodeDeploy受管 Auto Scaling 生命週期掛鉤。

     例如，輸入下列 AWS CLI 命令：

     aws deploy update-deployment-group --application-name my-example-app --current-deployment-group-name my-deployment-group --auto-scaling-groups

     另一個範例是，如果您搭配 Java 使用 CodeDeploy API，請呼叫 UpdateDeploymentGroup並autoScalingGroups設為 new ArrayList<String>()。這將autoScalingGroups設定為空清單，並移除現有清單。請勿使用 null，這是預設值，因為這會autoScalingGroups保持原狀，但不是您想要的。

   檢查呼叫的輸出。如果輸出包含具有 Amazon EC2 Auto Scaling 生命週期掛鉤清單的hooksNotCleanedUp結構，則會有剩餘的生命週期掛鉤。

2. 呼叫 describe-lifecycle-hooks命令，指定與無法啟動的EC2執行個體相關聯的 Amazon EC2 Auto Scaling 群組名稱。在輸出中，尋找下列任何項目：

   • 與您在步驟 1 中識別的hooksNotCleanedUp結構對應的 Amazon EC2 Auto Scaling 生命週期掛鉤名稱。

   • Amazon EC2 Auto Scaling 生命週期掛鉤名稱，其中包含與失敗的 Auto Scaling 群組相關聯的部署群組名稱。

   • Amazon EC2 Auto Scaling 生命週期掛鉤名稱可能導致 CodeDeploy 部署的心跳逾時。

3. 如果掛鉤屬於步驟 2 中列出的其中一個類別，請呼叫 delete-lifecycle-hook命令以將其刪除。在通話中指定 Amazon EC2 Auto Scaling 群組和生命週期掛鉤。

   重要

   僅刪除造成問題的掛鉤，如步驟 2 所述。如果您刪除可行的掛鉤，您的部署可能會失敗，或者 CodeDeploy 可能無法部署應用程式修訂版以擴展EC2執行個體。

4. 使用所需的 Auto Scaling 群組名稱呼叫 update-deployment-group或 create-deployment-group命令。 CodeDeploy 會使用新的 重新安裝 Auto Scaling 掛鉤UUIDs。

1. 呼叫 describe-lifecycle-hooks命令，指定與 中的部署群組相關聯的 Amazon EC2 Auto Scaling 群組名稱 CodeDeploy。在輸出的 LifecycleHooks 清單中，記錄每個 LifecycleHookName 值。

2. 呼叫 get-deployment-group命令，指定與 Amazon EC2 Auto Scaling 群組相關聯的部署群組名稱。在輸出的autoScalingGroups清單中，尋找名稱值符合 Amazon EC2 Auto Scaling 群組名稱的每個項目，然後記下對應的hook值。

1. 如果在 describe-lifecycle-hooks 命令輸出中包含在 get-deployment-group 命令輸出中未包含的生命週期關聯名稱，則執行以下作業：

   1. 針對describe-lifecycle-hooks命令輸出中的每個生命週期掛鉤名稱，呼叫 delete-lifecycle-hook命令。

   2. 呼叫 update-deployment-group命令，指定原始 Amazon EC2 Auto Scaling 群組的名稱。在 Amazon EC2 Auto Scaling 群組中 CodeDeploy 建立新的替換生命週期掛鉤，並將生命週期掛鉤與部署群組建立關聯。當新的執行個體新增至 Amazon EC2 Auto Scaling 群組時，現在應繼續自動部署。

2. 如果在 get-deployment-group 命令輸出中包含在 describe-lifecycle-hooks 命令輸出中未包含的生命週期關聯名稱，則執行以下作業：

   1. 呼叫 update-deployment-group命令，但不指定原始 Amazon EC2 Auto Scaling 群組的名稱。

   2. 再次呼叫 update-deployment-group命令，但這次會指定原始 Amazon EC2 Auto Scaling 群組的名稱。 CodeDeploy 在 Amazon EC2 Auto Scaling 群組中重新建立缺少的生命週期掛鉤。當新的執行個體新增至 Amazon EC2 Auto Scaling 群組時，現在應繼續自動部署。

如果 InService 狀態中沒有執行個體，則對錯誤進行故障診斷

1. 在 Amazon EC2主控台中，驗證所需容量設定。如果為零，請將其設定為正數。等待執行個體成為 InService，這表示部署成功。您已修正問題，可以略過本疑難排解程序的其餘步驟。如需設定所需容量設定的資訊，請參閱 Amazon Auto Scaling 使用者指南 中的在 Auto Scaling 群組上設定容量限制。 EC2 Auto Scaling

2. 如果 Auto Scaling 持續嘗試啟動新的EC2執行個體以滿足所需的容量，但無法完成橫向擴展，通常是由於 Auto Scaling 生命週期掛鉤失敗所致。對此問題進行故障診斷，如下所示：

   1. 若要檢查哪些 Auto Scaling 生命週期掛鉤事件失敗，請參閱 Amazon EC2 Auto Scaling 使用者指南中的驗證 Auto Scaling 群組的擴展活動。 Auto Scaling

   2. 如果失敗的掛鉤名稱為 CodeDeploy-managed-automatic-launch-deployment-hook-DEPLOYMENT_GROUP_NAME，請前往 CodeDeploy，尋找部署群組，並尋找 Auto Scaling 啟動的失敗部署。然後調查部署失敗的原因。

   3. 如果您了解部署失敗的原因 （例如 CloudWatch ，警示發生），而且可以在不變更修訂的情況下修正問題，請立即執行此操作。

   4. 如果在調查後，您判斷 CodeDeploy的上次成功修訂不再運作良好，且 Auto Scaling 群組中沒有運作良好的執行個體，則表示您處於部署死區案例。若要解決此問題，您必須暫時從 Auto Scaling 群組移除 CodeDeploy的生命週期掛鉤，然後重新安裝掛鉤並重新部署新的 （良好） CodeDeploy 修訂，以修正錯誤修訂。如需說明，請參閱：

      • To fix the deployment deadlock issue (CLI)

      • To fix the deployment deadlock issue (console)

修正部署死鎖問題 （CLI）

1. （選用） 封鎖造成 CodeDeploy 錯誤的 CI/CD 管道，以免在您修正此問題時發生非預期的部署。

2. 記下您目前的 Auto Scaling DesiredCapacity設定：

   aws autoscaling describe-auto-scaling-groups --auto-scaling-group-name ASG_NAME

   您可能需要在此程序結束時縮減至此數字。

3. 將 Auto Scaling DesiredCapacity設定設為 1。如果所需的容量大於 開頭1，這是選用的。透過將執行個體縮減為 1，執行個體在稍後佈建和部署的時間會縮短，進而加快疑難排解速度。如果您的 Auto Scaling 所需容量最初設定為 0，您必須將其增加至 1。這是必要項目。

   aws 自動擴展 set-desired-capacity --auto-scaling-group-name ASG_NAME --所需容量 1

   注意

   此程序的其餘步驟假設您已DesiredCapacity將 設定為 1。

   此時，Auto Scaling 會嘗試擴展至一個執行個體。然後，由於 CodeDeploy 新增的掛鉤仍然存在，因此 CodeDeploy 會嘗試部署；部署失敗；Auto Scaling 會取消執行個體；而 Auto Scaling 會嘗試重新啟動執行個體，以達到所需容量的 ，再次失敗。您處於取消重新啟動迴圈。

4. 從部署群組取消註冊 Auto Scaling 群組：

   警告

   下列命令將啟動沒有軟體的新EC2執行個體。在執行 命令之前，請確定不接受執行任何軟體的 Auto Scaling InService執行個體。例如，請確定與執行個體相關聯的負載平衡器不會在沒有軟體的情況下將流量傳送至此主機。

   重要

   使用如下所示的 CodeDeploy 命令來移除掛鉤。請勿透過 Auto Scaling 服務移除掛鉤，因為 無法辨識移除 CodeDeploy。

   aws deploy update-deployment-group --application-name APPLICATION_NAME --current-deployment-group-name DEPLOYMENT_GROUP_NAME --auto-scaling-groups

   執行此命令後，會發生以下情況：

   1. CodeDeploy 從部署群組取消註冊 Auto Scaling 群組。

   2. CodeDeploy 從 Auto Scaling 群組中移除 Auto Scaling 生命週期掛鉤。

   3. 由於造成失敗部署的掛鉤不再存在，Auto Scaling 會取消現有的EC2執行個體，並立即啟動新的執行個體，以擴展至所需的容量。新執行個體應該很快就會進入 InService 狀態。新執行個體不包含軟體。

5. 等待EC2執行個體進入 InService 狀態。若要驗證其狀態，請使用下列命令：

   aws autoscaling describe-auto-scaling-groups --auto-scaling-group-names ASG_NAME --query AutoScalingGroups[0].Instances[*].LifecycleState

6. 將掛鉤新增至EC2執行個體：

   重要

   使用如下所示的 CodeDeploy 命令來新增掛鉤。請勿使用 Auto Scaling 服務新增掛鉤，因為 無法辨識新增 CodeDeploy。

   aws deploy update-deployment-group --application-name APPLICATION_NAME --current-deployment-group-name DEPLOYMENT_GROUP_NAME --auto-scaling-groups ASG_NAME

   執行此命令後，會發生以下情況：

   1. CodeDeploy 重新安裝 Auto Scaling 生命週期掛鉤至EC2執行個體

   2. CodeDeploy 會使用部署群組重新註冊 Auto Scaling 群組。

7. 使用 Amazon S3 或您知道運作狀態良好且想要使用的 GitHub 修訂版建立機群範圍部署。

   例如，如果修訂版是 Amazon S3 儲存貯體中的 .zip 檔案，my-revision-bucket名為 物件索引鍵 httpd_app.zip，請輸入下列命令：

   aws deploy create-deployment --application-name APPLICATION_NAME --deployment-group-name DEPLOYMENT_GROUP_NAME --revision "revisionType=S3,s3Location={bucket=my-revision-bucket,bundleType=zip,key=httpd_app.zip}"

   由於 Auto Scaling 群組中現在有一個InService執行個體，因此此部署應該可以運作，而且您不應再看到錯誤部署失敗，因為找不到部署群組 的執行個體。

8. 在部署成功後，如果您先前已將 Auto Scaling 群組擴展到下列位置，請將該群組擴展回原始容量：

   aws autoscaling set-desired-capacity --auto-scaling-group-name ASG_NAME --desired-capacity ORIGINAL_CAPACITY

修正部署鎖死問題 （主控台）

1. （選用） 封鎖造成 CodeDeploy 錯誤的 CI/CD 管道，以免在您修正此問題時發生非預期的部署。

2. 前往 Amazon EC2主控台，並記下您的 Auto Scaling 所需容量設定。您可能需要在此程序結束時縮減至此數字。如需尋找此設定的資訊，請參閱在 Auto Scaling 群組 上設定容量限制。

3. 將所需的EC2執行個體數目設定為 1：

   如果所需的容量大於 以開頭1，這是選用的。透過將其縮減為 1，執行個體稍後佈建和部署的時間將減少，這可加快故障診斷速度。如果您的 Auto Scaling 所需容量最初設定為 0，您必須將其增加至 1。這是必要項目。

   注意

   此程序的其餘步驟假設您已將所需容量設定為 1。

   1. 在 開啟 Amazon EC2主控台https://console.aws.amazon.com/ec2/，然後從導覽窗格中選擇 Auto Scaling 群組。

   2. 選擇適當的區域。

   3. 前往有問題的 Auto Scaling 群組。

   4. 在群組詳細資訊 中，選擇編輯 。

   5. 將所需的容量設定為 1。

   6. 選擇更新。

4. 從部署群組取消註冊 Auto Scaling 群組：

   警告

   下列子步驟將啟動沒有軟體的新EC2執行個體。在執行 命令之前，請確定不接受執行任何軟體的 Auto Scaling InService執行個體。例如，請確定與執行個體相關聯的負載平衡器不會在沒有軟體的情況下將流量傳送至此主機。

   1. 在 開啟 CodeDeploy 主控台https://console.aws.amazon.com/codedeploy/。

   2. 選擇適當的區域。

   3. 在導覽窗格中，選擇 Applications (應用程式)。

   4. 選擇 CodeDeploy 應用程式的名稱。

   5. 選擇 CodeDeploy 部署群組的名稱。

   6. 選擇編輯。

   7. 在環境組態 中，取消選取 Amazon EC2 Auto Scaling 群組 。

      注意

      如果未定義環境組態，則主控台不允許您儲存組態。若要略過檢查，請暫時新增 的標籤On-premises，EC2否則您知道不會解析到任何主機。若要新增標籤，請選取 Amazon EC2執行個體或內部部署執行個體 ，然後新增 EC2或 的標籤索引鍵On-premises。您可以讓標籤值保持空白。

   8. 選擇 Save changes (儲存變更)。

      完成這些子步驟後，會發生以下情況：

      1. CodeDeploy 從部署群組取消註冊 Auto Scaling 群組。

      2. CodeDeploy 從 Auto Scaling 群組中移除 Auto Scaling 生命週期掛鉤。

      3. 由於造成失敗部署的掛鉤不再存在，Auto Scaling 會取消現有的EC2執行個體，並立即啟動新的執行個體，以擴展至所需的容量。新的執行個體應該很快就會進入 InService 狀態。新執行個體不包含軟體。

5. 等待EC2執行個體進入 InService 狀態。若要驗證其狀態：

   1. 在 開啟 Amazon EC2主控台https://console.aws.amazon.com/ec2/。

   2. 在導覽窗格中，選擇 Auto Scaling Groups (AS 安全群組)。

   3. 選擇 Auto Scaling 群組。

   4. 在內容窗格中，選擇執行個體管理索引標籤。

   5. 在執行個體 下，請確定生命週期欄在執行個體InService旁指示 。

6. 使用您用來移除 Auto Scaling 群組的相同方法，向 CodeDeploy 部署群組重新註冊 Auto Scaling 群組：

   1. 在 開啟 CodeDeploy 主控台https://console.aws.amazon.com/codedeploy/。

   2. 選擇適當的區域。

   3. 在導覽窗格中，選擇 Applications (應用程式)。

   4. 選擇 CodeDeploy 應用程式的名稱。

   5. 選擇 CodeDeploy 部署群組的名稱。

   6. 選擇編輯。

   7. 在環境組態 中，選取 Amazon EC2 Auto Scaling 群組，然後從清單中選擇 Auto Scaling 群組。

   8. 在 Amazon EC2執行個體或內部部署執行個體 下，尋找您新增的標籤，並將其移除。

   9. 取消選取 Amazon EC2執行個體或內部部署執行個體 旁的核取方塊。

   10. 選擇 Save changes (儲存變更)。

   此組態會將生命週期掛鉤重新安裝至 Auto Scaling 群組。

7. 使用 Amazon S3 或您知道運作狀態良好且想要使用的 GitHub 修訂版建立機群範圍部署。

   例如，如果修訂版本是 Amazon S3 儲存貯體中的 .zip 檔案，my-revision-bucket名為 物件索引鍵 httpd_app.zip，請執行下列動作：

   1. 在 CodeDeploy 主控台的部署群組頁面中，選擇建立部署 。

   2. 針對 Revision type (修訂版類型)，選擇 My application is stored in Amazon S3 (我的應用程式存放在 Amazon S3)。

   3. 針對修訂位置 ，選擇 s3://my-revision-bucket/httpd_app.zip。

   4. 針對修訂版檔案類型 ，選擇 .zip。

   5. 選擇 Create deployment (建立部署)。

   由於 Auto Scaling 群組中現在有一個InService執行個體，因此此部署應該可以運作，而且您不應再看到錯誤。部署失敗是因為找不到部署群組 的執行個體。

8. 在部署成功後，如果您先前已將 Auto Scaling 群組擴展到下列位置，請將該群組擴展回原始容量：

   1. 在 開啟 Amazon EC2主控台https://console.aws.amazon.com/ec2/，然後從導覽窗格中選擇 Auto Scaling 群組。

   2. 選擇適當的區域。

   3. 前往 Auto Scaling 群組。

   4. 在群組詳細資訊 中，選擇編輯 。

   5. 將所需的容量設回其原始值。

   6. 選擇更新。