GitHub connexions - 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.

GitHub connexions

Vous utilisez les connexions pour autoriser et établir des configurations qui associent votre fournisseur tiers à vos AWS ressources.

Note

Cette fonctionnalité n'est pas disponible dans les régions Asie-Pacifique (Hong Kong), Asie-Pacifique (Hyderabad), Asie-Pacifique (Jakarta), Asie-Pacifique (Melbourne), Asie-Pacifique (Osaka), Afrique (Le Cap), Moyen-Orient (Bahreïn), Moyen-Orient (UAE), Europe (Espagne), Europe (Zurich), Israël (Tel Aviv) ou AWS GovCloud (USA Ouest). Pour faire référence aux autres actions disponibles, voirIntégrations de produits et de services avec CodePipeline. Pour les considérations relatives à cette action dans la région Europe (Milan), voir la note dansCodeStarSourceConnection pour Bitbucket Cloud GitHub, GitHub Enterprise Server, GitLab .com et les actions GitLab autogérées.

Pour ajouter une action source pour votre référentiel GitHub ou GitHub celui de votre référentiel Enterprise Cloud CodePipeline, vous pouvez choisir de :

Note

Vous pouvez également créer une connexion à l'aide de la console Developer Tools sous Paramètres. Voir Créer une connexion.

Avant de commencer :

  • Vous devez avoir créé un compte auprès de GitHub.

  • Vous devez déjà avoir créé un dépôt de GitHub code.

  • Si votre rôle de CodePipeline service a été créé avant le 18 décembre 2019, vous devrez peut-être mettre à jour ses autorisations à utiliser codestar-connections:UseConnection pour les AWS CodeStar connexions. Pour obtenir des instructions, consultez Ajout d'autorisations au rôle de service CodePipeline.

Note

Pour créer la connexion, vous devez être le propriétaire de GitHub l'organisation. Pour les référentiels qui ne font pas partie d'une organisation, vous devez être le propriétaire du référentiel.

Création d'une connexion à GitHub (console)

Suivez ces étapes pour utiliser la CodePipeline console afin d'ajouter une action de connexion pour votre référentiel GitHub ou GitHub celui d'Enterprise Cloud.

Note

Au cours de ces étapes, vous pouvez sélectionner des référentiels spécifiques sous Accès au référentiel. Les référentiels non sélectionnés ne seront ni accessibles ni visibles par CodePipeline.

Étape 1 : créer ou modifier votre pipeline

  1. Connectez-vous à la CodePipeline console.

  2. Choisissez l'une des options suivantes.

    • Choisissez de créer un pipeline. Suivez les étapes décrites dans Créer un pipeline pour terminer le premier écran et choisissez Next. Sur la page Source, sous Source Provider, sélectionnez GitHub (Version 2).

    • Choisissez de modifier un pipeline existant. Choisissez Modifier, puis sélectionnez Modifier l'étape. Choisissez d'ajouter ou de modifier votre action source. Sur la page Modifier l'action, sous Nom de l'action, entrez le nom de votre action. Dans Action provider, sélectionnez GitHub (Version 2).

  3. Effectuez l’une des actions suivantes :

    • Sous Connexion, si vous n'avez pas encore créé de connexion avec votre fournisseur, choisissez Se connecter à GitHub. Passez à l'étape 2 : créer une connexion à GitHub.

    • Sous Connexion, si vous avez déjà créé une connexion avec votre fournisseur, choisissez-la. Passez à l'étape 3 : enregistrer l'action source pour votre connexion.

Étape 2 : créer une connexion avec GitHub

Une fois que vous avez choisi de créer la connexion, la GitHub page Connect to apparaît.

Capture d'écran de la console montrant la page de GitHub connexion initiale.
Pour créer une connexion avec GitHub
  1. Dans les paramètres de GitHub connexion, le nom de votre connexion apparaît dans Nom de la connexion. Choisissez Connect to GitHub. La page de demande d'accès s'affiche.

  2. Choisissez Autoriser le AWS connecteur pour GitHub. La page de connexion affiche et affiche le champ GitHub Applications.

    Capture d'écran de la console montrant la page de GitHub connexion initiale avec le champ GitHub Apps.
  3. Sous GitHub Applications, choisissez une installation d'application ou choisissez Installer une nouvelle application pour en créer une.

    Installez une application pour toutes vos connexions à un fournisseur particulier. Si vous avez déjà installé le AWS Connector for GitHub app, choisissez-le et ignorez cette étape.

    Note

    Si vous souhaitez créer un jeton d'accès utilisateur, assurez-vous d'avoir déjà installé le AWS connecteur pour l' GitHub application, puis laissez le champ Installation de l'application vide. CodeConnections utilisera le jeton d'accès utilisateur pour la connexion.

  4. Sur la GitHub page Installer le AWS connecteur pour, choisissez le compte sur lequel vous souhaitez installer l'application.

    Note

    Vous n'installez l'application qu'une seule fois pour chaque GitHub compte. Si vous avez déjà installé l'application, vous pouvez choisir Configure (Configurer) pour passer à une page de modification pour l'installation de votre application, ou vous pouvez utiliser le bouton Précédent pour revenir à la console.

  5. Sur la GitHub page Installer le AWS connecteur pour, laissez les valeurs par défaut et choisissez Installer.

  6. Sur la GitHub page Connect to, l'ID de connexion de votre nouvelle installation apparaît dans GitHub Apps. Choisissez Se connecter.

Étape 3 : Enregistrez votre action GitHub source

Suivez ces étapes sur la page Modifier l'action pour enregistrer votre action source avec vos informations de connexion.

Pour enregistrer votre action GitHub source
  1. Dans Nom du référentiel, choisissez le nom de votre référentiel tiers.

  2. Sous Déclencheurs du pipeline, vous pouvez ajouter des déclencheurs si votre action est une CodeConnections action. Pour configurer la configuration des déclencheurs du pipeline et pour éventuellement filtrer à l'aide de déclencheurs, reportez-vous à la sectionFiltrer les déclencheurs sur les requêtes push ou pull de code.

  3. Dans Output artifact format (Format d'artefact de sortie), vous devez choisir le format de vos artefacts.

  4. Choisissez Suivant dans l'assistant ou Enregistrer sur la page d'action Modifier.

Création d'une connexion avec GitHub (CLI)

Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour créer une connexion.

Pour ce faire, utilisez la commande create-connection.

Important

Une connexion créée via le AWS CLI ou AWS CloudFormation est en PENDING statut par défaut. Après avoir créé une connexion avec le CLI ou AWS CloudFormation, utilisez la console pour modifier la connexion afin de définir son statutAVAILABLE.

Pour créer une connexion
  1. Ouvrez une invite de terminal (Linux, macOS ou Unix) ou de commande (Windows). Utilisez le AWS CLI pour exécuter la create-connection commande, en spécifiant le --provider-type et --connection-name pour votre connexion. Dans cet exemple, le nom du fournisseur tiers est GitHub et le nom de connexion spécifié est MyConnection.

    aws codestar-connections create-connection --provider-type GitHub --connection-name MyConnection

    En cas de succès, cette commande renvoie les ARN informations de connexion similaires aux suivantes.

    { "ConnectionArn": "arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f" }
  2. Utilisez la console pour terminer la connexion. Pour plus d'informations, voir Mettre à jour une connexion en attente.

  3. Le pipeline détecte par défaut les modifications lors de l'envoi du code vers le référentiel des sources de connexion. Pour configurer la configuration du déclencheur du pipeline pour le lancement manuel ou pour les balises Git, effectuez l'une des opérations suivantes :

    • Pour configurer la configuration du déclencheur du pipeline afin qu'elle commence par un déverrouillage manuel uniquement, ajoutez la ligne suivante à la configuration :

      "DetectChanges": "false",
    • Pour configurer la configuration des déclencheurs du pipeline afin de filtrer avec des déclencheurs, voir plus de détails dansFiltrer les déclencheurs sur les requêtes push ou pull de code. Par exemple, ce qui suit ajoute au niveau du pipeline de la JSON définition du pipeline. Dans cet exemple, release-v0 et release-v1 sont les balises Git à inclure et release-v2 les balises Git à exclure.

      "triggers": [ { "providerType": "CodeStarSourceConnection", "gitConfiguration": { "sourceActionName": "Source", "push": [ { "tags": { "includes": [ "release-v0", "release-v1" ], "excludes": [ "release-v2" ] } } ] } } ]