View a markdown version of this page

Création d'une connexion à l' GitLab autogestion - Console Outils pour développeur
Création d'une connexion à GitLab Self-managed (console)Création d'une connexion à l' GitLab autogestion (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éation d'une connexion à l' GitLab autogestion

Vous pouvez créer des connexions pour GitLab Enterprise Edition ou GitLab Community Edition à l'aide d'une installation autogérée.

Vous pouvez utiliser le Console de gestion AWS ou le AWS Command Line Interface (AWS CLI) pour créer une connexion et un hôte pour l' GitLab autogestion.

Note

En autorisant cette application de connexion en mode GitLab autogéré, vous accordez à notre service les autorisations nécessaires pour 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 Self-managed, 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 un VPC. Pour plus d’informations sur la configuration réseau et de VPC pour votre ressource hôte, consultez les prérequis pour les VPC dans (Facultatif) Prérequis : configuration réseau ou d’Amazon VPC pour votre connexion et Résolution des problèmes liés à la configuration d'un VPC pour votre hôte.

Avant de commencer :

  • Vous devez déjà avoir créé un compte GitLab et disposer GitLab d'Enterprise Edition ou GitLab Community Edition avec une installation autogérée. Pour de plus amples informations, veuillez consulter 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 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 le api scope. Si le mode Admin est activé sur votre GitLab instance, le PAT doit également inclure la admin_mode portée. Pour plus d'informations, consultez les sections Jetons d'accès personnels et Champs d'application des jetons d'accès sur le GitLab site Web. Vous devez être administrateur pour créer et utiliser le PAT.

    Note

    Votre PAT est utilisé pour autoriser l’hôte et n’est pas stocké ni utilisé par les connexions à d’autres fins. Pour configurer un hôte, vous pouvez créer un PAT temporaire, puis, une fois l’hôte configuré, vous pouvez le supprimer.

Note

Pour les organisations qui GitHub utilisent Enterprise Server ou qui GitLab sont autogérées, vous ne transmettez pas d'hôte disponible. Vous créez un nouvel hôte pour chaque connexion de votre organisation et vous devez vous assurer de saisir les mêmes informations dans les champs réseau (ID VPC, ID de sous-réseau et ID de groupe de sécurité) de l'hôte. Pour de plus amples informations, veuillez consulter Configuration de la connexion et de l'hôte pour les fournisseurs installés qui soutiennent les organisations.

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

Procédez comme suit pour créer un hôte et une connexion à GitLab Self-Managed dans la console. Pour voir les considérations relatives à la configuration d’un hôte dans un VPC, consultez (Facultatif) Prérequis : configuration réseau ou d’Amazon VPC pour votre connexion.

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.

Note

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

Étape 1 : Créer votre hôte

  1. Connectez-vous au Console de gestion AWS, 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, choisissez GitLab Autogéré.

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

  6. Si votre serveur est configuré dans un VPC Amazon et que vous souhaitez vous connecter à votre VPC, choisissez Use a VPC (Utiliser un VPC). Sinon, choisissez No VPC.

  7. (Facultatif) Si vous avez lancé votre hôte dans un VPC Amazon et que vous souhaitez vous connecter avec votre VPC, choisissez Utiliser un VPC et procédez comme suit.

    Note

    Pour les organisations qui GitHub utilisent Enterprise Server ou qui GitLab sont autogérées, vous ne transmettez pas d'hôte disponible. Vous créez un nouvel hôte pour chaque connexion de votre organisation et vous devez vous assurer de saisir les mêmes informations dans les champs réseau (ID VPC, ID de sous-réseau et ID de groupe de sécurité) de l'hôte. Pour de plus amples informations, veuillez consulter Configuration de la connexion et de l'hôte pour les fournisseurs installés qui soutiennent les organisations.

    1. Dans ID du VPC, choisissez votre ID de VPC. Veillez à choisir le VPC de l’infrastructure sur laquelle votre hôte est installé ou un VPC qui a accès à votre instance via VPN ou Direct Connect.

    2. Si vous avez configuré un VPC privé et que vous avez configuré votre hôte pour effectuer la validation TLS à l’aide d’une autorité de certification non publique, dans Certificat TLS, saisissez votre ID de certificat. La valeur du certificat TLS 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 configuration VPC, prévoyez plusieurs minutes pour l'approvisionnement 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.

    Capture d'écran de la console montrant les détails de l'hôte GitLab autogéré avec l'hôte en statut En attente.
Étape 2 : Configurer votre hôte en attente

  1. Choisissez Configurer l’hôte.

  2. Une host_name page de configuration s'affiche. Dans Fournir un jeton d'accès personnel, fournissez le api scope à votre GitLab PAT. Si le mode Admin est activé sur votre GitLab instance, le PAT doit également inclure la admin_mode portée. Pour plus d'informations, consultez la section Portées des jetons d'accès sur le GitLab site Web.

    Note

    Seul un administrateur peut créer et utiliser le PAT.

    Capture d'écran de la console montrant la saisie du jeton d'accès GitLab personnel pour le nouvel hôte

  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.

    Capture d’écran de la console montrant l’état disponible du nouvel hôte
Étape 3 : Créer votre connexion

  1. Connectez-vous au Console de gestion AWS, 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.

    Capture d'écran de la console montrant l'option de connexion sélectionnée pour GitLab l'autogestion.

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

  5. Si vous avez lancé votre serveur dans un VPC Amazon et que vous souhaitez vous connecter à votre VPC, choisissez Use a VPC (Utilisation d'un VPC) et complétez ce qui suit.

    1. Dans ID du VPC, choisissez votre ID de VPC. Veillez à choisir le VPC de l’infrastructure sur laquelle votre hôte est installé ou un VPC qui a accès à votre hôte via VPN ou 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.

      Veillez à choisir le sous-réseau de l’infrastructure sur laquelle votre hôte est installé ou un sous-réseau qui a accès à votre hôte installé via VPN ou Direct Connect.

    3. Sous Security group IDs (ID de groupe de sécurité), choisissez Add (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é.

      Veillez à choisir le groupe de sécurité de l’infrastructure sur laquelle votre hôte est installé ou un groupe de sécurité qui a accès à votre hôte installé via VPN ou Direct Connect.

    4. Si vous avez configuré un VPC privé et que vous avez configuré votre hôte pour effectuer la validation TLS à l’aide d’une autorité de certification non publique, dans Certificat TLS, saisissez votre ID de certificat. La valeur du certificat TLS doit être la clé publique du certificat.

  6. Choisissez Se connecter à l' GitLab autogestion. 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, l'URL est utilisée.

  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 pour la connexion d'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 Se connecter à l' GitLab autogestion.

    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 à l' GitLab autogestion (CLI)

Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour créer un hôte et une connexion pour l' GitLabautogestion.

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

Étape 1 : Pour créer un hôte pour l' GitLab autogestion (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) hôte semblables à ce qui suit.

    {
    "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 à Console de gestion AWS et ouvrez la console Developer Tools à 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 l' GitLab autogestion (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 informations ARN de connexion semblables à ce qui suit.

    {
    "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 à Console de gestion AWS et ouvrez la console Developer Tools à 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.