Generando una tubería de arranque para AWS CodePipeline en AWS SAM

Para generar una configuración de canalización inicial para AWS CodePipeline, lleve a cabo las siguientes tareas en este orden:

1. Cree recursos de infraestructura

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

3. Confirme la configuración de su canalización en Git

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

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 AWS recursos de infraestructura, como IAM los usuarios y las funciones) tienen más permisos que los desarrolladores (es decir, los usuarios que solo necesitan permiso para configurar canalizaciones individuales, pero no los AWS recursos de infraestructura necesarios).

Paso 1: cree recursos de infraestructura

Las canalizaciones que se utilizan AWS SAM requieren determinados AWS recursos, como un IAM usuario y las funciones con los permisos necesarios, un bucket de Amazon S3 y, opcionalmente, un ECR repositorio de Amazon. 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.

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

Para generar la configuración de la canalización, ejecute el siguiente comando:

sam pipeline init

Paso 3: 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.

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

Pues ahora AWS CodePipeline puedes crear la conexión ejecutando el siguiente comando:

sam deploy -t codepipeline.yaml --stack-name <pipeline-stack-name> --capabilities=CAPABILITY_IAM --region <region-X>

Si utilizas GitHub Bitbucket, después de ejecutar el sam deploy comando anteriormente, completa la conexión siguiendo los pasos descritos en Para completar una conexión, que se encuentran en el tema Actualizar una conexión pendiente de la guía del usuario de la consola de Developer Tools. Además, guarda una copia del resultado CodeStarConnectionArn del sam deploy comando, ya que la necesitarás si quieres usarla AWS CodePipeline con otra rama que no seamain.

Configuración de otras ramificaciones

De forma predeterminada, AWS CodePipeline usa la main rama con AWS SAM. Si desea utilizar una ramificación que no sea main, debe volver a ejecutar el comando sam deploy. Tenga en cuenta que, en función del repositorio de Git que utilice, es posible que también tenga que proporcionar el CodeStarConnectionArn:

# For GitHub and Bitbucket
sam deploy -t codepipeline.yaml --stack-name <feature-pipeline-stack-name> --capabilities=CAPABILITY_IAM --parameter-overrides="FeatureGitBranch=<branch-name> CodeStarConnectionArn=<codestar-connection-arn>"

# For AWS CodeCommit
sam deploy -t codepipeline.yaml --stack-name <feature-pipeline-stack-name> --capabilities=CAPABILITY_IAM --parameter-overrides="FeatureGitBranch=<branch-name>"

Más información

Para ver un ejemplo práctico de cómo configurar una canalización de CI/CD, consulte CI/CD en The Complete Workshop. AWS CodePipeline AWS SAM