GitHub et accès au serveur d' GitHub entreprise dans CodeBuild

Pour créer une connexion avec GitHub

• Suivez les instructions du guide de l'utilisateur des outils de développement pour créer une connexion à GitHub.

Pour accorder l'accès aux IAM rôles CodeBuild du projet

1. Créez un IAM rôle pour votre CodeBuild projet en suivant les instructions correspondant CodeBuild Autoriser l'interaction avec d'autres AWS services à votre CodeBuild projet.

2. Tout en suivant les instructions, ajoutez la IAM politique suivante à votre rôle de CodeBuild projet pour autoriser l'accès à la connexion.

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "codeconnections:GetConnectionToken",
           "codeconnections:GetConnection"
         ],
         "Resource": [
           <connection-arn>
         ]
       }
     ]
   }

1. Dans le champ Source provider, sélectionnez GitHub.

2. Pour Credential, effectuez l'une des opérations suivantes :

   • Choisissez Informations d'identification source par défaut pour utiliser les informations d'identification source par défaut de votre compte pour les appliquer à tous les projets.

     1. Si vous n'êtes pas connecté à GitHub, choisissez Gérer les informations d'identification de source par défaut.

     2. Pour le type d'identifiant, choisissez jeton d'accès personnel.

     3. Si vous avez choisi Identifiant source par défaut, dans Service, choisissez le service que vous souhaitez utiliser pour stocker votre jeton et procédez comme suit :

        • Si vous choisissez d'utiliser Secrets Manager, vous pouvez choisir d'utiliser une connexion secrète existante ou de créer un nouveau secret et choisir Enregistrer. Pour plus d'informations sur la création d'un nouveau secret, consultezCréez et stockez un jeton dans un secret du Gestionnaire de Secrets.

        • Si vous choisissez de l'utiliser CodeBuild, entrez votre jeton d'accès GitHub personnel et choisissez Enregistrer.

   • Choisissez Identifiant source personnalisé pour utiliser un identifiant source personnalisé afin de remplacer les paramètres par défaut de votre compte.

     1. Pour le type d'identifiant, choisissez jeton d'accès personnel.

     2. Dans Connexion, choisissez d'utiliser une connexion secrète existante ou d'en créer une nouvelle.

1. Exécutez la commande import-source-credentials :

   aws codebuild import-source-credentials --generate-cli-skeleton

   JSON- les données formatées apparaissent dans la sortie. Copiez les données dans un fichier (par exemple,import-source-credentials.json) à un emplacement de l'ordinateur local ou de l'instance sur laquelle le AWS CLI est installé. Modifiez les données copiées comme suit, puis enregistrez vos résultats.

   {
       "serverType": "server-type",
       "authType": "auth-type",
       "shouldOverwrite": "should-overwrite",
       "token": "token",
       "username": "username"
       }

   Remplacez les éléments suivants :

   • server-type: valeur requise. Le fournisseur de source utilisé pour cette information d'identification. Les valeurs valides sont GITHUBBITBUCKET, GITHUB _ ENTERPRISEGITLAB, et GITLAB _ SELF _MANAGED.

   • auth-type: valeur requise. Type d'authentification utilisé pour se connecter à un référentiel. Les valeurs valides sont BASIC PERSONAL _ OAUTH AUTH TOKENCODECONNECTIONS, ACCESS _ _ et SECRETS _MANAGER. Car GitHub seul PERSONAL _ ACCESS _ TOKEN est autorisé. BASIC_ n'AUTHest autorisé qu'avec le mot de passe de l'application Bitbucket.

   • should-overwrite: valeur facultative. Définissez cette valeur sur false pour empêcher le remplacement des informations d'identification source du référentiel. Définissez cette valeur sur true pour remplacer les informations d'identification source du référentiel. La valeur par défaut est true.

   • token: valeur requise. Pour GitHub notre serveur d' GitHub entreprise, il s'agit du jeton d'accès personnel. Pour Bitbucket, il s'agit du jeton d'accès personnel ou du mot de passe de l'application. Pour le type d'authentificationCODECONNECTIONS, il s'agit de la connexion. ARN Pour le type d'authentification SECRETS _MANAGER, c'est le secret. ARN

   • username: valeur facultative. Ce paramètre est ignoré pour GitHub les fournisseurs de sources GitHub Enterprise Server.

2. Pour vous connecter à votre compte avec un jeton d'accès, passez au répertoire contenant le fichier import-source-credentials.json que vous avez enregistré à l'étape 1 et exécutez à nouveau la commande import-source-credentials.

   aws codebuild import-source-credentials --cli-input-json file://import-source-credentials.json

   JSON-les données formatées apparaissent dans la sortie avec un Amazon Resource Name ()ARN.

   {
       "arn": "arn:aws:codebuild:region:account-id:token/server-type"
       }

   Note

   Si vous exécutez la commande import-source-credentials avec le même type de serveur et de auth une seconde fois, le jeton d'accès stocké est mis à jour.

   Une fois que votre compte est connecté par un jeton d'accès, vous pouvez l'utiliser create-project pour créer votre CodeBuild projet. Pour de plus amples informations, veuillez consulter Création d'un projet de génération (AWS CLI).

3. Pour afficher les jetons d'accès connectés, exécutez la commande list-source-credentials.

   aws codebuild list-source-credentials

   Un sourceCredentialsInfos objet JSON formaté apparaît dans la sortie :

   {
           "sourceCredentialsInfos": [
               {
                   "authType": "auth-type",
                   "serverType": "server-type", 
                   "arn": "arn"
               }
           ]
       }
       

   Le sourceCredentialsObject contient la liste des informations d'identification de la source connectée :

   • L'élément authType est le type d'authentification utilisé par les informations d'identification. Cela peut être OAUTHBASIC_AUTH,PERSONAL_ACCESS_TOKEN,CODECONNECTIONS, ouSECRETS_MANAGER.

   • Le serverType est le type de fournisseur de source. Cela peut être GITHUBGITHUB_ENTERPRISE,BITBUCKET,GITLAB, ouGITLAB_SELF_MANAGED.

   • arnC'est ARN le jeton.

4. Pour vous déconnecter d'un fournisseur source et supprimer ses jetons d'accès, exécutez la delete-source-credentials commande avec sonARN.

   aws codebuild delete-source-credentials --arn arn-of-your-credentials

   JSON-les données formatées sont renvoyées avec l'une ARN des informations d'identification supprimées.

   {
       "arn": "arn:aws:codebuild:region:account-id:token/server-type"
       }

1. Dans le champ Source provider, sélectionnez GitHub.

2. Pour Credential, effectuez l'une des opérations suivantes :

   • Choisissez Informations d'identification source par défaut pour utiliser les informations d'identification source par défaut de votre compte pour les appliquer à tous les projets.

     1. Si vous n'êtes pas connecté à GitHub, choisissez Gérer les informations d'identification de source par défaut.

     2. Pour le type d'identifiant, choisissez OAuth.

     3. Si vous avez choisi Identifiant source par défaut, dans Service, choisissez le service que vous souhaitez utiliser pour stocker votre jeton et procédez comme suit :

        • Si vous choisissez d'utiliser Secrets Manager, vous pouvez choisir d'utiliser une connexion secrète existante ou de créer un nouveau secret et choisir Enregistrer. Pour plus d'informations sur la création d'un nouveau secret, consultezCréez et stockez un jeton dans un secret du Gestionnaire de Secrets.

        • Si vous choisissez de l'utiliser CodeBuild, continuez en choisissant Connect to GitHub.

   • Choisissez Identifiant source personnalisé pour utiliser un identifiant source personnalisé afin de remplacer les paramètres par défaut de votre compte.

     1. Pour le type d'identifiant, choisissez OAuth.

     2. Dans Connexion, choisissez d'utiliser une connexion secrète existante ou d'en créer une nouvelle.