Generación de canalizaciones iniciales para canalizaciones de Jenkins, GitLab CI/CD, GitHub Actions o Bitbucket

Para generar una configuración de canalización inicial para Jenkins, GitLab CI/CD, GitHub Actions o Bitbucket Pipelines, realiza las siguientes tareas en este orden:

1. Cree recursos de infraestructura

2. Conecte su repositorio de Git con su sistema CI/CD

3. Cree objetos de credenciales

4. Genere la configuración de la canalización

5. Confirme su configuración de la canalización en el repositorio de Git

nota

El siguiente procedimiento utiliza dos comandos CLI de AWS SAM, sam pipeline bootstrap y sam pipeline init. La razón por la que hay dos comandos es para gestionar el caso de uso en el que los administradores (es decir, los usuarios que necesitan permiso para configurar los recursos de AWS de infraestructura, como los usuarios y roles de IAM) tienen más permisos que los desarrolladores (es decir, los usuarios que solo necesitan permiso para configurar canalizaciones individuales, pero no los recursos de AWS de infraestructura necesarios).

Paso 1: cree recursos de infraestructura

Las canalizaciones que utilizan AWS SAM requieren determinados recursos de AWS, como un usuario de IAM y las funciones con los permisos necesarios, un bucket de Amazon S3 y, opcionalmente, un repositorio de Amazon ECR. Debe tener un conjunto de recursos de infraestructura para cada etapa de implementación de la canalización.

Puede ejecutar el siguiente comando para editar o agregar esta configuración:

sam pipeline bootstrap

nota

Ejecute el comando anterior para cada etapa de implementación de su canalización.

Debe registrar las credenciales de AWS (el identificador y la contraseña) de los usuarios de la canalización para cada etapa de implementación de la canalización, ya que son necesarias para los pasos siguientes.

Paso 2: conecte su repositorio de Git con su sistema CI/CD

Es necesario conectar el repositorio de Git al sistema de CI/CD para que el sistema de CI/CD pueda acceder al código fuente de la aplicación para creaciones e implementaciones.

nota

Puede omitir este paso si utiliza una de las siguientes combinaciones, ya que la conexión se realiza automáticamente:

1. GitHub Acciones con repositorio GitHub

2. GitLab CI/CD con repositorio GitLab

3. Bitbucket Pipelines con repositorio de Bitbucket

Para conectar el repositorio de Git con el sistema de CI/CD, realice una de las siguientes acciones:

• Si utiliza Jenkins, consulte la documentación de Jenkins para “añadir un origen de ramificación”.

• Si utilizas GitLab CI/CD y otro repositorio de Git GitLab, consulta la GitLabdocumentación para «conectar un repositorio externo».

Paso 3: crear objetos de credenciales

Cada sistema CI/CD tiene su propia forma de gestionar las credenciales necesarias para que el sistema CI/CD acceda a su repositorio de Git.

Para crear los objetos de credenciales necesarios, realice una de las siguientes acciones:

• Si utiliza Jenkins, cree una “credencial” única que almacene tanto el identificador como la contraseña. Siga las instrucciones del blog Cómo crear una canalización con Jenkins con AWS SAM, en la sección Configurar Jenkins. Necesitará el “identificador de credencial” para el siguiente paso.

• Si utilizas GitLab CI/CD, crea dos «variables protegidas», una para cada identificador de clave y clave secreta. Siga las instrucciones de la GitLab documentación; necesitará dos «claves variables» para el siguiente paso.

• Si utilizas GitHub Actions, crea dos «secretos cifrados», uno para cada clave y una clave secreta. Sigue las instrucciones de la GitHubdocumentación: necesitarás dos «nombres secretos» para el siguiente paso.

• Si utiliza Bitbucket Pipelines, cree dos “variables seguras”, una para cada identificador y contraseña. Siga las instrucciones de las variables y secretos; necesitará dos “nombres secretos” para el siguiente paso.

Paso 4: genere la configuración de la canalización

Para generar la configuración de la canalización, ejecute el siguiente comando. Necesitará introducir el objeto de credenciales que creó en el paso anterior:

sam pipeline init

Paso 5: confirme la configuración de su canalización en el repositorio de Git

Este paso es necesario para garantizar que su sistema de CI/CD conozca la configuración de la canalización y se ejecute cuando se realicen los cambios.

Más información

Para ver un ejemplo práctico de cómo configurar una canalización de CI/CD usando GitHub Actions, consulte CI/CD con GitHub en El taller completo de AWS SAM.