Tutorial: Crear una canalización con las acciones de implementación de AWS CloudFormation StackSets

Para crear un rol de administrador con su cuenta de administrador

• Siga las instrucciones de Configuración de permisos básicos para operaciones con conjuntos de pilas. Su rol debe llamarse AWSCloudFormationStackSetAdministrationRole.

Para crear el rol de servicio en la cuenta de destino

• Cree un rol de servicio en la cuenta de destino que confíe en la cuenta de administrador. Siga las instrucciones de Configuración de permisos básicos para operaciones con conjuntos de pilas. Su rol debe llamarse AWSCloudFormationStackSetExecutionRole.

Para crear un bucket de origen de S3

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en https://console.aws.amazon.com/s3/.

2. Elija Crear bucket.

3. En Nombre del bucket, escriba un nombre para el bucket.

   En Región la región en la que desea crear la canalización. Elija Crear bucket.

4. Una vez creado el bucket, aparecerá un banner donde se indicará que la operación se ha realizado correctamente. Elija Go to bucket details (Acceder a los detalles del bucket).

5. En la pestaña Properties (Propiedades), elija Versioning (Control de versiones). Elija Enable versioning (Habilitar control de versiones) y haga clic en Save (Guardar).

Para crear el archivo de plantilla de AWS CloudFormation

1. Descargue el siguiente archivo de plantilla de ejemplo para generar la configuración de CloudTrail para conjuntos de pilas: https://s3.amazonaws.com/cloudformation-stackset-sample-templates-us-east-1/EnableAWSCloudtrail.yml.

2. Guarde el archivo como template.yml.

Para crear el archivo parameters.txt

1. Cree un archivo con los parámetros para la implementación. Los parámetros son valores que desea actualizar en su pila en tiempo de ejecución. El siguiente archivo de ejemplo actualiza los parámetros de la plantilla del conjunto de pilas para permitir la validación del registro y los eventos globales.

   [
     {
       "ParameterKey": "EnableLogFileValidation",
       "ParameterValue": "true"
     }, 
     {
       "ParameterKey": "IncludeGlobalEvents",
       "ParameterValue": "true"
     }
   ]

2. Guarde el archivo como parameters.txt.

Para crear el archivo accounts.txt

1. Cree un archivo con las cuentas en las que desee crear las instancias, como se muestra en el siguiente archivo de ejemplo.

   [
       "111111222222","333333444444"
   ]

2. Guarde el archivo como accounts.txt.

Para crear y cargar los archivos de origen

1. Combine los archivos .zip en un solo archivo ZIP. Sus archivos deberían aparecer así en el archivo ZIP.

   template.yml
   parameters.txt
   accounts.txt

2. Cargue el archivo ZIP en el bucket de S3. Este archivo es el artefacto de origen creado por el asistente Crear canalización para la acción de implementación en CodePipeline.

Para crear una canalización con una acción de CloudFormationStackSet

1. Inicie sesión en la Consola de administración de AWS y abra la consola de CodePipeline en http://console.aws.amazon.com/codesuite/codepipeline/home.

2. En la página Bienvenido, Introducción o en la página Canalizaciones, elija Crear canalización.

3. En la página Paso 1: elección de la opción de creación, en Opciones de creación, seleccione la opción Crear una canalización personalizada. Elija Siguiente.

4. En Paso 2: elegir la configuración de la canalización, en Nombre de la canalización, escriba MyStackSetsPipeline.

5. En Tipo de canalización, elija V1 para los fines de este tutorial. También puede elegir V2; sin embargo, tenga en cuenta que los tipos de canalización difieren en cuanto a características y precio. Para obtener más información, consulte Tipos de canalización.

6. En Rol de servicio, elija Nuevo rol de servicio para permitir que CodePipeline cree un rol de servicio en IAM.

7. En Almacén de artefactos, deje los valores predeterminados.

   nota

   Este no es el bucket de origen para su código fuente. Este es el almacén de artefactos de la canalización. Cada canalización debe tener su propio almacén de artefactos independiente, como un bucket de S3. Al crear o editar una canalización, debe tener un bucket de artefactos en la región de la canalización y un bucket de artefactos en cada región de AWS en la que ejecute una acción.

   Para obtener más información, consulte Artefactos de entrada y salida y CodePipeline referencia de estructura de tubería.

   Elija Siguiente.

8. En la página Paso 3: agregar la etapa de origen, en Proveedor de origen, elija Amazon S3.

9. En Bucket, introduzca el bucket de origen de S3 creado para este tutorial, por ejemplo BucketName. En Clave de objeto de S3, escriba la ruta y el nombre del archivo ZIP, como MyFiles.zip.

10. Elija Siguiente.

11. En Paso 4: agregar la etapa de compilación, elija Omitir la etapa de compilación y, a continuación, acepte el mensaje de advertencia eligiendo Omitir una vez más.

    Elija Siguiente.

12. En Paso 5: agregación de la etapa de prueba, elija Omitir la etapa de prueba y, a continuación, acepte el mensaje de advertencia eligiendo Omitir una vez más.

    Elija Siguiente.

13. En Paso 6: agregar la etapa de implementación:

    1. En Proveedor de implementación, elija Conjunto de pilas de AWS CloudFormation).

    2. En Nombre de conjunto de pilas, escriba un nombre para el conjunto de pilas. Este es el nombre del conjunto de pilas que crea la plantilla.

       nota

       Anote el nombre del conjunto de pilas. La usará cuando añada la segunda acción de implementación de StackSets a su canalización.

    3. En Ruta de plantilla, introduzca el nombre del artefacto y la ruta del archivo donde subió el archivo de plantilla. Por ejemplo, introduzca lo siguiente utilizando el el nombre del artefacto de origen por defecto SourceArtifact.

       SourceArtifact::template.yml

    4. En Destinos de implementación, introduzca el nombre del artefacto y la ruta del archivo donde subió el archivo de cuentas. Por ejemplo, introduzca lo siguiente utilizando el el nombre del artefacto de origen por defecto SourceArtifact.

       SourceArtifact::accounts.txt

    5. En Regiones de Regiones de AWS de destino de implementación), introduzca una región para la implementación de su instancia de pila inicial, como us-east-1.

    6. Expanda Opciones de implementación. En Parámetros, introduzca el nombre del artefacto y la ruta del archivo donde cargó el archivo de parámetros. Por ejemplo, introduzca lo siguiente utilizando el el nombre del artefacto de origen por defecto SourceArtifact.

       SourceArtifact::parameters.txt

       Para introducir los parámetros como una entrada literal en lugar de como una ruta de archivo, introduzca lo siguiente:

       ParameterKey=EnableLogFileValidation,ParameterValue=true
       ParameterKey=IncludeGlobalEvents,ParameterValue=true

    7. En Capacidades, elija CAPABILITY_IAM y CAPABILITY_NAMED_IAM.

    8. En Modelo de permiso, elija SELF_MANAGED.

    9. En Porcentaje de tolerancia a errores, introduzca 20.

    10. En Porcentaje máximo simultáneo, introduzca 25.

    11. Elija Siguiente.

    12. En Paso 7: revisión, elija Crear canalización. Aparece su canalización.

    13. Permita que su canalización se ejecute.

Para ver los recursos

1. Abra la consola de CodePipeline en https://console.aws.amazon.com/codepipeline/.

2. En Canalizaciones, elija la canalización y luego Ver. El diagrama muestra las etapas de código fuente e implementación de la canalización.

3. Elija la CloudFormation acción en la acción CloudFormationStackSet de su canalización. La plantilla, los recursos y los eventos del conjunto de pilas se muestran en la consola CloudFormation.

4. En el panel de navegación de la izquierda, seleccione StackSets. En la lista, elija el nuevo conjunto de pilas.

5. Elija la pestaña Instancias de la pila. Verifique que se haya creado una instancia de pila para cada cuenta que haya proporcionado en la región us-east-1. Compruebe que el estado de cada instancia de pila sea CURRENT.

Para crear una acción siguiente en su canalización

1. Abra la consola de CodePipeline en https://console.aws.amazon.com/codepipeline/.

   En Canalizaciones, elija la canalización y luego Ver. El diagrama muestra las etapas de código fuente e implementación de la canalización.

2. Elija esta opción para editar la canalización. La canalización se muestra en modo de edición.

3. En la etapa Implementar, elija Editar.

4. En la acción de implementación de Conjunto de pilas de AWS CloudFormationCloudFormation, seleccione Añadir grupo de acciones.

5. En la página Editar acción, añada los detalles de la acción:

   1. En Nombre de la acción, escriba un nombre para la acción.

   2. En Proveedor de acciones, elija Instancias de pila de AWS CloudFormation).

   3. En Artefactos de entrada, seleccione SourceArtifact.

   4. En Nombre de conjunto de pilas, introduzca el nombre para el conjunto de pilas. Este es el nombre del conjunto de pilas proporcionado en la primera acción.

   5. En Destinos de implementación, introduzca el nombre del artefacto y la ruta del archivo donde subió el archivo de cuentas. Por ejemplo, introduzca lo siguiente utilizando el el nombre del artefacto de origen por defecto SourceArtifact.

      SourceArtifact::accounts.txt

   6. En Regiones de AWS de destino de implementación), introduzca las regiones en las que se van a implementar las instancias de pila restantes, por ejemplo, us-east-2 y eu-central-1 de la siguiente manera:

      us-east2, eu-central-1

   7. En Porcentaje de tolerancia a errores, introduzca 20.

   8. En Porcentaje máximo simultáneo, introduzca 25.

   9. Seleccione Save.

   10. Publica un cambio manualmente. La canalización actualizada se muestra con dos acciones en la etapa de implementación.

Para ver los recursos

1. Abra la consola de CodePipeline en https://console.aws.amazon.com/codepipeline/.

2. En Canalizaciones, elija la canalización y luego Ver. El diagrama muestra las etapas de código fuente e implementación de la canalización.

3. Elija la acción CloudFormation en la acción AWS CloudFormation Stack Instances de su canalización. La plantilla, los recursos y los eventos del conjunto de pilas se muestran en la consola CloudFormation.

4. En el panel de navegación de la izquierda, seleccione StackSets. En la lista, elija el conjunto de pilas.

5. Elija la pestaña Instancias de la pila. Compruebe que todas las instancias de pila restantes de cada cuenta que haya proporcionado se hayan creado o actualizado en las regiones esperadas. Compruebe que el estado de cada instancia de pila sea CURRENT.

1. Abra la consola de CodePipeline en https://console.aws.amazon.com/codepipeline/.

2. En Canalizaciones, elija la canalización y luego Editar. En la etapa Implementar, elija Editar.

3. Elija editar la acción Conjunto de pila de AWS CloudFormation) en su canalización. En Descripción, sobrescriba la descripción existente por una nueva descripción para el conjunto de pilas.

4. Elija editar la acción Instancias de pila de AWS CloudFormation) en su canalización. En Regiones de AWS de destino de implementación), elimine el valor us-east-2 que introducido al crear la acción.

5. Guarde los cambios. Elija Publicar modificación para ejecutar su canalización.

6. Abra su acción en CloudFormation. Seleccione la pestaña Información de StackSet. En Descripción de StackSet, verifique que se muestre la nueva descripción.

7. Elija la pestaña Instancias de la pila. En Estado, verifique que el estado de las instancias de la pila en us-east-2 sea OUTDATED.