Création d'un pipeline utilisant CodeBuild (console CodePipeline) - AWS CodeBuild

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Création d'un pipeline utilisant CodeBuild (console CodePipeline)

Utilisez la procédure suivante pour créer un pipeline qui utilise CodeBuild pour générer et déployer votre code source.

Pour créer un pipeline qui teste uniquement votre code source :

Pour utiliser l'assistant de création de pipeline dans CodePipeline afin de créer un pipeline qui utilise CodeBuild

  1. Connectez-vous à AWS Management Console en utilisant :

    • Votre compte racine AWS. Ceci n'est pas recommandé. Pour plus d'informations, consultez la section L'utilisateur root du compte dans le Guide de l'utilisateur.

    • Un utilisateur administrateur de votreAWS compte. Pour plus d'informations, consultez la section Création de votre premier utilisateurCompte AWS root et de votre premier groupe dans le Guide de l'utilisateur.

    • Un utilisateur de votreAWS compte autorisé à utiliser l'ensemble minimum d'actions suivant :

      codepipeline:*
iam:ListRoles
iam:PassRole
s3:CreateBucket
s3:GetBucketPolicy
s3:GetObject
s3:ListAllMyBuckets
s3:ListBucket
s3:PutBucketPolicy
codecommit:ListBranches
codecommit:ListRepositories
codedeploy:GetApplication
codedeploy:GetDeploymentGroup
codedeploy:ListApplications
codedeploy:ListDeploymentGroups
elasticbeanstalk:DescribeApplications
elasticbeanstalk:DescribeEnvironments
lambda:GetFunctionConfiguration
lambda:ListFunctions
opsworks:DescribeStacks
opsworks:DescribeApps
opsworks:DescribeLayers

  2. Ouvrez laAWS CodePipeline console à l'adresse https://console.aws.amazon.com/codesuite/codepipeline/home.

  3. Dans le sélecteur deAWS région, choisissez laAWS région dans laquelle se trouvent lesAWS ressources de votre projet de construction. Il doit s'agir d'uneAWS région priseCodeBuild en charge. Pour de plus amples informations, veuillez consulter AWS CodeBuild dans le Référence générale d'Amazon Web Services.

  4. Créez un pipeline. Si une page d'information CodePipeline s'affiche, choisissez Créer un pipeline. Si une page Tous les pipelines s'affiche, choisissez Créer un pipeline.

  5. Sur la page Étape 1 : Choisir des paramètres de pipeline, pour Nom du pipeline, saisissez un nom pour le pipeline, par exemple, CodeBuildDemoPipeline. Si vous choisissez un autre nom, veillez à l'utiliser tout au long de cette procédure.

  6. Pour Nom du rôle, sélectionnez l'une des options suivantes :

    Choisissez New service role (Nouveau rôle de service) et dans Nom du rôle, saisissez le nom de votre nouveau rôle de service.

    Choisissez Existing service role (Rôle de service existant), puis choisissez le rôle de service CodePipeline que vous avez créé ou identifié dans le cadre des prérequis de cette rubrique.

  7. Pour Artifact store (Magasin d'artefacts), effectuez l'une des opérations suivantes :

    • Choisissez l'emplacement par défaut pour utiliser le magasin d'artefacts par défaut, tel que le compartiment d'artefacts S3 désigné comme emplacement par défaut, pour votre pipeline dans laAWS région que vous avez sélectionnée pour votre pipeline.

    • Choisissez Emplacement personnalisé si vous avez déjà créé un magasin d'artefacts, tel qu'un compartiment d'artefacts S3, dans la mêmeAWS région que votre pipeline.

    Note

    Il ne s'agit pas du compartiment source du code source pour votre pipeline. Il s'agit du magasin d'artefacts pour votre pipeline. Un magasin d'artefacts distinct, tel qu'un compartiment S3, est nécessaire pour chaque pipeline, estAWS nécessaire pour chaque pipeline.

  8. Choisissez Suivant.

  9. Sur la page Étape 2 : Ajouter une étape source, pour Fournisseur de source, effectuez l'une des actions suivantes :

    • Si votre code source est stocké dans un compartiment S3, choisissez Amazon S3. Pour Bucket (Compartiment), sélectionnez le compartiment S3 qui contient votre code source. Pour S3 object key (Clé d'objet S3), saisissez le nom du fichier qui contient le code source (par exemple file-name.zip). Choisissez Suivant.

    • Si votre code source est stocké dans un compartiment AWS CodeCommit, choisissez CodeCommit. Pour Repository name, choisissez le nom du référentiel qui contient le code source. Pour Branch name (Nom de branche), choisissez le nom de la branche qui représente la version du code source à générer. Choisissez Suivant.

    • Si votre code source est stocké dans unGitHub référentiel, choisissez GitHub. Choisissez Connect àGitHub et suivez les instructions pour vous authentifier auprès deGitHub. Pour Repository, choisissez le nom du référentiel qui contient le code source. Pour Branch (Branche), choisissez le nom de la branche qui représente la version du code source à générer.

    Choisissez Suivant.

  10. Sur la page Étape 3: Ajouter une étape de génération, pour Fournisseur de génération, choisissez CodeBuild.

  11. Si vous avez déjà un projet de génération que vous souhaitez utiliser, dans Nom du projet, choisissez le nom du projet de génération et passez à l'étape suivante de cette procédure.

    Si vous devez créer un nouveau projet deCodeBuild construction, suivez les instructions fourniesCréation d'un projet de génération (console) et revenez à cette procédure.

    Si vous choisissez un projet de génération existant, celui-ci doit avoir des paramètres d'artefact de sortie déjà définis (même si CodePipeline les remplace). Pour plus d'informations, veuillez consulter Modification des paramètres d'un projet de génération (console).

    Important

    Si vous activez des webhooks pour un projet CodeBuild et que le projet est utilisé en tant qu'étape de génération dans CodePipeline, deux générations identiques sont créées pour chaque validation. L'une est déclenchée via des webhooks et l'autre via CodePipeline. Comme la facturation est effectuée par génération, les deux générations vous sont facturées. Par conséquent, si vous utilisez CodePipeline, nous vous recommandons de désactiver les webhooks dans CodeBuild. Dans la console AWS CodeBuild, décochez la case Webhook. Pour plus d'informations, veuillez consulter Modification des paramètres d'un projet de génération (console).

  12. Sur la page Étape 4 : Ajouter une étape de déploiement, effectuez l'une des opérations suivantes :

    • Si vous ne souhaitez pas déployer l'artefact de sortie de génération, choisissez Ignorer et confirmez ce choix lorsque vous y êtes invité.

    • Si vous souhaitez déployer l'artefact de sortie de génération, pour Deploy provider (Fournisseur de déploiement), choisissez un fournisseur de déploiement, puis spécifiez les paramètres lorsque vous y êtes invité.

    Choisissez Suivant.

  13. Sur la page Vérification, vérifiez vos sélections, puis choisissez Créer un pipeline.

  14. Une fois que le pipeline s'exécute correctement, vous pouvez obtenir l'artefact de sortie de la génération. Avec le pipeline affiché dans la console CodePipeline, dans l'action Génération, sélectionnez l'info-bulle. Notez la valeur de Output artefact (par exemple, MyAppBuild).

    Note

    Vous pouvez également obtenir l'artefact de sortie de la génération en choisissant le lien Artefacts de génération sur la page des détails de génération dans la console CodeBuild. Pour accéder à cette page, ignorez les autres étapes de cette procédure et consultez Affichage des détails d'une génération (console).

  15. Ouvrez la console Amazon S3 sur https://console.aws.amazon.com/s3/.

  16. Dans la liste des compartiments, ouvrez le compartiment utilisé par le pipeline. Le nom du compartiment doit suivre le format codepipeline-region-ID-random-number. Vous pouvez utiliser leAWS CLI pour exécuter laCodePipelineget-pipeline commande afin d'obtenir le nom du compartiment, où se my-pipeline-nametrouve le nom d'affichage de votre pipeline :

    aws codepipeline get-pipeline --name my-pipeline-name

    Dans la sortie, l'objet pipeline contient un objet artifactStore contenant une valeur location avec le nom du compartiment.

  17. Ouvrez le dossier correspondant au nom de votre pipeline (selon la longueur du nom du pipeline, le nom de dossier peut être tronqué), puis ouvrez le dossier correspondant à la valeur pour Output artifact (Artefact de sortie) que vous avez notée précédemment.

  18. Extrayez le contenu du fichier . Si ce dossier contient plusieurs fichiers, extrayez le contenu du fichier avec le dernier horodatage Last Modified. (Vous pouvez attribuer au fichier l'extension .zip pour pouvoir l'utiliser avec l'utilitaire ZIP de votre système.) L'artefact de sortie de génération figure dans le contenu extrait du fichier.

  19. Si vous avez demandé à CodePipeline de déployer l'artefact de sortie de génération, utilisez les instructions du fournisseur de déploiement pour obtenir l'artefact de sortie de génération sur les cibles de déploiement.