Uso de AWS SAM para generar canalizaciones de inicio para Jenkins, GitLab CI/CD, GitHub Actions o Bitbucket Pipelines - AWS Serverless Application Model
Paso 1: cree recursos de infraestructuraPaso 2: conecte su repositorio de Git con su sistema CI/CDPaso 3: crear objetos de credencialesPaso 4: genere la configuración de la canalizaciónPaso 5: confirma la configuración de su canalización en el repositorio de GitMás información

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.

Uso de AWS SAM para generar canalizaciones de inicio para Jenkins, GitLab CI/CD, GitHub Actions o Bitbucket Pipelines

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

  1. Crea recursos de infraestructura

  2. Conecta tu repositorio de Git con tu sistema CI/CD

  3. Crea objetos de credenciales

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

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

nota

El siguiente procedimiento utilizas 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) tengan 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.

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

sam pipeline bootstrap
nota

Ejecuta 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

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

  1. GitHub Actions con repositorio de GitHub

  2. CI/CD de GitLab con repositorio de 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 utilizas Jenkins, consulta la documentación de Jenkins para «añadir un origen de ramificación».

  • Si utilizas el CI/CD de GitLab y un repositorio de Git que no sea GitLab, consulta la documentación de GitLab 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 tu repositorio de Git.

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

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

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

  • Si usas GitHub Actions, cree dos «secretos cifrados», uno para cada identificador y contraseña. Sigue las instrucciones de la documentación de GitHub; necesitarás dos «nombres secretos» para el siguiente paso.

  • Si utilizas Bitbucket Pipelines, crea dos «variables seguras», una para cada identificador y contraseña. Sigue las instrucciones de las variables y secretos; necesitarás 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, ejecuta el siguiente comando. Necesitará introducir el objeto de credenciales que creaste en el paso anterior:

sam pipeline init

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

Este paso es necesario para garantizar que tu 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, consulta CI/CD con GitHub en El taller completo de AWS SAM.