Création d'une connexion à l' GitLabautogestion

Vous pouvez créer des connexions pour GitLab Enterprise Edition ou GitLab Community Edition avec une installation autogérée.

Vous pouvez utiliser le AWS Management Console ou le AWS Command Line Interface (AWS CLI) pour créer une connexion et un hôte à des fins d' GitLab autogestion.

Note

En autorisant cette application de connexion en mode GitLab autogérée, vous autorisez notre service à traiter vos données, et vous pouvez révoquer ces autorisations à tout moment en désinstallant l'application.

Avant de créer une connexion à GitLab Automanaged, vous devez créer un hôte à utiliser pour la connexion, comme indiqué dans ces étapes. Pour voir une présentation du flux de travail de création d’hôte pour les fournisseurs installés, consultez Flux de travail de création ou de mise à jour d’un hôte.

Vous pouvez éventuellement configurer votre hôte avec unVPC. Pour plus d'informations sur le réseau et VPC la configuration de votre ressource hôte, consultez les VPC conditions requises dans (Facultatif) Conditions préalables : VPC configuration réseau ou Amazon pour votre connexion etRésolution des problèmes VPC de configuration pour votre hôte.

Avant de commencer :

• Vous devez déjà avoir créé un compte GitLab et disposer de l'édition GitLab Enterprise ou de l'édition GitLab Community avec une installation autogérée. Pour plus d'informations, consultez https://docs.gitlab.com/ee/subscriptions/self_managed/.

  Note

  Les connexions fournissent uniquement l’accès au compte qui a été utilisé pour créer et autoriser la connexion.

  Note

  Vous pouvez créer des connexions à un référentiel dans lequel vous avez le rôle de propriétaire GitLab, puis la connexion peut être utilisée avec des ressources telles que CodePipeline. Pour les référentiels dans des groupes, il n'est pas nécessaire d'être le propriétaire du groupe.

• Vous devez déjà avoir créé un jeton d'accès GitLab personnel (PAT) avec l'autorisation limitée suivante uniquement : api. Pour plus d'informations, consultez le https://docs.gitlab.com/ee/fichier user/profile/personal_access_tokens.html. Vous devez être administrateur pour créer et utiliser lePAT.

  Note

  PATLe vôtre est utilisé pour autoriser l'hôte et n'est pas stocké ou utilisé par les connexions. Pour configurer un hôte, vous pouvez créer un hôte temporaire, PAT puis, une fois l'hôte configuré, vous pouvez le supprimerPAT.

Création d'une connexion à l' GitLab autogestion (console)

Suivez ces étapes pour créer un hôte et une connexion GitLab autogérés dans la console. Pour les considérations relatives à la configuration d'un hôte dans unVPC, voir(Facultatif) Conditions préalables : VPC configuration réseau ou Amazon pour votre connexion.

Note

À compter du 1er juillet 2024, la console crée des connexions avec codeconnections la ressourceARN. Les ressources associées aux deux préfixes de service continueront de s'afficher dans la console.

Note

Vous créez un hôte pour une seule installation GitLab autogérée, puis vous pouvez gérer une ou plusieurs connexions GitLab autogérées avec cet hôte.

Étape 1 : Créer votre hôte

1. Connectez-vous à AWS Management Console, puis ouvrez la console AWS Developer Tools à l'adressehttps://console.aws.amazon.com/codesuite/settings/connections.

2. Sur l'ongle Hosts (Hôtes), choisissez Create host (Créer un hôte).

3. Dans Host name (Nom d'hôte), saisissez le nom que vous souhaitez utiliser pour votre hôte.

4. Dans Sélectionnez un fournisseur, sélectionnez GitLabAutogéré.

5. Dans URL, entrez le point de terminaison de l'infrastructure sur laquelle votre fournisseur est installé.

6. Si votre serveur est configuré au sein d'un Amazon VPC et que vous souhaitez vous connecter à votreVPC, choisissez Utiliser un VPC. Sinon, choisissez NonVPC.

7. (Facultatif) Si vous avez lancé votre hôte sur un Amazon VPC et que vous souhaitez vous connecter à votre compteVPC, choisissez Utiliser un VPC et effectuez les opérations suivantes.

   1. Dans VPCID, choisissez votre VPC identifiant. Assurez-vous de choisir VPC l'infrastructure sur laquelle votre hôte est installé ou celle VPC avec accès à votre instance via VPN Direct Connect.

   2. Si vous avez VPC configuré un système privé et que vous avez configuré votre hôte pour effectuer la TLS validation à l'aide d'une autorité de certification non publique, entrez votre identifiant de TLScertificat dans le certificat. La valeur du TLS certificat est la clé publique du certificat.

8. Choisissez Create host (Créer un hôte).

9. Une fois la page des détails de l'hôte affichée, l'état de l'hôte change au fur et à mesure que l'hôte est créé.

   Note

   Si la configuration de votre hôte inclut une VPC configuration, prévoyez quelques minutes pour le provisionnement des composants du réseau hôte.

   Attendez que votre hôte atteigne l'état En attente, puis terminez la configuration. Pour de plus amples informations, veuillez consulter Configurer un hôte en attente.

   

Étape 2 : Configurer votre hôte en attente

1. Choisissez Configurer l’hôte.

2. Une mise en place host_nameles pages s'affichent. Dans Fournir un jeton d'accès personnel, GitLab PAT accordez uniquement l'autorisation limitée suivante :. api

   Note

   Seul un administrateur peut créer et utiliser lePAT.

   

3. Une fois votre hôte enregistré avec succès, la page des détails de l'hôte s'affiche et indique que l'état de l'hôte est Disponible.

   

Étape 3 : Créer votre connexion

1. Connectez-vous à AWS Management Console, puis ouvrez la console AWS Developer Tools à l'adressehttps://console.aws.amazon.com/codesuite/settings/connections.

2. Choisissez Paramètres, puis choisissez Connexions. Choisissez Créer une connexion.

3. Pour créer une connexion à un GitLab référentiel, sous Sélectionnez un fournisseur, choisissez GitLab Autogéré. Dans Connection name (Nom de la connexion), saisissez le nom de la connexion que vous souhaitez créer.

   

4. Dans URL, entrez le point de terminaison de votre serveur.

5. Si vous avez lancé votre serveur sur un Amazon VPC et que vous souhaitez vous connecter à votre compteVPC, choisissez Utiliser un VPC et effectuez les opérations suivantes.

   1. Dans VPCID, choisissez votre VPC identifiant. Assurez-vous de choisir VPC l'infrastructure sur laquelle votre hôte est installé ou celle VPC avec accès à votre hôte via VPN Direct Connect.

   2. Sous Subnet ID (ID de sous-réseau), choisissez Add (Ajouter). Dans le champ, choisissez l'ID de sous-réseau que vous souhaitez utiliser pour votre hôte. Vous pouvez choisir jusqu'à 10 sous-réseaux.

      Assurez-vous de choisir le sous-réseau de l'infrastructure sur laquelle votre hôte est installé ou un sous-réseau avec accès à votre hôte installé via Direct VPN Connect.

   3. Sous Groupe de sécurité IDs, choisissez Ajouter. Dans le champ, choisissez le groupe de sécurité que vous souhaitez utiliser pour votre hôte. Vous pouvez choisir jusqu'à 10 groupes de sécurité.

      Assurez-vous de choisir le groupe de sécurité pour l'infrastructure sur laquelle votre hôte est installé ou un groupe de sécurité ayant accès à votre hôte installé via VPN Direct Connect.

   4. Si vous avez VPC configuré un système privé et que vous avez configuré votre hôte pour effectuer la TLS validation à l'aide d'une autorité de certification non publique, entrez votre identifiant de TLScertificat dans le certificat. La valeur du TLS certificat doit être la clé publique du certificat.

6. Choisissez Connect to GitLab self-managed. La connexion créée s'affiche avec le statut En attente. Une ressource hôte est créée pour la connexion avec les informations de serveur que vous avez fournies. Pour le nom d'hôte, le URL est utilisé.

7. Choisissez Update pending connection (Mettre à jour la connexion en attente).

8. Lorsque la page de connexion GitLab s'affiche, connectez-vous avec vos informations d'identification, puis choisissez Se connecter.

9. Une page d'autorisation s'affiche avec un message demandant l'autorisation de connexion pour accéder à votre GitLab compte.

   Choisissez Authorize (Autoriser).

10. Le navigateur revient à la page de la console des connexions. Sous Créer une GitLab connexion, la nouvelle connexion est affichée dans Nom de la connexion.

11. Choisissez Connect to GitLab self-managed.

    Une fois la connexion créée avec succès, une bannière de réussite s'affiche. Les détails de la connexion sont affichés sur la page Paramètres de connexion.

Création d'une connexion à GitLab Self-managed () CLI

Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour créer un hôte et une connexion à des fins GitLab d'autogestion.

Pour ce faire, utilisez les commandes create-host et create-connection.

Important

Une connexion créée via le AWS CLI ou AWS CloudFormation est en PENDING état 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.

Étape 1 : Pour créer un hôte pour GitLab autogéré () CLI

1. Ouvrez une invite de terminal (Linux, macOS ou Unix) ou de commande (Windows). Utilisez le AWS CLI pour exécuter la create-host commande, en spécifiant le --name--provider-type, et --provider-endpoint pour votre connexion. Dans cet exemple, le nom du fournisseur tiers est GitLabSelfManaged et le point de terminaison est my-instance.dev.

   aws codeconnections create-host --name MyHost --provider-type GitLabSelfManaged --provider-endpoint "https://my-instance.dev"

   En cas de succès, cette commande renvoie les informations Amazon Resource Name (ARN) de l'hôte similaires aux suivantes.

   {
       "HostArn": "arn:aws:codeconnections:us-west-2:account_id:host/My-Host-28aef605"
   }

   Après cette étape, l'hôte présente l'état PENDING.

2. Utilisez la console pour terminer la configuration de l’hôte et le faire passer à l’état Available.

Étape 2 : Configurer un hôte en attente dans la console

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

2. Utilisez la console pour terminer la configuration de l'hôte et passer l'hôte vers l'état Available. Consultez Configurer un hôte en attente.

Étape 3 : Pour créer une connexion pour GitLab Self-managed () CLI

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 --host-arn et --connection-name pour votre connexion.

   aws codeconnections create-connection --host-arn arn:aws:codeconnections:us-west-2:account_id:host/MyHost-234EXAMPLE --connection-name MyConnection

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

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

2. Utilisez la console pour configurer la connexion en attente à l’étape suivante.

Étape 4 : Pour établir une connexion GitLab autogérée dans la console

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

2. Utilisez la console pour configurer la connexion en attente et la faire passer à l’état Available. Pour de plus amples informations, veuillez consulter Mettre à jour une connexion en attente.