サンプルテンプレートを使用して StackSets の使用を開始する
このチュートリアルは、AWS Management Console を使用して StackSets の使用を開始するのに役立ちます。サンプルテンプレートを使用して StackSet を作成する手順を説明します。複数のリージョンにスタックをデプロイし、StackSet オペレーションをモニタリングして、結果を表示する方法について説明します。
このチュートリアルでは、米国西部 (オレゴン) リージョン (us-west-2
) および米国東部 (バージニア北部) リージョン (us-east-1
) 内の AWS アカウント で AWS Config を有効にする StackSet を作成します。StackSets を使用すると、1 回のオペレーションで複数のアカウントとリージョンにまたがるスタックを作成、更新、または削除できるため、大規模なインフラストラクチャを管理するのに最適なソリューションです。このチュートリアルでは、簡素化のために 1 つのアカウントを使用していますが、StackSets のマルチリージョン機能を効果的に示す内容となっています。
サンプルテンプレートは、次の S3 バケットにあります: https://s3.amazonaws.com/cloudformation-stackset-sample-templates-us-east-1/EnableAWSConfig.yml
注記
StackSets は無料ですが、このチュートリアルで作成する AWS Config などの AWS リソースに対して課金されます。詳細については、「AWS Config 料金表
トピック
前提条件
このチュートリアル開始する前に、以下の前提条件を満たしていることを確認してください。
-
セルフマネージド型のアクセス許可に必要な IAM ロールを設定しておく必要があります。StackSet を作成して 1 つのアカウント内にスタックをデプロイするには、アカウントで次のロールが必要です。
-
AWSCloudFormationStackSetAdministrationRole
-
AWSCloudFormationStackSetExecutionRole
これらのロールの設定手順の詳細については、「セルフマネージドのアクセス許可の付与」を参照してください。
-
コンソールからサンプルテンプレートを使用して StackSet を作成する
AWS Config を有効にする StackSet を作成するには
-
クラウドフォーメーション コンソール
を開きます。 -
画面の上部のナビゲーションバーで、StackSet を管理する AWS リージョン を選択します。
StackSets がサポートされているリージョンはいずれも選択できます。選択したリージョンは、StackSet でデプロイできるリージョンには影響しません。
-
ナビゲーションペインから [StackSets] を選択します。
-
[StackSets] ページの上部から [StackSets の作成] を選択します。
-
[アクセス許可] で、[セルフサービスのアクセス許可] を選択し、前提条件で作成した IAM ロールを選択します。
-
IAM 管理者ロールで、AWSCloudFormationStackSetAdministrationRole を選択します。
-
IAM 実行ロール名で、AWSCloudFormationStackSetExecutionRole を選択します。
-
-
[Prerequisite - Prepare template (前提条件 - テンプレートの準備)] で [Use a sample template (サンプルテンプレートの使用)] を選択します。
-
[サンプルテンプレートの選択] で、ドロップダウンメニューから [AWS Config の有効化] テンプレートを選択します。[次へ] を選択します。
このテンプレートは、設定レコーダーや配信チャネルなど、アカウントで AWS Config を有効にするために必要なリソースを作成します。
-
[StackSet の詳細を指定] ページで、[StackSet 名] に
my-awsconfig-stackset
と入力します。 -
[StackSet の説明] には、
A StackSet that enables Config across multiple Regions
と入力します。 -
[パラメータ] で、次のように AWS Config 設定を行います。
-
[すべてのリソースタイプをサポート] で、デフォルト値の true のままにして、サポートされているすべてのリソースタイプを記録します。
-
[グローバルリソースタイプを含める] で、デフォルト値の false のままにして、IAM ロールなどのグローバルリソースを除外します。
-
[すべてがサポートされていない場合のリソースタイプのリスト] を <All> のままにしておきます
-
[Config サービスにリンクされたロールのリソースを含むリージョン] で、<DeployToAnyRegion> を
us-west-2
に置き換えます。つまり、
AWSServiceRoleForConfig
という名前のサービスにリンクされたロールは、スタックが米国西部 (オレゴン) リージョンにデプロイされている場合にのみ作成されます。デプロイリージョンは、この手順の後半で選択します。 -
[設定レコーダーの記録頻度] で、[DAILY] 記録を選択します。
-
-
[次へ] を選択して続行します。
-
[StackSet オプションの設定] ページで、[新しいタグの追加] を選択し、キーと値のペアを指定してタグを追加します。
-
[キー] に「
Stage
」と入力します。 -
[Value (値)] に「
Test
」と入力します。
StackSets に適用するタグは、スタックによって作成されるリソースに適用されます。
-
-
[実行設定] で、[アクティブ] を選択して CloudFormation の最適化されたオペレーション処理を有効にします。
-
競合しないオペレーションは、デプロイ時間を短縮するために同時に実行されます。
-
競合するオペレーションは自動的にキューに入れられ、リクエストされた順序で処理されます。
オペレーションが実行中またはキューに入れられている間、CloudFormation ではオペレーションが競合しない場合でもすべての受信オペレーションがキューに入ります。この間は実行設定を変更できません。
-
-
[次へ] を選択します。
-
[デプロイオプションの設定] ページの [StackSet にスタックを追加] で、[新しいスタックのデプロイ] オプションを選択します。
-
[アカウント] で [Deploy stacks in accounts (スタックをアカウントにデプロイ)] を選択します。
-
テキストボックスに AWS アカウント ID を入力します。
-
[リージョンの指定] では、次のリージョンをこの順序で選択します。
-
米国西部 (オレゴン) リージョン (
us-west-2
) -
米国東部 (バージニア北部) リージョン (
us-east-1
)
必要に応じて、米国西部 (オレゴン) リージョンの横にある上矢印を使用して、リストの最初の項目になるように移動します。リージョンの順序に従って、デプロイの順序が決まります。
-
-
[デプロイオプション] では、次の設定を行います。
-
[Maximum concurrent accounts (同時アカウントの最大数)] については、デフォルト値の [数値] と 1 をそのまま使用します。
つまり、マルチアカウントデプロイの場合、この設定では、CloudFormation は一度に 1 つのアカウントのみでスタックをデプロイします。
-
[Failure tolerance (障害耐性)] については、デフォルトの [数値] と [0] をそのまま使用します。
つまり、CloudFormation が現在のリージョンでデプロイを停止し、残りのリージョンでのデプロイをキャンセルする前に、最大で 0 個のスタックデプロイが、指定されたリージョンのうちいずれかで失敗できるということを意味します。
-
[リージョンの同時実行] では、[順次] (デフォルト) を選択します。
この設定により、CloudFormation は 1 つのリージョンでデプロイを完了してから次のリージョンに移動します。
-
[同時実行モード] では、[厳格な耐障害性] のデフォルト設定を維持します。
マルチアカウントデプロイの場合、これにより障害発生時のアカウントの同時実行レベルが下がり、[障害耐性] +1 の範囲内に維持されます。
-
-
[次へ] を選択します。
-
[確認] ページで選択内容を確認します。変更するには、関連セクションで [編集] をクリックします。
-
StackSet を作成する準備ができたら、[送信] を選択します。
StackSet の作成をモニタリングする
[送信] を選択すると、CloudFormation は StackSet の作成と、アカウント内の指定されたリージョンへのスタックのデプロイを開始します。StackSet の詳細ページが自動的に開き、オペレーションの進行状況をモニタリングできます。
StackSet の作成をモニタリングするには
-
StackSet の詳細ページで、[オペレーション] タブがデフォルトで表示され、進行中の現在のオペレーションが表示されます。
-
オペレーションのステータスは、最初は
RUNNING
である必要があります。CloudFormation は、設定したデプロイオプションに従って、指定したリージョンにスタックを作成します。 -
オペレーションの詳細については、リストでオペレーション ID を選択します。
-
オペレーションの詳細ページで、各リージョンで作成されているスタックインスタンスのステータスを表示できます。
-
オペレーションステータスが
SUCCEEDED
に変わるまで待ちます。これは、StackSet とそのすべてのスタックインスタンスが正常に作成されたことを示します。
StackSet の結果を表示する
StackSet の作成が完了したら、デプロイされたスタックインスタンスを表示し、指定したリージョンのアカウントで AWS Config が有効になっていることを確認できます。
StackSet の結果を表示するには
-
StackSet の詳細ページで、[スタックインスタンス] タブを選択します。
-
指定したリージョンのアカウントで作成されたスタックインスタンスのリストが表示されます。各スタックインスタンスのステータスは
SUCCEEDED
である必要があり、これは正常にデプロイされたことを示します。 -
アカウントで AWS Config が有効になっていることを確認するには、デプロイされた各リージョンで AWS Config コンソールを確認します。
StackSet を更新する
StackSet を作成したら、それを更新してパラメータ値を変更したり、リージョンを追加したりできます。このセクションでは、AWS Config 記録頻度パラメータを更新する方法について説明します。
StackSet を更新するには
-
[StackSets] ページで、
my-awsconfig-stackset
を選択します。 -
StackSet を選択した状態で、[アクション] メニューから [StackSet の詳細を編集] を選択します。
-
[テンプレートの選択] ページの [前提条件 - テンプレートの準備] で、[現在のテンプレートの使用] を選択します。
-
[次へ] を選択します。
-
[StackSet の詳細を指定] ページの [パラメータ] で、[設定レコーダーの記録頻度] を見つけて、[DAILY] から [CONTINUOUS] に変更します。
-
[次へ] を選択します。
-
[StackSet オプションの設定] ページで、設定をそのままにして [次へ] を選択します。
-
[デプロイオプションの設定] ページで、アカウント ID と StackSet の作成時に使用したのと同じリージョンを指定します。
-
[デプロイオプション] では、以前と同じ設定のままにします。
-
[次へ] を選択します。
-
[レビュー] ページで変更内容を確認し、[送信] を選択します。
-
CloudFormation が StackSet の更新を開始します。StackSet の詳細ページの [オペレーション] タブで進行状況をモニタリングできます。
スタックを StackSet に追加する
追加のリージョンにデプロイすることで、StackSet にスタックを追加できます。このセクションでは、新しいリージョンにスタックを追加する方法を示します。
StackSet にスタックを追加するには
-
[StackSets] ページで、
my-awsconfig-stackset
を選択します。 -
StackSet を選択した状態で、[アクション] メニューから [StackSet にスタックを追加] を選択します。
-
[デプロイオプションの設定] ページの [StackSet にスタックを追加] で、[新しいスタックのデプロイ] オプションを選択します。
-
[アカウント] で、[スタックをアカウントにデプロイ] を選択し、アカウント ID を入力します。
-
[リージョンの指定] には、[欧州 (アイルランド)] (
eu-west-1
) などの新しいリージョンを選択します。 -
[デプロイオプション] では、以前と同じ設定のままにします。
-
[次へ] を選択します。
-
[上書きの指定] ページでは、プロパティ値を指定されたままにして、[次へ] を選択します。
-
[確認] ページで選択内容を確認し、[送信] を選択します。
-
CloudFormation は、指定されたリージョンで新しいスタックの作成を開始します。StackSet の詳細ページの [オペレーション] タブで進行状況をモニタリングできます。
クリーンアップ
不要な AWS Config リソースに対して料金が発生しないようにするには、StackSet からスタックを削除し、StackSet 自体を削除し、このチュートリアル用に作成した IAM ロールを削除してクリーンアップする必要があります。すべてのリソースはアカウント内にデプロイされるため、クリーンアップは簡単です。
StackSet からスタックを削除するには
-
[StackSets] ページで、
my-awsconfig-stackset
を選択します。 -
StackSet を選択した状態で、[アクション] メニューから [StackSet からスタックを削除] を選択します。
-
[デプロイオプションの設定] ページの [アカウント] で、[スタックをアカウントにデプロイ] を選択し、アカウント ID を入力します。
-
[リージョンの指定] で、スタックをデプロイしたすべてのリージョンを選択します。
-
[デプロイオプション] では、デフォルト設定のままにします。
-
スタックとそのリソースが削除されるように、[スタックを保持] が有効になっていないことを確認します。
-
[次へ] を選択します。
-
[確認] ページで選択内容を確認し、[送信] を選択します。
-
CloudFormation は StackSet からのスタックの削除を開始します。StackSet の詳細ページの [オペレーション] タブで進行状況をモニタリングできます。
StackSet を削除するには
-
すべてのスタックが削除されたら、[StackSets] ページで
my-awsconfig-stackset
を選択します。 -
StackSet を選択した状態で、[アクション] メニューから [StackSet の削除] を選択します。
-
確認を求められたら、[削除] を選択します。
IAM サービスロールを削除するには
アカウントにのみデプロイしたため、この単一のアカウントから IAM ロールを削除するだけで済み、クリーンアップはマルチアカウントデプロイよりもはるかにシンプルになります。
-
[IAM コンソール]
を開きます。 -
ナビゲーションペインで、[Roles] を選択します。
-
検索ボックスに
AWSCloudFormationStackSet
と入力して、このチュートリアル用に作成したロールを見つけます。 -
[AWSCloudFormationStackSetAdministrationRole] の横にあるチェックボックスをオンにします。
-
ページの上部から、[削除] を選択します。
-
確認ダイアログボックスで、
delete
と入力し、[削除] を選択します。 -
同じプロセスを繰り返して、[AWSCloudFormationStackSetExecutionRole] を削除します。
StackSet を削除すると、AWS::S3::Bucket
リソースの DeletionPolicy
属性により、Amazon S3 バケットが各 AWS リージョン に残ります。これにより、AWS Config 履歴データが保持されます。このデータが不要になった場合は、バケットを手動で削除しても問題ありません。バケットを削除するには、パケットを空にする必要があります。バケットを空にすると、バケット内のすべてのオブジェクトが削除されます。
Amazon S3 バケットを空にして削除するには
-
Amazon S3 コンソール
を開きます。 -
コンソールの左側のナビゲーションペインで、[バケット] を選択します。
-
[バケット] リストには、デプロイした各リージョンでこの StackSet 用に作成されたバケットが表示されます。この StackSet 用に作成されたバケットの名前の横にあるオプションを選択し、[空] を選択します。
-
[バケットを空にする] ページで、テキストフィールドに
permanently delete
と入力して、[空にする] をクリックします。 -
[バケットを空にする: ステータス] ページで、バケットを空にするプロセスの進行状況をモニタリングします。
-
バケットリストに戻るには、[Exit (終了)] を選択します。
-
バケットの名前の横にあるオプションを選択し、[削除] を選択します。
-
確認を求められたら、バケットの名前を入力し、[バケットを削除] を選択します。
-
[バケット] リストで、バケット削除プロセスの進捗状況を確認します。Amazon S3 がバケットの削除を完了すると、バケットはリストから消えます。
-
異なるリージョンで StackSet によって作成された各バケットごとにこのプロセスを繰り返します。
次のステップ
お疲れ様でした。サンプルテンプレートを使用した StackSet の作成、アカウント内の複数のリージョンへのスタックのデプロイ、StackSet の更新、スタックの追加、リソースのクリーンアップが正常に完了しました。シングルアカウントデプロイに焦点を当てることで、StackSets のコアマルチリージョン機能を学習しながら、クリーンアッププロセスを簡素化しました。
StackSets の詳細については、次のトピックをご覧ください。
-
CloudFormation StackSet 内のスタックのパラメータ値を上書きする – 特定のアカウントとリージョンのパラメータ値を上書きする方法を説明します。
-
サービスマネージド型のアクセス許可を持つ AWS CloudFormation StackSets の作成 – AWS Organizations を使用したマルチアカウントデプロイ用の StackSets の作成について説明します。