Amazon EC2 Auto Scaling の問題のトラブルシューティング

1. 次のいずれかを行います。

   • delete-deployment-group コマンドを呼び出して、ハートビートタイムアウトの原因となっている Auto Scaling グループに関連付けられたデプロイグループを削除します。

   • Auto Scaling グループ名の NULL 以外の空のリストを使用して 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 ライフサイクルフック名。

   • 障害が発生した EC2 Auto Scaling グループに関連付けられたデプロイグループの名前を含む Amazon Auto Scaling ライフサイクルフック名。

   • CodeDeploy デプロイのハートビートタイムアウトの原因となった可能性のある Amazon EC2 Auto Scaling ライフサイクルフック名。

3. フックがステップ 2 に記載されているカテゴリのいずれかに当てはまる場合は、 delete-lifecycle-hook コマンドを呼び出して削除します。呼び出しで Amazon EC2 Auto Scaling グループとライフサイクルフックを指定します。

   重要

   ステップ 2 で説明したように、問題の原因となっているフックのみを削除してください。実行可能なフックを削除すると、デプロイが失敗したり、アプリケーションリビジョンをスケールアウトしたEC2インスタンスにデプロイできない CodeDeploy 可能性があります。

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. get-deployment-group コマンド出力にもないライフサイクルフック名が describe-lifecycle-hooks コマンド出力にある場合は、次の操作を行います。

   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. describe-lifecycle-hooks コマンド出力にもないライフサイクルフック名が get-deployment-group コマンド出力にある場合は、次の操作を行います。

   1. update-deployment-group コマンドを呼び出しますが、元の Amazon EC2 Auto Scaling グループの名前を指定しないでください。

   2. update-deployment-group コマンドを再度呼び出しますが、今回は元の Amazon EC2 Auto Scaling グループの名前を指定します。Amazon EC2 Auto Scaling グループで欠落しているライフサイクルフック CodeDeploy を再作成します。新しいインスタンスが 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 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 --desired-capacity 1

   注記

   この手順の残りのステップでは、 を に設定していることを前提DesiredCapacityとしています1。

   この時点で、Auto Scaling は 1 つのインスタンスへのスケーリングを試みます。次に、 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 ビジョンを使用してフリート全体のデプロイを作成し、正常で使用したいことがわかっています。

   たとえば、リビジョンが、my-revision-bucket という Amazon S3 バケットにある .zip ファイルで、オブジェクトキーが 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 Groups を選択します。

   2. 適切なリージョンを選択します。

   3. 問題がある Auto Scaling グループに移動します。

   4. [グループの詳細] で、[編集] を選択します。

   5. 1 に 希望する容量 を設定。

   6. [Update] (更新) を選択します。

4. デプロイグループから Auto Scaling グループの登録を解除します。

   警告

   以下のサブステップでは、ソフトウェアなしで新しいEC2インスタンスを起動します。コマンドを実行する前に、ソフトウェアを実行していない Auto Scaling InService インスタンスが許容されることを確認します。例えば、インスタンスに関連付けられているロードバランサーがソフトウェアなしでこのホストにトラフィックを送信していないことを確認してください。

   1. で CodeDeploy コンソールを開きますhttps://console.aws.amazon.com/codedeploy/。

   2. 適切なリージョンを選択します。

   3. ナビゲーションペインで、[アプリケーション] を選択します。

   4. CodeDeploy アプリケーションの名前を選択します。

   5. CodeDeploy デプロイグループの名前を選択します。

   6. [編集] を選択します。

   7. 環境設定 で、Amazon EC2 Auto Scaling グループ の選択を解除します。

      注記

      環境設定が定義されていない場合、コンソールでは設定を保存できません。チェックをバイパスするには、どのホストにも解決しないことがわかっている EC2 または On-premises のタグを一時的に追加してください。タグを追加するには、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] をクリックします。

   3. [Auto Scaling グループ] を選択します。

   4. コンテンツペインで、インスタンス管理 タブを選択します。

   5. 「インスタンス」の「ライフサイクル」列にインスタンスのInService横に が表示されていることを確認します。

6. Auto Scaling グループの削除に使用したのと同じ方法を使用して、 CodeDeploy デプロイグループに Auto Scaling グループを再登録します。

   1. で CodeDeploy コンソールを開きますhttps://console.aws.amazon.com/codedeploy/。

   2. 適切なリージョンを選択します。

   3. ナビゲーションペインで、[アプリケーション] を選択します。

   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 ビジョンを使用してフリート全体のデプロイを作成し、正常で使用したいことがわかっています。

   たとえば、リビジョンが、my-revision-bucket という Amazon S3 バケットにある .zip ファイルで、オブジェクトキーが 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 Groups を選択します。

   2. 適切なリージョンを選択します。

   3. Auto Scaling グループに移動します。

   4. [グループの詳細] で、[編集] を選択します。

   5. 希望する容量 元の値に戻す設定をします。

   6. [Update] (更新) を選択します。