Création d'un pipeline, d'étapes et d'actions

Étape 1 : Créer et nommer votre pipeline

1. Connectez-vous à la CodePipeline console AWS Management Console et ouvrez-la à l'adresse http://console.aws.amazon. com/codesuite/codepipeline/home.

2. Sur la page Welcome (Bienvenue), choisissez Créer un pipeline.

   Si c'est la première fois que vous l'utilisez CodePipeline, choisissez Get Started.

3. Sur la page Étape 1 : Choisir une option de création, sous Options de création, choisissez l'option Créer un pipeline personnalisé. Choisissez Suivant.

4. Sur la page Étape 2 : Choisir les paramètres du pipeline, dans Nom du pipeline, entrez le nom de votre pipeline.

   Dans un seul AWS compte, chaque pipeline que vous créez dans une AWS région doit porter un nom unique. Les noms peuvent être réutilisés pour des pipelines de régions différentes.

   Note

   Une fois le pipeline créé, vous ne pouvez plus modifier son nom. Pour plus d'informations sur les autres limitations, consultez Quotas dans AWS CodePipeline.

5. Dans Type de pipeline, choisissez l'une des options suivantes. Les types de pipelines diffèrent en termes de caractéristiques et de prix. Pour de plus amples informations, veuillez consulter Types de canalisations.

   • Les pipelines de type V1 ont une JSON structure qui contient des paramètres de pipeline, d'étape et d'action standard.

   • Les pipelines de type V2 ont la même structure que les pipelines de type V1, avec une prise en charge de paramètres supplémentaires, tels que les déclencheurs sur les balises Git et les variables au niveau du pipeline.

6. Dans Rôle du service, sélectionnez l'une des options suivantes :

   • Choisissez Nouveau rôle de service pour CodePipeline autoriser la création d'un nouveau rôle de service dansIAM.

   • Choisissez Rôle de service existant pour utiliser un rôle de service déjà créé dansIAM. Dans Rôle ARN, choisissez votre rôle ARN de service dans la liste.

   Note

   En fonction de la date de création de votre rôle de service, vous devrez peut-être mettre à jour ses autorisations pour en prendre en charge d'autres Services AWS. Pour plus d’informations, veuillez consulter Ajout d'autorisations au rôle de service CodePipeline.

   Pour plus d'informations sur le rôle de service et sa déclaration de stratégie, consultez Gérer le rôle CodePipeline de service.

7. (Facultatif) Sous Variables, choisissez Ajouter une variable pour ajouter des variables au niveau du pipeline.

   Pour plus d'informations sur les variables au niveau du pipeline, consultezRéférence aux variables. Pour un didacticiel avec une variable au niveau du pipeline transmise au moment de l'exécution du pipeline, voir. Tutoriel : Utiliser des variables au niveau du pipeline

   Note

   Bien qu'il soit facultatif d'ajouter des variables au niveau du pipeline, pour un pipeline spécifié avec des variables au niveau du pipeline pour lequel aucune valeur n'est fournie, l'exécution du pipeline échouera.

8. (Facultatif) Développez Advanced settings (Paramètres avancés).

9. Dans Magasin d'artefacts, effectuez l'une des actions suivantes :

   1. 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 le répertoire que Région AWS vous avez sélectionné pour votre pipeline.

   2. Choisissez Custom location (Emplacement personnalisé) si vous disposez déjà d'un magasin d'artefacts, par exemple, un compartiment d'artefacts S3, dans la même région que votre pipeline. Dans Bucket (Compartiment), choisissez le nom du compartiment.

   Note

   Il ne s'agit pas du compartiment source de votre code source. 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. Lorsque vous créez ou modifiez un pipeline, vous devez disposer d'un compartiment d'artefacts dans la région du pipeline et d'un compartiment d'artefacts par AWS région dans laquelle vous exécutez une action.

   Pour plus d’informations, consultez Artefacts d'entrée et de sortie et CodePipeline référence de structure de pipeline.

10. Dans Encryption key (Clé de chiffrement), effectuez l'une des opérations suivantes :

    1. Pour utiliser la CodePipeline valeur par défaut AWS KMS key pour chiffrer les données dans le magasin d'artefacts du pipeline (compartiment S3), choisissez Default AWS Managed Key.

    2. Pour utiliser votre clé gérée par le client afin de chiffrer les données dans le magasin d'artefacts du pipeline (compartiment S3), choisissez Clé gérée par le client. Choisissez l'ID de cléARN, la clé ou l'aliasARN.

11. Choisissez Suivant.

Étape 2 : Créer une étape source

1. Sur la page Étape 3 : Ajouter une étape source, dans Source provider, choisissez le type de référentiel dans lequel votre code source est stocké, puis spécifiez les options requises. Les champs supplémentaires s'affichent en fonction du fournisseur de source sélectionné comme suit.

   • Pour Bitbucket Cloud GitHub (version 2), GitHub Enterprise Server, GitLab .com ou en mode GitLab autogéré :

     1. Sous Connexion, choisissez une connexion existante ou créez-en une nouvelle. Pour créer ou gérer une connexion pour votre action GitHub source, consultezGitHub connexions.

     2. Choisissez le référentiel que vous souhaitez utiliser comme emplacement source pour votre pipeline.

        Choisissez d'ajouter un déclencheur ou de filtrer les types de déclencheurs pour démarrer votre pipeline. Pour plus d'informations sur l'utilisation des déclencheurs, consultezFiltrer les déclencheurs sur les requêtes push ou pull de code. Pour plus d'informations sur le filtrage à l'aide de modèles globulaires, consultezUtilisation de modèles globulaires dans la syntaxe.

     3. Dans Format d'artefact de sortie, choisissez le format de vos artefacts.

        • Pour stocker les artefacts de sortie de l' GitHub action à l'aide de la méthode par défaut, choisissez CodePipelinepar défaut. L'action accède aux fichiers depuis le GitHub référentiel et stocke les artefacts dans un ZIP fichier du magasin d'artefacts du pipeline.

        • Pour stocker un JSON fichier contenant une URL référence au référentiel afin que les actions en aval puissent exécuter directement les commandes Git, choisissez Full clone. Cette option ne peut être utilisée que par des actions CodeBuild en aval.

          Si vous choisissez cette option, vous devrez mettre à jour les autorisations associées à votre rôle de service de CodeBuild projet, comme indiqué dansRésolution des problèmes CodePipeline. Pour consulter un didacticiel expliquant comment utiliser l'option de clonage complet, voirTutoriel : Utiliser un clone complet avec une source de GitHub pipeline.

   • Pour Amazon S3 :

     1. Dans Emplacement Amazon S3, indiquez le nom du compartiment S3 et le chemin d'accès à l'objet dans un compartiment où la gestion des versions est activée. Le format du nom et du chemin du compartiment ressemblent à l'exemple suivant :

         s3://bucketName/folderName/objectName

        Note

        Lorsque Amazon S3 est le fournisseur source de votre pipeline, vous pouvez compresser votre ou vos fichiers source dans un seul fichier .zip et télécharger le fichier .zip dans votre compartiment source. Vous pouvez également charger un seul fichier décompressé ; toutefois, les actions en aval qui attendent un fichier .zip échoueront.

     2. Après avoir choisi le compartiment source S3, vous CodePipeline créez la règle Amazon CloudWatch Events et AWS CloudTrail le journal à créer pour ce pipeline. Acceptez les valeurs par défaut sous Options de détection des modifications. Cela permet d' CodePipeline utiliser Amazon CloudWatch Events et AWS CloudTrail de détecter les modifications apportées à votre nouveau pipeline. Choisissez Suivant.

   • Dans AWS CodeCommit :

     • Dans Nom du référentiel, choisissez le nom du CodeCommit référentiel que vous souhaitez utiliser comme emplacement source pour votre pipeline. Dans Nom de branche, depuis la liste déroulante, choisissez la branche que vous souhaitez utiliser.

     • Dans Format d'artefact de sortie, choisissez le format de vos artefacts.

       • Pour stocker les artefacts de sortie de l' CodeCommit action à l'aide de la méthode par défaut, choisissez CodePipelinepar défaut. L'action accède aux fichiers depuis le CodeCommit référentiel et stocke les artefacts dans un ZIP fichier du magasin d'artefacts du pipeline.

       • Pour stocker un JSON fichier contenant une URL référence au référentiel afin que les actions en aval puissent exécuter directement les commandes Git, choisissez Full clone. Cette option ne peut être utilisée que par des actions CodeBuild en aval.

         Si vous choisissez cette option, vous devrez ajouter l'codecommit:GitPullautorisation à votre rôle de CodeBuild service, comme indiqué dansAjouter CodeBuild GitClone des autorisations pour les actions CodeCommit source. Vous devrez également ajouter les codecommit:GetRepository autorisations à votre rôle de CodePipeline service, comme indiqué dansAjout d'autorisations au rôle de service CodePipeline. Pour consulter un didacticiel expliquant comment utiliser l'option de clonage complet, voirTutoriel : Utiliser un clone complet avec une source de GitHub pipeline.

     • Une fois que vous avez choisi le nom du CodeCommit référentiel et la branche, un message s'affiche dans les options de détection des modifications indiquant la règle Amazon CloudWatch Events à créer pour ce pipeline. Acceptez les valeurs par défaut sous Options de détection des modifications. Cela permet d' CodePipeline utiliser Amazon CloudWatch Events pour détecter les modifications apportées à votre nouveau pipeline.

   • Pour Amazon ECR :

     • Dans Nom du référentiel, choisissez le nom de votre ECR référentiel Amazon.

     • Dans la balise Image, spécifiez le nom et la version de l'image, s'ils sont différents deLATEST.

     • Dans Artefacts de sortie, choisissez l'artefact de sortie par défaut, par exemple MyApp, qui contient le nom de l'image et les URI informations du référentiel que vous souhaitez utiliser à l'étape suivante.

       Pour un didacticiel sur la création d'un pipeline pour Amazon ECS avec des déploiements CodeDeploy bleu-vert incluant un stage ECR source Amazon, consultez. Tutoriel : Création d'un pipeline avec une ECR source Amazon et déploiement en ECS vue d'un déploiement CodeDeploy

     Lorsque vous incluez une étape ECR source Amazon dans votre pipeline, l'action source génère un imageDetail.json fichier en tant qu'artefact de sortie lorsque vous validez une modification. Pour de plus amples informations concernant le fichier imageDetail.json, veuillez consulter imageDetailfichier .json pour les actions de déploiement ECS bleu/vert d'Amazon.

   Note

   L'objet et le type de fichier doivent être compatibles avec le système de déploiement que vous prévoyez d'utiliser (par exemple, Elastic Beanstalk ou). CodeDeploy Les types de fichier .zip, .tar et .tgz peuvent être pris en charge. Pour plus d'informations sur les types de conteneurs pris en charge pour Elastic Beanstalk, consultez Personnalisation et configuration des environnements Elastic Beanstalk et des plateformes prises en charge. Pour plus d'informations sur le déploiement de révisions avec CodeDeploy, consultez les sections Chargement de la révision de votre application et Préparation d'une révision.

2. Pour configurer l'étape pour une nouvelle tentative automatique, choisissez Activer la nouvelle tentative automatique en cas d'échec de l'étape. Pour plus d'informations sur la nouvelle tentative automatique, consultezConfiguration d'une étape pour une nouvelle tentative automatique en cas d'échec.

3. Choisissez Suivant.

Étape 4 : Création d'une phase de construction

Cette étape est facultative si vous prévoyez de créer une étape de déploiement.

1. Sur la page Étape 3 : Ajouter une étape de génération, effectuez l'une des opérations suivantes et choisissez Suivant :

   • Choisissez Skip build stage (Ignorer l'étape de génération) si vous prévoyez de créer une étape de déploiement.

   • Pour choisir l'action Commandes pour votre phase de construction, sélectionnez Commandes.

     Note

     L'exécution de l'action Commandes entraînera des frais distincts dans AWS CodeBuild

     Dans Commandes, entrez les commandes shell pour votre action. Pour plus d'informations sur l'action Commandes, consultezRéférence d'action des commandes.

   • Pour choisir d'autres fournisseurs de build CodeBuild, par exemple, choisissez Autres fournisseurs. Dans Fournisseur de génération, choisissez un fournisseur d'action personnalisée de services de génération, puis indiquez les détails de configuration pour ce fournisseur. Pour obtenir un exemple sur la manière d'ajouter Jenkins comme fournisseur de génération, consultez Didacticiel : Création d'un pipeline à quatre étapes.

   • Dans Fournisseur de génération, choisissez AWS CodeBuild.

     Dans Région, choisissez la AWS région dans laquelle se trouve la ressource. Le champ Région indique l'endroit où les AWS ressources sont créées pour ce type d'action et ce type de fournisseur. Ce champ s'affiche uniquement pour les actions pour lesquelles le fournisseur d'actions est un Service AWS. Le champ Région correspond par défaut à la même AWS région que votre pipeline.

     Dans Nom du projet, choisissez votre projet de génération. Si vous avez déjà créé un projet de construction dans CodeBuild, choisissez-le. Vous pouvez également créer un projet de construction dans CodeBuild puis revenir à cette tâche. Suivez les instructions de la section Création d'un pipeline à utiliser CodeBuild dans le guide de CodeBuild l'utilisateur.

     Dans Variables d'environnement, pour ajouter des variables d' CodeBuildenvironnement à votre action de génération, choisissez Ajouter une variable d'environnement. Chaque variable est composée de trois entrées :

     • Dans Nom, entrez le nom ou clé de la variable d'environnement.

     • Dans Valeur, entrez la valeur de la variable d'environnement. Si vous choisissez Parameter pour le type de variable, assurez-vous que cette valeur est le nom d'un paramètre que vous avez déjà stocké dans le magasin de paramètres de AWS Systems Manager.

       Note

       Nous déconseillons vivement l'utilisation de variables d'environnement pour stocker des valeurs sensibles, en particulier des AWS informations d'identification. Lorsque vous utilisez la CodeBuild console ou AWS CLI, les variables d'environnement sont affichées en texte brut. Pour les valeurs sensibles, nous vous recommandons d'utiliser plutôt le type Parameter (Paramètre).

     • (Facultatif) Dans Type, entrez le type de variable d'environnement. Les valeurs valides sont Plaintext (Texte brut) ou Parameter (Paramètre). La valeur par défaut est Plaintext (Texte brut).

     (Facultatif) Dans Type de construction, choisissez l'une des options suivantes :

     • Pour exécuter chaque build en une seule exécution d'action de build, choisissez Single build.

     • Pour exécuter plusieurs builds lors de la même exécution d'une action de build, choisissez Batch build.

     (Facultatif) Si vous avez choisi d'exécuter des constructions par lots, vous pouvez choisir Combiner tous les artefacts du lot dans un seul emplacement pour placer tous les artefacts de construction dans un seul artefact de sortie.

2. Pour configurer l'étape pour une nouvelle tentative automatique, choisissez Activer la nouvelle tentative automatique en cas d'échec de l'étape. Pour plus d'informations sur la nouvelle tentative automatique, consultezConfiguration d'une étape pour une nouvelle tentative automatique en cas d'échec.

3. Choisissez Suivant.

Étape 5 : Création d'une phase de déploiement

Cette étape est facultative si vous avez déjà créé une étape de génération.

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

   • Choisissez Skip deploy stage (Ignorer l'étape de déploiement) si vous avez créé une étape de génération lors de l'étape précédente.

     Note

     Cette option ne s'affiche pas si vous avez déjà ignoré l'étape de génération.

   • Dans Deploy provider (Fournisseur de déploiement), choisissez une action personnalisée que vous avez créée pour un fournisseur de déploiement.

     Dans Région, pour les actions interrégionales uniquement, choisissez la AWS région dans laquelle la ressource est créée. Le champ Région indique l'endroit où les AWS ressources sont créées pour ce type d'action et ce type de fournisseur. Ce champ s'affiche uniquement pour les actions dont le fournisseur d'actions est un Service AWS. Le champ Région correspond par défaut à la même AWS région que votre pipeline.

   • Dans Fournisseur de déploiement, les champs sont disponibles pour les fournisseurs par défaut comme suit :

     • CodeDeploy

       Dans Nom de l'application, entrez ou choisissez le nom d'une CodeDeploy application existante. Dans Groupe de déploiement, saisissez le nom d'un groupe de déploiement pour l'application. Choisissez Suivant. Vous pouvez également créer une application, un groupe de déploiement ou les deux dans la CodeDeploy console.

     • AWS Elastic Beanstalk

       Dans Nom de l'application, entrez ou choisissez le nom d'une application Elastic Beanstalk existante. Dans Nom de l'environnement, saisissez un environnement pour l'application. Choisissez Suivant. Vous pouvez également créer une application, un environnement ou les deux dans la console Elastic Beanstalk.

     • AWS OpsWorks Stacks

       Dans Stack, saisissez ou choisissez le nom de la pile que vous souhaitez utiliser. Dans Couche, choisissez la couche à laquelle appartiennent vos instances cibles. Dans App, choisissez l'application que vous souhaitez mettre à jour et déployer. Si vous avez besoin de créer une application, choisissez Crée une nouvelle dans AWS OpsWorks.

       Pour plus d'informations sur l'ajout d'une application à une pile et à une couche AWS OpsWorks, consultez la section Ajouter des applications dans le guide de AWS OpsWorks l'utilisateur.

       Pour un end-to-end exemple d'utilisation d'un pipeline simple en CodePipeline tant que source du code que vous exécutez sur des AWS OpsWorks couches, consultez la section Utilisation CodePipeline avec AWS OpsWorks Stacks.

     • AWS CloudFormation

       Effectuez l’une des actions suivantes :

       • En mode Action, choisissez Créer ou mettre à jour une pile, entrez le nom de la pile et le nom du fichier modèle, puis choisissez le nom du rôle AWS CloudFormation à assumer. Entrez éventuellement le nom d'un fichier de configuration et choisissez une option IAM de fonctionnalité.

       • En mode Action, choisissez Créer ou remplacer un ensemble de modifications, entrez un nom de pile et un nom d'ensemble de modifications, puis choisissez le nom d'un rôle AWS CloudFormation à assumer. Entrez éventuellement le nom d'un fichier de configuration et choisissez une option IAM de fonctionnalité.

       Pour plus d'informations sur l'intégration de AWS CloudFormation fonctionnalités dans un pipeline CodePipeline, voir Continuous Delivery with CodePipeline dans le guide de AWS CloudFormation l'utilisateur.

     • Amazon ECS

       Dans Nom du cluster, entrez ou choisissez le nom d'un ECS cluster Amazon existant. Dans Nom du service, saisissez ou choisissez le nom du service exécuté sur le cluster. Vous pouvez également créer un cluster et un service. Dans Nom du fichier d'image, tapez le nom du fichier de définitions d'image qui décrit le conteneur et l'image du service.

       Note

       L'action ECS de déploiement Amazon nécessite un imagedefinitions.json fichier comme entrée pour l'action de déploiement. Le nom de fichier par défaut est imagedefinitions.json. Si vous choisissez d'utiliser un autre nom de fichier, vous devez l'indiquer lorsque vous créez la phase de déploiement du pipeline. Pour de plus amples informations, veuillez consulter fichier imagedefinitions.json pour les actions de déploiement standard d'Amazon ECS.

       Choisissez Suivant.

       Note

       Assurez-vous que votre ECS cluster Amazon est configuré avec deux instances ou plus. Les ECS clusters Amazon doivent contenir au moins deux instances afin que l'une soit maintenue en tant qu'instance principale et l'autre utilisée pour les nouveaux déploiements.

       Pour un didacticiel sur le déploiement d'applications basées sur des conteneurs avec votre pipeline, voir Tutoriel : déploiement continu avec. CodePipeline

     • Amazon ECS (bleu/vert)

       Entrez l' CodeDeploy application et le groupe de déploiement, la définition de la ECS tâche Amazon et les informations sur AppSpec le fichier, puis choisissez Next.

       Note

       L'action Amazon ECS (bleu/vert) nécessite un fichier imageDetail .json comme artefact d'entrée pour l'action de déploiement. Étant donné que l'action Amazon ECR source crée ce fichier, les pipelines dotés d'une action Amazon ECR source n'ont pas besoin de fournir de imageDetail.json fichier. Pour de plus amples informations, veuillez consulter imageDetailfichier .json pour les actions de déploiement ECS bleu/vert d'Amazon.

       Pour un didacticiel sur la création d'un pipeline pour les déploiements bleu-vert vers un ECS cluster Amazon avec CodeDeploy, consultez. Tutoriel : Création d'un pipeline avec une ECR source Amazon et déploiement en ECS vue d'un déploiement CodeDeploy

     • AWS Service Catalog

       Choisissez Enter deployment configuration (Entrer une configuration de déploiement) si vous souhaitez utiliser des champs dans la console pour spécifier votre configuration, ou choisissez Configuration file (Fichier de configuration) si vous disposez d'un fichier de configuration distinct. Entrez les informations sur le produit et la configuration, puis choisissez Suivant.

       Pour un didacticiel sur le déploiement des modifications apportées aux produits dans Service Catalog avec votre pipeline, consultezTutoriel : Création d'un pipeline à déployer sur Service Catalog.

     • Kit Alexa Skills

       Dans Alexa Skill ID (ID Alexa Skill), entrez l'ID de votre compétence Alexa. Dans Client ID et Client secret, entrez les informations d'identification générées à l'aide du profil de sécurité Login with Amazon (LWA). Dans Jeton d'actualisation, entrez le jeton d'actualisation que vous avez généré à l'aide de la ASK CLI commande de récupération d'un jeton d'actualisation. Choisissez Suivant.

       Pour un didacticiel sur le déploiement des compétences Alexa avec votre pipeline et la génération des LWA informations d'identification, consultezDidacticiel : Création d'un pipeline qui déploie un kit Amazon Alexa Skill.

     • Amazon S3

       Dans Bucket (Compartiment), entrez le nom du compartiment S3 que vous souhaitez utiliser. Choisissez Extraire le fichier avant le déploiement si l'artefact d'entrée de votre phase de déploiement est un ZIP fichier. Si l'option Extraire le fichier avant le déploiement est sélectionnée, vous pouvez éventuellement saisir une valeur pour le chemin de déploiement dans lequel votre ZIP fichier sera décompressé. Dans le cas contraire, vous devez saisir une valeur dans Clé d'objet S3.

       Note

       La plupart des artefacts source et des artefacts de sortie d'étape de génération sont compressés. Tous les fournisseurs de sources de pipeline, à l'exception d'Amazon S3, compressent vos fichiers source avant de les fournir comme artefact d'entrée pour l'action suivante.

       (Facultatif) Dans Canned ACL, entrez le ACL scan à appliquer à l'objet déployé sur Amazon S3.

       Note

       L'application d'un fichier ACL prédéfini remplace tout ce qui ACL est déjà appliqué à l'objet.

       (Facultatif) Dans Cache control (Contrôle de cache), spécifiez les paramètres de contrôle de cache pour les demandes pour télécharger des objets à partir du compartiment. Pour obtenir la liste des valeurs valides, consultez le champ Cache-Controld'en-tête pour les HTTP opérations. Pour entrer plusieurs valeurs dans Cache control (Contrôle de cache), utilisez une virgule entre chaque valeur. Vous pouvez ajouter un espace après chaque virgule (facultatif), comme illustré dans cet exemple.

       

       L'exemple d'entrée précédent est affiché CLI comme suit :

       "CacheControl": "public, max-age=0, no-transform"

       Choisissez Suivant.

       Pour un didacticiel sur la création d'un pipeline avec un fournisseur d'actions de déploiement Amazon S3, consultezTutoriel : Création d'un pipeline utilisant Amazon S3 comme fournisseur de déploiement.

2. Pour configurer l'étape pour une nouvelle tentative automatique, choisissez Activer la nouvelle tentative automatique en cas d'échec de l'étape. Pour plus d'informations sur la nouvelle tentative automatique, consultezConfiguration d'une étape pour une nouvelle tentative automatique en cas d'échec.

3. Pour configurer la phase de restauration automatique, choisissez Configurer la restauration automatique en cas d'échec de l'étape. Pour plus d'informations sur l'annulation automatique, consultezConfiguration d'une étape pour une annulation automatique.

4. Choisissez Next step (Étape suivante).

Étape 6 : Passez en revue le pipeline

• Sur la page Step 6: Review, passez en revue la configuration de votre pipeline, puis choisissez Create pipeline pour créer le pipeline ou Previous pour revenir en arrière et modifier votre choix. Pour quitter l'assistant sans créer de pipeline, choisissez Cancel.

Pour créer le fichier JSON

1. Sur un terminal (Linux, macOS ou Unix) ou à l'invite de commande (Windows), créez un nouveau fichier texte dans un répertoire local.

2. (Facultatif) Vous pouvez ajouter une ou plusieurs variables au niveau du pipeline. Vous pouvez référencer cette valeur dans la configuration des CodePipeline actions. Vous pouvez ajouter les noms et les valeurs des variables lorsque vous créez le pipeline, et vous pouvez également choisir d'attribuer des valeurs lorsque vous démarrez le pipeline dans la console.

   Note

   Bien qu'il soit facultatif d'ajouter des variables au niveau du pipeline, pour un pipeline spécifié avec des variables au niveau du pipeline pour lequel aucune valeur n'est fournie, l'exécution du pipeline échouera.

   Une variable au niveau du pipeline est résolue au moment de l'exécution du pipeline. Toutes les variables sont immuables, ce qui signifie qu'elles ne peuvent pas être mises à jour après l'attribution d'une valeur. Les variables au niveau du pipeline avec des valeurs résolues s'afficheront dans l'historique pour chaque exécution.

   Vous fournissez des variables au niveau du pipeline à l'aide de l'attribut variables de la structure du pipeline. Dans l'exemple suivant, la valeur de la variable Variable1 estValue1.

          "variables": [
               {
                   "name": "Timeout",
                   "defaultValue": "1000",
                   "description": "description"
               }
           ]

   Ajoutez cette structure à votre pipeline JSON ou à l'exemple JSON de l'étape suivante. Pour plus d'informations sur les variables, y compris les informations sur les espaces de noms, consultezRéférence aux variables.

3. Ouvrez le fichier dans un éditeur de texte brut et modifiez les valeurs pour refléter la structure que vous souhaitez créer. Vous devez au moins modifier le nom du pipeline. Vous devez également prendre en compte si vous souhaitez modifier :

   • Le compartiment S3 où les artefacts de ce pipeline sont stockés.

   • L'emplacement source de votre code.

   • Le fournisseur du déploiement.

   • Comment vous souhaitez que votre code soit déployé.

   • Les balises de votre pipeline.

   La structure du modèle de pipeline en deux étapes suivant met en évidence les valeurs que vous devez penser à modifier pour votre pipeline. Votre pipeline contient probablement plus de deux étapes :

   {
       "pipeline": {
           "roleArn": "arn:aws:iam::80398EXAMPLE::role/AWS-CodePipeline-Service",  
           "stages": [
               {
                   "name": "Source",
                   "actions": [
                       {
                           "inputArtifacts": [],
                           "name": "Source",
                           "actionTypeId": {
                               "category": "Source",
                               "owner": "AWS",
                               "version": "1",
                               "provider": "S3"
                           },
                           "outputArtifacts": [
                               {
                                   "name": "MyApp"
                               }
                           ],
                           "configuration": {
                               "S3Bucket": "amzn-s3-demo-source-bucket",
                               "S3ObjectKey": "ExampleCodePipelineSampleBundle.zip",
                               "PollForSourceChanges": "false"
                           },
                           "runOrder": 1                       
                       }
                   ]
               },
               {
                   "name": "Staging",
                   "actions": [
                       {
                           "inputArtifacts": [
                               {
                                   "name": "MyApp"
                               }
                           ],
                           "name": "Deploy-CodeDeploy-Application",
                           "actionTypeId": {
                               "category": "Deploy",
                               "owner": "AWS",
                               "version": "1",
                               "provider": "CodeDeploy"
                           },
                           "outputArtifacts": [],
                           "configuration": {
                               "ApplicationName": "CodePipelineDemoApplication",
                               "DeploymentGroupName": "CodePipelineDemoFleet"
                           },
                           "runOrder": 1
                       }
                   ]
               }
           ],
           "artifactStore": {
               "type": "S3",
               "location": "codepipeline-us-east-2-250656481468"
           },
           "name": "MyFirstPipeline",
           "version": 1,
           "variables": [
               {
                   "name": "Timeout",
                   "defaultValue": "1000",
                   "description": "description"
               }
             ]
           },
           "triggers": [
               {
                   "providerType": "CodeStarSourceConnection",
                   "gitConfiguration": {
                       "sourceActionName": "Source",
                       "push": [
                           {
                               "tags": {
                                   "includes": [
                                       "v1"
                                   ],
                                   "excludes": [
                                       "v2"
                                   ]
                               }
                           }
                       ]
                   }
               }
           ]
       "metadata": {
           "pipelineArn": "arn:aws:codepipeline:us-east-2:80398EXAMPLE:MyFirstPipeline",
           "updated": 1501626591.112,
           "created": 1501626591.112
       },
       "tags": [{
         "key": "Project",
         "value": "ProjectA"
       }]
   } 

   Cet exemple ajoute le balisage du pipeline en incluant la clé de balise Project et la valeur ProjectA sur le pipeline. Pour plus d'informations sur le balisage des ressources CodePipeline, consultezBalisage des ressources.

   Assurez-vous que le PollForSourceChanges paramètre de votre JSON fichier est défini comme suit :

                   "PollForSourceChanges": "false",

   CodePipeline utilise Amazon CloudWatch Events pour détecter les modifications apportées à votre référentiel CodeCommit source et à votre branche ou à votre compartiment source S3. L'étape suivante comporte les instructions de création de ces ressources pour votre pipeline. Vous pouvez définir l'indicateur sur false pour désactiver les vérifications périodiques, lesquelles ne sont pas nécessaires lorsque les méthodes de détection des modifications recommandées sont utilisées.

4. Pour créer une action de génération, de test ou de déploiement dans une région différente de celle de votre pipeline, vous devez ajouter les éléments suivants à la structure de votre pipeline. Pour obtenir des instructions, consultez Ajouter une action interrégionale dans CodePipeline.

   • Ajoutez le paramètre Region à la structure de pipeline de votre action.

   • Utilisez le artifactStores paramètre pour spécifier un compartiment d'artefacts pour chaque AWS région dans laquelle vous avez une action.

5. Une fois que vous êtes satisfait de sa structure, enregistrez votre fichier en lui attribuant un nom tel que pipeline.json.

Pour créer un pipeline

1. Exécutez la create-pipeline commande et utilisez le --cli-input-json paramètre pour spécifier le JSON fichier que vous avez créé précédemment.

   Pour créer un pipeline nommé MySecondPipeline avec un JSON fichier nommé pipeline.json qui inclut le nom »MySecondPipeline« comme valeur de name dans leJSON, votre commande ressemblerait à ce qui suit :

   aws codepipeline create-pipeline --cli-input-json file://pipeline.json

   Important

   N'oubliez pas d'inclure file:// devant le nom du fichier. Il est nécessaire dans cette commande.

   Cette commande renvoie la structure de l'ensemble du pipeline que vous avez créé.

2. Pour afficher le pipeline, ouvrez la CodePipeline console et choisissez-le dans la liste des pipelines, ou utilisez la get-pipeline-state commande. Pour de plus amples informations, veuillez consulter Afficher les pipelines et les détails dans CodePipeline.

3. Si vous utilisez le CLI pour créer un pipeline, vous devez créer manuellement les ressources de détection des modifications recommandées pour votre pipeline :

   • Pour un pipeline doté d'un CodeCommit référentiel, vous devez créer manuellement la règle CloudWatch Events, comme décrit dansCréation d'une EventBridge règle pour une CodeCommit source (CLI).

   • Pour un pipeline avec une source Amazon S3, vous devez créer manuellement la règle et le suivi des CloudWatch AWS CloudTrail événements, comme décrit dansConnexion aux actions source Amazon S3 qui utilisent EventBridge et AWS CloudTrail.

Étape 1 : Choisissez votre option de création

1. Connectez-vous à la CodePipeline console AWS Management Console et ouvrez-la à l'adresse http://console.aws.amazon. com/codesuite/codepipeline/home.

2. Sur la page Welcome (Bienvenue), choisissez Créer un pipeline.

   Si c'est la première fois que vous l'utilisez CodePipeline, choisissez Get Started.

3. Sur la page Étape 1 : Choisir une option de création, sous Options de création, choisissez l'option Créer un pipeline à partir d'un modèle. Choisissez Suivant.

Étape 2 : Choisissez le modèle

Choisissez un modèle pour créer un pipeline avec une phase de déploiement, une automatisation ou un pipeline CI.

1. Sur la page Étape 2 : Choisir un modèle, effectuez l'une des opérations suivantes, puis choisissez Suivant :

   • Choisissez Deployment si vous prévoyez de créer une phase de déploiement. Consultez les options pour les modèles déployés vers ECR ou CloudFormation. Pour cet exemple, choisissez Deployment, puis choisissez de déployer vers CloudFormation.

   • Choisissez Continuous Integration si vous envisagez de créer un pipeline CI. Consultez les options pour les pipelines CI, telles que la construction vers Gradle.

   • Choisissez Automation si vous envisagez de créer un pipeline automatisé. Consultez les options d'automatisation, telles que la planification d'une construction en python.

2. 
   
   

Étape 3 : Choisissez la source

• Sur la page Étape 3 : Choisir une source, dans Fournisseur de source, choisissez le fournisseur du référentiel dans lequel votre code source est stocké, spécifiez les options requises, puis choisissez Étape suivante.

  • Pour Bitbucket Cloud GitHub (version 2), GitHub Enterprise Server, GitLab .com ou en mode GitLab autogéré :

    1. Sous Connexion, choisissez une connexion existante ou créez-en une nouvelle. Pour créer ou gérer une connexion pour votre action GitHub source, consultezGitHub connexions.

    2. Choisissez le référentiel que vous souhaitez utiliser comme emplacement source pour votre pipeline.

       Choisissez d'ajouter un déclencheur ou de filtrer les types de déclencheurs pour démarrer votre pipeline. Pour plus d'informations sur l'utilisation des déclencheurs, consultezFiltrer les déclencheurs sur les requêtes push ou pull de code. Pour plus d'informations sur le filtrage à l'aide de modèles globulaires, consultezUtilisation de modèles globulaires dans la syntaxe.

    3. Dans Format d'artefact de sortie, choisissez le format de vos artefacts.

       • Pour stocker les artefacts de sortie de l' GitHub action à l'aide de la méthode par défaut, choisissez CodePipelinepar défaut. L'action accède aux fichiers depuis le GitHub référentiel et stocke les artefacts dans un ZIP fichier du magasin d'artefacts du pipeline.

       • Pour stocker un JSON fichier contenant une URL référence au référentiel afin que les actions en aval puissent exécuter directement les commandes Git, choisissez Full clone. Cette option ne peut être utilisée que par des actions CodeBuild en aval.

         Si vous choisissez cette option, vous devrez mettre à jour les autorisations associées à votre rôle de service de CodeBuild projet, comme indiqué dansRésolution des problèmes CodePipeline. Pour consulter un didacticiel expliquant comment utiliser l'option de clonage complet, voirTutoriel : Utiliser un clone complet avec une source de GitHub pipeline.

  • Pour Amazon ECR :

    • Dans Nom du référentiel, choisissez le nom de votre ECR référentiel Amazon.

    • Dans la balise Image, spécifiez le nom et la version de l'image, s'ils sont différents deLATEST.

    • Dans Artefacts de sortie, choisissez l'artefact de sortie par défaut, par exemple MyApp, qui contient le nom de l'image et les URI informations du référentiel que vous souhaitez utiliser à l'étape suivante.

    Lorsque vous incluez une étape ECR source Amazon dans votre pipeline, l'action source génère un imageDetail.json fichier en tant qu'artefact de sortie lorsque vous validez une modification. Pour de plus amples informations concernant le fichier imageDetail.json, veuillez consulter imageDetailfichier .json pour les actions de déploiement ECS bleu/vert d'Amazon.

  Note

  L'objet et le type de fichier doivent être compatibles avec le système de déploiement que vous prévoyez d'utiliser (par exemple, Elastic Beanstalk ou). CodeDeploy Les types de fichier .zip, .tar et .tgz peuvent être pris en charge. Pour plus d'informations sur les types de conteneurs pris en charge pour Elastic Beanstalk, consultez Personnalisation et configuration des environnements Elastic Beanstalk et des plateformes prises en charge. Pour plus d'informations sur le déploiement de révisions avec CodeDeploy, consultez les sections Chargement de la révision de votre application et Préparation d'une révision.

Étape 4 : Configuration du modèle

Pour cet exemple, le déploiement vers CloudFormation a été sélectionné. Au cours de cette étape, ajoutez la configuration de votre modèle.

1. À l'étape 4 : Configurer le modèle, dans Nom de la pile, entrez le nom de votre pipeline.

2. Modifiez la IAM politique relative aux espaces réservés pour les autorisations qui s'appliquent à votre modèle.

3. Choisissez Créer un pipeline à partir d'un modèle

4. Un message s'affiche indiquant que les ressources de votre pipeline sont en cours de création.

Étape 5 : Afficher le pipeline

• Maintenant que vous avez créé votre pipeline, vous pouvez le visualiser dans la CodePipeline console et voir le stack in AWS CloudFormation. Le pipeline commence à s'exécuter après sa création. Pour de plus amples informations, veuillez consulter Afficher les pipelines et les détails dans CodePipeline. Pour plus d'informations sur les modifications de votre pipeline, consultez Modifier un pipeline dans CodePipeline.