Tutorial: Crear una canalización que utilice AWS AppConfig como proveedor de implementación

En este tutorial, va a configurar una canalización que enviará constantemente archivos de configuración utilizando AWS AppConfig como proveedor de acciones de implementación en la etapa de implementación.

importante

Como parte de la creación de una canalización, CodePipeline utilizará un bucket de artefactos de S3 proporcionado por el cliente para los artefactos. (Es diferente del bucket que se usa para una acción de origen de S3). Si el bucket de artefactos de S3 se encuentra en una cuenta diferente a la cuenta de su canalización, asegúrese de que el bucket de artefactos de S3 pertenezca a Cuentas de AWS que sean seguras y fiables.

Requisitos previos

Debe seguir los siguientes pasos antes de comenzar:

• En este ejemplo, se utiliza un origen de S3 para la canalización. Cree o utilice un bucket de Amazon S3 con el control de versiones habilitado. Puede seguir las instrucciones de Paso 1: creación de un bucket de origen de S3 para la aplicación para crear un bucket de S3.

Paso 1: Crear los recursos de AWS AppConfig

En esta sección, se crean los recursos siguientes.

• Una aplicación en AWS AppConfig es una unidad lógica de código que proporciona capacidades a sus clientes.

• Un entorno en AWS AppConfig es un grupo de implementación lógica de destinos de AppConfig, como aplicaciones en un entorno beta o de producción.

• Un perfil de configuración es un conjunto de opciones que influyen en el comportamiento de la aplicación. El perfil de configuración habilita a AWS AppConfig para acceder a la configuración en su ubicación almacenada.

• (Opcional) Una estrategia de implementación en AWS AppConfig define el comportamiento de una implementación de configuración, como el porcentaje de clientes que deben recibir la nueva configuración implementada en un momento dado durante una implementación.

Para crear una aplicación, un entorno, un perfil de configuración y una estrategia de implementación

1. Inicie sesión en Consola de administración de AWS.

2. Siga los pasos de los temas siguientes para crear sus recursos en AWS AppConfig.

   • Crear una aplicación.

   • Crear un entorno.

   • Crear un perfil de configuración de AWS CodePipeline.

   • (Opcional) Elegir una estrategia de implementación predefinida o crear una propia.

Paso 2: Cargar los archivos en un bucket de origen de S3

En esta sección, cree su archivo o archivos de configuración. A continuación, comprima y coloque los archivos fuente en el bucket que la canalización utiliza para la etapa de origen.

Para crear archivos de configuración

1. Cree un archivo configuration.json para cada configuración de cada región. Incluya los siguientes contenidos:

   Hello World!

2. Siga estos pasos para comprimir y cargar los archivos de configuración.

Para comprimir y cargar los archivos fuente

1. Cree un archivo .zip con los archivos y asigne un nombre al archivo .zip configuration-files.zip. Por ejemplo, el archivo.zip puede usar la siguiente estructura:

   .
   └── appconfig-configurations
       └── MyConfigurations
           ├── us-east-1
           │   └── configuration.json
           └── us-west-2
               └── configuration.json

2. En la consola de Amazon S3 para su bucket, elija Cargar y siga las instrucciones para cargar el archivo .zip.

Paso 3: Crear la canalización

En esta sección, debe crear una canalización con las siguientes acciones:

• Una etapa de origen con una acción de Amazon S3 en la que los artefactos de origen son los archivos para su configuración.

• Una etapa de implementación con una acción de implementación de AppConfig.

Para crear una canalización con el asistente

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 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 MyAppConfigPipeline.

5. CodePipeline proporciona canalizaciones de tipo V1 y V2, que difieren en características y precio. El tipo V2 es el único tipo que puede elegir en la consola. Para obtener más información, consulte Tipos de canalización. Para obtener más información acerca de los precios de CodePipeline, consulte Precios.

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

7. En Advanced settings (Configuración avanzada), deje los valores predeterminados y elija Next (Siguiente).

8. En Paso 3: agregar la etapa de origen, en Proveedor de origen, elija Amazon S3. En Bucket, elija el nombre del bucket de origen de S3.

   En Clave de objeto de S3, escriba el nombre del archivo .zip: configuration-files.zip.

   Elija Siguiente.

9. 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.

10. 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.

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

    1. En Proveedor de implementación, elija AWS AppConfig.

    2. En Aplicación, elija el nombre de la nueva aplicación que creó en AWS AppConfig. El campo muestra el ID de la aplicación.

    3. En Entorno, elija el nombre del entorno que creó en AWS AppConfig. El campo muestra el ID de su entorno.

    4. En Perfil de configuración, elija el nombre del perfil de configuración que creó en AWS AppConfig. El campo muestra el ID de su perfil de configuración.

    5. En Estrategia de implementación, elija el nombre de su estrategia de implementación. Puede ser una estrategia de implementación que haya creado en AppConfig o una que haya elegido entre las estrategias de implementación predefinidas en AppConfig. El campo muestra el ID de su estrategia de implementación.

    6. En Ruta de configuración del artefacto de entrada, introduzca la ruta del archivo. Asegúrese de que la ruta de configuración del artefacto de entrada coincida con la estructura de directorios del archivo.zip del bucket de S3. En este ejemplo, especifique la siguiente ruta de archivo: appconfig-configurations/MyConfigurations/us-west-2/configuration.json.

    7. Elija Siguiente.

12. En Step 7: Review, revise la información y después elija Create pipeline.

Paso 4: Realizar un cambio en cualquier archivo de origen y verificar la implementación

Realice un cambio en los archivos fuente y, a continuación, cárguelos en el bucket. Esto desencadena la ejecución de la canalización. Compruebe que la configuración esté disponible consultando la versión.