> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integração com o GitLab autogerenciado

> Conecte o Devin à sua instância autogerenciada do GitLab

<div id="overview">
  ## Visão geral
</div>

Este guia apresenta a configuração completa para integrar uma **instância do GitLab** ao Devin, incluindo tanto a **configuração do administrador** quanto a **configuração do usuário final**.

A integração tem duas partes:

1. **Configuração do administrador**
   * Conectar a instância auto-hospedada do GitLab da organização ao Devin
   * Configurar uma conta de serviço
   * Configurar o acesso ao repositório
   * Registrar o OAuth para que os usuários possam vincular suas contas pessoais do GitLab
2. **Configuração do usuário**
   * Vincular a conta do GitLab de um usuário à sua conta do Devin

<Note>
  A configuração do administrador deve ser concluída antes que qualquer usuário possa vincular sua conta do GitLab. Somente admins do Enterprise podem executar as etapas de configuração do administrador.
</Note>

***

<div id="part-1-admin-setup">
  ## Parte 1: Configuração do administrador
</div>

<div id="step-1-create-a-service-account-in-gitlab">
  ### Etapa 1: Criar uma conta de serviço no GitLab
</div>

No GitLab:

1. Acesse o **grupo do GitLab** correto
2. Vá para **Configurações**
3. Abra **Service Accounts**
4. Crie uma nova conta de serviço

Essa é a conta de serviço que o Devin usará para acessar repositórios no GitLab.

<Frame>
  <img src="https://mintcdn.com/cognitionai/AnsrXvUO6uX9lwu8/images/enterprise/gitlab/gitlab-create-service-account.png?fit=max&auto=format&n=AnsrXvUO6uX9lwu8&q=85&s=e81fed639122165593233b0e2e959318" alt="Criar conta de serviço no GitLab" width="3158" height="1980" data-path="images/enterprise/gitlab/gitlab-create-service-account.png" />
</Frame>

***

<div id="step-2-add-the-service-account-as-a-group-member">
  ### Etapa 2: Adicione a conta de serviço como membro do grupo
</div>

Ainda no GitLab:

1. Acesse a página **Members** do grupo

<Frame>
  <img src="https://mintcdn.com/cognitionai/AnsrXvUO6uX9lwu8/images/enterprise/gitlab/gitlab-group-members.png?fit=max&auto=format&n=AnsrXvUO6uX9lwu8&q=85&s=8a205b2d0ea97565ec9e4dbaca80ad87" alt="Página de membros do grupo no GitLab" width="894" height="1156" data-path="images/enterprise/gitlab/gitlab-group-members.png" />
</Frame>

2. Adicione a conta de serviço como membro do grupo
3. Atribua a ela a função **Developer**

Isso é necessário para que a conta de serviço possa acessar os repositórios corretamente.

***

<div id="step-3-generate-a-personal-access-token-for-the-service-account">
  ### Etapa 3: Gere um token de acesso pessoal para a conta de serviço
</div>

Após criar a conta de serviço:

1. Localize a conta de serviço recém-criada
2. Clique nos três pontos > **Gerenciar tokens de acesso** > **Gerar um novo token de acesso pessoal** > selecione **api** nos escopos de acesso
3. Copie e armazene esse token em segurança

<Note>
  Certifique-se de selecionar o token da conta de serviço, e não o seu token de acesso pessoal, encontrado nas preferências do usuário. O objetivo é que o Devin atue como a conta de serviço, e não como você. Você usará esse token ao adicionar a conexão do GitLab no Devin.
</Note>

***

<div id="step-4-add-the-gitlab-connection-in-devin">
  ### Etapa 4: Adicione a conexão do GitLab no Devin
</div>

No Devin:

1. Acesse **Configurações Enterprise**
2. Abra **Conexões**
3. Adicione uma nova conexão
4. Insira:
   * A **URL do GitLab auto-hospedado** (se aplicável)

<Frame>
  <img src="https://mintcdn.com/cognitionai/AnsrXvUO6uX9lwu8/images/enterprise/gitlab/gitlab-add-connection.png?fit=max&auto=format&n=AnsrXvUO6uX9lwu8&q=85&s=e7425687734160e1004131a22b9d1d14" alt="Adicionar URL da conexão do GitLab" width="3160" height="1970" data-path="images/enterprise/gitlab/gitlab-add-connection.png" />
</Frame>

* O **token de acesso pessoal** criado para a conta de serviço

Isso cria a conexão Enterprise do GitLab.

***

<div id="step-5-configure-webhook">
  ### Etapa 5: Configurar Webhook
</div>

Configurar um webhook permite que o Devin receba automaticamente notificações em tempo real quando eventos específicos ocorrerem no GitLab (como abrir ou atualizar merge requests e adicionar comentários em merge requests).

Para configurar o webhook:

1. Em **Configurações do Enterprise** > **Conexões**, localize a instância do GitLab que você acabou de adicionar
2. Clique no menu suspenso **Gerenciar**
3. Selecione **Configurar Webhook**
4. Siga os comandos fornecidos para concluir a configuração

<Frame>
  <img src="https://mintcdn.com/cognitionai/pyEbN3xdufu0Z31G/images/enterprise/gitlab/gitlab-configure-webhook.png?fit=max&auto=format&n=pyEbN3xdufu0Z31G&q=85&s=d2e01d6fd89ca40302f9ea9ebf61848b" alt="Configurar Webhook" width="452" height="388" data-path="images/enterprise/gitlab/gitlab-configure-webhook.png" />
</Frame>

Depois de configurado, o Devin poderá responder a eventos do GitLab em tempo real, em vez de depender de verificações periódicas.

***

<div id="step-6-verify-repository-access">
  ### Etapa 6: Verifique o acesso aos repositórios
</div>

Após adicionar a conexão:

1. Confirme que a conta de serviço tem acesso aos repositórios que você quer usar
2. No Devin, se os repositórios não aparecerem imediatamente, atualize manualmente a lista de repositórios
3. Acesse **Repositórios Enterprise**
4. Selecione a organização correta

<Frame>
  <img src="https://mintcdn.com/cognitionai/AnsrXvUO6uX9lwu8/images/enterprise/gitlab/gitlab-enterprise-repositories.png?fit=max&auto=format&n=AnsrXvUO6uX9lwu8&q=85&s=ef2b4392c4b1fdf004a26f2304576959" alt="Repositórios Enterprise" width="3164" height="1980" data-path="images/enterprise/gitlab/gitlab-enterprise-repositories.png" />
</Frame>

5. Abra **Gerenciar permissões**
6. Adicione os repositórios relevantes com as permissões adequadas de **leitura/gravação**

<Frame>
  <img src="https://mintcdn.com/cognitionai/AnsrXvUO6uX9lwu8/images/enterprise/gitlab/gitlab-manage-permissions.png?fit=max&auto=format&n=AnsrXvUO6uX9lwu8&q=85&s=e833b6573eedb18bf62079456d077b74" alt="Gerenciar permissões de repositório" width="540" height="128" data-path="images/enterprise/gitlab/gitlab-manage-permissions.png" />
</Frame>

<Note>
  Se algum repositório estiver faltando, pode ser porque o Devin atualiza a lista de repositórios periodicamente, e não instantaneamente.
</Note>

***

<div id="part-2-enable-user-linking-for-self-hosted-gitlab">
  ## Parte 2: Ativar a vinculação de usuários no GitLab auto-hospedado
</div>

<div id="step-7-register-an-oauth-application-on-the-self-hosted-gitlab-instance">
  ### Etapa 7: Registre um aplicativo OAuth na instância auto-hospedada do GitLab
</div>

Para permitir que usuários individuais vinculem sua identidade do GitLab ao Devin, o administrador deve registrar um app OAuth para a instância auto-hospedada do GitLab.

No Devin:

1. Acesse a área de conexão do GitLab no Enterprise
2. Abra **Advanced**
3. Vá para a seção de GitLab auto-hospedado
4. Inicie o fluxo para **registrar um aplicativo OAuth**

<Frame>
  <img src="https://mintcdn.com/cognitionai/EHv4sbxOtqeRVSwT/images/enterprise/gitlab/gitlab-register-oauth.png?fit=max&auto=format&n=EHv4sbxOtqeRVSwT&q=85&s=58275e975adaff88336802286e89eb8b" alt="Registrar aplicativo OAuth" width="1428" height="1324" data-path="images/enterprise/gitlab/gitlab-register-oauth.png" />
</Frame>

***

<div id="step-8-complete-oauth-app-registration-in-gitlab">
  ### Etapa 8: Conclua o registro do app OAuth no GitLab
</div>

Siga o link no modal de registro para abrir o formulário do aplicativo no GitLab. Preencha os campos como mostrado:

1. Defina **Name** e **Redirect URI** exatamente como mostrado no modal do Devin
2. Ative a caixa de seleção **Confidential**
3. Selecione o escopo **api**
4. Clique em **Save application**

<Frame>
  <img src="https://mintcdn.com/cognitionai/hGn6kEeruNGdZWya/images/enterprise/gitlab/gitlab-oauth-app-settings.png?fit=max&auto=format&n=hGn6kEeruNGdZWya&q=85&s=f30a422acffd08b475cfdd4d70be4f0b" alt="Configurações do app OAuth do GitLab" width="2060" height="1792" data-path="images/enterprise/gitlab/gitlab-oauth-app-settings.png" />
</Frame>

5. Copie o **Application ID** e o **Application Secret** do GitLab
6. Volte ao Devin e cole esses valores no modal de registro
7. Clique em **Register**

Isso conclui a configuração do lado do administrador necessária para a vinculação de identidade de usuário.

***

<div id="part-3-organization-membership-requirement">
  ## Parte 3: Requisito de associação à organização
</div>

<div id="step-9-make-sure-the-user-belongs-to-the-correct-devin-organization">
  ### Etapa 9: Verifique se o usuário pertence à organização do Devin correta
</div>

Antes que um usuário possa vincular a conta do GitLab, ele precisa ser membro de uma organização do Devin com permissões para repositórios do GitLab.

No Devin:

1. Vá para a seção de associação à organização
2. Confirme que o usuário faz parte de uma organização do Devin com permissões para repositórios do GitLab
3. Se não fizer parte, adicione-o primeiro

<Note>
  **Conexões pessoais mostra apenas integrações das organizações às quais o usuário pertence.** Se um usuário não estiver em uma organização do Devin com permissões para repositórios do GitLab, a integração do GitLab pode nem aparecer.
</Note>

***

<div id="part-4-end-user-setup">
  ## Parte 4: Configuração para o usuário final
</div>

<div id="step-10-open-personal-connections">
  ### Etapa 10: Abra as Conexões pessoais
</div>

Como usuário final no Devin:

1. Vá para **Conexões pessoais**
2. Procure a integração auto-hospedada do GitLab

Se ela não aparecer, verifique primeiro sua associação à organização.

***

<div id="step-11-link-the-users-gitlab-account">
  ### Etapa 11: Vincule a conta do GitLab do usuário
</div>

Assim que a integração aparecer:

1. Selecione a conexão do GitLab auto-hospedado
2. Conclua o processo de vinculação
3. Vincule a **conta do GitLab** do usuário à **conta do Devin** dele

Depois disso, Devin deverá conseguir atuar como esse usuário nas operações do GitLab.