チュートリアル: AWS CloudFormation StackSets デプロイアクションでパイプラインを作成する

管理者アカウントで管理者ロールを作成するには

• 「スタックセットオペレーションの基本アクセス許可の設定」の手順に従います。ロールは AWSCloudFormationStackSetAdministrationRole という名前にする必要があります。

ターゲットアカウントにサービスロールを作成するには

• 管理者アカウントを信頼するターゲットアカウントにサービスロールを作成します。「スタックセットオペレーションの基本アクセス許可の設定」の手順に従います。ロールは AWSCloudFormationStackSetExecutionRole という名前にする必要があります。

S3 ソースバケットを作成するには

1. にサインイン AWS Management Console し、https://console.aws.amazon.com/s3/ で Amazon S3 コンソールを開きます。

2. [バケットを作成] を選択します。

3. [バケット名] にバケットの名前を入力します。

   [リージョン] で、パイプラインを作成するリージョンを選択します。[バケットを作成] を選択します。

4. バケットが作成されると、成功バナーが表示されます。[バケットの詳細に移動] を選択します。

5. [プロパティ] タブで、[バージョニング] を選択します。[バージョニングの有効化] を選択し、[保存] を選択します。

AWS CloudFormation テンプレートファイルを作成するには

1. スタックセットの CloudTrail 設定を生成するために、サンプルテンプレートファイル https://s3.amazonaws.com/cloudformation-stackset-sample-templates-us-east-1/EnableAWSCloudtrail.yml をダウンロードします。

2. template.yml という名前でファイルを保存します。

parameters.txt ファイルを作成するには

1. デプロイのパラメータでファイルを作成します。パラメータは、実行時にスタック内で更新する値です。次のサンプルファイルは、スタックセットのテンプレートパラメータを更新して、ログ記録検証とグローバルイベントを有効にします。

   [
     {
       "ParameterKey": "EnableLogFileValidation",
       "ParameterValue": "true"
     }, 
     {
       "ParameterKey": "IncludeGlobalEvents",
       "ParameterValue": "true"
     }
   ]

2. parameters.txt という名前でファイルを保存します。

accounts.txt ファイルを作成するには

1. 次のサンプルファイルに示されているように、インスタンスを作成するアカウントでファイルを作成します。

   [
       "111111222222","333333444444"
   ]

2. accounts.txt という名前でファイルを保存します。

ソースファイルを作成してアップロードするには

1. ファイルを単一の zip ファイルに結合します。ファイルは zip ファイルで以下のようになっています。

   template.yml
   parameters.txt
   accounts.txt

2. zip ファイルを S3 バケットにアップロードします。このファイルは、CodePipeline でのデプロイアクションのために [パイプラインを作成する] ウィザードによって作成されたソースアーティファクトです。

CloudFormationStackSet アクションを使用してパイプラインを作成するには

1. にサインイン AWS Management Console し、http://console.aws.amazon.com/codesuite/codepipeline/home で CodePipeline コンソールを開きます。

2. [ようこそ] ページ、[開始方法] ページ、または [パイプライン] ページで、[パイプラインの作成] を選択します。

3. [ステップ 1: 作成オプションを選択する] ページの [作成オプション] で、[カスタムパイプラインを構築する] オプションを選択します。[次へ] を選択します。

4. [ステップ 2: パイプラインの設定を選択する] で、[パイプライン名] に「MyStackSetsPipeline」と入力します。

5. このチュートリアルの目的では、[パイプラインタイプ] で、[V1] を選択します。[V2] を選択することもできますが、パイプラインタイプは特性と価格が異なることに注意してください。詳細については、「パイプラインのタイプ」を参照してください。

6. [サービスロール] で、[新しいサービスロール] を選択し、CodePipeline に IAM でのサービスロールの作成を許可します。

7. [アーティファクトストア] では、デフォルト値はそのままにしておきます。

   注記

   これはソースコードのソースバケットではありません。パイプラインのアーティファクトストアです。パイプラインごとに S3 バケットなどの個別のアーティファクトストアが必要です。パイプラインを作成または編集するときは、パイプラインリージョンにアーティファクトバケットと、アクションを実行している AWS リージョンごとに 1 つのアーティファクトバケットが必要です。

   詳細については、入力および出力アーティファクトおよびCodePipeline パイプライン構造リファレンスを参照してください。

   [Next (次へ)] を選択します。

8. [ステップ 3: ソースステージを追加する] ページの [ソースプロバイダー] で、[Amazon S3] を選択します。

9. [バケット] に、このチュートリアル用に作成した S3 ソースバケット (BucketName など) を入力します。[S3 オブジェクトキー] に、zip ファイルのファイルパスとファイル名 (MyFiles.zip など) を入力します。

10. [Next (次へ)] を選択します。

11. [ステップ 4: ビルドステージを追加する] で、[ビルドステージをスキップ] を選択し、もう一度 [スキップ] を選択して警告メッセージを受け入れます。

    [Next (次へ)] を選択します。

12. ステップ 5: テストステージを追加し、テストステージをスキップを選択し、もう一度スキップを選択して警告メッセージを受け入れます。

    [Next (次へ)] を選択します。

13. ステップ 6: デプロイステージを追加する：

    1. [デプロイプロバイダー] で、[AWS CloudFormation スタックセット] を選択します。

    2. [スタックセット名] に、スタックセットの名前を入力します。これは、テンプレートが作成するスタックセットの名前です。

       注記

       スタックセット名を記録します。この名前は、パイプラインに 2 番目の StackSets デプロイアクションを追加するときに使用します。

    3. [テンプレートパス] に、テンプレートファイルをアップロードしたアーティファクト名とファイルパスを入力します。例えば、デフォルトのソースアーティファクト名 SourceArtifact を使用して次のように入力します。

       SourceArtifact::template.yml

    4. [デプロイターゲット] に、アカウントファイルをアップロードしたアーティファクト名とファイルパスを入力します。例えば、デフォルトのソースアーティファクト名 SourceArtifact を使用して次のように入力します。

       SourceArtifact::accounts.txt

    5. デプロイターゲット AWS リージョンで、 などの初期スタックインスタンスをデプロイするためのリージョンを 1 つ入力しますus-east-1。

    6. [デプロイオプション] を拡張します。[パラメータ] に、パラメータファイルをアップロードしたアーティファクト名とファイルパスを入力します。例えば、デフォルトのソースアーティファクト名 SourceArtifact を使用して次のように入力します。

       SourceArtifact::parameters.txt

       パラメータをファイルパスではなく、リテラル入力として入力するには、次のように入力します。

       ParameterKey=EnableLogFileValidation,ParameterValue=true
       ParameterKey=IncludeGlobalEvents,ParameterValue=true

    7. [Capabilities] (機能) で、[CAPABILITY_IAM] と [CAPABILITY_NAMED_IAM] を選択します。

    8. [アクセス許可モデル] で、[SELF_MANAGED] を選択します。

    9. [障害耐性の割合] に「20」と入力します。

    10. [最大同時割合] に「25」と入力します。

    11. [Next (次へ)] を選択します。

    12. ステップ 7: 確認で、パイプラインの作成を選択します。パイプラインが表示されます。

    13. パイプラインの実行を許可します。

リソースを表示するには

1. CodePipeline コンソール (https://console.aws.amazon.com/codepipeline/) を開きます。

2. [パイプライン] で、パイプラインを選択してから、[表示] を選択します。この図は、パイプラインのソースとデプロイのステージを示しています。

3. パイプラインの CloudFormationStackSet AWS CloudFormation アクションで アクションを選択します。スタックセットのテンプレート、リソース、イベントが AWS CloudFormation コンソールに表示されます。

4. 左のナビゲーションメニューから [StackSets] を選択します。リストで、新しいスタックセットを選択します。

5. [スタックインスタンス] タブを選択します。us-east-1 リージョンでは、提供したアカウントごとに 1 つのスタックインスタンスが作成されていることを確認します。各スタックインスタンスのステータスが CURRENT になっていることを確認します。

パイプラインで次のアクションを作成するには

1. CodePipeline コンソール (https://console.aws.amazon.com/codepipeline/) を開きます。

   [パイプライン] で、パイプラインを選択してから、[表示] を選択します。この図は、パイプラインのソースとデプロイのステージを示しています。

2. パイプラインの編集を選択します。パイプラインは [編集] モードで表示されます。

3. [デプロイ] ステージで、[編集] を選択します。

4. [AWS CloudFormation スタックセット] デプロイアクションで、[アクショングループの追加] を選択します。

5. [アクションの編集] ページで、アクションの詳細を追加します。

   1. [アクション名] に、アクションの名前を入力します。

   2. [アクションプロバイダー] で、[AWS CloudFormation スタックインスタンス] を選択します。

   3. [入力アーティファクト] で、[ソースアーティファクト] を選択します。

   4. [スタックセット名] に、スタックセットの名前を入力します。これは、最初のアクションで指定したスタックセットの名前です。

   5. [デプロイターゲット] に、アカウントファイルをアップロードしたアーティファクト名とファイルパスを入力します。例えば、デフォルトのソースアーティファクト名 SourceArtifact を使用して次のように入力します。

      SourceArtifact::accounts.txt

   6. デプロイターゲット AWS リージョンで、eu-central-1次のように us-east-2や などの残りのスタックインスタンスをデプロイするリージョンを入力します。

      us-east2, eu-central-1

   7. [障害耐性の割合] に「20」と入力します。

   8. [最大同時割合] に「25」と入力します。

   9. [保存] を選択します。

   10. 手動で変更を解除します。更新されたパイプラインがデプロイステージに 2 つのアクションと共に表示されます。

リソースを表示するには

1. CodePipeline コンソール (https://console.aws.amazon.com/codepipeline/) を開きます。

2. [パイプライン] で、パイプラインを選択してから、[表示] を選択します。この図は、パイプラインのソースとデプロイのステージを示しています。

3. パイプライン内の AWS CloudFormation アクションのAWS CloudFormation Stack Instancesアクションを選択します。スタックセットのテンプレート、リソース、イベントが AWS CloudFormation コンソールに表示されます。

4. 左のナビゲーションメニューから [StackSets] を選択します。リストで、スタックセットを選択します。

5. [スタックインスタンス] タブを選択します。提供した各アカウントの残りのスタックインスタンスが、すべて想定したリージョンで作成または更新されていることを確認します。各スタックインスタンスのステータスが CURRENT になっていることを確認します。

1. CodePipeline コンソール (https://console.aws.amazon.com/codepipeline/) を開きます。

2. [パイプライン] で、パイプラインを選択してから、[編集] を選択します。[デプロイ] ステージで、[編集] を選択します。

3. パイプラインで、[AWS CloudFormation スタックセット] アクションを選択して編集します。[説明] で、既存の説明をスタックセットの新しい説明に書き直します。

4. パイプラインで、[AWS CloudFormation スタックインスタンス] アクションを選択して編集します。デプロイターゲット AWS リージョンで、アクションの作成時に入力されたus-east-2値を削除します。

5. 変更を保存します。[変更のリリース] を選択して、パイプラインを実行します。

6. AWS CloudFormationでアクションを開きます。[StackSet の情報] タブを選択します。[StackSet の説明] で、新しい説明が表示されていることを確認します。

7. [スタックインスタンス] タブを選択します。[ステータス] で、us-east-2 のスタックインスタンスのステータスが OUTDATED であることを確認します。