GitLab dans ChatGPT et Codex est actuellement en version bêta.
Présentation
Utilisez le modèle d’application GitLab autogérée pour créer une application en brouillon propre à un espace de travail pour une instance GitLab autogérée ou GitLab Dedicated. Fournissez le nom d’hôte GitLab et les identifiants de l’application OAuth, vérifiez l’application en brouillon, puis publiez-la pour les membres éligibles de l’espace de travail. Après sa publication, les actions activées de l’application sont disponibles dans les conversations ChatGPT et les sessions Codex.
Pour une présentation du comportement GitLab pris en charge, de la disponibilité, des autorisations, de l’utilisation des données et des exigences réseau, consultez : Connecter GitLab à ChatGPT et Codex.
Ce que vous configurez
Vous créez une application propre à l’espace de travail à partir du modèle d’application GitLab autogérée. L’application utilise :
Une application OAuth GitLab enregistrée sur votre hôte GitLab autogéré ou GitLab Dedicated.
L’ID de l’application et le secret OAuth GitLab pour l’autorisation des utilisateurs.
Les portées OAuth requises : api, write_repository et openid.
Votre nom d’hôte GitLab, par exemple gitlab.example.com, pour déterminer les points de terminaison Web, d’API, d’autorisation et de token.
Avant de commencer
Vous avez besoin des éléments suivants :
Un accès administrateur ou propriétaire à l’espace de travail ChatGPT.
L’autorisation GitLab de créer l’application OAuth : accès Propriétaire au groupe pour une application appartenant à un groupe, ou accès administrateur à l’instance pour une application à l’échelle de l’instance.
Uniquement le nom d’hôte GitLab, sans https://, port ni chemin. Utilisez un hôte GitLab autogéré ou GitLab Dedicated, et non gitlab.com.
Une décision concernant les actions GitLab que ChatGPT et Codex doivent prendre en charge, comme la recherche dans les dépôts, les workflows de demandes de fusion ou de tickets, la modification de fichiers ou des workflows Codex plus larges.
Gardez ChatGPT et GitLab ouverts dans des onglets distincts. Copiez exactement l’URI de redirection affichée dans ChatGPT ; ne la créez pas et ne la modifiez pas.
Valeurs à préparer
Nom d’hôte GitLab : par exemple, gitlab.example.com.
URI de redirection : copiez-la depuis le processus de configuration du modèle ChatGPT.
ID de l’application OAuth GitLab.
Secret OAuth GitLab.
Portées OAuth : copiez-les depuis le processus de configuration du modèle ChatGPT.
Start the template setup in ChatGPT
In ChatGPT, switch to the workspace where the app should be available.
Go to Workspace settings > Plugins.
In Directory, find GitLab, open its GitLab Self-Managed app template, and select Enable.
Enter a clear app name and description.
Enter the GitLab hostname, such as gitlab.example.com.
Copy the Redirect URI shown in ChatGPT, and keep this tab open.
Example: https://chatgpt.com/connector/oauth/<redirect_id>. Do not remove the redirect ID, add a trailing slash, or replace the URI with a generic ChatGPT URL.
Créer l’application OAuth GitLab dans GitLab
Choisir où créer l’application
Ouvrez votre hôte GitLab, par exemple https://gitlab.example.com.
Choisissez de créer une application à l’échelle de l’instance ou appartenant à un groupe. Ce choix détermine qui gère l’application ; l’accès aux projets reste soumis aux autorisations GitLab de l’utilisateur qui accorde l’autorisation et aux portées OAuth accordées.
Pour une application à l’échelle de l’instance, accédez à Administration > Applications. Pour une application appartenant à un groupe, accédez aux Paramètres > Applications du groupe.
Ajouter les détails de l’application
Sélectionnez Nouvelle application ou Ajouter une nouvelle application.
Saisissez un nom d’application explicite, tel que GitLab autogéré ou GitLab Dedicated.
Dans URI de redirection, collez l’URI exacte copiée depuis ChatGPT.
Laissez Confidentiel activé pour cette application OAuth côté serveur.
Configurer l’accès et enregistrer
Pour une application à l’échelle de l’instance, GitLab recommande de sélectionner Approuvée. Cela évite le prompt d’autorisation de l’utilisateur.
Sélectionnez les portées api, write_repository et openid.
Vérifiez qui peut gérer l’application et confirmez que les utilisateurs GitLab qui accordent l’autorisation disposent des autorisations appropriées sur les groupes et les projets.
Enregistrez l’application.
Exigences relatives aux portées OAuth
Le modèle demande les portées OAuth suivantes pour les actions GitLab activées dans ChatGPT et Codex :
api : requise pour les opérations de l’API GitLab exposées par l’application, notamment les actions liées aux demandes de fusion, aux tickets et au CI/CD.
write_repository : requise pour les opérations d’écriture dans les dépôts via Git.
openid : requise pour les informations d’identité et d’appartenance OpenID Connect.
Copier les identifiants OAuth GitLab
Dans l’application GitLab enregistrée, copiez l’ID de l’application et le secret. Traitez le secret comme un identifiant. S’il est exposé, renouvelez-le dans GitLab et créez une nouvelle application d’espace de travail.
Terminer la configuration dans ChatGPT
Revenez à l’onglet de configuration du modèle ChatGPT.
Collez l’ID de l’application GitLab dans ID client OAuth.
Collez le secret GitLab dans Secret client OAuth.
Vérifiez que le nom d’hôte GitLab contient uniquement le nom d’hôte, par exemple gitlab.example.com.
Sélectionnez Créer un brouillon.
Ouvrez les détails de l’application en brouillon et vérifiez Accès par rôle et Configurer les actions.
Publier et gérer l’application pour ChatGPT et Codex
La création de l’application en brouillon ne la rend pas automatiquement disponible aux membres. Après avoir vérifié le brouillon :
Sélectionnez Publier pour l’application en brouillon.
Accédez à Paramètres de l’espace de travail > Plugins et vérifiez que GitLab est disponible pour les rôles prévus.
Vérifiez l’Accès par rôle pour les rôles qui doivent utiliser l’application.
Dans Configurer les actions, vérifiez les actions de lecture et d’écriture disponibles.
Dans Configurer les approbations, choisissez quand les utilisateurs doivent approuver une action avant que ChatGPT ou Codex utilise l’application.
Demandez à un utilisateur test disposant d’un accès d’ouvrir GitLab depuis le Répertoire des plugins ou Paramètres > Plugins. Vérifiez que l’utilisateur peut installer le plugin et se connecter à l’application créée à partir du modèle GitLab autogéré.
Ces paramètres d’approbation de l’application s’appliquent aux conversations ChatGPT et aux fils Codex.
Configurer l’activité GitLab pour la revue de code Codex
Une fois l’application publiée, configurez l’activité GitLab dans Codex si vous prévoyez d’utiliser la revue de code Codex. Cette configuration de l’activité configure les événements webhook requis.
Ouvrez les paramètres des connecteurs Codex.
Configurez un compte de service pour l’espace de travail. Laissez Codex créer le compte ou fournissez un token d’accès personnel pour un compte de service existant.
Activez l’activité GitLab pour le projet ou l’un de ses groupes parents.
Si Codex doit exécuter des tâches de programmation ou utiliser une configuration propre au projet, créez un environnement de projet.
L’application GitLab utilise l’OAuth utilisateur pour les lectures et les actions activées dans ChatGPT et Codex. Pour les écritures de revue Codex sur GitLab autogéré ou GitLab Dedicated, le token du compte de service géré par l’espace de travail détermine l’identité et les projets sur lesquels Codex peut commenter ou réagir.
En savoir plus : Examiner les demandes de fusion GitLab avec Codex.
Connecter et tester l’application GitLab
En tant qu’utilisateur disposant d’un accès, ouvrez GitLab depuis le Répertoire des plugins ou Paramètres > Plugins. Sélectionnez Installer le plugin, puis Se connecter.
Si votre espace de travail comporte plusieurs applications GitLab, choisissez celle correspondant à cet hôte GitLab autogéré ou GitLab Dedicated.
Autorisez l’application OAuth GitLab lorsque vous y êtes invité.
Exécutez d’abord une petite action de lecture dans ChatGPT ou Codex, comme afficher les projets accessibles ou récupérer une demande de fusion connue.
Si les actions d’écriture sont activées, testez-les dans un projet à faible risque et dans chaque produit où vous prévoyez de les utiliser avant un déploiement plus large.
Nom d’hôte et comportement OAuth
L’application utilise le nom d’hôte pour déterminer les points de terminaison GitLab. Saisissez uniquement l’hôte, par exemple gitlab.example.com. N’incluez pas https://, un chemin d’API ou de dépôt, un port ni gitlab.com. Ce modèle est destiné à GitLab autogéré ou GitLab Dedicated. Pour GitLab.com (SaaS), utilisez l’application GitLab.
Résoudre les problèmes de configuration de l’application GitLab autogérée
URI de redirection non concordante : vérifiez que l’URI de redirection de l’application OAuth GitLab correspond exactement à celle affichée dans ChatGPT.
ChatGPT ne peut pas créer ou enregistrer l’application en brouillon : vérifiez que le nom d’hôte, l’ID de l’application, le secret et l’URI de redirection sont renseignés.
L’authentification réussit, mais les appels au projet échouent : vérifiez que l’utilisateur GitLab qui accorde l’autorisation peut accéder au projet et que l’application OAuth dispose des portées du modèle.
L’API renvoie une erreur 403 ou indique des autorisations insuffisantes : vérifiez que le compte GitLab connecté dispose des autorisations requises sur le projet ou le groupe et que l’application OAuth inclut les portées requises par le modèle.
Aucun projet n’est accessible : vérifiez que l’utilisateur a accès au projet, qu’il est connecté à l’instance GitLab prévue et qu’il a sélectionné la bonne application GitLab dans ChatGPT ou Codex.