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éez un pipeline qui utilise CodeBuild (CodePipeline console) Utilisez la procédure suivante pour créer un pipeline qui permet CodeBuild de créer et de déployer votre code source. Pour créer un pipeline qui teste uniquement votre code source : + Utilisez la procédure suivante pour créer le pipeline, puis supprimez les étapes de génération et bêta du pipeline. Utilisez ensuite la procédure [Ajouter une action de CodeBuild test à un pipeline (CodePipeline console)](how-to-create-pipeline-add-test.md) décrite dans cette rubrique pour ajouter au pipeline une action de test qui utilise CodeBuild. + Utilisez l'une des autres procédures de cette rubrique pour créer le pipeline, puis utilisez la procédure [Ajouter une action de CodeBuild test à un pipeline (CodePipeline console)](how-to-create-pipeline-add-test.md) décrite dans cette rubrique pour ajouter au pipeline une action de test qui utilise CodeBuild. **Pour utiliser l'assistant de création de pipeline CodePipeline pour créer un pipeline qui utilise CodeBuild** 1. Connectez-vous au AWS Management Console en utilisant : + Votre compte AWS root. Ceci n'est pas recommandé. Pour plus d'informations, consultez [la section L'utilisateur root du compte](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html) dans le *guide de l'utilisateur*. + Utilisateur administrateur de votre AWS compte. Pour plus d'informations, consultez la section [Création de votre premier utilisateur et de votre premier groupe Compte AWS root](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html) dans le *guide de l'utilisateur*. + Un utilisateur de votre AWS compte autorisé à effectuer les actions minimales suivantes : ``` 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 ``` 1. Ouvrez la AWS CodePipeline console à l'adresse [https://console.aws.amazon.com/codesuite/codepipeline/home](https://console.aws.amazon.com/codesuite/codepipeline/home). 1. Dans le sélecteur de AWS région, choisissez la AWS région dans laquelle se trouvent les AWS ressources de votre projet de construction. Il doit s'agir d'une AWS région prise CodeBuild en charge. Pour plus d’informations, consultez [AWS CodeBuild](https://docs.aws.amazon.com/general/latest/gr/rande.html#codebuild_region) dans le *Référence générale d'Amazon Web Services*. 1. Créez un pipeline. Si une page CodePipeline d'informations s'affiche, choisissez **Create pipeline**. Si une page **Tous les pipelines** s'affiche, choisissez **Créer un pipeline**. 1. 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. 1. 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. 1. Pour **Artifact store (Magasin d'artefacts)**, effectuez l'une des opérations suivantes : + Choisissez **Emplacement par défaut** pour utiliser le magasin d'artefacts par défaut, tel que le compartiment d'artefacts S3 désigné par défaut, pour votre pipeline dans la AWS 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 bucket d'artefacts S3, dans la même AWS 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 requis pour chaque pipeline, dans la même AWS région que le pipeline. 1. Choisissez **Suivant**. 1. 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 AWS CodeCommit dépôt, 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 un GitHub dépôt, choisissez **GitHub**. Choisissez **Connect to GitHub**, puis suivez les instructions pour vous authentifier auprès GitHub de. 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**. 1. Sur la page **Étape 3: Ajouter une étape de génération**, pour **Fournisseur de génération**, choisissez **CodeBuild**. 1. Si vous avez déjà un projet de construction que vous souhaitez utiliser, dans **Nom du projet**, choisissez le nom du projet de construction et passez à l'étape suivante de cette procédure. Si vous devez créer un nouveau projet de CodeBuild construction, suivez les instructions fournies [Création d'un projet de génération (console)](create-project.md#create-project-console) et revenez à cette procédure. Si vous choisissez un projet de construction existant, les paramètres d'artefact de sortie de construction doivent déjà être définis (même s'ils les CodePipeline remplacent). Pour de plus amples informations, veuillez consulter [Modification des paramètres d'un projet de génération (console)](change-project.md#change-project-console). **Important** Si vous activez les webhooks pour un CodeBuild projet et que le projet est utilisé comme étape de construction CodePipeline, deux versions 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 de plus amples informations, veuillez consulter [Modification des paramètres d'un projet de génération (console)](change-project.md#change-project-console). 1. 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**. 1. Sur la page **Vérification**, vérifiez vos sélections, puis choisissez **Créer un pipeline**. 1. Une fois que le pipeline s'exécute correctement, vous pouvez obtenir l'artefact de sortie de la génération. Le pipeline étant affiché dans la CodePipeline console, dans l'action **Construire**, choisissez l'infobulle. Notez la valeur de l'**artefact de sortie** (par exemple, **MyAppBuild**). **Note** Vous pouvez également obtenir l'artefact de sortie du build en cliquant sur le lien **Build artefacts** sur la page des détails du build dans la CodeBuild console. 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)](view-build-details.md#view-build-details-console). 1. Ouvrez la console Amazon S3 à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. 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 le AWS CLI pour exécuter la CodePipeline **get-pipeline** commande afin d'obtenir le nom du bucket, où se {{my-pipeline-name}} trouve 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. 1. 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. 1. 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. 1. 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 accéder à l'artefact de sortie de génération sur les cibles de déploiement.