Tutorial de sincronización de Git de AWS CloudFormation - AWS CloudFormation
Paso 1: crear una pilaPaso 2: especificar los detalles de la pilaPaso 3: configurar las opciones la pilaPaso 4: revisar e implementarModificar la pila

Tutorial de sincronización de Git de AWS CloudFormation

Aprenda a usar la sincronización de Git con el siguiente tutorial. Antes de comenzar, asegúrese de completar los requisitos previos de la sincronización de Git.

Paso 1: crear una pila

  1. Acceda a la consola de CloudFormation.

  2. Seleccione Crear pila.

  3. En el panel Crear pila, en la parte de Requisitos previos: preparar plantilla, confirme que la opción La plantilla está lista esté seleccionada.

  4. En el panel Especificar plantilla, seleccione Sincronizar desde Git.

  5. Elija Siguiente para especificar los detalles de la pila.

Paso 2: especificar los detalles de la pila

  1. En el panel Ingresar el nombre de la pila, escriba un nombre para la pila. Los nombres de pilas pueden incluir letras (A-Z y a-z), números (0-9) y guiones (-).

  2. El archivo de implementación de la pila tiene dos opciones:

    • Crear el archivo con los siguientes parámetros y colocarlo en mi repositorio.

      Elija esta opción si quiere que la sincronización de Git cree el archivo de implementación de la pila y lo coloque en su repositorio.

    • Estoy proporcionando mi propio archivo en mi repositorio.

      Elija esta opción si creó el archivo de implementación de la pila y lo agregó a su repositorio.

    Para obtener más información, consulte Archivo de implementación de la pila.

  3. El panel Repositorio de definiciones de plantillas tiene dos opciones:

    • Elegir un repositorio de Git vinculado

    • Vincular un repositorio de Git

    Si ya vinculó un repositorio de Git a CloudFormation, seleccione Elegir un repositorio de Git vinculado y continúe con el siguiente paso. De lo contrario, realice los siguientes subpasos para conectar un repositorio de Git:

    1. Seleccione Vincular un repositorio de Git.

    2. Elija su proveedor de repositorios de Git entre los siguientes:

      • GitHub

      • GitHub Enterprise

      • GitLab

      • Bitbucket

    3. Elija una Conexión de la lista. Si no aparece ninguna opción en la lista de Conexiones, diríjase a la Consola de conexiones para crear una conexión con su repositorio.

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

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

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

  7. 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 CloudFormation. Si decide generar un nuevo rol, los permisos necesarios se incluyen en el rol.

    nota

    Para obtener información importante sobre los permisos necesarios y la política de confianza para la sincronización de Git, consulte Permisos necesarios.

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

  9. Agregue los parámetros para la pila que desee establecer a partir del archivo de implementación de la pila. Los parámetros son pares clave-valor. Por ejemplo, para agregar el parámetro de puerto al archivo de implementación de la pila:

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

    2. En Clave, escriba port.

    3. En Valor, introduzca 8080.

    4. Repita los pasos anteriores para todos los parámetros de la pila que desee que estén disponibles en el archivo de implementación de la pila.

  10. (Opcional) Agregue etiquetas. Las etiquetas son pares clave-valor que puede utilizar para identificar y clasificar los recursos de la pila. Para agregar etiquetas a la implementación de la pila, siga el mismo proceso que utilizó para agregar parámetros.

  11. Seleccione Siguiente para continuar con Configurar las opciones de la pila.

Paso 3: configurar las opciones la pila

Para obtener más información acerca de cómo configurar opciones de la pila, consulte Configuración de las opciones de pila de AWS CloudFormation.

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

Paso 4: revisar e implementar

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

  2. Seleccione Enviar para crear la pila.

    importante

    Cuando 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 completar el proceso. Al fusionar la solicitud de extracción, se crea la pila, y la sincronización de Git supervisa la plantilla de CloudFormation y el archivo de implementación de la pila en busca de cambios para actualizar la pila.

Modificar la pila

Tras completar los pasos anteriores, se crea una nueva pila, y CloudFormation supervisa el repositorio de Git para detectar cambios.

Para modificar la pila, realice los cambios directamente en el archivo de implementación de la pila. Luego, consérvelos en el repositorio y la rama que configuró para la pila en la sincronización de Git.

En el panel 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 de AWS CloudFormation.