View a markdown version of this page

Conectando GitLab - AWS DevOps Agente
Registro GitLab (nível da conta)Conectando projetos a um Agent SpaceConfigurando a revisão de código e o teste automatizadoGerenciando GitLab conexões

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

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)

GitLab é registrado no nível da AWS conta e compartilhado entre todos os Agent Spaces dessa conta. Cada registro é vinculado a um GitLab usuário ou GitLab grupo.

Etapa 1: Navegar até os fornecedores de funil

  1. Faça login no console AWS de gerenciamento

  2. Navegue até o console do AWS DevOps agente

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

  4. Encontre GitLabna seção Provedores disponíveis em Pipeline e escolha Registrar

Etapa 2: configurar a GitLab conexão

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

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

  3. 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.

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

  5. Copie o token gerado

  6. Retornar ao console do AWS DevOps agente

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

Etapa 3: Concluir o registro

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

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

Conectando projetos a um Agent Space

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

  2. Vá para a guia Capacidades

  3. Na seção Pipeline, escolha Adicionar

  4. GitLabSelecione na lista de provedores disponíveis

  5. Selecione o GitLab registro que contém os projetos que você deseja usar

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

  7. Escolha Salvar

AWS DevOps O agente monitora esses projetos para implantações do GitLab Pipelines para informar as investigações causais. Um único Espaço do Agente pode usar projetos de vários registros. Para adicionar projetos de outro registro, repita essas etapas.

Configurando a revisão de código e o teste automatizado

Quando você seleciona projetos na etapa de GitLab conexão, eles são automaticamente adicionados à seção Revisão de código e teste automatizado. Esta seção configura quais projetos acionam automaticamente Revisões do código de prontidão para lançamento e quais recursos de teste automatizados.

A configuração de revisão de código e teste automatizado inclui:

  • Capacidades — Escolha recursos de revisão de código e testes automatizados para cada projeto. A seção fornece duas configurações por projeto:

    • Análise automática de alterações por gatilho — Quando ativado para um projeto, o DevOps Agente é executado automaticamente Revisões do código de prontidão para lançamento sempre que uma solicitação de mesclagem é aberta ou atualizada. As descobertas da revisão aparecem como comentários embutidos na solicitação de mesclagem. Isso é ativado por padrão para todos os projetos conectados.

    • Teste de verificação automatizado — Quando habilitado para um projeto, o DevOps Agent cria, executa e testa suas alterações de código em um ambiente de verificação gerenciado durante as análises de código. Isso fornece validação funcional além da análise estática. Para obter mais informações, consulte Teste de verificação automatizado. Isso é ativado por padrão para todos os projetos conectados.

  • Lista de projetos — Mostra todos os projetos selecionados durante a etapa de conexão. Use o campo de pesquisa para filtrar projetos por nome. Cada projeto tem caixas de seleção independentes para ambos os recursos.

  • Função de tempo de execução (opcional) — Escolha a função do IAM que o DevOps agente assume para executar recursos automatizados nos projetos selecionados. Essa função é usada ao acessar os serviços internos necessários durante as compilações, como registros de pacotes privados e sistemas de armazenamento de artefatos. Recomendamos usar uma função diferente da sua função de agente principal.

Para configurar revisões automatizadas:

  1. Depois de conectar seus projetos, navegue até a seção Revisão de código e teste automatizado em suas configurações de GitLab integração.

  2. Para cada projeto, ative ou desative o recurso de revisão automática de alterações, dependendo se você deseja revisões automáticas de solicitações de mesclagem.

  3. Para cada projeto, ative ou desative o recurso de teste de verificação automatizado, dependendo se você deseja testes de verificação automatizados em um ambiente de verificação gerenciado.

  4. Opcionalmente, selecione uma função do IAM no menu suspenso Função do Runtime que o DevOps Agente assumirá ao executar recursos automatizados nos projetos selecionados.

  5. Escolha Salvar para aplicar sua configuração.

Depois de configurada, qualquer nova solicitação de mesclagem em um projeto com a revisão automática de alterações ativada acionará automaticamente uma revisão do código de prontidão para lançamento. Se o teste de verificação automatizado também estiver ativado, a revisão incluirá a validação funcional em um ambiente de verificação. Para obter mais informações sobre revisões de código, consulteRevisões do código de prontidão para lançamento.

Gerenciando GitLab conexões

  • 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 escolha 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.