スタックの進行状況を監視する
このセクションでは、現在進行中のスタックデプロイを監視する方法について説明します。CloudFormation は、デプロイイベントの詳細な時系列リストを提供します。これには、デプロイの進捗状況と、デプロイ中に発生した問題が表示されます。
トピック
スタックイベントを表示する (コンソール)
スタックイベントを表示する
-
https://console.aws.amazon.com/cloudformation
で AWS CloudFormation コンソール を開きます。 -
画面の上部のナビゲーションバーで、スタックを作成した AWS リージョンを選択します。
-
CloudFormation コンソールの [Stacks] (スタック) ページで、スタック名を選択します。CloudFormation は選択したスタックのスタック詳細を表示します。
-
[イベント] タブを選択して、スタックのために 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 |
リソースのステータスは、以下のステータスコードのいずれかになります。
|
DetailedStatus |
スタックの詳細ステータス。 |
ResourceStatusReason |
ステータスの詳細 |
スタックステータスコード
次の表は、スタックステータスコードの説明です。
スタックステータスと、オプションの詳細ステータス | 説明 |
---|---|
|
1 つ以上のスタックを正常に作成。 |
|
1 つ以上のスタックを作成中。 |
|
1 つ以上のスタックの作成に失敗。関連するエラーメッセージを確認するには、スタックのイベントを調べます。作成の失敗の理由としては、スタックのすべてのリソースを操作するためのアクセス許可の不足、AWS サービスによるパラメーター値の拒否、リソース作成中のタイムアウトなどが考えられます。 |
|
1 つ以上のスタックを正常に削除。削除されたスタックは、90 日間は保持され、表示できます。 |
|
1 つ以上のスタックの削除に失敗。削除が失敗したので、まだ実行されているリソースがいくつかある可能性があります。ただし、スタックを操作したり、更新したりすることはできません。スタックを再度削除するか、スタックのイベントを調べて関連するエラーメッセージを確認します。 |
|
1 つ以上のスタックを削除中。 |
|
進行中の、予測される StackId を持つがテンプレートまたはリソースのない 1 つ以上のスタックの作成。重要このステータスコードのスタックは、スタックの可能な限りの最大数に対してカウントされます。 |
|
スタックの作成の失敗後、またはスタックの作成の明示的なキャンセル後に、1 つ以上のスタックを正常に削除。スタックは以前の動作状態に戻ります。スタック作成オペレーションの実行中に作成されたすべてのリソースが削除されます。 このステータスが存在するのは、スタックの作成が失敗した後のみです。部分的に作成されたスタックからすべてのオペレーションが適切にクリーンアップされたことを示します。この状態では、削除オペレーションのみを実行できます。 |
|
スタックの作成の失敗後、またはスタックの作成の明示的なキャンセル後に、1 つ以上のスタックの削除に失敗。スタックを削除するか、スタックのイベントを調べて関連するエラーメッセージを確認します。 |
|
スタックの作成の失敗後、またはスタックの作成の明示的なキャンセル後に、1 つ以上のスタックを削除中。 |
|
1 つ以上のスタックを正常に更新。 |
|
スタックの正常な更新後に、1 つ以上のスタックの古いリソースを削除中。リソースの置き換えが必要なスタック更新の場合、CloudFormation はまず新しいリソースを作成し、次に古いリソースを削除して、スタックの中断を減らすことに役立ちます。この状態では、スタックは更新済みで使用可能ですが、CloudFormation はまだ古いリソースを削除中です。 |
|
1 つ以上のスタックの失敗した更新。関連するエラーメッセージを確認するには、スタックのイベントを調べます。 |
|
1 つ以上のスタックを更新中。 |
|
スタックの更新の失敗後、1 つ以上のスタックを前の動作状態に正常に戻しました。 |
|
スタックの更新の失敗後、1 つ以上のスタックの新しいリソースを削除中。この状態では、スタックが前の動作状態にロールバックされて使用可能ですが、CloudFormation がスタックの更新中に作成した新しいリソースをまだ削除中です。 |
|
スタックの更新の失敗後、1 つ以上のスタックを前の動作ステートに戻すことに失敗。この状態の場合は、スタックを削除するか、ロールバックを続行することができます。スタックが動作状態に戻るには、エラーを修正する必要がある場合があります。または、AWS Support に連絡してスタックを使用可能な状態に復元することができます。 |
|
スタックの更新の失敗後、1 つ以上のスタックを前の動作状態に戻しています。 |
|
インポートオペレーションは現在進行中です。 |
|
|
|
インポートは、以前のテンプレート構成にロールバックされます。 |
|
スタック内の少なくとも 1 つのリソースに対するインポートのロールバックオペレーションが失敗しました。正常にインポートされたリソース CloudFormation の結果が利用可能になります。 |
|
インポートは、以前のテンプレート構成に正常にロールバックされました。 |