Importando dados históricos para DevOps ferramentas

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 9 min. de leitura
  • Use o catálogo de serviços para integrar um novo app e importar histórico DevOps dados desse app. Habilite a pesquisa para importar dados mapeados para planos, repositórios e pipelines associados em uma frequência programada.

    Histórico de importação DevOps dados de ferramentas existentes

    Você pode criar uma solicitação de integração do app e importar dados históricos para . DevOps ferramenta que você já incorporou, usando o formulário de catálogo de integração do app. Atualmente, você pode importar dados históricos dos últimos 90 dias a partir da data atual e habilitar a pesquisa em uma frequência programada para as seguintes ferramentas:
    • Jira (Plano)
    • GitHub e. GitHub Empresa (codificação)
    • Jenkins (Orquestração)
    Nota:
    • Certifique-se de ter criado, conectado e descoberto a ferramenta para a qual você está importando dados.
    • Importar Solicitações para a ferramenta Plano ( Jira) são processados primeiro, seguidos por solicitações de importação de repositório e pipeline.

    Fluxo de trabalho de importação e novas tentativas

    Ao enviar com sucesso a solicitação de catálogo do catálogo de autoatendimento, a solicitação é enviada para aprovação seguindo o fluxo do aprovador designado que você configurou. Quando a solicitação é aprovada, um evento de entrada é criado para a solicitação de integração do app. . Processando detalhes O campo do registro de evento de entrada exibe o ID e o status da solicitação de importação. Uma única solicitação de importação cria várias páginas de solicitação de importação secundárias que são exibidas na lista relacionada. As páginas de solicitação de importação são criadas com base na seguinte lógica para as ferramentas compatíveis:
    • Jira: uma página é criada para um intervalo de 15 dias.
    • GitHub : uma página é criada para cada 100 confirmações.
    • Jenkins: as páginas são criadas por compilação.
    . Após a conclusão do processamento das solicitações de importação, os itens de trabalho associados, confirmações, ramificações, marcadores, execuções de pipeline e os resumos de testes mapeados são criados e persistentes no sistema.
    Na importação bem-sucedida, você pode exibir todas as confirmações importadas no DevOps > Desenvolver:
    • Filiais
    • Confirmar
    • Comprometidos
    • Marcadores
    • Repositórios
    • Itens de trabalho
    para obter detalhes para confirmar a importação bem-sucedida para o intervalo de datas especificado.

    Ao processar uma solicitação de importação, se alguma página apresentar erro, um mecanismo de nova tentativa incorporado tentará processar a página por um número definido de vezes. Se a página ainda estiver em estado de erro, as páginas subsequentes ou restantes na solicitação de importação serão processadas. O estado geral da solicitação de importação permanece com erro.

    Por exemplo, se a solicitação de importação do plano falhar (depois de todas as novas tentativas), prosseguiremos para processar as importações de repositório e pipeline. Você pode configurar as novas tentativas para a solicitação de importação de DevOps > Administração > Propriedades > Máximo de novas tentativas por página durante a importação.
    • Especifique a contagem de novas tentativas para tentativas automáticas, caso a página de solicitação de importação falhe em Máximo de novas tentativas por página durante a importação campo. Se, após todas as novas tentativas automáticas, a página não for bem-sucedida, a solicitação de importação processará as páginas restantes. O status geral da solicitação de importação é refletido como com erro.
    • Você pode tentar novamente manualmente uma importação com falha clicando em Importação novamente botão, na página de solicitação de importação com falha,

    Configuração e programação de pesquisa

    Habilite a pesquisa para importar DevOps dados em uma frequência programada para apps que importaram dados históricos e são mapeados para planos, repositórios e pipelines associados.

    Depois de integrar um app e importar o associado DevOps dados, você pode habilitar a programação do sistema de base para que as solicitações de importação sejam criadas para os planos, repositórios e pipelines que são rastreados e associados a um app. Quando a importação solicita a conclusão do processamento, os dados associados são persistentes e exibidos no app. Enquanto o sistema de base DevOpsImportPolling programar trabalho está ativo por padrão, você deve habilitar a pesquisa do DevOps propriedades para executar o trabalho agendado.

    Para habilitar a pesquisa, navegue até DevOps > Administração > Propriedades > Habilitar pesquisa de importação e marque a caixa de seleção.

    Ativar este sinalizador de propriedade habilita o sistema de base DevOpsImportPolling programar trabalho. O trabalho agendado para pesquisa considera a última importação bem-sucedida ou 30 dias, o que for posterior como a "data de início", e a data do dia atual como a "data de término" para a importação de dados, para todos os aplicativos que estão ativos e têm pipelines rastreados. O trabalho pesquisa a hora da última importação bem-sucedida e cria a solicitação de importação subsequente de acordo. Essa lógica garante que o trabalho de pesquisa agendado importe o delta de relevante DevOps dados desse app, desde a última importação bem-sucedida até a data atual, até um máximo de trinta dias.
    Nota:
    Não configure uma frequência de pesquisa que seja inferior a um dia ou 24 horas.
    A frequência padrão do trabalho é definida para ser executado diariamente à meia-noite usando o fuso horário do sistema. Para mudar a frequência do trabalho agendado, você precisa de ServiceNow ServiceNow AI Platform Função de administrador (admin).
    Navegar até Definição do Sistema > Trabalhos agendados > DevOpsImportPolling e modifique o. Executar frequência, Fuso horário e Hora valores de campo, conforme necessário. Para obter mais informações, consulte Programar trabalhos
    Nota:
    • O trabalho agendado se aplica somente a apps ativos. Certifique-se de que o aplicativo para o qual você está configurando a pesquisa esteja no estado ativo e no Rastrear o campo está habilitado para os pipelines relevantes.
    • Considere o seguinte ao modificar a frequência da programação:
    Os trabalhos agendados que pesquisam para importação DevOps os dados respeitam os valores padrão para o seguinte DevOps propriedades relacionadas a importações e solicitações de importação:
    • Máximo de novas tentativas por página ao importar
    • Número máximo de páginas a serem processadas por vez para uma solicitação de importação
    • Para salvar cargas úteis como anexos no registro da Página de solicitação de importação, defina o campo "Valor" como "Verdadeiro". Qualquer outra coisa é considerada falsa.

    Importação existente Azure DevOps repositórios e planos

    Depois de integrar Azure DevOps com DevOps, você pode importar até 90 dias de existentes Azure DevOps dados de pipeline, repositório e plano. Em seguida, você pode usar DevOps painéis para exibir e gerenciar Azure DevOps dados.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    • Você solicitará os dados do catálogo de serviços como um item do catálogo predefinido.
    • Resumos de testes importados, artefatos e pacotes estão vinculados a execuções de pipeline e não a execuções de etapa.
    • Os resultados da verificação do SonarQube não são importados.
    • Azure DevOps impõe as seguintes restrições:
      • Máximo de 20 000 itens de trabalho podem ser importados a cada 15 dias.
      • Máximo de 200 confirmações de execução podem ser mapeadas para qualquer execução de pipeline.
      • Os resultados de testes para execuções de pipeline com mais de 7 dias não são retornados.
    Nota:
    O processo de importação pode levar algum tempo, horas para conjuntos de dados muito grandes.

    Procedimento

    1. Navegar até Tudo > Catálogo de serviços > Definições de Catálogo > Meus catálogos e selecione Integração do DevOps .
    2. Em Itens do catálogo lista relacionada, selecione Integração do app DevOps .
    3. No formulário Item do catálogo, selecione Experimente para solicitar os dados.
      O formulário de Integração da aplicação DevOps resultante permite especificar o item do catálogo a ser solicitado. Nesse caso, o "app" a ser solicitado é seu Azure DevOps instância.

      Especifique a instância no formulário de integração

    4. Selecione o ícone Selecionar na lista ( Ícone de aplicações) no Aplicação e selecione sua instância de Azure DevOps.
      Agora que você especificou a instância, especificará o intervalo de datas e as fontes de dados a serem importados.
    5. Repita o procedimento a seguir para cada pipeline, repositório e plano que você deseja importar:
      1. Selecione o ícone Selecionar na lista ( Ícone de aplicações) no apropriado Integração campo para selecionar o item a ser importado.
        Você pode selecionar vários itens.
      2. Especifique o intervalo de datas para os dados em Importar de e. Importar para campos.
    6. Selecione Pedir agora.
      Sua solicitação aparece na página Status do pedido.
    7. Selecione o número da solicitação para que você ou outro usuário com a função de administrador possa aprovar a solicitação.
      Selecione a solicitação para aprová-la
    8. Aprovar a solicitação: No formulário de solicitação, defina Aprovação e. Estado da solicitação . Aprovado .
      O processo de importação começa imediatamente após a aprovação.

    Importação existente GitLab pipelines e repositórios

    Depois de integrar GitLab com DevOps, você pode importar até 90 dias de existentes GitLab pipeline e dados do repositório. Em seguida, você pode usar DevOps painéis para exibir e gerenciar GitLab dados.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    • Você solicitará os dados do catálogo de serviços como um item do catálogo predefinido.
    • Os resumos de testes importados estão vinculados a execuções de pipeline e não a execuções de etapa.
    • Somente artefatos publicados usando a palavra-chave artefatos são importados.
    • Os resultados do teste não são exibidos para artefatos que expiraram. Você pode definir a data de expiração de um artefato configurando o. expire_in propriedade no pipeline. Para obter mais informações sobre políticas de expiração de artefato, consulte Expiração de metadados de artefato e trabalho .
    • Os resultados da verificação do SonarQube não são importados.
    • Apenas 6400 confirmações por ramificação podem ser importadas em uma única importação.
    • O GitLab impõe a seguinte restrição: Ao associar confirmações de execução a uma execução de pipeline, o GitLab não fornece a parte inicial dos detalhes de confirmação em alguns cenários. Ele fornece somente a parte antes do SHA como "0000000000000000". Nesses cenários, a confirmação mais recente será associada como a confirmação de execução. Por exemplo, quando uma nova ramificação é criada ou quando um pipeline é executado manualmente.
      Nota:
      O processo de importação pode levar algum tempo, horas para conjuntos de dados muito grandes.

    Procedimento

    1. Navegar até Tudo > Catálogo de serviços > Definições de Catálogo > Meus catálogos e selecione Integração do DevOps .
    2. Em Itens do catálogo lista relacionada, selecione Integração do app DevOps .
    3. No formulário Item do catálogo, selecione Experimente para solicitar os dados.
      O formulário de Integração da aplicação DevOps resultante permite especificar o item do catálogo a ser solicitado. Nesse caso, o "app" a ser solicitado é seu GitLab instância.

      Especifique a instância no formulário de integração

    4. Selecione o ícone Selecionar na lista ( Ícone de aplicações) no Aplicação e selecione sua instância de GitLab.
      Agora que você especificou a instância, especificará o intervalo de datas e as fontes de dados a serem importados.
    5. Repita o procedimento a seguir para cada repositório que você deseja importar:
      1. Selecione o ícone Selecionar na lista ( Ícone de aplicações) no Repositórios de integração e selecione o item a ser importado.
        Você pode selecionar vários itens.
      2. Especifique o intervalo de datas para os dados em Importar de e. Importar para campos.
      Nota:
      Os pipelines mapeados para os repositórios são selecionados automaticamente quando você seleciona o repositório no Repositórios de integração campo. Você não precisa selecionar os pipelines separadamente.
    6. Selecione Pedir agora.
      Sua solicitação aparece na página Status do pedido.
    7. Selecione o número da solicitação para que você ou outro usuário com a função de administrador possa aprovar a solicitação.
      Selecione a solicitação para aprová-la
    8. Aprovar a solicitação: No formulário de solicitação, defina Aprovação e. Estado da solicitação . Aprovado .
      O processo de importação começa imediatamente após a aprovação.