---
sourceDocument: Xanadu IT Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/it-service-management

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Xanadu IT Service Management

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

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

# Integrar GitLab em Velocidade de mudança para DevOps --- Espaço {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

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](https://servicenow-prod.fluidtopics.net/isUci~UGMcUesjWvlSjNzw "Saiba mais sobre o processo de configuração para Velocidade de mudança para DevOps que é necessário antes de configurar integrações com sua cadeia de ferramentas.").

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

## Procedimento

1. Navegar até EspaçosEspaç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 | 1. Selecione Conectar uma ferramenta. 2. 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. {#onboard-gitlab-to-devops-change-velocity-workspace__ol_e5j_4y1_fwb} |
   | Módulo de aplicações | 1. Selecione Aplicações ( ![ícone Aplicações]()) na navegação primária. 2. Selecione uma aplicação existente ou crie uma. Para criar uma aplicação, consulte app-create-workspace.html. 3. No painel Ações recomendadas, selecione o cartão Conectar a uma ferramenta. 4. 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. {#onboard-gitlab-to-devops-change-velocity-workspace__ol_u24_mz1_fwb} |
   | Módulo de ferramentas | 1. Selecione Ferramentas ( ![ícone Ferramentas]()) na navegação primária. 2. 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. 3. Selecione Conectar uma ferramenta. 4. No modal da ferramenta Conectar-se a um, selecione GitLab. {#onboard-gitlab-to-devops-change-velocity-workspace__ol_fjs_k1b_fwb} |
   |-|-|

   {#onboard-gitlab-to-devops-change-velocity-workspace__choicetable_m3t_ky1_fwb}  
   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
      {#onboard-gitlab-to-devops-change-velocity-workspace__ul_uvd_2dg_fwb}
   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](https://servicenow-prod.fluidtopics.net/doXrtQ0VfOYDyw1cn9s41g#setting-up-gitlab-oauth "Integre sua conta GitLab à sua instância ServiceNow criando uma aplicação OAuth personalizada em GitLab e autenticando solicitações de ServiceNow DevOps.").

      {#onboard-gitlab-to-devops-change-velocity-workspace__ul_tjv_gdg_fwb}
   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](https://www.servicenow.com/docs/access?context=c_MIDServerSelector&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)
   5. Selecione Conectar.  
   {#onboard-gitlab-to-devops-change-velocity-workspace__substeps_wdp_x1b_fwb}
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](https://servicenow-prod.fluidtopics.net/gr3Dt9S7_1bNaxJs8idjRg "Permissões necessárias em sua ferramenta de terceiros para se conectar a Velocidade de mudança para DevOps.").

   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.
      {#onboard-gitlab-to-devops-change-velocity-workspace__ul_csp_h5c_xwb}  
      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.

   {#onboard-gitlab-to-devops-change-velocity-workspace__ol_slg_2tz_cxb}

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](https://servicenow-prod.fluidtopics.net/g2jkCyZosAVMGIZlfkck7w "Use essas propriedades para definir as configurações na aplicação Velocidade de mudança para DevOps.").
9. Selecione Configurar.  
   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.
   {#onboard-gitlab-to-devops-change-velocity-workspace__ul_yfy_zz1_bzb}
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.
    {#onboard-gitlab-to-devops-change-velocity-workspace__ol_r1g_3jc_bzb}
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](https://servicenow-prod.fluidtopics.net/sHILZQn4idywyL0kfRxbpQ "Se a credencial da ferramenta tiver sido alterada, você deverá atualizar as credenciais na instância ServiceNow para evitar a desconexão.").
**Tarefas relacionadas**   

* [Configurar webhooks a partir do registro da ferramenta](https://servicenow-prod.fluidtopics.net/1YeBcS62d9_OTF8TnC3W7Q "Configure webhooks do registro da ferramenta para enviar dados para Velocidade de mudança para DevOps depois que a ferramenta estiver conectada.")

