スタックの進行状況を監視する - AWS CloudFormation

スタックの進行状況を監視する

このセクションでは、現在進行中のスタックデプロイを監視する方法について説明します。CloudFormation は、デプロイイベントの詳細な時系列リストを提供します。これには、デプロイの進捗状況と、デプロイ中に発生した問題が表示されます。

スタックイベントを表示する (コンソール)

スタックイベントを表示する
  1. https://console.aws.amazon.com/cloudformation で AWS CloudFormation コンソール を開きます。

  2. 画面の上部のナビゲーションバーで、スタックを作成した AWS リージョンを選択します。

  3. CloudFormation コンソールの [Stacks] (スタック) ページで、スタック名を選択します。CloudFormation は選択したスタックのスタック詳細を表示します。

  4. [イベント] タブを選択して、スタックのために CloudFormation が生成したスタックイベントを表示します。

CloudFormation は、スタックイベントを 1 分ごとに自動的に更新します。これに加えて、CloudFormation は新しいスタックイベントの発生時に [新しいイベントを利用できます] バッジを表示します。更新アイコンを選択して、これらのイベントをリストにロードします。スタックの作成イベントを表示することで、スタックの作成 (または失敗、スタックをデバッグしている場合) につながる一連のイベントを理解することができます。

スタックの作成中、スタックは [スタック] ページでステータスが CREATE_IN_PROGRESS と表示されます。スタックが正常に作成されると、ステータスが CREATE_COMPLETE に変わります。

詳細については、CloudFormation スタック作成イベントを理解するおよびスタック更新の進行状況を監視するを参照してください。

スタックイベントを表示する (AWS CLI)

代替手段として、スタックが作成されている間に describe-stack-events コマンドを使用し、報告されるイベントを表示することができます。

以下の describe-stack-events コマンドは、myteststack スタックイベントを記述します。

aws cloudformation describe-stack-events --stack-name myteststack

以下に、応答の例を示します。

{ "StackEvents": [ { "StackId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "EventId": "af67ef60-0b8f-11e3-8b8a-500150b352e0", "ResourceStatus": "CREATE_COMPLETE", "ResourceType": "AWS::CloudFormation::Stack", "Timestamp": "2013-08-23T01:02:30.070Z", "StackName": "myteststack", "PhysicalResourceId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/a69442d0-0b8f-11e3-8b8a-500150b352e0", "LogicalResourceId": "myteststack" }, { "StackId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "EventId": "S3Bucket-CREATE_COMPLETE-1377219748025", "ResourceStatus": "CREATE_COMPLETE", "ResourceType": "AWS::S3::Bucket", "Timestamp": "2013-08-23T01:02:28.025Z", "StackName": "myteststack", "ResourceProperties": "{\"AccessControl\":\"PublicRead\"}", "PhysicalResourceId": "myteststack-s3bucket-jssofi1zie2w", "LogicalResourceId": "S3Bucket" }, { "StackId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "EventId": "S3Bucket-CREATE_IN_PROGRESS-1377219746688", "ResourceStatus": "CREATE_IN_PROGRESS", "ResourceType": "AWS::S3::Bucket", "Timestamp": "2013-08-23T01:02:26.688Z", "ResourceStatusReason": "Resource creation Initiated", "StackName": "myteststack", "ResourceProperties": "{\"AccessControl\":\"PublicRead\"}", "PhysicalResourceId": "myteststack-s3bucket-jssofi1zie2w", "LogicalResourceId": "S3Bucket" }, { "StackId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "EventId": "S3Bucket-CREATE_IN_PROGRESS-1377219743862", "ResourceStatus": "CREATE_IN_PROGRESS", "ResourceType": "AWS::S3::Bucket", "Timestamp": "2013-08-23T01:02:23.862Z", "StackName": "myteststack", "ResourceProperties": "{\"AccessControl\":\"PublicRead\"}", "PhysicalResourceId": null, "LogicalResourceId": "S3Bucket" }, { "StackId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896", "EventId": "a69469e0-0b8f-11e3-8b8a-500150b352e0", "ResourceStatus": "CREATE_IN_PROGRESS", "ResourceType": "AWS::CloudFormation::Stack", "Timestamp": "2013-08-23T01:02:15.422Z", "ResourceStatusReason": "User Initiated", "StackName": "myteststack", "PhysicalResourceId": "arn:aws:cloudformation:aws-region:123456789012:stack/myteststack/a69442d0-0b8f-11e3-8b8a-500150b352e0", "LogicalResourceId": "myteststack" } ] }

最新のイベントが先頭に表示されます。次の表は、describe-stack-events コマンドによって返されるフィールドとその説明です。

フィールド 説明
EventId

イベントの識別子

StackName

イベントに対応するスタックの名前

StackId

イベントに対応するスタックの識別子

LogicalResourceId

リソースの論理識別子

PhysicalResourceId

リソースの物理識別子

ResourceProperties

リソースのプロパティ

ResourceType

リソースのタイプ。

Timestamp

イベントが発生した時刻

ResourceStatus

リソースのステータスは、以下のステータスコードのいずれかになります。CREATE_COMPLETE | CREATE_FAILED | CREATE_IN_PROGRESS | DELETE_COMPLETE | DELETE_FAILED | DELETE_IN_PROGRESS | DELETE_SKIPPED | IMPORT_COMPLETE | IMPORT_IN_PROGRESS | IMPORT_ROLLBACK_COMPLETE | IMPORT_ROLLBACK_FAILED | IMPORT_ROLLBACK_IN_PROGRESS | REVIEW_IN_PROGRESS | ROLLBACK_COMPLETE | ROLLBACK_FAILED | ROLLBACK_IN_PROGRESS | UPDATE_COMPLETE | UPDATE_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_FAILED | UPDATE_IN_PROGRESS | UPDATE_ROLLBACK_COMPLETE | UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS | UPDATE_ROLLBACK_FAILED | UPDATE_ROLLBACK_IN_PROGRESS

DELETE_SKIPPED ステータスは、削除ポリシー属性が保持になっているリソースに適用されます。

DetailedStatus

スタックの詳細ステータス。CONFIGURATION_COMPLETE が存在する場合、スタックリソースの設定フェーズは完了済みで、リソースの安定化が進行中です。

ResourceStatusReason

ステータスの詳細

スタックステータスコード

次の表は、スタックステータスコードの説明です。

スタックステータスと、オプションの詳細ステータス 説明

CREATE_COMPLETE

1 つ以上のスタックを正常に作成。

CREATE_IN_PROGRESS

1 つ以上のスタックを作成中。

CREATE_FAILED

1 つ以上のスタックの作成に失敗。関連するエラーメッセージを確認するには、スタックのイベントを調べます。作成の失敗の理由としては、スタックのすべてのリソースを操作するためのアクセス許可の不足、AWS サービスによるパラメーター値の拒否、リソース作成中のタイムアウトなどが考えられます。

DELETE_COMPLETE

1 つ以上のスタックを正常に削除。削除されたスタックは、90 日間は保持され、表示できます。

DELETE_FAILED

1 つ以上のスタックの削除に失敗。削除が失敗したので、まだ実行されているリソースがいくつかある可能性があります。ただし、スタックを操作したり、更新したりすることはできません。スタックを再度削除するか、スタックのイベントを調べて関連するエラーメッセージを確認します。

DELETE_IN_PROGRESS

1 つ以上のスタックを削除中。

REVIEW_IN_PROGRESS

進行中の、予測される StackId を持つがテンプレートまたはリソースのない 1 つ以上のスタックの作成。
重要

このステータスコードのスタックは、スタックの可能な限りの最大数に対してカウントされます。

ROLLBACK_COMPLETE

スタックの作成の失敗後、またはスタックの作成の明示的なキャンセル後に、1 つ以上のスタックを正常に削除。スタックは以前の動作状態に戻ります。スタック作成オペレーションの実行中に作成されたすべてのリソースが削除されます。

このステータスが存在するのは、スタックの作成が失敗した後のみです。部分的に作成されたスタックからすべてのオペレーションが適切にクリーンアップされたことを示します。この状態では、削除オペレーションのみを実行できます。

ROLLBACK_FAILED

スタックの作成の失敗後、またはスタックの作成の明示的なキャンセル後に、1 つ以上のスタックの削除に失敗。スタックを削除するか、スタックのイベントを調べて関連するエラーメッセージを確認します。

ROLLBACK_IN_PROGRESS

スタックの作成の失敗後、またはスタックの作成の明示的なキャンセル後に、1 つ以上のスタックを削除中。

UPDATE_COMPLETE

1 つ以上のスタックを正常に更新。

UPDATE_COMPLETE_CLEANUP_IN_PROGRESS

スタックの正常な更新後に、1 つ以上のスタックの古いリソースを削除中。リソースの置き換えが必要なスタック更新の場合、CloudFormation はまず新しいリソースを作成し、次に古いリソースを削除して、スタックの中断を減らすことに役立ちます。この状態では、スタックは更新済みで使用可能ですが、CloudFormation はまだ古いリソースを削除中です。

UPDATE_FAILED

1 つ以上のスタックの失敗した更新。関連するエラーメッセージを確認するには、スタックのイベントを調べます。

UPDATE_IN_PROGRESS

1 つ以上のスタックを更新中。

UPDATE_ROLLBACK_COMPLETE

スタックの更新の失敗後、1 つ以上のスタックを前の動作状態に正常に戻しました。

UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS

スタックの更新の失敗後、1 つ以上のスタックの新しいリソースを削除中。この状態では、スタックが前の動作状態にロールバックされて使用可能ですが、CloudFormation がスタックの更新中に作成した新しいリソースをまだ削除中です。

UPDATE_ROLLBACK_FAILED

スタックの更新の失敗後、1 つ以上のスタックを前の動作ステートに戻すことに失敗。この状態の場合は、スタックを削除するか、ロールバックを続行することができます。スタックが動作状態に戻るには、エラーを修正する必要がある場合があります。または、AWS Support に連絡してスタックを使用可能な状態に復元することができます。

UPDATE_ROLLBACK_IN_PROGRESS

スタックの更新の失敗後、1 つ以上のスタックを前の動作状態に戻しています。

IMPORT_IN_PROGRESS

インポートオペレーションは現在進行中です。

IMPORT_COMPLETE

resource import をサポートするスタック内のすべてのリソースについて、インポート操作が正常に完了しました。

IMPORT_ROLLBACK_IN_PROGRESS

インポートは、以前のテンプレート構成にロールバックされます。

IMPORT_ROLLBACK_FAILED

スタック内の少なくとも 1 つのリソースに対するインポートのロールバックオペレーションが失敗しました。正常にインポートされたリソース CloudFormation の結果が利用可能になります。

IMPORT_ROLLBACK_COMPLETE

インポートは、以前のテンプレート構成に正常にロールバックされました。