Integrar GitLab em Velocidade de mudança para DevOps — Espaço

Conecte-se à sua instância GitLab usando o playbook do Espaço de mudança de DevOps para descobrir repositórios e pipelines.

Antes de Iniciar

Conclua as tarefas especificadas no tópico Comece com Velocidade de mudança para DevOps.

Função necessária: sn_devops.admin ou sn_devops.tool_owner

Procedimento

1. Navegar até Espaços > Espaço de mudança de DevOps e use uma das seguintes opções para abrir o Playbook para integração GitLab.

   Opção	Etapas
   Página inicial	Selecione Conectar uma ferramenta. No modal Conectar a uma ferramenta, selecione a ferramenta na categoria apropriada. Por exemplo, se você quiser se conectar a GitLab como ferramenta de codificação, selecione GitLab na categoria Código.
   Módulo de aplicações	Selecione Aplicações ( ) na navegação primária. Selecione uma aplicação existente ou crie uma. Para criar uma aplicação, consulte Criar uma aplicação - Espaço. No painel Ações recomendadas, selecione o cartão Conectar a uma ferramenta. No modal Conectar a uma ferramenta, selecione a ferramenta na categoria apropriada. Por exemplo, se você quiser se conectar a GitLab como ferramenta de codificação, selecione GitLab na categoria Código.
   Módulo de ferramentas	Selecione Ferramentas ( ) na navegação primária. Na lista Capacidade, selecione a categoria apropriada. Por exemplo, se você quiser se conectar a GitLab como ferramenta de codificação, selecione a categoria Codificação. Selecione Conectar uma ferramenta. No modal da ferramenta Conectar-se a um, selecione GitLab.

   Importante:

   Se você quiser descobrir e rastrear objetos de ferramenta, como pipelines ou repositórios ao se conectar à ferramenta, deverá conectar sua ferramenta do módulo Aplicação.
2. No campo Nome da ferramenta, insira um nome para a ferramenta.
   
3. Selecione Avançar.

   O DevOps playbook é aberto para ajudá-lo a concluir as tarefas de integração.

4. Insira os detalhes da sua GitLab instância.
   1. Insira o URL da instância GitLab.
   2. No campo Tipo de credencial, selecione um.
      • Autorização básica
      • OAuth 2.0
   3. Insira as credenciais.
      • Autenticação básica: insira o nome de usuário e a senha/token de acesso da sua instância GitLab.
        Nota:

        Somente o token de acesso pessoal é compatível. Ao gerar o token, selecione a API de escopo e conceda acesso de leitura/gravação, incluindo todos os grupos e projetos, registro de contêiner e registro de pacote.
      • OAuth 2.0: insira sua credencial do OAuth.

        Para obter mais informações sobre credenciais OAuth2.0, consulte Configuração de GitLab credenciais do OAuth 2.0 para DevOps.

   4. Opcional: Se sua instância GitLab estiver anexada a um MID Server, selecione a opção MID Server e insira seus detalhes.

      Para obter mais informações sobre o MID Server, consulte Seleção de MID Server

   5. Selecione Conectar.

      

5. As verificações de permissão são executadas nas credenciais que você inseriu.
   As permissões necessárias e as permissões disponíveis são exibidas. Se você quiser inserir credenciais com permissões melhores, selecione Inserir credenciais novamente. Para obter informações detalhadas sobre todas as permissões necessárias, consulte GitLab permissões em Permissões necessárias para DevOps ferramentas.

   Você pode optar por continuar com a conexão da ferramenta mesmo se não tiver todas as permissões necessárias.

   

6. Selecione Avançar.
7. Especifique o acesso para a ferramenta.
   1. Se você quiser controlar o acesso à ferramenta, adicione os grupos que devem ter acesso à ferramenta no campo Mantido por.
      As tarefas que esses usuários nos grupos podem executar dependem da função atribuída a eles.

      • DevOps Função de proprietário da ferramenta: pode exibir e editar a ferramenta.
      • DevOps Função de proprietário da aplicação: pode exibir a ferramenta e associar, descobrir, importar dados históricos e modificar etapas do pipeline (se aplicável) dos objetos da ferramenta (como planos, repositórios e pipelines).
      • DevOps Função de administrador: pode editar todas as ferramentas.
      • Outras funções DevOps : pode exibir a ferramenta.
      Nota:

      Se você não selecionar um grupo e ignorar esta etapa, todos os usuários com a função de proprietário da ferramenta DevOps poderão editar a ferramenta.
   2. Se você optar por controlar o acesso à ferramenta, a opção Todos os proprietários de app podem exibir e associar objetos de ferramenta a aplicações ficará disponível para seleção.

      Esta opção permite que todos os usuários com a função de proprietário de app DevOps acessem a ferramenta. Se selecionado, eles poderão exibir, associar, descobrir, importar dados históricos e modificar etapas do pipeline (se aplicável) dos objetos da ferramenta.

   3. Selecione Atribuir.

   

8. Selecione os projetos para os quais você deseja configurar webhooks automaticamente.

   Você também pode habilitar a pesquisa noturna para recuperar dados de quaisquer pipelines rastreados selecionando a opção Habilitar propriedade de pesquisa no módulo Administração. Consulte Propriedades Velocidade de mudança para DevOps.

9. Selecione Configurar.
   

   Para configurar manualmente, selecione Configurar manualmente. Para obter mais informações, consulte Configurar webhooks em GitLab manualmente.

   Importante:

   • Se você estiver se conectando pela página inicial ou pelo módulo Ferramentas, a conexão será concluída e você será direcionado para a página Resumo.
   • Se você estiver se conectando do módulo Aplicações, os repositórios e pipelines disponíveis em seu projeto serão descobertos. Você pode rastrear e importar dados históricos deles.
10. Selecione os repositórios a serem rastreados.
    1. Selecione os repositórios para os quais você deseja rastrear atualizações e associar à aplicação.

    2. Selecione Avançar.

       

    3. Se você quiser importar dados do repositório, selecione o intervalo de datas e selecione Enviar.

       Você pode importar até 90 dias de dados.

11. Selecione o pipeline que você deseja rastrear e clique em Avançar.

    Para cada pipeline selecionado, todas as etapas são importadas para a última execução bem-sucedida.

    

12. Opcional: Na atividade Atribuir serviços a etapas de pipeline, especifique Tipo de etapa e Serviço para cada etapa de pipeline.

    A conclusão desta etapa como parte da integração da ferramenta permite que os painéis Insights de DevOps mostrem dados mais significativos imediatamente.

13. Selecione Avançar.
14. Na página Resumo, revise os detalhes da ferramenta GitLab.

    Selecione Exibir registro da ferramenta para revisar os detalhes da instância conectada.

    

Resultado

Você integrou com sucesso sua ferramenta [ GitLab a Velocidade de mudança para DevOps.

Nota:

Se a credencial da ferramenta mudar, você também deverá atualizar as credenciais em DevOps Change. Para obter mais informações, consulte Atualizar credenciais da ferramenta de terceiros em Velocidade de mudança para DevOps.

Tarefas relacionadas

• Configurar webhooks a partir do registro da ferramenta