AMS CloudFormation の取り込み

変更タイプのバージョンを確認するには、次のコマンドを使用します。

aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID

1. スタックの作成に使用する CloudFormation テンプレートを準備し、S3 バケットにアップロードします。重要な詳細については、AWS CloudFormation 取り込みガイドライン」、「ベストプラクティス」、および「制限」を参照してください。

2. RFC を作成して AMS に送信します。

   1. 実行パラメータ JSON ファイルを作成して保存し、必要な CloudFormation テンプレートパラメータを含めます。次の例では、CreateCfnParams.json.

      ウェブアプリケーションスタック CreateCfnParams.json ファイルの例：

      {
        "Name": "cfn-ingest",
        "Description": "CFNIngest Web Application Stack",
        "VpcId": "VPC_ID",
        "CloudFormationTemplateS3Endpoint": "$S3_URL",
        "TimeoutInMinutes": 120,
        "Tags": [
         {
          "Key":   "Enviroment Type"
          "Value": "Dev",
         },
         {
          "Key":   "Application"
          "Value": "PCS",
         }
        ],
        "Parameters": [
         {
          "Name": "Parameter-for-S3Bucket-Name",
          "Value":  "BUCKET-NAME"
         },
         {
          "Name": "Parameter-for-Image-Id",
          "Value":  "AMI-ID"
         }
        ],
      }

      SNS トピック CreateCfnParams.json ファイルの例：

      {
        "Name": "cfn-ingest",
        "Description": "CFNIngest Web Application Stack",
        "CloudFormationTemplateS3Endpoint": "$S3_URL",
        "Tags": [
          {"Key": "Enviroment Type", "Value": "Dev"}
        ],
        "Parameters": [
          {"Name": "TopicName", "Value": "MyTopic1"}
        ]
      }

3. 次の内容の RFC パラメータ JSON ファイルを作成して保存します。次の例では、CreateCfnRfc.json ファイルという名前を付けます。

   {
      "ChangeTypeId": "ct-36cn2avfrrj9v",
      "ChangeTypeVersion": "2.0",
      "Title": "cfn-ingest"
   }

4. CreateCfnRfc ファイルと CreateCfnParams ファイルを指定して、RFC を作成します。

   aws amscm create-rfc --cli-input-json file://CreateCfnRfc.json  --execution-parameters file://CreateCfnParams.json

   レスポンスで新しい RFC の ID を受け取り、それを使用して RFC を送信およびモニタリングできます。送信するまで、RFC は編集状態のままであり、開始されません。

変更タイプのバージョンを確認するには、次のコマンドを使用します。

aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID

1. スタックの更新に使用する AWS CloudFormation テンプレートを準備し、S3 バケットにアップロードします。重要な詳細については、AWS CloudFormation 取り込みガイドライン」、「ベストプラクティス」、および「制限」を参照してください。

2. RFC を作成して AMS に送信します。

   1. 実行パラメータ JSON ファイルを作成して保存し、必要な CloudFormation テンプレートパラメータを含めます。この例では、UpdateCfnParams.json.

      インラインパラメータ更新を含む UpdateCfnParams.json ファイルの例：

      {
        "StackId": "stack-yjjoo9aicjyqw4ro2",
        "VpcId": "VPC_ID",
        "CloudFormationTemplate": "{\"AWSTemplateFormatVersion\":\"2010-09-09\",\"Description\":\"Create a SNS topic\",\"Parameters\":{\"TopicName\":{\"Type\":\"String\"},\"DisplayName\":{\"Type\":\"String\"}},\"Resources\":{\"SnsTopic\":{\"Type\":\"AWS::SNS::Topic\",\"Properties\":{\"TopicName\":{\"Ref\":\"TopicName\"},\"DisplayName\":{\"Ref\":\"DisplayName\"}}}}}",
        "TemplateParameters": [
          {
            "Key": "TopicName",
            "Value": "TopicNameCLI"
          },
          {
            "Key": "DisplayName",
            "Value": "DisplayNameCLI"
          }
        ],
        "TimeoutInMinutes": 1440
      }

      更新された CloudFormation テンプレートを含む S3 バケットエンドポイントを含む UpdateCfnParams.json ファイルの例：

      {
        "StackId": "stack-yjjoo9aicjyqw4ro2",
        "VpcId": "VPC_ID",
        "CloudFormationTemplateS3Endpoint": "s3_url",
        "TemplateParameters": [
          {
            "Key": "TopicName",
            "Value": "TopicNameCLI"
          },
          {
            "Key": "DisplayName",
            "Value": "DisplayNameCLI"
          }
        ],
        "TimeoutInMinutes": 1080
      }

3. 次の内容の RFC パラメータ JSON ファイルを作成して保存します。この例では、UpdateCfnRfc.json ファイルという名前を付けます。

   {
      "ChangeTypeId": "ct-361tlo1k7339x",
      "ChangeTypeVersion": "1.0",
      "Title": "cfn-ingest-template-update"
   }

4. RFC を作成し、UpdateCfnRfc ファイルと UpdateCfnParams ファイルを指定します。

   aws amscm create-rfc --cli-input-json file://UpdateCfnRfc.json  --execution-parameters file://UpdateCfnParams.json

   レスポンスで新しい RFC の ID を受け取り、それを使用して RFC を送信およびモニタリングできます。送信するまで、RFC は編集状態のままであり、開始されません。

変更タイプのバージョンを確認するには、次のコマンドを使用します。

aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID

1. この変更タイプの実行パラメータ JSON スキーマを現在のフォルダ内のファイルに出力します。この例では、CreateAsgParams.json:

   aws amscm create-rfc --change-type-id "ct-1404e21baa2ox" --change-type-version "1.0" --title "Approve Update" --execution-parameters file://PATH_TO_EXECUTION_PARAMETERS --profile saml

2. スキーマを次のように変更して保存します。

   {
     "StackId": "STACK_ID",
     "VpcId": "VPC_ID",
     "ChangeSetName": "UPDATE-ef81e2bc-03f6-4b17-a3c7-feb700e78faa",
     "TimeoutInMinutes": 1080
   }
   

変更タイプのバージョンを確認するには、次のコマンドを使用します。

aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID

変更するパラメータのみを指定します。パラメータがない場合、既存の値は保持されます。

インライン作成：

インラインで指定された実行パラメータ (インラインで実行パラメータを指定する場合は引用符をエスケープ) を指定して create RFC コマンドを発行し、返された RFC ID を送信します。たとえば、コンテンツを次のような内容に置き換えることができます。

aws amscm create-rfc \
--change-type-id "ct-2uzbqr7x7mekd" \
--change-type-version "1.0" \
--title "Enable termination protection on CFN stack" \
--execution-parameters "{\"DocumentName\":\"AWSManagedServices-ManageResourceTerminationProtection\",\"Region\":\"us-east-1\",\"Parameters\":{\"ResourceId\":[\"stack-psvnq6cupymio3enl\"],\"TerminationProtectionDesiredState\":[\"enabled\"]}}"

テンプレートの作成：

1. この変更タイプの実行パラメータを JSON ファイルに出力します。この例では EnableTermProCFNParams.json:

   aws amscm get-change-type-version --change-type-id "ct-2uzbqr7x7mekd" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > EnableTermProCFNParams.json

2. EnableTermProCFNParams ファイルを変更して保存し、変更するパラメータのみを保持します。たとえば、コンテンツを次のような内容に置き換えることができます。

   {
     "DocumentName": "AWSManagedServices-ManageResourceTerminationProtection",
     "Region": "us-east-1",
     "Parameters": {
       "ResourceId": ["stack-psvnq6cupymio3enl"],
       "TerminationProtectionDesiredState": ["enabled"]
     }
   }

3. RFC テンプレートを現在のフォルダ内のファイルに出力します。この例では EnableTermProCFNRfc.json:

   aws amscm create-rfc --generate-cli-skeleton > EnableTermProCFNRfc.json

4. EnableTermProCFNRfc.json ファイルを変更して保存します。たとえば、コンテンツを次のような内容に置き換えることができます。

   {
       "ChangeTypeId": "ct-2uzbqr7x7mekd",
       "ChangeTypeVersion": "1.0",
       "Title": "Enable termination protection on CFN instance"
   }

5. EnableTermProCFNRfc ファイルと EnableTermProCFNParams ファイルを指定して、RFC を作成します。

   aws amscm create-rfc --cli-input-json file://EnableTermProCFNRfc.json  --execution-parameters file://EnableTermProCFNParams.json

   レスポンスで新しい RFC の ID を受け取り、それを使用して RFC を送信およびモニタリングできます。送信するまで、RFC は編集状態のままであり、開始されません。