インスタンスの問題のトラブルシューティング

タグは正しく設定する必要がある

list-deployment-instances コマンドを使用して、デプロイに使用されるインスタンスに正しくタグ付けされていることを確認します。出力に EC2 インスタンスがない場合は、EC2 コンソールを使用して、インスタンスにタグが設定されていることを確認します。詳細については、「Amazon EC2 ユーザーガイド」の「コンソールでのタグの使用」を参照してください。 Amazon EC2

注記

インスタンスにタグを付け、 CodeDeploy を使用してアプリケーションをすぐにデプロイする場合、インスタンスがデプロイに含まれない可能性があります。これは、 がタグ CodeDeploy を読み取るまでに数分かかる場合があるためです。インスタンスにタグを付けてから、そのインスタンスへのデプロイを試みるまでに、少なくとも 5 分待つことをお勧めします。

AWS CodeDeploy エージェントはインスタンスにインストールして実行する必要があります

CodeDeploy エージェントがインスタンスにインストールされ、実行されていることを確認するには、「」を参照してください CodeDeploy エージェントが実行中であることを確認する。

CodeDeploy エージェントをインストール、アンインストール、または再インストールするには、「」を参照してください CodeDeploy エージェントをインストールする。

デプロイ中にインスタンスを削除した場合、デプロイは最大 1 時間は失敗しません。

CodeDeploy では、各デプロイライフサイクルイベントが完了まで実行されるように 1 時間のウィンドウが用意されています。これにより、実行時間が長いスクリプトにも十分な時間が提供されます。

ライフサイクルイベントの進行中にスクリプトが完了しない場合 (インスタンスが終了した場合や CodeDeploy エージェントがシャットダウンした場合など）、デプロイのステータスが Failed と表示されるまでに最大 1 時間かかることがあります。スクリプトに指定されたタイムアウト時間が 1 時間未満である場合も同様です。これは、インスタンスが終了すると、 CodeDeploy エージェントがシャットダウンし、それ以上スクリプトを処理できないためです。

インスタンスがライフサイクル間、または最初のライフサイクルイベントのステップが開始する前に削除された場合、タイムアウトはわずか 5 分後に発生します。

ログファイルの分析によるインスタンスでのデプロイの失敗の調査

デプロイのインスタンスのステータスが Succeeded 以外のいずれかである場合は、デプロイのログファイルデータを確認すると、問題の特定に役立ちます。デプロイのログデータへのアクセス方法については、「 CodeDeploy EC2/オンプレミスデプロイのログデータを表示する」を参照してください。

誤って削除された場合は、新しい CodeDeploy ログファイルを作成する

インスタンスのデプロイログファイルを誤って削除した場合、 CodeDeploy は代替ログファイルを作成しません。新しいログファイルを作成するには、インスタンスにサインインし、以下のコマンドを実行します。

Amazon Linux、Ubuntu Server、または RHEL インスタンスの場合、以下のコマンドをこの順序で 1 つずつ実行します。

systemctl stop codedeploy-agent

systemctl start codedeploy-agent

Windows Server インスタンスの場合

powershell.exe -Command Restart-Service -Name codedeployagent

InvalidSignatureException 「– 署名の有効期限が切れました: [time] が [time]」デプロイエラーのトラブルシューティング

CodeDeploy では、オペレーションを実行するために正確な時間参照が必要です。インスタンスの日時が正しく設定されていない場合、デプロイリクエストの署名日と一致しない可能性があります CodeDeploy 。

誤った時間設定に関連するデプロイの失敗を回避する方法については、次のトピックを参照してください。

• Linux インスタンスの時刻の設定

• Windows インスタンスの時刻を設定する