CloudFormation Ingestion d'AMS

Pour vérifier la version du type de modification, utilisez cette commande :

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

1. Préparez le CloudFormation modèle que vous utiliserez pour créer la pile et téléchargez-le dans votre compartiment S3. Pour obtenir des informations importantes, consultez les directives, CloudFormation les meilleures pratiques et les limites d'AWS Ingest.

2. Créez et soumettez le RFC à AMS :

   1. Créez et enregistrez le fichier JSON des paramètres d'exécution, incluez les paramètres du CloudFormation modèle que vous souhaitez. L'exemple suivant le nomme CreateCfnParams .json.

      Exemple de fichier CreateCfnParams .json de pile d'applications 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"
         }
        ],
      }

      Exemple de CreateCfnParams fichier .json de rubrique SNS :

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

3. Créez et enregistrez le fichier JSON des paramètres RFC avec le contenu suivant. L'exemple suivant le nomme fichier CreateCfnRfc .json :

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

4. Créez la RFC en spécifiant le CreateCfnRfc fichier et le CreateCfnParams fichier :

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

   Vous recevez l'identifiant de la nouvelle RFC dans la réponse et vous pouvez l'utiliser pour soumettre et surveiller la RFC. Tant que vous ne l'avez pas soumise, la RFC reste en cours d'édition et ne démarre pas.

Pour vérifier la version du type de modification, utilisez cette commande :

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

1. Préparez le AWS CloudFormation modèle que vous souhaitez utiliser pour mettre à jour la pile, puis chargez-le dans votre compartiment S3. Pour obtenir des informations importantes, consultez les directives, CloudFormation les meilleures pratiques et les limites d'AWS Ingest.

2. Créez et soumettez le RFC à AMS :

   1. Créez et enregistrez le fichier JSON des paramètres d'exécution, incluez les paramètres du CloudFormation modèle que vous souhaitez. Cet exemple le nomme UpdateCfnParams .json.

      Exemple de fichier UpdateCfnParams .json avec mises à jour des paramètres en ligne :

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

      Exemple de fichier UpdateCfnParams .json avec point de terminaison du compartiment S3 contenant un CloudFormation modèle mis à jour :

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

3. Créez et enregistrez le fichier JSON des paramètres RFC avec le contenu suivant. Cet exemple le nomme fichier UpdateCfnRfc .json.

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

4. Créez la RFC en spécifiant le UpdateCfnRfc fichier et le UpdateCfnParams fichier :

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

   Vous recevez l'identifiant de la nouvelle RFC dans la réponse et vous pouvez l'utiliser pour soumettre et surveiller la RFC. Tant que vous ne l'avez pas soumise, la RFC reste en cours d'édition et ne démarre pas.

Pour vérifier la version du type de modification, utilisez cette commande :

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

1. Exportez le schéma JSON des paramètres d'exécution pour ce type de modification dans un fichier de votre dossier actuel. Cet exemple le nomme 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. Modifiez et enregistrez le schéma comme suit :

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

Pour vérifier la version du type de modification, utilisez cette commande :

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

Spécifiez uniquement les paramètres que vous souhaitez modifier. Les paramètres absents conservent les valeurs existantes.

CRÉATION EN LIGNE :

Émettez la commande create RFC avec les paramètres d'exécution fournis en ligne (évitez les guillemets lorsque vous fournissez des paramètres d'exécution en ligne), puis soumettez l'ID RFC renvoyé. Par exemple, vous pouvez remplacer le contenu par quelque chose comme ceci :

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

CRÉATION DU MODÈLE :

1. Exportez les paramètres d'exécution de ce type de modification dans un fichier JSON ; cet exemple le nomme EnableTermPro CFNParams .json :

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

2. Modifiez et enregistrez le EnableTermPro CFNParams fichier en ne conservant que les paramètres que vous souhaitez modifier. Par exemple, vous pouvez remplacer le contenu par quelque chose comme ceci :

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

3. Exportez le modèle RFC dans un fichier de votre dossier actuel ; cet exemple le nomme EnableTermPro CFNRfc .json :

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

4. Modifiez et enregistrez le fichier EnableTermPro CFNRfc .json. Par exemple, vous pouvez remplacer le contenu par quelque chose comme ceci :

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

5. Créez la RFC en spécifiant le EnableTermPro CFNRfc fichier et le EnableTermPro CFNParams fichier :

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

   Vous recevez l'identifiant de la nouvelle RFC dans la réponse et vous pouvez l'utiliser pour soumettre et surveiller la RFC. Tant que vous ne l'avez pas soumise, la RFC reste en cours d'édition et ne démarre pas.