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

En este tutorial, configurará una canalización que entregue archivos de configuración de forma continua AWS AppConfig utilizándolos como proveedor de acciones de despliegue en la fase de despliegue.

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: Crear un bucket de S3 para la aplicación para crear un bucket de S3.

Paso 1: Cree sus AWS AppConfig recursos

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

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

• Un entorno AWS AppConfig es un grupo de AppConfig objetivos de despliegue lógico, 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 permite acceder AWS AppConfig a la configuración en su ubicación almacenada.

• (Opcional) Una estrategia de implementación AWS AppConfig define el comportamiento de una implementación de configuración, por ejemplo, qué porcentaje de clientes 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 AWS Management Console.

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

   • Crear una aplicación.

   • Crear un entorno.

   • Cree un perfil AWS CodePipeline de configuración.

   • (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 despliegue con una acción AppConfig de despliegue.

Para crear una canalización con el asistente

1. Inicie sesión en la CodePipeline consola AWS Management Console y ábrala 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 Step 1: Choose pipeline settings (Paso 1: Elegir configuración de canalización), en Pipeline name (Nombre de canalización), escriba MyAppConfigPipeline.

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

5. En Función de servicio, elija Nueva función de servicio CodePipeline para poder crear una función de servicio en IAM.

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

7. En el Step 2: Add source stage (Paso 2: Añadir una etapa de código fuente), en Source provider (Proveedor de código fuente), 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.

8. En Step 3: Add build stage (Paso 3: Añadir etapa de compilación), elija Skip build stage (Omitir etapa de compilación) y, a continuación, acepte el mensaje de advertencia eligiendo Skip (Omitir) una vez más.

   Elija Siguiente.

9. En Step 4: Add deploy stage (Paso 4: Añadir una etapa de implementación):

   1. En Deploy provider (Proveedor de implementación), elija AWS AppConfig.

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

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

   4. En Perfil de configuración, elija el nombre del perfil de configuración en el que creó 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 despliegue que haya creado AppConfig o una que haya elegido entre las estrategias de despliegue predefinidas 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.

10. En Step 5: 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.