Cómo funciona la sincronización de Git

En este tema se describe cómo funciona la sincronización de Git y se introducen los conceptos clave necesarios para trabajar con ella.

Cómo funciona la sincronización de Git

Para utilizar la sincronización de Git, primero debe conectar un proveedor de Git a CloudFormation mediante el servicio CodeConnections. En los procedimiento de esta guía, la conexión se crea a través de la consola de CodeConnections. También puede crear la conexión con la AWS CLI. Puede utilizar cualquiera de los siguientes proveedores de Git:

• GitHub

• GitHub Enterprise

• GitLab

• Bitbucket

• GitLab autoadministrado

A continuación, cree una plantilla de CloudFormation que defina su pila y agréguela a su repositorio. Este archivo de plantilla está supervisado. CloudFormation actualiza la pila automáticamente cuando se realizan cambios en ella.

En la consola de CloudFormation, cree una nueva pila y elija Sincronizar desde Git para indicar a CloudFormation que utilice la sincronización de Git. Deberá especificar el repositorio y la rama que desea que CloudFormation supervise, y la plantilla de CloudFormation del repositorio que define la pila.

Durante la configuración, puede proporcionar su propio archivo de implementación de pila desde su repositorio o hacer que la sincronización de Git genere uno por usted. El archivo de implementación de la pila contiene parámetros y valores que configuran los recursos de la pila. Este archivo de implementación de pila está supervisado. CloudFormation actualiza la pila automáticamente cuando se realizan cambios en ella.

La sincronización de Git crea una solicitud de extracción en su repositorio para sincronizar su pila con el archivo de plantilla de CloudFormation y el archivo de implementación de la pila. Si la sincronización de Git genera el archivo de implementación de la pila por usted, la sincronización de Git lo envía a su repositorio.

A continuación, combine la solicitud de extracción con su repositorio para que CloudFormation aprovisione la pila, la configure con sus parámetros de implementación y comience a monitorear su repositorio para detectar cambios.

A partir de ese momento, cada vez que realice cambios en el archivo de plantilla o en el archivo de implementación de la pila y los confirme en el repositorio, CloudFormation detectará automáticamente los cambios y actualizará la pila.

Puede supervisar el estado de su configuración de sincronización de Git para la pila y ver un historial de las confirmaciones aplicadas a la pila en la consola de CloudFormation. La consola también proporciona herramientas para reconfigurar la sincronización de Git y solucionar problemas.

Archivo de implementación de la pila

Un archivo de implementación de la pila es un archivo con notación de objetos JavaScript (JSON) o YAML que contiene parámetros y valores que administran la pila de CloudFormation. Este se supervisa para detectar cambios. Cuando los cambios en el archivo se confirman en el repositorio, la pila asociada se actualiza automáticamente.

El archivo de implementación de la pila contiene un par valor-clave y dos diccionarios:

• template-file-path

  Esta es la ruta completa del repositorio del archivo de plantilla de CloudFormation. El archivo de plantilla declara los recursos de la pila de CloudFormation asociada a este archivo de implementación.

• parameters

  El diccionario de parámetros contiene pares de clave-valor que configuran los recursos de la pila. Un archivo de implementación de la pila puede tener hasta 50 parámetros.

• tags

  El diccionario de etiqueta contiene pares clave-valor que puede utilizar para identificar y clasificar los recursos de la pila. Un archivo de implementación de la pila puede tener hasta 50 etiquetas.

Puede proporcionar su propio archivo de implementación de la pila o hacer que la sincronización de Git cree uno por usted y envíe automáticamente una solicitud de extracción a su repositorio. Puede gestionar los parámetros y las etiquetas editando el archivo de implementación de la pila y confirmando los cambios en el repositorio.

A continuación, se muestra un ejemplo de un archivo de implementación de pila de sincronización de Git:

template-file-path: ./fargate-srvc/my-stack-template.yaml

parameters: 
    image: public.ecr.aws/lts/nginx:latest
    task_size: x-small
    max_capacity: 5
    port: 8080
    env: production
tags:
    cost-center: '123456'
    org: 'AWS'

Archivo de plantilla de CloudFormation

Un archivo de plantilla contiene una declaración de los recursos de AWS que componen una pila de CloudFormation. Con la sincronización de Git, el archivo de plantilla se almacena en su repositorio de Git y el archivo de implementación de la pila hace referencia a él. Puede gestionar la pila editando el archivo de plantilla y confirmando los cambios en el repositorio.

Para obtener más información, consulte Trabajo con plantillas de CloudFormation.

Repositorio de definiciones de plantilla

El repositorio de definiciones de plantillas es el repositorio de Git que está vinculado a CloudFormation mediante la sincronización de Git. El repositorio se supervisa para detectar cambios en la plantilla de CloudFormation y en el archivo de implementación de la pila. Cuando los cambios en el archivo se confirman en el repositorio, la pila asociada se actualiza automáticamente.

importante

Al configurar el repositorio de definiciones de plantillas en la consola de sincronización de Git, seleccione el repositorio y la rama correctos en la conexión de Git. La sincronización de Git solo supervisa la rama y el repositorio configurados para detectar cambios en la plantilla de CloudFormation y los archivos de implementación de la pila.