Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Tutorial: Crear una canalización que se utilice AWS AppConfig como proveedor de despliegue
<a name="tutorials-AppConfig"></a>

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.

**importante**  
Como parte de la creación de una canalización, se utilizará un depósito de artefactos de S3 proporcionado por el cliente CodePipeline para crear artefactos. (Es diferente del bucket que se usa para una acción de origen de S3). Si el depósito de artefactos de S3 está en una cuenta diferente a la de tu canalización, asegúrate de que el depósito de artefactos de S3 pertenezca a una Cuentas de AWS persona segura y fiable.

**Topics**
+ [

## Requisitos previos
](#tutorials-AppConfig-prereq)
+ [

## Paso 1: Crea tus recursos AWS AppConfig
](#tutorials-AppConfig-application)
+ [

## Paso 2: Cargar los archivos en un bucket de origen de S3
](#tutorials-AppConfig-bucket)
+ [

## Paso 3: Crear la canalización
](#tutorials-AppConfig-pipeline)
+ [

## Paso 4: Realizar un cambio en cualquier archivo de origen y verificar la implementación
](#tutorials-AppConfig-verify)

## Requisitos previos
<a name="tutorials-AppConfig-prereq"></a>

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](tutorials-simple-s3.md#s3-create-s3-bucket) para crear un bucket de S3.

## Paso 1: Crea tus recursos AWS AppConfig
<a name="tutorials-AppConfig-application"></a>

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 Consola de administración de AWS.

1. Siga los pasos de los siguientes temas para crear sus recursos en AWS AppConfig.
   + [Crear una aplicación](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-application.html).
   + [Crear un entorno](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-environment.html).
   + [Cree un perfil AWS CodePipeline de configuración](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-configuration-and-profile.html).
   + (Opcional) [Elegir una estrategia de implementación predefinida o crear una propia.](https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig-creating-deployment-strategy.html)

## Paso 2: Cargar los archivos en un bucket de origen de S3
<a name="tutorials-AppConfig-bucket"></a>

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!
   ```

1. 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
   ```

1. 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
<a name="tutorials-AppConfig-pipeline"></a>

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 Consola de administración de AWS y abra la CodePipeline consola en [http://console.aws.amazon. com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home).

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

1. 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**.

1. En **Paso 2: elegir la configuración de la canalización**, en **Nombre de la canalización**, escriba **MyAppConfigPipeline**.

1. CodePipeline proporciona tuberías 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](https://docs.aws.amazon.com/codepipeline/latest/userguide/pipeline-types-planning.html?icmpid=docs_acp_help_panel). Para obtener información sobre los precios de CodePipeline, consulte [Precios](https://aws.amazon.com/codepipeline/pricing/).

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

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

1. 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**.

1. 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**.

1. 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**.

1. En el **paso 6: Añadir la etapa de despliegue**:

   1. En **Deploy provider**, elija **AWS AppConfig**. 

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

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

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

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

   1. 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`. 

   1. Elija **Siguiente**.

1. En el **paso 7: Revisar**, revise la información y, a continuación, seleccione **Crear canalización**.

## Paso 4: Realizar un cambio en cualquier archivo de origen y verificar la implementación
<a name="tutorials-AppConfig-verify"></a>

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.