Spoke do GitLab

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 7 min. de leitura
  • Gerencie o ciclo de vida do DevOps em GitLab a partir de sua instância ServiceNow. Crie fluxos em ServiceNow para gerenciar ramificações, grupos, problemas, solicitações de mesclagem, projetos e código-fonte em GitLab.

    Solicitar aplicativos na Store

    Acesse o site ServiceNow Store para ver todos os aplicativos disponíveis e obter informações sobre como enviar solicitações para a loja. Para obter informações sobre notas de versão cumulativa para todos os aplicativos liberados, consulte as ServiceNow Store notas de versão do histórico de versão.

    Assinatura do Integration Hub

    Este spoke requer uma assinatura do Hub de integração. Para obter mais informações, consulte Cronogramas jurídicos - Visão geral do IntegrationHub.

    Versão do spoke

    GitLab spoke v2.1.3 é a versão mais recente.

    Versões compatíveis

    Este spoke foi criado para a versão GitLab da API v4, mas pode ser compatível com versões posteriores.

    Requisitos do spoke

    • GitLab conta
    • Uma aplicação em GitLab configurada para integração com ServiceNow
    • ID da aplicação e segredo da aplicação GitLab
    Consulte a documentação https://docs.gitlab.com/ee/integration/oauth_provider.html para obter instruções sobre como criar e configurar aplicações.

    Ações do spoke

    O GitLab spoke fornece ações para automatizar tarefas GitLab quando ocorrem eventos em ServiceNow. As ações disponíveis incluem:

    Categoria Ação Descrição
    Gestão de filiais Comparar marcadores de ramificações ou confirmações Compara ramificações, marcadores ou confirmações.
    Criar Ramificação Cria uma ramificação no projeto necessário.
    Excluir ramificação Exclui a ramificação necessária de um projeto.
    Excluir ramificações mescladas Exclui a ramificação mesclada necessária de um projeto.
    Pesquisar ramificação Recupera os detalhes da ramificação necessária.
    Pesquisar fluxo de ramificações Recupera uma lista de ramificações e os detalhes da ramificação em um projeto.
    Proteger ramificação Protege uma ramificação em um projeto com níveis de acesso.
    Desproteger ramificação Desprotege uma ramificação em um projeto com níveis de acesso.
    Gestão de grupo Adicionar usuário a um grupo Adiciona o usuário a um grupo GitLab.
    Remover usuário de um grupo Remove o usuário de um grupo GitLab.
    Gestão de problemas Criar Problema Cria um problema no projeto necessário.
    Criar anotação do problema Cria uma anotação do problema para o problema necessário.
    Excluir anotação do problema Exclui uma anotação de problema para o problema necessário.
    Pesquisar fluxo de anotações do problema Recupera todas as anotações de problema em um problema.
    Pesquisar fluxo de problemas Recupera uma lista de problemas e detalhes do problema.
    Atualizar problema Atualiza os detalhes do problema necessário.
    Atualizar anotação do problema Atualiza uma anotação de problema em um projeto.
    Mesclar gestão de solicitações Aceitar solicitação de mesclagem Aprova uma solicitação de mesclagem em GitLab.
    Criar solicitação de mesclagem Cria uma solicitação de mesclagem em GitLab.
    Criar anotação de solicitação de mesclagem Cria uma anotação para a solicitação de mesclagem necessária.
    Excluir anotação de solicitação de mesclagem Exclui uma anotação para a solicitação de mesclagem necessária.
    Pesquisar todos os fluxos de solicitações de mesclagem Recupera a lista de solicitações de mesclagem em um projeto.
    Pesquisar anotações de solicitação de mesclagem Recupera a lista de anotações de solicitação de mesclagem em um projeto.
    Atualizar solicitação de mesclagem Atualiza os detalhes da solicitação de mesclagem necessária.
    Atualizar nota de solicitação de mesclagem Atualiza os detalhes da anotação de solicitação de mesclagem necessária.
    Gestão de pacotes Excluir arquivo de pacote Exclui um arquivo de pacote do registro de pacote do projeto.
    Excluir pacote de projeto Exclui um pacote do registro de pacotes do projeto.
    Excluir repositório de registro Remove um repositório de registro de um projeto.
    Excluir marcadores do repositório de registro Remove marcadores de repositório de registro em um lote de um projeto.
    Pesquisar detalhes de um registro Recupera detalhes de um repositório de registro para um projeto especificado.
    Pesquisar fluxo de arquivos de pacote Recupera a lista de arquivos de pacote de um único pacote.
    Pesquisar pacotes no fluxo do grupo Recupera uma lista de pacotes de projeto e detalhes do pacote no nível do grupo.
    Pesquisar pacotes no fluxo do projeto Recupera uma lista de pacotes de projeto e detalhes do pacote.
    Pesquisar pacote de projeto Recupera os detalhes do pacote especificado para um projeto especificado.
    Pesquisar repositórios de registro Recupera uma lista de repositórios de registro para um projeto especificado.
    Gestão de pipeline Pesquisar pipeline de projeto por ID Recupera os detalhes de um pipeline especificado para um projeto especificado.
    Pesquisar fluxo de trabalhos do pipeline de projeto Recupera a lista de trabalhos em um pipeline de projeto.
    Pesquisar relatório de teste de pipeline de projeto Recupera o relatório de teste do pipeline especificado para o projeto especificado.
    Pesquisar fluxo de pipelines de projeto Recupera a lista de pipelines em um projeto.
    Gestão de ganchos do projeto Criar gancho de projeto Cria um gancho para um projeto.
    Excluir gancho do projeto Remove um gancho de um projeto.
    Pesquisar gancho do projeto Recupera detalhes de um gancho especificado em um projeto.
    Pesquisar ganchos do projeto Recupera detalhes de todos os ganchos em um projeto.
    Atualizar gancho do projeto Atualiza os detalhes de um gancho para um projeto especificado.
    Gestão de projetos Adicionar usuário a um projeto Adiciona o usuário a um projeto em GitLab.
    Arquivar projeto Arquiva um projeto em GitLab.
    Criar marco Cria um marco em um projeto GitLab.
    Criar Projeto Cria um projeto em GitLab.
    Excluir marco Exclui o marco em um projeto GitLab.
    Excluir Projeto Exclui um projeto em GitLab.
    Pesquisar fluxo de marcos Recupera os detalhes dos marcos GitLab.
    Pesquisar projeto Recupera os detalhes do projeto especificado.
    Pesquisar fluxo de trabalhos do projeto Recupera os detalhes dos trabalhos do projeto.
    Pesquisar fluxo de projetos Recupera os detalhes dos projetos.
    Remover usuário de um projeto Remove o usuário de um projeto em GitLab.
    Compartilhar projeto com o grupo Compartilha um projeto com um grupo em GitLab.
    Desarquivar projeto Desarquiva um projeto em GitLab.
    Cancelar compartilhamento do projeto com o grupo Cancela o compartilhamento de um projeto com um grupo em GitLab.
    Atualizar marco Atualiza os detalhes de um marco em um projeto.
    Atualizar projeto Atualiza os detalhes de um projeto.
    Gestão de código de origem Obter confirmação Recupera os detalhes de uma confirmação em GitLab.
    Adicionar novo arquivo ao repositório Adiciona um arquivo a um repositório em GitLab.
    Gestão de token Pesquisar tokens de acesso pessoal Recupera uma lista de tokens de acesso pessoal.
    Revogar token de acesso pessoal Revoga um token de acesso pessoal.

    Fluxos de spoke

    O spoke GitLab fornece fluxos de amostra para demonstrar a automação das tarefas GitLab. Para personalizar um fluxo de amostra, copie-o para um novo escopo da aplicação.
    Fluxo Descrição
    Arquivar projetos com mais de 6 meses Arquiva os projetos que estão inativos nos últimos seis meses.

    Subfluxos do spoke

    O spoke GitLab fornece fluxos de amostra para demonstrar a automação das tarefas GitLab. Para personalizar um subfluxo de amostra, copie-o para um novo escopo da aplicação. Os subfluxos de amostra disponíveis incluem:
    Subfluxos Descrição
    Processar eventos do webhook de implantação do GitLab​ Processa webhooks de implantação em GitLab.
    Processar eventos do webhook de trabalho do GitLab​ Processa eventos de webhook de trabalho em GitLab.
    Processar eventos de webhook de solicitação de mesclagem do GitLab Processa eventos de webhook de solicitação de mesclagem em GitLab.
    Processar eventos de webhook de pipeline do GitLab​ Processa eventos de webhook de pipeline em GitLab.
    Processar eventos de webhook de push do GitLab​ Processa eventos de webhook por push em GitLab.

    Spoke webhooks

    Os webhooks bidirecionais podem ser configurados para serem notificados sobre os eventos necessários. A política de roteamento define condições que devem ser atendidas para notificar o app ServiceNow. Essas condições são baseadas nos eventos em GitLab sobre os quais você deseja ser notificado. Quando as condições são atendidas, a política de roteamento aciona o subfluxo associado que, por sua vez, automatiza as tarefas GitLab.

    Os webhooks bidirecionais requerem configuração separada e podem ser usados independentemente sem usar as ações de spoke. Por padrão, a aplicação GitLab Webhooks está disponível no spoke GitLab e tem os seguintes módulos:
    Webhook Descrição
    Registros de webhook do GitLab Exibe a lista de registros de webhook disponíveis.
    Políticas de roteamento do webhook do GitLab Exibe a lista de políticas de roteamento de webhook disponíveis.

    Módulo de spoke

    O GitLab spoke fornece a aplicação Gitlab Token Management que inclui o módulo Gitlab Token Managements. Você deve registrar aqui para autenticar solicitações da sua instância ServiceNow.

    Requisitos de aliases de conexão e credencial

    Integration Hub usa aliases para gerenciar conexões e informações de credenciais e credenciais de OAuth. O uso de um alias elimina a necessidade de configurar várias credenciais e perfis de informações de conexão ao usar vários ambientes. Se as informações de conexão ou de credencial forem alteradas, não será necessário atualizar nenhuma ação que use a conexão.

    Para obter informações sobre como configurar o spoke, consulte Configurar GitLab spoke.

    Requisitos do MID Server

    Essas ações usam chamadas REST, que podem ser executadas em um MID Server. Use o registro de conexão associado ao alias GitLab para configurar onde as ações são executadas, bem como definir atributos de seleção MID Server. Para obter mais informações, consulte MID server.