Importação de dados históricos para ferramentas DevOps
Use o catálogo de serviços para integrar um novo app e importar dados históricos DevOps para esse app. Habilite a pesquisa para importar dados mapeados para planos, repositórios e pipelines associados em uma frequência programada.
Importar dados históricos DevOps para ferramentas existentes
Você pode criar uma solicitação de integração de app e importar dados históricos para uma ferramenta DevOps que você já integrou, usando o formulário de catálogo de integração de apps. 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 Enterprise (codificação)
- Jenkins (Orquestração)
Nota:
- Certifique-se de ter criado, conectado e descoberto a ferramenta para a qual está importando dados.
- As solicitações de importação da ferramenta Planejar (Jira) são processadas primeiro, seguidas pelas solicitações de importação do repositório e do pipeline.
Importar fluxo de trabalho 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. O campo Detalhes de processamento do registro do 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: páginas são criadas por compilação.
Se a importação for bem-sucedida, você poderá exibir todas as confirmações importadas no :
- Filiais
- Confirmar
- Comprometidos
- Marcadores
- Repositórios
- Itens de trabalho
Ao processar uma solicitação de importação, se houver erros na página, um mecanismo de nova tentativa integrado tentará processar a página por um número definido de vezes. Depois de todas as novas tentativas automáticas, 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 (após 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 em .
- Especifique a contagem de novas tentativas para tentativa automática, caso a página de solicitação de importação falhe no campo Máximo de novas tentativas por página, durante a importação. 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 no botão Repetir importação, na página de solicitação de importação com falha,
Programação e configuração de pesquisa
Habilite a pesquisa para importar DevOps dados em uma frequência programada para apps que importaram dados históricos e estão mapeados para planos, repositórios e pipelines associados.
Depois de ter integrado um app e importado os dados DevOps associados, 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 as solicitações de importação concluem o processamento, os dados associados são persistentes e exibidos no app. Embora o trabalho de programação DevOpsImportPolling do sistema base esteja ativo por padrão, você deve habilitar a pesquisa nas propriedades DevOps para executar o trabalho agendado.
Para habilitar a pesquisa, navegue até e marque a caixa de seleção.
Ativar este sinalizador de propriedade habilita o trabalho de programação DevOpsImportPolling do sistema de base. O trabalho programado para pesquisa considera a última importação bem-sucedida ou 30 dias, o que ocorrer depois como a "data de início", e a data do dia atual como a "data de término" da importação de dados, para todos os apps ativos e rastreados pipelines. 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 programado importe o delta de dados DevOps relevantes para esse app, desde a última importação bem-sucedida até a data, até um máximo de trinta dias.
Nota:
A frequência padrão do trabalho é definida para ser executada diariamente à meia-noite usando o fuso horário do sistema. Para alterar a frequência do trabalho agendado, você precisa da função ServiceNow Now Platform Administrador (admin).Não configure uma frequência de pesquisa inferior a um dia ou 24 horas.
Navegar até e modifique os valores dos campos Frequência de execução, Fuso horárioe Tempo, conforme necessário. Para obter mais informações, consulte Trabalhos de programação
Nota:
- O trabalho agendado se aplica somente a apps ativos. Certifique-se de que o app para o qual você está configurando a pesquisa esteja no estado ativo e que o campo Rastrear esteja habilitado para os pipelines relevantes.
- Considere o seguinte ao modificar a frequência da programação:
- Para o JIRA, o fuso horário padrão é baseado no fuso horário do local do servidor JIRA.
- Para Jenkins, o fuso horário padrão é UTC. Para obter mais informações, consulte Jenkins a documentação sobre fusos horários da Hora do sistema.
Os trabalhos agendados que pesquisam para importar dados DevOps respeitam os valores padrão para as seguintes propriedades DevOps 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 como anexos no registro da página de solicitação de importação, defina o campo "Valor" como "verdadeiro". Qualquer outra coisa é considerada falsa.
Importar pipelines, repositórios e planos Azure DevOps existentes
Depois de integrar Azure DevOps com DevOps, você pode importar até 90 dias Azure DevOps de pipeline, repositório e dados do plano existentes. 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 teste, artefatos e pacotes importados sã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:
- Um máximo de 20.000 itens de trabalho podem ser importados a cada 15 dias.
- É possível mapear no máximo 200 confirmações de execução 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
-
No formulário Item do catálogo, selecione Testar para solicitar os dados.
O formulário de integração do app DevOps resultante permite que você especifique o item do catálogo a ser solicitado. Nesse caso, o "app" a ser solicitado é sua instância Azure DevOps.
-
Selecione o ícone Selecionar na lista (ícone
) no campo Aplicação e selecione sua instância de Azure DevOps.
Agora que especificou a instância, você especificará o intervalo de datas e as origens de dados a serem importados. -
Repita o procedimento a seguir para cada pipeline, repositório e plano que você deseja importar:
-
Selecione o ícone Selecionar na lista (ícone ) no campo de integração apropriado para selecionar o item a ser importado.
Você pode selecionar vários itens.
-
Selecione o ícone Selecionar na lista (ícone
-
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.
Importar pipelines e repositórios GitLab existentes
Depois de ter integrado GitLab com DevOps, você pode importar até 90 dias de pipeline GitLab existente e dados de repositório. 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 teste importados estão vinculados a execuções de pipeline e não a execuções de etapas.
- Somente artefatos publicados usando a palavra-chave artefatos são importados.
- Os resultados de testes não são exibidos para artefatos que expiraram. Você pode definir a data de expiração de um artefato configurando a propriedade expire_in no pipeline. Para obter mais informações sobre políticas de expiração de artefatos, consulte Expiração de metadados de artefatos e trabalhos.
- Os resultados da verificação do SonarQube não são importados.
- Somente 6.400 confirmações por ramificação podem ser importadas em uma única importação.
- O GitLab impõe a seguinte restrição: ao associar execuções de confirmações a uma execução de pipeline, o GitLab não fornece a parte inicial dos detalhes da 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
-
No formulário Item do catálogo, selecione Testar para solicitar os dados.
O formulário de integração do app DevOps resultante permite que você especifique o item do catálogo a ser solicitado. Nesse caso, o "app" a ser solicitado é sua instância GitLab.
-
Selecione o ícone Selecionar na lista (ícone ) no campo Aplicação e selecione sua instância de GitLab.
Agora que especificou a instância, você especificará o intervalo de datas e as origens de dados a serem importados.
-
Repita o procedimento a seguir para cada repositório que deseja importar:
-
Selecione o ícone Selecionar na lista (ícone ) no campo Repositórios de integração e selecione o item a ser importado.
Você pode selecionar vários itens.
Nota:Os pipelines mapeados para os repositórios são selecionados automaticamente quando você seleciona o repositório no campo Repositórios de integração. Você não precisa selecionar os pipelines separadamente. -
Selecione o ícone Selecionar na lista (ícone
-
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.