O GitLab no ChatGPT e no Codex encontra-se atualmente em versão beta.
Visão geral
Utilize o modelo de aplicação GitLab Self-Managed para criar um rascunho de aplicação específico do espaço de trabalho para uma instância do GitLab Self-Managed ou do GitLab Dedicated. Forneça o nome do anfitrião do GitLab e as credenciais da aplicação OAuth, reveja o rascunho da aplicação e publique-o para os membros elegíveis do espaço de trabalho. Após a publicação, as ações ativadas da aplicação ficam disponíveis nas conversas do ChatGPT e nas sessões do Codex.
Para uma visão geral das funcionalidades suportadas do GitLab, da disponibilidade, das permissões, da utilização de dados e dos requisitos de rede, consulte: Ligar o GitLab ao ChatGPT e ao Codex.
O que está a configurar
Está a criar uma aplicação específica do espaço de trabalho a partir do modelo de aplicação GitLab Self-Managed. A aplicação utiliza:
Uma aplicação OAuth do GitLab registada no seu anfitrião GitLab Self-Managed ou GitLab Dedicated.
O ID da aplicação e o Segredo OAuth do GitLab para autorização do utilizador.
Os âmbitos OAuth necessários: api, write_repository e openid.
O nome do anfitrião do GitLab, como gitlab.example.com, para determinar os endpoints web, de API, de autorização e de token.
Antes de começar
Precisa de:
Acesso de administrador ou proprietário do espaço de trabalho do ChatGPT.
Permissão no GitLab para criar a aplicação OAuth: acesso de Proprietário do grupo para uma aplicação pertencente a um grupo, ou acesso de administrador da instância para uma aplicação que abranja toda a instância.
Apenas o nome do anfitrião do GitLab, sem https://, porta ou caminho. Utilize um anfitrião GitLab Self-Managed ou GitLab Dedicated, não gitlab.com.
Uma decisão sobre as ações do GitLab que o ChatGPT e o Codex devem suportar, como pesquisa em repositórios, fluxos de trabalho de pedidos de integração, fluxos de trabalho de issues, edição de ficheiros ou fluxos de trabalho mais abrangentes do Codex.
Mantenha o ChatGPT e o GitLab abertos em separadores distintos. Copie o URI de redirecionamento exato apresentado no ChatGPT; não o crie nem o altere.
Para abrir a página Aplicações a partir da Consola de administração, selecione o espaço de trabalho do ChatGPT pretendido, abra Plugins e selecione Gerir aplicações legadas.
Valores a preparar
Nome do anfitrião do GitLab: por exemplo, gitlab.example.com.
URI de redirecionamento: copie-o do processo de configuração do modelo no ChatGPT.
ID da aplicação OAuth do GitLab.
Segredo OAuth do GitLab.
Âmbitos OAuth: copie-os do processo de configuração do modelo no ChatGPT.
Start the template setup in ChatGPT
In ChatGPT, switch to the workspace where the app should be available.
Go to Workspace settings > Apps.
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.
Criar a aplicação OAuth do GitLab no GitLab
Escolher onde criar a aplicação
Aceda ao seu anfitrião GitLab, como https://gitlab.example.com.
Escolha se pretende criar uma aplicação para toda a instância ou uma aplicação pertencente a um grupo. Esta escolha determina quem gere a aplicação; o acesso aos projetos continua a depender das permissões no GitLab do utilizador que concede autorização e dos âmbitos OAuth concedidos.
Para uma aplicação que abranja toda a instância, aceda a Administração > Aplicações. Para uma aplicação pertencente a um grupo, aceda a Definições > Aplicações do grupo.
Adicionar os detalhes da aplicação
Selecione Nova aplicação ou Adicionar nova aplicação.
Introduza um nome claro para a aplicação, como GitLab Self-Managed ou GitLab Dedicated.
Em URI de redirecionamento, cole o URI exato copiado do ChatGPT.
Mantenha a opção Confidencial ativada para esta aplicação OAuth do lado do servidor.
Configurar o acesso e guardar
Para uma aplicação que abranja toda a instância, o GitLab recomenda selecionar Fidedigna. Desta forma, não é apresentado o pedido de autorização ao utilizador.
Selecione os âmbitos api, write_repository e openid.
Reveja quem pode gerir a aplicação e confirme que os utilizadores do GitLab que concedem autorização têm as permissões de grupo e de projeto adequadas.
Guarde a aplicação.
Requisitos de âmbitos OAuth
O modelo solicita os seguintes âmbitos OAuth para as ações do GitLab ativadas no ChatGPT e no Codex:
api: necessário para as operações da API do GitLab disponibilizadas pela aplicação, incluindo ações de pedidos de integração, issues e CI/CD.
write_repository: necessário para operações de escrita no repositório através do Git.
openid: necessário para informações de identidade e de pertença a grupos do OpenID Connect.
Copiar as credenciais OAuth do GitLab
Na aplicação GitLab guardada, copie o ID da aplicação e o Segredo. Trate o Segredo como uma credencial. Se for exposto, renove-o no GitLab e crie uma nova aplicação no espaço de trabalho.
Concluir a configuração no ChatGPT
Volte ao separador de configuração do modelo no ChatGPT.
Cole o ID da aplicação do GitLab em ID de cliente OAuth.
Cole o Segredo do GitLab em Segredo de cliente OAuth.
Confirme que o campo do nome do anfitrião do GitLab contém apenas o nome do anfitrião, como gitlab.example.com.
Selecione Criar rascunho.
Abra os detalhes do rascunho da aplicação e reveja Acesso por função e Configurar ações.
Publicar e gerir a aplicação para o ChatGPT e o Codex
Criar o rascunho da aplicação não a disponibiliza automaticamente aos membros. Depois de rever o rascunho:
Selecione Publicar no rascunho da aplicação.
Aceda à Consola de administração, selecione o espaço de trabalho do ChatGPT pretendido e abra Plugins. Em seguida, confirme que o GitLab está disponível para as funções pretendidas.
Reveja o Acesso por função para as funções que devem utilizar a aplicação.
Em Configurar ações, reveja as ações de leitura e escrita disponíveis.
Em Configurar aprovações, escolha quando os utilizadores têm de aprovar uma ação antes de o ChatGPT ou o Codex utilizar a aplicação.
Peça a um utilizador de teste com acesso que abra o GitLab a partir do Diretório de plugins ou de Definições > Plugins. Confirme que o utilizador consegue instalar o plugin e ligar-se à aplicação criada a partir do modelo GitLab Self-Managed.
Estas definições de aprovação da aplicação aplicam-se às conversas do ChatGPT e às threads do Codex.
Configurar a atividade do GitLab para a revisão de código do Codex
Depois de publicar a aplicação, configure a atividade do GitLab no Codex se pretender utilizar a revisão de código do Codex. Esta configuração da atividade define os eventos de webhook necessários.
Abra as definições de conectores do Codex.
Configure uma conta de serviço do espaço de trabalho. Deixe o Codex criar a conta ou forneça um token de acesso pessoal de uma conta de serviço existente.
Ative a Atividade do GitLab para o projeto ou para um dos seus grupos ascendentes.
Se o Codex precisar de executar tarefas de programação ou de utilizar uma configuração específica do projeto, crie um ambiente de projeto.
A aplicação GitLab utiliza o OAuth do utilizador para leituras e ações ativadas no ChatGPT e no Codex. Nas operações de escrita de revisões do Codex no GitLab Self-Managed ou no GitLab Dedicated, o token da conta de serviço gerida pelo espaço de trabalho determina a identidade e os projetos em que o Codex pode comentar ou reagir.
Saiba mais: Rever pedidos de integração do GitLab com o Codex.
Ligar e testar a aplicação GitLab
Com uma conta de utilizador com acesso, abra o GitLab a partir do Diretório de plugins ou de Definições > Plugins. Selecione Instalar plugin e, em seguida, Ligar.
Se o seu espaço de trabalho tiver mais de uma aplicação GitLab, escolha a aplicação para este anfitrião GitLab Self-Managed ou GitLab Dedicated.
Autorize a aplicação OAuth do GitLab quando lhe for solicitado.
Comece por executar uma ação de leitura simples no ChatGPT ou no Codex, como listar projetos acessíveis ou obter um pedido de integração conhecido.
Se as ações de escrita estiverem ativadas, teste-as num projeto de baixo risco e em cada produto em que pretenda utilizá-las antes de alargar a sua utilização.
Nome do anfitrião e funcionamento do OAuth
A aplicação utiliza o nome do anfitrião para determinar os endpoints do GitLab. Introduza apenas o nome do anfitrião, como gitlab.example.com. Não inclua https://, um caminho de API ou de repositório, uma porta ou gitlab.com. Este modelo destina-se ao GitLab Self-Managed ou ao GitLab Dedicated. Para o GitLab.com (SaaS), utilize a aplicação GitLab.
Resolver problemas de configuração da aplicação GitLab Self-Managed
O URI de redirecionamento não corresponde: confirme que o URI de redirecionamento da aplicação OAuth do GitLab corresponde exatamente ao URI de redirecionamento apresentado no ChatGPT.
O ChatGPT não consegue criar ou guardar o rascunho da aplicação: confirme que o nome do anfitrião, o ID da aplicação, o Segredo e o URI de redirecionamento estão preenchidos.
A autenticação é bem-sucedida, mas as chamadas ao projeto falham: confirme que o utilizador do GitLab que concede autorização tem acesso ao projeto e que a aplicação OAuth tem os âmbitos do modelo.
A API devolve 403 ou permissões insuficientes: confirme que a conta GitLab ligada tem as permissões de projeto ou de grupo necessárias e que a aplicação OAuth inclui os âmbitos exigidos pelo modelo.
Nenhum projeto está acessível: confirme que o utilizador tem acesso aos projetos, está ligado à instância do GitLab pretendida e selecionou a aplicação GitLab correta no ChatGPT ou no Codex.