Creación de una pila a partir del código fuente del repositorio con sincronización de Git - AWS CloudFormation
Creación de una pila a partir del código fuente del repositorioActualización de la pila desde el repositorio de Git

Creación de una pila a partir del código fuente del repositorio con sincronización de Git

En este tema se explica cómo crear una pila de CloudFormation que se sincronice con un repositorio de Git mediante la sincronización de Git.

importante

Antes de continuar, complete todos los requisitos previos de la sección anterior.

Creación de una pila a partir del código fuente del repositorio

  1. Inicie sesión en la AWS Management Console y abra la consola de AWS 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 la que creó la pila.

  3. En la página Pilas, elija Crear pila y, a continuación, elija Con recursos nuevos (estándar).

  4. En la página Crear pila, proceda del modo siguiente:

    1. En Requisito previo: preparar la plantilla, mantenga seleccionada la opción Seleccione una plantilla existente.

    2. En Especificar plantilla, elija Sincronizar desde Git y, a continuación, seleccione Siguiente.

  5. En la página Especificar los detalles de la pila, en Nombre de la pila, ingrese un nombre para la pila. Los nombres de pilas pueden incluir letras (A-Z y a-z), números (0-9) y guiones (-).

  6. En Archivo de implementación de Stack, Creación del archivo de implementación:

    • Si no ha creado un archivo de implementación de pilas y lo ha agregado al repositorio, elija Crear el archivo con los siguientes parámetros y colocarlo en mi repositorio.

    • Si tiene archivo de implementación de pila en su repositorio, seleccione Proporciono mi propio archivo en mi repositorio.

  7. En Repositorio de definiciones de plantillas, seleccione Elegir un repositorio de Git vinculado para seleccionar un repositorio de Git que ya está vinculado a CloudFormation o Vincular un repositorio de Git para vincular uno nuevo. Si elige Vincular un repositorio de Git, haga lo siguiente:

    1. En Seleccionar el proveedor de repositorios, elija una de las siguientes opciones:

      • GitHub

      • GitHub Enterprise Server

      • GitLab

      • Bitbucket

      • GitLab autoadministrado

    2. Para Conexión, elija una conexión de la lista. Si no aparece ninguna opción en la lista Conexión, elija agregar una nueva conexión para ir a la Consola de conexiones y crear una conexión con su repositorio.

  8. En la lista de Repositorios, seleccione el repositorio de Git que contenga el archivo de plantillas de la pila.

  9. En la lista de Ramas, seleccione la rama que quiere que supervise la sincronización de Git sync.

    nota

    La sincronización de Git solo supervisa la rama seleccionada para detectar cambios en la plantilla de CloudFormation y los archivos de implementación de la pila. Cualquier cambio que desee aplicar a su pila debe estar registrado en esta rama.

  10. Para la Ruta del archivo de implementación, especifique la ruta completa, incluido el nombre del archivo de implementación de la pila, desde la raíz de la rama de repositorio.

    Si CloudFormation genera el archivo por usted, aquí es donde se guardará el archivo en su repositorio. Si proporciona el archivo, esta es la ubicación del archivo en su repositorio.

  11. Agregar un rol de IAM. El rol de IAM incluye los permisos necesarios para que CloudFormation sincronice la pila desde su repositorio de Git. Puede elegir Nuevo rol de IAM para generar un nuevo rol o elegir Rol de IAM existente para seleccionar un rol existente de su Cuenta de AWS. Si decide generar un nuevo rol, los permisos necesarios se incluyen en el rol.

  12. Cómo habilitar o desactivar los comentarios en una solicitud de extracción:

    • Para incluir la información posterior al conjunto de cambios de CloudFormation en las solicitudes de cambios para actualizaciones de pila, mantenga activada la opción Habilitar comentarios en las solicitudes de cambios.

    • Si desactiva esta opción, CloudFormation no describirá las diferencias entre la configuración de la pila actual y los cambios propuestos en las solicitudes de incorporación de cambios cuando se actualicen los archivos del repositorio.

  13. Para Ruta del archivo de plantillas, especifique la ruta completa desde la raíz de su repositorio para el archivo de plantillas de la pila.

  14. (Opcional) Para especificar los parámetros de la pila, seleccione Agregar parámetro, brinde una clave y un valor para cada parámetro y, a continuación, seleccione Siguiente. Para obtener más información, consulte Archivo de implementación de la pila.

    Por ejemplo, para especificar un parámetro port=8080 en el archivo de implementación de la pila, haga lo siguiente:

    1. Elija Add parameter (Añadir parámetro).

    2. En Clave, escriba port.

    3. En Valor, introduzca 8080.

  15. (Opcional) Para especificar etiquetas de pila, seleccione Agregar nueva etiqueta, ingrese un valor y una clave de etiqueta, y luego elija Siguiente. Para obtener más información, consulte Archivo de implementación de la pila.

  16. Seleccione Siguiente para continuar con Configurar las opciones de la pila. Para obtener más información acerca de cómo configurar opciones de la pila, consulte Configurar las opciones la pila.

    Cuando haya completado la configuración, seleccione Siguiente para continuar con la revisión y la implementación.

  17. Revise la configuración de la pila y confirme lo siguiente:

    • La plantilla de la pila se configuró correctamente y se estableció en Sincronizar desde Git.

    • El archivo de implementación se configuró correctamente.

    • El repositorio de definiciones de plantillas se configuró correctamente y, en particular, se seleccionó el Repositorio y Nombre de rama correctos.

    • La vista previa del archivo de implementación es correcta y contiene los parámetros y valores esperados.

  18. Seleccione Enviar para crear la pila.

    Después de que selecciona Enviar, se crea automáticamente una solicitud de extracción en su repositorio de Git. Debe combinar esta solicitud de extracción en su repositorio de Git para crear su pila. Una vez que se crea la pila, CloudFormation supervisa su repositorio de Git en busca de cambios.

Actualización de la pila desde el repositorio de Git

Para actualizar la pila, realice los cambios directamente en el archivo de plantilla o en el archivo de implementación de la pila en su repositorio de Git. Tras confirmar los cambios en la rama supervisada, CloudFormation actualiza automáticamente la pila. Si utiliza solicitudes de extracción, se crea automáticamente una solicitud de extracción en su repositorio de Git antes de que se actualice la pila. Debe combinar esta solicitud de extracción en su repositorio de Git para actualizar su pila.

En la consola de CloudFormation, puede seleccionar la pila y elegir la pestaña Sincronización de Git para ver información sobre el estado de la pila y los eventos de sincronización. Para obtener más información, consulte Panel de estado de sincronización de Git.