View a markdown version of this page

Créez une connexion avec GitHub - Console Outils pour développeur
Créer une connexion à GitHub (console)Créer une connexion à GitHub (CLI)

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 une connexion avec GitHub

Vous pouvez utiliser le Console de gestion AWS ou le AWS Command Line Interface (AWS CLI) pour créer une connexion à GitHub.

Avant de commencer :

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

  • Vous devez déjà avoir créé votre référentiel de code tiers.

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éer une connexion à GitHub (console)

Vous pouvez utiliser la console pour créer une connexion à GitHub.

Note

À compter du 1er juillet 2024, la console crée des connexions avec codeconnections l'ARN de la ressource. Les ressources avec les deux préfixes de service continueront à s'afficher dans la console.

  1. Connectez-vous au et ouvrez Console de gestion AWS la console Developer Tools à l'adressehttps://console.aws.amazon.com/codesuite/settings/connections.

  2. Choisissez Settings > Connections (Paramètres > Connexions), puis Create connection (Créer une connexion).

  3. Pour créer une connexion à un référentiel GitHub ou à un référentiel GitHub Enterprise Cloud, sous Sélectionnez un fournisseur, choisissez GitHub. Dans Connection name (Nom de la connexion), saisissez le nom de la connexion que vous souhaitez créer. Choisissez Se connecter à GitHub, puis passez à l'étape 2.

    Capture d'écran de la console montrant l'option de connexion sélectionnée pour Bitbucket.
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 (Se connecter à) GitHub. La page de demande d'accès s'affiche.

    Capture d'écran de la console montrant la page d'accès au GitHub compte.

  2. Choisissez Authorize AWS Connector pour GitHub. La page de connexion affiche et affiche le champ GitHub Apps.

    Capture d'écran de la console montrant la page de GitHub connexion initiale avec le champ GitHub Applications.

  3. Sous GitHub Applications, choisissez l'installation d'une application ou choisissez Installer une nouvelle application pour en créer une.

    Note

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

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

    Capture d'écran de la console montrant la page AWS Connector pour GitHub l'installation.
    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, conservez les valeurs par défaut et choisissez Installer.

    Capture d'écran de la console montrant le deuxième AWS connecteur pour la page GitHub d'installation.

    Après cette étape, une page d'autorisations mise à jour peut s'afficher dans GitHub.

  6. Si une page s'affiche indiquant que les autorisations ont été mises à jour pour le AWS Connector pour GitHub l'application, choisissez Accepter les nouvelles autorisations.

    Capture d'écran de la console montrant la page AWS Connector pour les autorisations GitHub mises à jour.

  7. Vous êtes redirigé vers la GitHub page Se connecter à. L'ID de connexion de votre nouvelle installation apparaît dans GitHub Apps. Choisissez Connect (Connexion).

Consultez votre connexion créée

  • La connexion créée s'affiche dans la liste des connexions.

    Capture d'écran de la console montrant la liste des connexions avec la connexion créée avec succès.

Créer une connexion à GitHub (CLI)

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

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 à l'aide de l'interface de ligne de commande CloudFormation, utilisez la console pour modifier la connexion afin de définir son étatAVAILABLE.

Pour créer une connexion avec GitHub

  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 codeconnections create-connection --provider-type GitHub --connection-name MyConnection

    En cas de succès, cette commande renvoie les informations ARN de connexion semblables à ce qui suit.

    {
    "ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
}

  2. Utilisez la console pour terminer la connexion. Pour de plus amples informations, veuillez consulter Mettre à jour une connexion en attente.