Refactorización de pilas

1. Evaluación de su infraestructura actual: revise sus pilas y recursos de CloudFormation existentes para identificar las oportunidades de refactorización de pilas.

2. Planificación de su refactorización: defina cómo deben organizarse los recursos. Tenga en cuenta las dependencias, las convenciones de nomenclatura y los límites operativos. Esto puede afectar a la validación de CloudFormation más adelante.

3. Determinación de las pilas de destino: decida en qué pilas refactorizará los recursos. Puede mover los recursos entre al menos 2 pilas (mediante la consola) y un máximo de 5 pilas (mediante la AWS CLI). Los recursos se pueden mover entre pilas anidadas.

4. Actualice las plantillas: modifique las plantillas de CloudFormation para que reflejen el cambio planificado, como mover las definiciones de recursos entre plantillas. Puede cambiar el nombre de los ID lógicos durante este proceso.

5. Cree la refactorización de la pila: proporcione una lista de los nombres y plantillas de la pila que desee refactorizar.

6. Revise el impacto de la refactorización y resuelva cualquier conflicto: CloudFormation valida las plantillas que proporciona y comprueba las dependencias entre pilas, los tipos de recursos con problemas de actualización de etiquetas y los conflictos de ID lógicos de los recursos.

   Si la validación se realiza correctamente, CloudFormation generará una vista previa de las acciones de refactorización que se llevarán a cabo durante la ejecución.

   Si la validación falla, resuelva los problemas identificados y vuelva a intentarlo. Si hay conflictos, proporcione una asignación de ID lógica del recurso que muestre el origen y el destino del recurso en conflicto.

7. Ejecute la refactorización: después de confirmar que los cambios se alinean con los objetivos de refactorización, complete la refactorización de la pila.

8. Supervise: realice un seguimiento del estado de ejecución para garantizar que la operación se complete correctamente.

Refactorización de las pilas

1. Inicie sesión en la Consola de administración de AWS y abra la consola de 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 donde se encuentran las pilas.

3. En el panel de navegación de la izquierda, seleccione Refactorizaciones de la pila.

4. En la página de refactorizaciones de la pila, seleccione Iniciar la refactorización de la pila.

5. En Descripción, proporcione una descripción que lo ayude a identificar la refactorización de la pila. A continuación, elija Siguiente.

6. Para la pila 1, haga lo siguiente:

   1. Elija Actualizar la plantilla para una pila existente o Crear una pila nueva.

      Si seleccionó Actualizar la plantilla para una pila existente, seleccione una pila existente de la lista. O elija Introducir un ARN de pila para introducir el ARN de una pila existente.

      Si seleccionó Crear nueva pila, en Nombre de pila, proporcione un nombre para la nueva pila.

   2. En Reemplazar una plantilla existente por una plantilla refactorizada, seleccione URL de Amazon S3 o Cargar un archivo de plantilla para cargar la plantilla deseada para la pila 1.

   3. Elija Siguiente.

7. Para la pila 2, haga lo siguiente:

   1. Elija Actualizar la plantilla para una pila existente o Crear una pila nueva.

      Si seleccionó Actualizar la plantilla para una pila existente, seleccione una pila existente de la lista. O elija Introducir un ARN de pila para introducir el ARN de una pila existente.

      Si seleccionó Crear nueva pila, en Nombre de pila, proporcione un nombre para la nueva pila.

   2. En Reemplazar la plantilla existente por una plantilla refactorizada, seleccione URL de Amazon S3 o Cargar archivo de plantilla para cargar la plantilla deseada para la pila 2.

   3. Elija Siguiente.

8. En la página Especificar los cambios de nombre de los ID de los recursos lógicos, asegúrese de que CloudFormation sepa cómo refactorizar las pilas asignando los recursos que se muestran a sus ID lógicos correctos. Como parte de la refactorización de la pila, si se ha cambiado el ID lógico de algún recurso, debe especificar el nombre de la pila de origen, el ID lógico original, el nombre de la pila de destino y el ID lógico al que se le ha cambiado el nombre. En algunos casos, es posible que la consola de CloudFormation detecte automáticamente la asignación de recursos y, antes de continuar, solo tiene que comprobar que la asignación de recursos rellenada previamente es correcta.

9. Elija Siguiente.

10. En la página Revisar y ejecutar, revise todas las selecciones de los pasos anteriores y confirme que todo está configurado correctamente.

11. Cuando tenga todo listo para refactorizar las pilas, elija Ejecutar la refactorización de la pila.

Refactorización de las pilas

1. Utilice el comando create-stack-refactor y proporcione los nombres de las pilas y las plantillas actualizadas para la refactorización de pilas. Incluya la opción --enable-stack-creation para permitir que CloudFormation cree pilas nuevas si aún no existen.

   aws cloudformation create-stack-refactor \
     --stack-definitions \
       StackName=Stack1,TemplateBody@=file://template1-updated.yaml \
       StackName=Stack2,TemplateBody@=file://template2-updated.yaml \
     --enable-stack-creation

   El comando devuelve un StackRefactorId que utilizará en pasos posteriores.

   {
       "StackRefactorId": "9c384f70-4e07-4ed7-a65d-fee5eb430841"
   }

   Si se detectan conflictos durante la validación de la plantilla (lo cual puede confirmar en el siguiente paso), utilice el comando create-stack-refactor con la opción --resource-mappings.

   aws cloudformation create-stack-refactor \
     --stack-definitions \
       StackName=Stack1,TemplateBody@=file://template1-updated.yaml \
       StackName=Stack2,TemplateBody@=file://template2-updated.yaml \
     --enable-stack-creation \ 
     --resource-mappings file://resource-mapping.json

   A continuación se muestra un ejemplo de un archivo resource-mapping.json.

   [
       {
           "Source": {
               "StackName": "Stack1",
               "LogicalResourceId": "MySNSTopic"
           },
           "Destination": {
               "StackName": "Stack2",
               "LogicalResourceId": "MyLambdaSNSTopic"
           }
       }
   ]

2. Utilice el comando describe-stack-refactor para asegurarse de que Status sea CREATE_COMPLETE. Esto verifica que la validación esté completa.

   aws cloudformation describe-stack-refactor \
     --stack-refactor-id 9c384f70-4e07-4ed7-a65d-fee5eb430841

   Ejemplo de código de salida:

   {
       "StackRefactorId": "9c384f70-4e07-4ed7-a65d-fee5eb430841",
       "StackIds": [
           "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack1/3e6a1ff0-94b1-11f0-aa6f-0a88d2e03acf",
           "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack2/5da91650-94b1-11f0-81cf-0a23500e151b"
       ],
       "ExecutionStatus": "AVAILABLE",
       "Status": "CREATE_COMPLETE"
   }

3. Utilice el comando list-stack-refactor-actions para obtener una vista previa de las acciones específicas que se van a realizar.

   aws cloudformation list-stack-refactor-actions \
     --stack-refactor-id 9c384f70-4e07-4ed7-a65d-fee5eb430841

   Ejemplo de código de salida:

   {
       "StackRefactorActions": [
           {
               "Action": "MOVE",
               "Entity": "RESOURCE",
               "PhysicalResourceId": "MyTestLambdaRole",
               "Description": "No configuration changes detected.",
               "Detection": "AUTO",
               "TagResources": [],
               "UntagResources": [],
               "ResourceMapping": {
                   "Source": {
                       "StackName": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack1/3e6a1ff0-94b1-11f0-aa6f-0a88d2e03acf",
                       "LogicalResourceId": "MyLambdaRole"
                   },
                   "Destination": {
                       "StackName": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack2/5da91650-94b1-11f0-81cf-0a23500e151b",
                       "LogicalResourceId": "MyLambdaRole"
                   }
               }
           },
           {
               "Action": "MOVE",
               "Entity": "RESOURCE",
               "PhysicalResourceId": "MyTestFunction",
               "Description": "Resource configuration changes will be validated during refactor execution.",
               "Detection": "AUTO",
               "TagResources": [
                   {
                       "Key": "aws:cloudformation:stack-name",
                       "Value": "Stack2"
                   },
                   {
                       "Key": "aws:cloudformation:logical-id",
                       "Value": "MyFunction"
                   },
                   {
                       "Key": "aws:cloudformation:stack-id",
                       "Value": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack2/5da91650-94b1-11f0-81cf-0a23500e151b"
                   }
               ],
               "UntagResources": [
                   "aws:cloudformation:stack-name",
                   "aws:cloudformation:logical-id",
                   "aws:cloudformation:stack-id"
               ],
               "ResourceMapping": {
                   "Source": {
                       "StackName": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack1/3e6a1ff0-94b1-11f0-aa6f-0a88d2e03acf",
                       "LogicalResourceId": "MyFunction"
                   },
                   "Destination": {
                       "StackName": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack2/5da91650-94b1-11f0-81cf-0a23500e151b",
                       "LogicalResourceId": "MyFunction"
                   }
               }
           }
       ]
   }

4. Tras revisar y confirmar los cambios, utilice el comando execute-stack-refactor para completar la operación de refactorización de pilas.

   aws cloudformation execute-stack-refactor \
     --stack-refactor-id 9c384f70-4e07-4ed7-a65d-fee5eb430841

5. Utilice el comando describe-stack-refactor para supervisar el estado de la ejecución.

   aws cloudformation describe-stack-refactor \
     --stack-refactor-id 9c384f70-4e07-4ed7-a65d-fee5eb430841

   Ejemplo de código de salida:

   {
       "StackRefactorId": "9c384f70-4e07-4ed7-a65d-fee5eb430841",
       "StackIds": [
           "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack1/3e6a1ff0-94b1-11f0-aa6f-0a88d2e03acf",
           "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack2/5da91650-94b1-11f0-81cf-0a23500e151b"
       ],
       "ExecutionStatus": "SUCCEEDED",
       "Status": "COMPLETE"
   }