View a markdown version of this page

Commencer avec CodePipeline - AWS CodePipeline

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.

Commencer avec CodePipeline

Si vous êtes nouveau dans ce CodePipeline domaine, vous pouvez suivre les didacticiels de ce guide après avoir suivi les étapes de configuration décrites dans ce chapitre.

La CodePipeline console inclut des informations utiles dans un panneau pliable que vous pouvez ouvrir à partir de l'icône d'informations ou de n'importe quel lien Info de la page. ( Image showing the lower-case letter i that is used as the console info icon ). Vous pouvez fermer ce panneau à tout moment.

La CodePipeline console permet également de rechercher rapidement vos ressources, telles que des référentiels, des projets de création, des applications de déploiement et des pipelines. Choisissez Go to ressource (Accéder aux ressources) ou appuyez sur la touche /, puis saisissez le nom de la ressource. Toutes les correspondances s'affichent dans la liste. Les recherches ne sont pas sensibles à la casse. Vous pouvez uniquement consulter les ressources que vous êtes autorisé à afficher. Pour de plus amples informations, veuillez consulter Affichage des ressources dans la console.

Avant de pouvoir l'utiliser AWS CodePipeline pour la première fois, vous devez créer votre propre utilisateur administratif Compte AWS et créer votre premier utilisateur administratif.

Inscrivez-vous pour Compte AWS

Pour commencer AWS, vous avez besoin d'un Compte AWS. Pour plus d'informations sur la création d'un Compte AWS, consultez la section Démarrage avec un Compte AWS dans le Guide de Gestion de compte AWS référence.

Appliquez une politique gérée pour l'accès administratif à CodePipeline

Vous devez accorder des autorisations pour interagir avec CodePipeline. Le moyen le plus rapide d'y parvenir est d'appliquer la politique AWSCodePipeline_FullAccess gérée à l'utilisateur administratif.

Note

La AWSCodePipeline_FullAccess politique inclut des autorisations qui permettent à l'utilisateur de la console de transmettre un rôle IAM à CodePipeline ou à un autre Services AWS. Cela autorise le service à assumer le rôle et à effectuer des actions en votre nom. Lorsque vous attachez la stratégie à un utilisateur, un rôle ou un groupe, les autorisations iam:PassRole sont appliquées. Assurez-vous que la stratégie est uniquement appliquée à des utilisateurs de confiance. Lorsque les utilisateurs disposant de ces autorisations utilisent la console pour créer ou modifier un pipeline, les options suivantes sont disponibles :

  • Créez un rôle CodePipeline de service ou choisissez-en un existant et transmettez-le à CodePipeline

  • Peut choisir de créer une règle d' CloudWatch événements pour la détection des modifications et de transmettre le rôle de service CloudWatch Events à CloudWatch Events

Pour plus d'informations, consultez la section Octroi à un utilisateur des autorisations lui permettant de transmettre un rôle à un Service AWS.

Note

La AWSCodePipeline_FullAccess politique donne accès à toutes les CodePipeline actions et ressources auxquelles l'utilisateur IAM a accès, ainsi qu'à toutes les actions possibles lors de la création d'étapes dans un pipeline, telles que la création d'étapes incluant CodeDeploy Elastic Beanstalk ou Amazon S3. La bonne pratique consiste à accorder aux personnes autorisées uniquement les autorisations dont elles ont besoin pour réaliser leur travail. Pour plus d'informations sur la manière de limiter les utilisateurs IAM à un ensemble limité d' CodePipeline actions et de ressources, consultezSupprimer les autorisations du rôle CodePipeline de service.

Pour activer l’accès, ajoutez des autorisations à vos utilisateurs, groupes ou rôles :

Installer la   AWS CLI

Pour appeler CodePipeline des commandes depuis la AWS CLI sur une machine de développement locale, vous devez installer la AWS CLI. Cette étape est facultative si vous avez l'intention de commencer en suivant uniquement les étapes de ce guide pour la CodePipeline console.

Pour installer et configurer AWS CLI
  1. Sur votre ordinateur local, téléchargez et installez le AWS CLI. Cela vous permettra d'interagir CodePipeline depuis la ligne de commande. Pour plus d'informations, consultez la section Configuration à l'aide de l'interface de ligne de AWS commande.

    Note

    CodePipeline fonctionne uniquement avec AWS CLI les versions 1.7.38 et ultérieures. Pour déterminer la version AWS CLI que vous avez peut-être installée, exécutez la commandeaws --version. Pour mettre à niveau une ancienne version AWS CLI vers la dernière version, suivez les instructions de la section Désinstaller le AWS CLI, puis suivez les instructions de la section Installation du AWS Command Line Interface.

  2. Configurez le AWS CLI avec la configure commande, comme suit :

    aws configure

    Lorsque vous y êtes invité, spécifiez la clé AWS d'accès et la clé d'accès AWS secrète de l'utilisateur IAM que vous allez utiliser avec CodePipeline. Lorsque vous êtes invité à saisir le nom de région par défaut, spécifiez la région dans laquelle vous allez créer le pipeline, par exempleus-east-2. Lorsque vous êtes invité à saisir le format de sortie par défaut, entrez json. Par exemple :

    AWS Access Key ID [None]: Type your target AWS access key ID here, and then press Enter AWS Secret Access Key [None]: Type your target AWS secret access key here, and then press Enter Default region name [None]: Type us-east-2 here, and then press Enter Default output format [None]: Type json here, and then press Enter
    Note

    Pour plus d'informations sur l'IAM, les clés d'accès et les clés secrètes, consultez les rubriques Gestion des clés d'accès pour les utilisateurs IAM et Comment obtenir des informations d'identification ? .

    Pour plus d'informations sur les régions et les points de terminaison disponibles CodePipeline, consultez la section AWS CodePipeline Points de terminaison et quotas.

Ouvrez la console pour CodePipeline

Étapes suivantes

Vous réunissez toutes les conditions prérequises. Vous pouvez commencer à utiliser CodePipeline. Pour commencer à utiliser CodePipeline consultez le CodePipeline tutoriels.