CloudFormation Ingestão de AMS

Para verificar a versão do tipo de alteração, use este comando:

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

1. Prepare o CloudFormation modelo que você usará para criar a pilha e faça o upload para seu bucket do S3. Para obter detalhes importantes, consulte as diretrizes CloudFormation de ingestão, as melhores práticas e as limitações da AWS.

2. Crie e envie o RFC para o AMS:

   1. Crie e salve o arquivo JSON dos parâmetros de execução, inclua os parâmetros do CloudFormation modelo que você deseja. O exemplo a seguir o nomeia CreateCfnParams.json.

      Exemplo de CreateCfnParams.json arquivo de pilha de aplicativos Web:

      {
        "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"
         }
        ],
      }

      Exemplo de CreateCfnParams.json arquivo de tópico do SNS:

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

3. Crie e salve o arquivo JSON dos parâmetros RFC com o conteúdo a seguir. O exemplo a seguir nomeia esse CreateCfnRfc.json arquivo:

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

4. Crie o RFC, especificando o CreateCfnRfc arquivo e o CreateCfnParams arquivo:

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

   Você recebe a ID da nova RFC na resposta e pode usá-la para enviar e monitorar a RFC. Até que você o envie, o RFC permanece no estado de edição e não inicia.

Para verificar a versão do tipo de alteração, use este comando:

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

1. Prepare o CloudFormation modelo que você deseja usar para atualizar a pilha e faça o upload para seu bucket do S3. Para obter detalhes importantes, consulte as diretrizes CloudFormation de ingestão, as melhores práticas e as limitações da AWS.

2. Crie e envie o RFC para o AMS:

   1. Crie e salve o arquivo JSON dos parâmetros de execução, inclua os parâmetros do CloudFormation modelo que você deseja. Este exemplo o nomeia UpdateCfnParams.json.

      UpdateCfnParams.json Arquivo de exemplo com atualizações de parâmetros em linha:

      {
        "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
      }

      UpdateCfnParams.json Arquivo de exemplo com o endpoint de bucket do S3 contendo um modelo atualizado CloudFormation :

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

3. Crie e salve o arquivo JSON dos parâmetros RFC com o conteúdo a seguir. Este exemplo o chama de UpdateCfnRfc.json arquivo.

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

4. Crie o RFC, especificando o UpdateCfnRfc arquivo e o UpdateCfnParams arquivo:

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

   Você recebe a ID da nova RFC na resposta e pode usá-la para enviar e monitorar a RFC. Até que você o envie, o RFC permanece no estado de edição e não inicia.

Para verificar a versão do tipo de alteração, use este comando:

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

1. Envie o esquema JSON dos parâmetros de execução para esse tipo de alteração em um arquivo na sua pasta atual. Este exemplo o nomeia 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. Modifique e salve o esquema da seguinte forma:

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

Para verificar a versão do tipo de alteração, use este comando:

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

Especifique somente os parâmetros que você deseja alterar. Os parâmetros ausentes mantêm os valores existentes.

CRIAÇÃO EM LINHA:

Emita o comando create RFC com os parâmetros de execução fornecidos em linha (aspas de escape ao fornecer parâmetros de execução em linha) e, em seguida, envie a ID de RFC retornada. Por exemplo, você pode substituir o conteúdo por algo assim:

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\"]}}"

CRIAÇÃO DO MODELO:

1. Exiba os parâmetros de execução desse tipo de alteração em um arquivo JSON; este exemplo o nomeia EnableTermProCFNParams.json:

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

2. Modifique e salve o EnableTermProCFNParams arquivo, mantendo somente os parâmetros que você deseja alterar. Por exemplo, você pode substituir o conteúdo por algo assim:

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

3. Envie o modelo RFC para um arquivo em sua pasta atual; este exemplo o nomeia EnableTermProCFNRfc.json:

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

4. Modifique e salve o EnableTermProCFNRfc.json arquivo. Por exemplo, você pode substituir o conteúdo por algo assim:

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

5. Crie o RFC, especificando o EnableTermProCFNRfc arquivo e o EnableTermProCFNParams arquivo:

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

   Você recebe a ID da nova RFC na resposta e pode usá-la para enviar e monitorar a RFC. Até que você o envie, o RFC permanece no estado de edição e não inicia.