Actualización de StackSets de AWS CloudFormation - AWS CloudFormation

Actualización de StackSets de AWS CloudFormation

Puede actualizar el StackSet mediante la consola de CloudFormation o la AWS CLI.

Para agregar y eliminar cuentas y regiones de un StackSet, consulte Adición de pilas a StackSets y Eliminar pilas de los StackSets. Para anular los valores de los parámetros para una pila, consulte Anulación de parámetros en pilas.

Actualización del StackSet (consola)

Actualización de un StackSet
  1. Inicie sesión en la AWS Management Console y abra la consola de AWS CloudFormation en https://console.aws.amazon.com/cloudformation.

  2. En la barra de navegación de la parte superior de la pantalla, elija la Región de AWS en la que creó el StackSet.

  3. En el panel de navegación, seleccione StackSets (Conjuntos de pilas).

  4. En la página StackSet, seleccione el StackSet que desea actualizar.

  5. Con el StackSet seleccionado, elija Editar detalles de StackSet en el menú Acciones.

  6. En la página Elegir una plantilla, actualice la sección Permisos según sea necesario o pase al siguiente paso.

  7. En Requisito previo: preparar plantilla, elija Usar plantilla actual para usar la plantilla actual o Reemplazar plantilla actual para especificar una URL de S3 a otra plantilla o cargar una nueva plantilla.

  8. Elija Siguiente.

  9. En la página Especificar detalles del StackSet, en Descripción del StackSet, actualice la descripción del StackSet según sea necesario.

  10. En Parámetros, actualice los valores de los parámetros según sea necesario.

  11. Elija Siguiente.

  12. En la página Configurar opciones del conjunto de pilas, en Etiquetas, modifique etiquetas según sea necesario. Puede añadir, actualizar o eliminar etiquetas. Para obtener más información acerca del uso de etiquetas en AWS, consulte Organización y rastreo de costos mediante las etiquetas de asignación de costos de AWS en la Guía del usuario de Administración de facturación y costos de AWS.

  13. Para la configuración de ejecución, puede actualizar la configuración de ejecución según sea necesario.

    nota

    Recuerde que no puede cambiar la configuración de ejecución cuando las operaciones están en ejecución o en cola.

  14. Si la plantilla contiene recursos de IAM, en Capacidades elija Confirmo que esta plantilla pueda crear recursos de IAM para especificar que desea utilizar recursos de IAM en la plantilla. Para obtener más información, consulte Reconocimiento de recursos de IAM en plantillas de CloudFormation.

  15. Elija Siguiente.

  16. En la página Establecer opciones de implementación, proporcione las cuentas y regiones para la actualización.

    CloudFormation implementará actualizaciones de pilas en las cuentas especificadas en la primera región, a continuación pasará a la siguiente, y así sucesivamente, mientras los fallos de implementación de una región no superen la tolerancia de fallos especificada.

    1. [Permisos autoadministrados] En Cuentas, Ubicaciones de implementación, elija Implementar pilas en cuentas. Pegue los ID de las cuentas de destino que ha utilizado para crear el StackSet en el cuadro de texto, separando varios números mediante comas.

      [Permisos administrados por el servicio] Realice una de las siguientes acciones:

      • Elija Implementar en unidades organizativas (OU). Ingrese las UO de destino que haya utilizado para crear el StackSet.

      • Elija Implementar en cuentas. Pegue los ID de las UO o las cuentas de destino que haya utilizado para crear el StackSet.

    2. En Especificar regiones, especifique el orden en el que desea que CloudFormation implemente las actualizaciones.

    3. Para Opciones de implementación, haga lo siguiente:

      • Para Número máximo de cuentas simultáneas, especifique cuántas cuentas se procesan simultáneamente.

      • En Tolerancia a errores, especifique el número máximo de errores de cuenta permitidos por región. La operación se detendrá y no continuará en otras regiones cuando se alcance este límite.

      • Para Concurrencia de regiones, elija cómo procesar las regiones: Secuencial (una región a la vez) o Paralelo (varias regiones simultáneamente).

      • Para el Modo de concurrencia, elija cómo se comporta la concurrencia durante la ejecución de la operación.

        • Tolerancia a errores estricta: reduce el nivel de simultaneidad de la cuenta cuando se producen errores, manteniéndose dentro de Tolerancia a errores +1.

        • Tolerancia flexible a errores: mantiene el nivel de concurrencia especificado (el valor de Número máximo de cuentas simultáneas) independientemente de los errores.

    4. Elija Siguiente para continuar.

  17. En la página Review (Revisar), revise las opciones seleccionadas. Para realizar cambios, elija Editar en la sección correspondiente.

  18. Cuando esté listo para continuar, elija Enviar.

    CloudFormation comienza a aplicar las actualizaciones en el StackSet y muestra la pestaña Operaciones de la página de detalles del StackSet. Puede ver el progreso y el estado de las operaciones de actualización en la pestaña Operations (Operaciones).

Actualización del StackSet (AWS CLI)

nota

Al actuar como administrador delegado, debe incluir --call-as DELEGATED_ADMIN en el comando.

  1. Actualización de un StackSet

    Ejecute el comando de update-stack-set para hacer cambios en el StackSet.

    En los siguientes ejemplos, actualizamos el StackSet mediante la opción --parameters. Específicamente, modificamos la frecuencia de entrega de instantánea predeterminada para la configuración del canal de entrega de TwentyFour_Hours a Twelve_Hours. Dado que seguimos utilizando la plantilla actual, añadimos la opción --use-previous-template.

    Defina el procesamiento simultáneo de cuentas y otras preferencias de implementación con la opción --operation-preferences. Estos ejemplos utilizan una configuración basada en el recuento. Considere que MaxConcurrentCount no debe superar FailureToleranceCount + 1. Para ajustes basados en porcentajes, utilice FailureTolerancePercentage o MaxConcurrentPercentage en su lugar.

    [Permisos autoadministrados] Para la opción --accounts, proporcione los ID de cuenta a los que desea que se dirija la actualización.

    aws cloudformation update-stack-set --stack-set-name my-stackset \ --use-previous-template \ --parameters ParameterKey=MaximumExecutionFrequency,ParameterValue=Twelve_Hours \ --accounts account_ID_1 account_ID_2 \ --regions us-west-2 us-east-1 \ --operation-preferences MaxConcurrentCount=1,FailureToleranceCount=0

    [Permisos administrados por el servicio] Para la opción --deployment-targets, proporcione el ID de raíz de la organización o los ID de unidad organizativa (UO) a los que desea que se dirija la actualización.

    aws cloudformation update-stack-set --stack-set-name my-stackset \ --use-previous-template \ --parameters ParameterKey=MaximumExecutionFrequency,ParameterValue=Twelve_Hours \ --deployment-targets OrganizationalUnitIds=ou-rcuk-1x5j1lwo,ou-rcuk-slr5lh0a \ --regions us-west-2 us-east-1 \ --operation-preferences MaxConcurrentCount=1,FailureToleranceCount=0

    Para obtener más información, consulte UpdateStackSet en la Referencia de la API de AWS CloudFormation.

  2. Compruebe que el StackSet se haya actualizado correctamente al ejecutar el comando describe-stack-set-operation para mostrar el estado y los resultados de la operación de actualización. Para --operation-id, utilice el ID de operación devuelto con el comando update-stack-set.

    aws cloudformation describe-stack-set-operation \ --operation-id operation_ID