Apilar a partir CloudFormation de plantilla | Actualizar - Referencia avanzada de tipos de cambios de AMS

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Apilar a partir CloudFormation de plantilla | Actualizar

Actualice los and/or parámetros de la plantilla de una pila de CFN. Para actualizar únicamente los parámetros de una pila existente, no se requiere una plantilla CFN modificada, sino que se pueden proporcionar parámetros modificados. Los valores de los parámetros existentes se sobrescriben y se añaden los valores de los parámetros nuevos. Para añadir, eliminar o modificar un recurso, o para cambiar los atributos a los que no se hace referencia en un parámetro, utilice una plantilla CFN modificada. Si la actualización da lugar a la sustitución o eliminación de un recurso de la pila, la RFC fallará y será necesaria su aprobación mediante el código de verificación «Aprobar ChangeSet y actualizar la CloudFormation pila» (ct-1404e21baa2ox).

Clasificación completa: Administración | Pila personalizada | Apilación a partir de plantilla | Actualización CloudFormation

Detalles del tipo de cambio

ID de tipo de cambio

ct-361tlo1k7339x

Versión actual

2.0

Duración prevista de la ejecución

360 minutos

Aprobación de AWS

Obligatorio

Aprobación del cliente

No obligatorio

Modo de ejecución

Automatizado

Información adicional

Actualizar la CloudFormation pila de ingesta

CloudFormation stack update interface showing description, ID, and version details.

Para actualizar una pila CloudFormation de ingesta mediante la consola

  1. Vaya a la página Crear RFC: en el panel de navegación izquierdo de la consola AMS, haga clic RFCspara abrir la página de RFCs lista y, a continuación, haga clic en Crear RFC.

  2. Elija un tipo de cambio (CT) popular en la vista predeterminada de búsqueda de tipos de cambios o seleccione un CT en la vista Elegir por categoría.

    • Busque por tipo de cambio: puede hacer clic en un CT popular en el área de creación rápida para abrir inmediatamente la página Ejecutar RFC. Tenga en cuenta que no puede elegir una versión antigua de CT con Quick Create.

      Para ordenar CTs, utilice el área Todos los tipos de cambios en la vista de tarjeta o de tabla. En cualquiera de las vistas, seleccione una CT y, a continuación, haga clic en Crear RFC para abrir la página Ejecutar RFC. Si corresponde, aparece la opción Crear con una versión anterior junto al botón Crear RFC.

    • Elegir por categoría: seleccione una categoría, una subcategoría, un elemento y una operación, y se abrirá el cuadro de detalles del CT con la opción Crear con una versión anterior, si corresponde. Haga clic en Crear RFC para abrir la página Ejecutar RFC.

  3. En la página Ejecutar RFC, abra el área del nombre del CT para ver el cuadro de detalles del CT. Se requiere un asunto (lo rellena automáticamente si elige su CT en la vista Buscar tipos de cambios). Abra el área de configuración adicional para añadir información sobre la RFC.

    En el área de configuración de ejecución, utilice las listas desplegables disponibles o introduzca valores para los parámetros necesarios. Para configurar los parámetros de ejecución opcionales, abra el área de configuración adicional.

  4. Cuando haya terminado, haga clic en Ejecutar. Si no hay errores, aparecerá la página de la RFC creada correctamente con los detalles de la RFC enviada y el resultado inicial de la ejecución.

  5. Abra el área de parámetros de ejecución para ver las configuraciones que envió. Actualice la página para actualizar el estado de ejecución de la RFC. Si lo desea, cancele la RFC o cree una copia de la misma con las opciones de la parte superior de la página.

Para actualizar una pila CloudFormation de ingesta mediante la CLI

  1. Utilice la función de creación en línea (se emite un create-rfc comando con todos los parámetros de ejecución y RFC incluidos) o la de plantilla (se crean dos archivos JSON, uno para los parámetros de RFC y otro para los parámetros de ejecución) y ejecute el create-rfc comando con los dos archivos como entrada. Ambos métodos se describen aquí.

  2. Envíe el aws amscm submit-rfc --rfc-id ID comando RFC: con el ID de RFC devuelto.

    Supervise el comando RFC:. aws amscm get-rfc --rfc-id ID

Para comprobar la versión del tipo de cambio, utilice este comando:

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

Puede utilizar cualquier CreateRfc parámetro con cualquier RFC, forme o no parte del esquema del tipo de cambio. Por ejemplo, para recibir notificaciones cuando cambie el estado de la RFC, añada esta línea --notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}" a la parte de los parámetros de la RFC de la solicitud (no a los parámetros de ejecución). Para ver una lista de todos los CreateRfc parámetros, consulta la referencia de la API de administración de cambios de AMS.

  1. Prepare la CloudFormation plantilla que desee usar para actualizar la pila y cárguela en su bucket de S3. Para obtener información importante, consulte las directrices, prácticas recomendadas y limitaciones de AWS CloudFormation Ingest.

  2. Cree y envíe el RFC a AMS:

    1. Cree y guarde el archivo JSON de los parámetros de ejecución e incluya los parámetros CloudFormation de la plantilla que desee. En este ejemplo se le asigna el nombre UpdateCfnParams .json.

      Ejemplo de UpdateCfnParams archivo.json con actualizaciones de parámetros integradas:

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

      Ejemplo de UpdateCfnParams archivo.json con un punto final de bucket de S3 que contiene una plantilla actualizada: CloudFormation

      { "StackId": "stack-yjjoo9aicjyqw4ro2", "VpcId": "VPC_ID", "CloudFormationTemplateS3Endpoint": "s3_url", "TemplateParameters": [ { "Key": "TopicName", "Value": "TopicNameCLI" }, { "Key": "DisplayName", "Value": "DisplayNameCLI" } ], "TimeoutInMinutes": 1080 }
  3. Cree y guarde el archivo JSON de parámetros de RFC con el siguiente contenido. Este ejemplo lo denomina UpdateCfnRfc archivo.json.

    { "ChangeTypeId": "ct-361tlo1k7339x", "ChangeTypeVersion": "1.0", "Title": "cfn-ingest-template-update" }
  4. Cree el RFC, especificando el UpdateCfnRfc archivo y el UpdateCfnParams archivo:

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

    Recibirá el ID de la nueva RFC en la respuesta y podrá utilizarla para enviar y supervisar la RFC. Hasta que la envíe, la RFC permanece en estado de edición y no se inicia.

  • Este tipo de cambio se encuentra ahora en la versión 2.0. Los cambios incluyen la eliminación del AutoApproveUpdateForResourcesparámetro, que se utilizaba en la versión 1.0 de este CT, y la adición de dos parámetros nuevos: AutoApproveRiskyUpdatesy BypassDriftCheck.

  • Si el bucket de S3 existe en una cuenta de AMS, debe utilizar sus credenciales de AMS para este comando. Por ejemplo, es posible que tengas que añadirlas --profile saml después de obtener tus credenciales de AMS AWS Security Token Service (AWS STS).

  • Todos Parameter los valores de los recursos de la CloudFormation plantilla deben tener un valor, ya sea por defecto o personalizado en la sección de parámetros del CT. Puede anular el valor del parámetro estructurando los recursos de la CloudFormation plantilla para que hagan referencia a una clave de parámetros. Para ver ejemplos que muestran cómo hacerlo, consulta la pila de CloudFormation ingesta: ejemplos de validadores CFN.

    IMPORTANTE: Los parámetros que faltan no se proporcionan de forma explícita en el formulario; por defecto, son los valores establecidos actualmente en la pila o plantilla existente.

  • Para ver una lista de los servicios autoaprovisionados que puede añadir mediante CloudFormation Ingest, consulte CloudFormation Ingest Stack: Supported Resources.

    Para obtener más información CloudFormation, consulte AWS CloudFormation.

La plantilla se valida para garantizar que se pueda crear en una cuenta de AMS. Si pasa la validación, se actualiza para incluir todos los recursos o configuraciones necesarios para que se ajuste a los requisitos de AMS. Esto incluye añadir recursos como CloudWatch las alarmas de Amazon para permitir que AMS Operations supervise la pila.

La RFC se rechaza si se cumple alguna de las siguientes condiciones:

  • La sintaxis JSON del RFC es incorrecta o no sigue el formato indicado.

  • La URL prefirmada del bucket de S3 proporcionada no es válida.

  • La plantilla no tiene una CloudFormation sintaxis válida.

  • La plantilla no tiene valores predeterminados establecidos para todos los valores de los parámetros.

  • La plantilla no pasa la validación de AMS. Para ver los pasos de validación de AMS, consulte la información que aparece más adelante en este tema.

La RFC falla si la CloudFormation pila no se crea debido a un problema de creación de recursos.

Para obtener más información sobre la validación y el validador de CFN, consulte Validación de plantillas e CloudFormation ingesta de pilas: ejemplos de validadores de CFN.

Parámetros de entrada de ejecución

Para obtener información detallada sobre los parámetros de entrada de la ejecución, consulteEsquema de cambio: escriba ct-361tlo1k7339x.

Ejemplo: Parámetros necesarios

{ "StackId": "stack-kiwonebfnadq08sol", "VpcId": "vpc-01234567890abcdef", "TimeoutInMinutes": 360 }

Ejemplo: todos los parámetros

Example not available.