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á.
# Conexão a CI/CD tubulações
A integração do pipeline de CI/CD permite que o AWS DevOps Agente monitore implantações e correlacione alterações de código com incidentes operacionais durante as investigações. Ao conectar seus CI/CD provedores, o agente pode rastrear eventos de implantação e associá-los a AWS recursos para ajudar a identificar possíveis causas-raiz durante a resposta a incidentes.
AWS DevOps O Agent oferece suporte à integração com CI/CD plataformas populares por meio de um processo de duas etapas:
1. Registro **no nível da conta — Registre** seu CI/CD provedor uma vez no nível da AWS conta
1. **Conexão com o Agent Space** — Conecte projetos ou repositórios específicos a Agent Spaces individuais com base em suas necessidades organizacionais
Essa abordagem permite que você compartilhe registros de CI/CD provedores em vários Agent Spaces, mantendo um controle granular sobre quais projetos são monitorados por cada espaço.
## CI/CD Provedores compatíveis
AWS DevOps O Agent oferece suporte às seguintes CI/CD plataformas:
+ **GitHub**— Conecte repositórios de [GitHub.com](http://GitHub.com) usando o GitHub aplicativo AWS DevOps Agent.
+ **GitLab**— Conecte projetos de [GitLab.com,](http://gitlab.com) GitLab instâncias gerenciadas ou GitLab implantações auto-hospedadas acessíveis ao público.
**Tópicos**
+ [Conectando GitHub](connecting-to-cicd-pipelines-connecting-github.md)
+ [Conectando GitLab](connecting-to-cicd-pipelines-connecting-gitlab.md)
# Conectando GitHub
GitHub a integração permite que o AWS DevOps Agente acesse repositórios de código e receba eventos de implantação durante investigações de incidentes. Essa integração segue um processo de duas etapas: registro em nível de conta GitHub, seguido pela conexão de repositórios específicos a Agent Spaces individuais.
AWS DevOps O agente é compatível com GitHub instâncias.com (SaaS) e GitHub Enterprise Server (auto-hospedadas).
## Pré-requisitos
Antes de se conectar GitHub, verifique se você tem:
+ Acesso ao console de administração do AWS DevOps agente
+ Uma conta de GitHub usuário ou organização com permissões de administrador
+ Autorização para instalar GitHub aplicativos em sua conta ou organização
Para o GitHub Enterprise Server, você também precisa:
+ Uma instância do GitHub Enterprise Server (versão 3.x ou posterior) acessível por HTTPS
+ O URL HTTPS da sua instância do GitHub Enterprise Server (por exemplo,`https://github.example.com`)
+ (Opcional) Uma conexão privada, se sua instância do GitHub Enterprise Server não estiver acessível publicamente
## Registro GitHub (nível da conta)
GitHub é registrado no nível da AWS conta e compartilhado entre todos os Agent Spaces dessa conta. Você só precisa se registrar GitHub uma vez por AWS conta.
### Etapa 1: Navegar até os fornecedores de funil
1. Faça login no console AWS de gerenciamento
1. Navegue até o console do AWS DevOps agente
1. Vá para a guia **Capacidades**
1. Na seção **Pipeline**, clique em **Adicionar**
1. **GitHub**Selecione na lista de provedores disponíveis
Se GitHub ainda não tiver sido registrado, você será solicitado a registrá-lo primeiro.
### Etapa 2: Escolha o tipo de conexão
Na tela “Registrar GitHub conta/organização”, selecione se você está se conectando como usuário ou organização:
+ **Usuário** — Sua GitHub conta pessoal com nome de usuário e perfil
+ **Organização** — Uma GitHub conta compartilhada em que várias pessoas podem colaborar em vários projetos ao mesmo tempo
Se você estiver se conectando a uma instância do GitHub Enterprise Server, marque a caixa de seleção **Usar GitHub Enterprise Server** e insira a URL HTTPS da sua instância (por exemplo,`https://github.example.com`).
Se sua instância do GitHub Enterprise Server não estiver acessível publicamente, você pode, opcionalmente, configurar uma conexão privada para permitir que o AWS DevOps Agente acesse sua instância com segurança. Para obter mais informações, consulte [Conectando-se a ferramentas hospedadas de forma privada](configuring-capabilities-for-aws-devops-agent-connecting-to-privately-hosted-tools.md).
**nota**
**Não `/api/v3` inclua nenhum caminho final no URL — insira somente o URL base.
### Etapa 3: configurar o GitHub aplicativo
Clique em **Enviar** para iniciar o processo de configuração do aplicativo. As próximas etapas são diferentes dependendo se você está se conectando a GitHub .com ou ao GitHub Enterprise Server.
#### Para GitHub .com
1. Você será redirecionado para GitHub instalar o GitHub aplicativo AWS DevOps Agent.
1. Selecione em qual conta ou organização instalar o aplicativo.
1. O aplicativo permite que o AWS DevOps Agente receba eventos de repositórios conectados, incluindo eventos de implantação.
#### Para servidor GitHub corporativo
GitHub O Enterprise Server usa um fluxo de manifesto de GitHub aplicativo, que configura automaticamente um novo GitHub aplicativo na sua instância. Isso envolve dois redirecionamentos para sua instância do GitHub Enterprise Server.
1. Seu navegador será redirecionado para a página “Criar GitHub aplicativo” da sua instância do GitHub Enterprise Server.
1. Você verá o nome do aplicativo pré-preenchido. Sinta-se à vontade para alterar o nome conforme necessário. Clique em **Criar GitHub aplicativo**.
1. Você será redirecionado de volta para o AWS DevOps Agent, que troca o código do manifesto pelas credenciais do aplicativo.
### Etapa 4: selecionar repositórios e concluir a instalação
1. Você verá a página **Instalar e Autorizar** do GitHub aplicativo.
1. Selecione quais repositórios permitir que o aplicativo acesse:
+ **Todos os repositórios** — Conceda acesso a todos os repositórios atuais e futuros
+ **Selecione somente repositórios** — Escolha repositórios específicos da sua conta ou organização
1. Clique em **Instalar e autorizar.**
1. Você será redirecionado de volta ao console do AWS DevOps agente, onde GitHub aparecerá como registrado no nível da conta.
## Conectando repositórios a um Espaço do Agente
Depois de se registrar GitHub no nível da conta, você pode conectar repositórios 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. **GitHub**Selecione na lista de provedores disponíveis
1. Selecione o subconjunto de repositórios relevantes para esse Espaço do Agente
1. Clique em **Adicionar** para concluir a conexão
Você pode conectar diferentes conjuntos de repositórios a diferentes Agent Spaces com base nas suas necessidades organizacionais.
## Entendendo o GitHub aplicativo
O GitHub aplicativo AWS DevOps Agent:
+ Solicita acesso somente de leitura aos seus repositórios
+ Recebe eventos de implantação e outros eventos do repositório
+ Permite que o AWS DevOps agente correlacione alterações de código com incidentes operacionais
+ Pode ser desinstalado a qualquer momento por meio de suas configurações GitHub
Para o GitHub Enterprise Server, o GitHub aplicativo é criado automaticamente na sua instância durante o registro. Você pode gerenciar o acesso ao repositório do aplicativo ou desinstalá-lo em **Configurações > Aplicativos > GitHub Aplicativos instalados**. Para excluir totalmente a definição do aplicativo, acesse **Configurações > Configurações do desenvolvedor > GitHub Aplicativos**.
## Gerenciando GitHub conexões
+ **Atualizando o acesso ao repositório** — Para alterar quais repositórios o GitHub aplicativo pode acessar, acesse as configurações da sua GitHub conta ou organização (ou as configurações da instância do GitHub Enterprise Server), navegue até os GitHub aplicativos instalados e modifique a configuração do aplicativo do AWS DevOps Agente.
+ **Visualizando repositórios conectados** — No console do AWS DevOps Agente, selecione seu Espaço do Agente e vá até a guia Capacidades para visualizar os repositórios conectados na seção Pipeline.
+ **Removendo a GitHub conexão** — Para se desconectar GitHub de um Espaço do Agente, selecione a conexão na seção Pipeline e clique em **Remover**. Para desinstalar completamente o GitHub aplicativo, desinstale-o das configurações da sua GitHub conta ou organização. Para o GitHub Enterprise Server, como o GitHub aplicativo é criado diretamente na sua instância durante o registro, você pode, opcionalmente, limpar o aplicativo por completo executando as duas ações a seguir:
+ **Desinstalar o aplicativo** — Vá para **Configurações > Aplicativos > GitHub Aplicativos instalados**, clique em **Configurar** no aplicativo e, em seguida, desinstale-o.
+ **Excluir o aplicativo** — Vá para **Configurações > Configurações do desenvolvedor > GitHub Aplicativos**, selecione o aplicativo, vá até a guia **Avançado** e escolha **Excluir GitHub aplicativo**. **Aviso:** a exclusão do GitHub aplicativo é permanente e não pode ser desfeita. Se você excluí-lo, precisará registrar novamente o GitHub Enterprise Server desde o início no console do AWS DevOps Agente para criar um novo aplicativo.
# 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. 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
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
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
**(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
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
+ **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.