Passer au contenu principal

​
Vue d’ensemble

Ce guide présente la configuration complète permettant d’intégrer une instance GitLab à Devin, y compris la configuration d’administration et la configuration utilisateur. L’intégration comporte deux parties :
  1. Configuration d’administration
    • Connecter l’instance GitLab auto-hébergée de l’organisation à Devin
    • Configurer un compte de service
    • Configurer l’accès aux dépôts
    • Enregistrer OAuth afin que les utilisateurs puissent lier leurs identités GitLab personnelles
  2. Configuration utilisateur
    • Lier le compte GitLab d’un utilisateur à son compte Devin
La configuration d’administration doit être terminée avant qu’un utilisateur puisse lier son compte GitLab. Seuls les administrateurs Enterprise peuvent effectuer les étapes de configuration d’administration.

​
Partie 1 : Configuration d’administration

​
Étape 1 : Créer un compte de service dans GitLab

Dans GitLab :
  1. Accédez au groupe GitLab approprié
  2. Accédez à Settings
  3. Ouvrez Service Accounts
  4. Créez un nouveau compte de service
Ce compte de service sera utilisé par Devin pour accéder aux dépôts dans GitLab.
Créer un compte de service dans GitLab

​
Étape 2 : Ajouter le compte de service comme membre du groupe

Toujours dans GitLab :
  1. Accédez à la page Membres du groupe
Page des membres du groupe GitLab
  1. Ajoutez le compte de service au groupe
  2. Accordez-lui le rôle Developer
C’est nécessaire pour que le compte de service puisse accéder correctement aux dépôts.

​
Étape 3 : Générer un jeton d’accès personnel pour le compte de service

Après avoir créé le compte de service :
  1. Repérez le compte de service que vous venez de créer
  2. Cliquez sur les trois points > Gérer les jetons d’accès > Générer un nouveau jeton d’accès personnel > sélectionnez api dans les périmètres d’accès
  3. Copiez ce jeton et conservez-le en lieu sûr
Assurez-vous de sélectionner le jeton du compte de service, et non votre jeton d’accès personnel situé dans les préférences de votre compte utilisateur. Devin doit agir en tant que compte de service, et non en votre nom. Vous utiliserez ce jeton lorsque vous ajouterez la connexion GitLab dans Devin.

​
Étape 4 : Ajouter la connexion GitLab dans Devin

Dans Devin :
  1. Accédez à Enterprise Settings
  2. Ouvrez Connections
  3. Ajoutez une nouvelle connexion
  4. Saisissez :
    • l’URL de votre instance GitLab auto-hébergée (le cas échéant)
Ajouter l’URL de connexion GitLab
  • le jeton d’accès personnel créé pour le compte de service
Cette opération crée la connexion GitLab au niveau de l’entreprise.

​
Étape 5 : Vérifier l’accès aux dépôts

Après avoir ajouté la connexion :
  1. Vérifiez que le compte de service a accès aux dépôts que vous souhaitez utiliser
  2. Dans Devin, si les dépôts n’apparaissent pas immédiatement, actualisez manuellement la liste des dépôts
  3. Accédez à Enterprise Repositories
  4. Sélectionnez l’organisation appropriée
Dépôts Enterprise
  1. Ouvrez Manage Permissions
  2. Ajoutez les dépôts concernés avec les autorisations lecture/écriture appropriées
Gérer les autorisations des dépôts
Si certains dépôts sont absents, c’est peut-être parce que Devin actualise la liste des dépôts périodiquement, et non instantanément.

​
Partie 2 : Activer l’association des utilisateurs pour GitLab auto-hébergé

​
Étape 6 : Enregistrer une application OAuth sur l’instance GitLab auto-hébergée

Pour permettre aux utilisateurs de lier leur identité GitLab à Devin, l’administrateur doit enregistrer une application OAuth pour l’instance GitLab auto-hébergée. Dans Devin :
  1. Accédez à la section de connexion GitLab de l’Enterprise
  2. Ouvrez Avancé
  3. Accédez à la section GitLab auto-hébergé
  4. Lancez le processus pour enregistrer une application OAuth
Cette étape permet l’association de comptes utilisateurs personnels.
Enregistrer une application OAuth

​
Étape 7 : Utiliser la procédure de configuration manuelle

Au cours de ce processus, plusieurs options de configuration peuvent être proposées. Pour la procédure manuelle dans l’interface utilisateur, suivez les instructions ci-dessous :
  • Utilisez directement l’interface GitLab pour créer l’application OAuth
Configuration manuelle d’OAuth

​
Étape 8 : Finaliser l’App Registration OAuth dans GitLab

Dans GitLab, lors de la création de l’application OAuth :
  1. Ouvrez la page d’enregistrement
  2. Vérifiez les paramètres de l’application
  3. Confirmez les paramètres requis, tels que :
    • Confidential (si déjà coché par défaut)
    • accès API / périmètre
  4. Enregistrez l’application
  5. Copiez l’ID d’application
  6. Copiez le secret de l’application
  7. Revenez dans Devin et saisissez ces valeurs aux emplacements demandés
Cela finalise la configuration côté administrateur nécessaire pour lier l’identité des utilisateurs.

​
Partie 3 : Condition d’appartenance à l’organisation

​
Étape 9 : Assurez-vous que l’utilisateur appartient à la bonne organisation Devin

Avant de pouvoir lier son compte GitLab, l’utilisateur doit être membre d’une organisation Devin disposant des autorisations sur les dépôts GitLab. Dans Devin :
  1. Accédez à la section d’appartenance à l’organisation
  2. Vérifiez que l’utilisateur fait partie d’une organisation Devin disposant des autorisations sur les dépôts GitLab
  3. Sinon, ajoutez-le d’abord
Personal Connections n’affiche que les intégrations des organisations auxquelles l’utilisateur appartient. Si un utilisateur ne fait pas partie d’une organisation Devin disposant des autorisations sur les dépôts GitLab, l’intégration GitLab peut ne pas apparaître du tout.

​
Partie 4 : Configuration des utilisateurs finaux

​
Étape 10 : Ouvrir Personal Connections

En tant qu’utilisateur final de Devin :
  1. Accédez à Personal Connections
  2. Recherchez l’intégration GitLab auto-hébergée
Si elle n’apparaît pas, vérifiez d’abord que vous faites bien partie de l’organisation.
Une fois que l’intégration apparaît :
  1. Sélectionnez la connexion GitLab auto-hébergée
  2. Suivez la procédure d’association
  3. Associez le compte GitLab de l’utilisateur à son compte Devin
Après cela, Devin devrait pouvoir agir au nom de cet utilisateur pour les opérations GitLab.