As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Conectando GitLab
<a name="connecting-to-cicd-pipelines-connecting-gitlab"></a>

GitLab a integração permite que o AWS DevOps Agente monitore as implantações do GitLab Pipelines para informar as investigações causais durante a resposta a incidentes. Essa integração segue um processo de duas etapas: registro em nível de conta GitLab, seguido pela conexão de projetos específicos a Agent Spaces individuais.

## Registro GitLab (nível da conta)
<a name="registering-gitlab-account-level"></a>

GitLab é registrado no nível da AWS conta e compartilhado entre todos os Agent Spaces dessa conta. Os Agent Spaces individuais podem então escolher quais projetos específicos se aplicam ao seu Agent Space.

### Etapa 1: Navegar até os fornecedores de funil
<a name="step-1-navigate-to-pipeline-providers"></a>

1. Faça login no console AWS de gerenciamento

1. Navegue até o console do AWS DevOps agente

1. Vá para a página **Capability Providers** (acessível na navegação lateral)

1. Encontre **GitLab**na seção Provedores **disponíveis** em **Pipeline** e clique em **Registrar**

### Etapa 2: configurar a GitLab conexão
<a name="step-2-configure-gitlab-connection"></a>

Na página GitLab de registro, configure o seguinte:

**Tipo de conexão** — Selecione se você está se conectando como pessoa ou grupo:
+ **Pessoal** (padrão) — Sua conta de GitLab usuário individual com nome de usuário e perfil
+ **Grupo** — Em GitLab, você usa grupos para gerenciar um ou mais projetos relacionados ao mesmo tempo

**GitLab tipo de instância** — Escolha a qual tipo de GitLab instância você está se conectando:
+ **GitLab.com** (padrão) — O GitLab serviço público
+ **Auto-hospedado publicamente acessível GitLab** — marque a caixa **Usar endpoint GitLab auto-hospedado** e forneça o URL para sua instância GitLab 

**nota**  
**Atualmente, somente GitLab instâncias acessíveis ao público são suportadas.

**Token de acesso** — Forneça um token de acesso GitLab pessoal:

1. Em uma guia separada do navegador, faça login na sua GitLab conta

1. Navegue até suas configurações de usuário e selecione **Tokens de acesso**

1. Crie um novo token de acesso pessoal com as seguintes permissões:
   + `read_repository`— Necessário para acessar o conteúdo do repositório
   + `read_virtual_registry`— Necessário para acessar as informações do registro virtual
   + `read_registry`— Necessário para acessar as informações do registro
   + `api`— Necessário para acesso à API de leitura e gravação
   + `self_rotate`- Necessário para tokens rotativos. No momento, esse recurso não é suportado pelo AWS DevOps Agente, mas será suportado em uma data posterior. Adicionar agora evita a necessidade de criar um novo token no futuro.

1. Defina a expiração do token para um máximo de 365 dias a partir da data atual

1. Copie o token gerado

1. Retornar ao console do AWS DevOps agente

1. Cole o token no campo “Token de acesso”

### Etapa 3: Concluir o registro
<a name="step-3-complete-registration"></a>

**(Opcional) Tags** — Adicione AWS tags ao GitLab registro para fins organizacionais.

Clique em **Avançar** para revisar sua configuração e, em seguida, clique em **Enviar** para concluir o processo de GitLab registro. O sistema validará seu token de acesso e estabelecerá a conexão.

## Conectando projetos a um Agent Space
<a name="connecting-projects-to-an-agent-space"></a>

Depois de se registrar GitLab no nível da conta, você pode conectar projetos específicos a Agent Spaces individuais:

1. No console do AWS DevOps agente, selecione seu Espaço do agente

1. Vá para a guia **Capacidades**

1. Na seção **Pipeline**, clique em **Adicionar**

1. **GitLab**Selecione na lista de provedores disponíveis

1. Selecione os GitLab projetos relevantes para o seu Espaço do Agente

1. Clique em **Salvar**

AWS DevOps O agente monitorará esses projetos para implantações da GitLab Pipelines para informar as investigações causais.

## Gerenciando GitLab conexões
<a name="managing-gitlab-connections"></a>
+ **Atualização do token** de acesso — Se seu token de acesso expirar ou precisar ser atualizado, você poderá atualizá-lo no console do AWS DevOps agente modificando o GitLab registro no nível da conta.
+ **Visualização de projetos conectados** — No console do AWS DevOps agente, selecione seu Espaço do agente e vá até a guia Capacidades para visualizar os projetos conectados na seção Pipeline.
+ **Removendo a GitLab conexão** — Para desconectar GitLab projetos de um Espaço do Agente, selecione a conexão na seção Pipeline e clique em **Remover**. Para remover completamente o GitLab registro, primeiro remova-o de todos os Agent Spaces e, em seguida, exclua o registro no nível da conta.