Génération de pipelines de démarrage pour AWS CodePipeline

Pour générer une configuration de pipeline de démarrage pour AWS CodePipeline, exécutez les tâches suivantes dans cet ordre :

1. Créer des ressources d’infrastructure

2. Générer la configuration du pipeline

3. Associer la configuration du pipeline au référentiel Git

4. Connecter le référentiel Git au système CI/CD

Note

La procédure suivante utilise deux commandes de la CLI AWS SAM, sam pipeline bootstrap et sam pipeline init. La raison pour laquelle il existe deux commandes est que cela permet de gérer le cas d’utilisation où les administrateurs (c’est-à-dire des utilisateurs ayant besoin d’une autorisation pour la configuration des ressources d’infrastructure AWS, tels que les utilisateurs et les rôles IAM) disposent de plus d’autorisations que les développeurs (c’est-à-dire les utilisateurs n’ayant besoin d’autorisation que pour la configuration des pipelines individuels, mais pas des ressources d’infrastructure AWS requises).

Étape 1 : créer des ressources d’infrastructure

Les pipelines qui utilisent AWS SAM requièrent certaines ressources AWS, comme un utilisateur IAM et des rôles disposant des autorisations nécessaires, un compartiment Amazon S3 et éventuellement un référentiel Amazon ECR. Vous devez disposer d’un ensemble de ressources d’infrastructure pour chaque étape de déploiement du pipeline.

Vous pouvez exécuter la commande suivante pour vous aider avec cette configuration :

sam pipeline bootstrap

Note

Exécutez la commande précédente pour chaque étape de déploiement du pipeline.

Étape 2 : générer la configuration du pipeline

Pour générer la configuration du pipeline, exécutez la commande suivante :

sam pipeline init

Étape 3 : associer la configuration du pipeline au référentiel Git

Cette étape est nécessaire pour vous assurer que le système CI/CD connaît la configuration du pipeline et s’exécute lorsque les modifications sont associées.

Étape 4 : connecter le référentiel Git au système CI/CD

Pour AWS CodePipeline vous pouvez maintenant créer la connexion en exécutant la commande suivante :

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

Si vous utilisez GitHub Bitbucket, après avoir exécuté la sam deploy commande précédemment, terminez la connexion en suivant les étapes décrites dans la section Pour établir une connexion trouvée dans la rubrique Mettre à jour une connexion en attente dans le guide de l'utilisateur de la console Developer Tools. De plus, stockez une copie du CodeStarConnectionArn à partir de la sortie de la commande sam deploy, car vous en aurez besoin si vous voulez utiliser AWS CodePipeline avec une branche autre que main.

Configuration d’autres branches

Par défaut, AWS CodePipeline utilise la branche main avec AWS SAM. Si vous voulez utiliser une branche autre que main, vous devez exécuter à nouveau la commande sam deploy. Notez que selon le référentiel Git que vous utilisez, il se peut que vous deviez aussi fournir le 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>"

En savoir plus

Pour un exemple pratique de configuration d'un pipeline CI/CD, consultez CI/CD avec AWS CodePipeline dans L'atelier AWS SAM complet.