Agregando dados de múltiplas origens em uma única cadeia de ferramentas

DevOps Insights chegará ao fim de sua vida útil e será descontinuado em 31 de agosto de 2026. Após essa data, o serviço não estará mais disponível. Não é mais possível criar novas integrações de ferramentas do DevOps Insights. Saiba mais

Por padrão, os dados gerados pelo pipeline ou por outras ferramentas são agregados à cadeia de ferramentas na qual as ferramentas estão contidas. Com o IBM Cloud® DevOps Insights, é possível agregar dados de qualidade gerados pelo IBM Cloud® Continuous Delivery por meio de múltiplas origens em uma única cadeia de ferramentas.

Diagrama de várias fontes canalizadas em uma única cadeia de
em uma cadeia de ferramentas central com
específicas*

Antes de Iniciar

  1. Configure o seu pipeline do Continuous Delivery para enviar registros de construção, de teste e de implementação para o DevOps Insights. Para obter mais informações sobre registros de construção, de teste e de implementação, consulte Publicando um registro de construção, Publicando um registro de implementação e Publicando resultados de teste.

  2. Defina políticas de porta na cadeia de ferramentas única a ser usada para agregar os relatórios de portas.

Identificando o ID de sua cadeia de ferramentas

É necessário ter o ID da cadeia de ferramentas para fazer a integração entre o Jenkins, o Travis CI e outras ferramentas de integração e entrega contínuas (CI/CD) e o IBM Cloud® DevOps Insights. Você também pode usar o ID da sua cadeia de ferramentas para configurar a agregação de dados de várias fontes em uma única cadeia de ferramentas.

Para obter mais informações sobre a integração de ferramentas de integração contínua e entrega contínua com DevOps Insights, consulte Integração de ferramentas de integração contínua e entrega contínua com DevOps Insights.

Localizando o ID de sua cadeia de ferramentas

O ID da cadeia de ferramentas está contido na URL. Para obter o ID de sua cadeia de ferramentas, conclua as seguintes etapas:

  1. No console IBM Cloud®, clique no ícone de hambúrguer Menu > Automação da plataforma > Cadeias de ferramentas.
  2. Na página Cadeias de ferramentas, selecione sua cadeia de ferramentas.
  3. Na página de visão geral da sua cadeia de ferramentas, na placa Ferramentas da IBM Cloud, clique em DevOps Insights.
  4. Na URL, copie tudo o que houver depois de ?toolchainId= na sequência de caracteres. Essa sequência tem 36 caracteres de comprimento e é composta por caracteres alfanuméricos e traços.

Se você desejar localizar o ID da cadeia de ferramentas para o Jenkins, selecione Jenkins na cadeia de ferramentas em vez de DevOps Insights. É possível usar o mesmo método para localizar o ID da cadeia de ferramentas na URL.

Por exemplo, https://cloud.ibm.com/devops/insights/overview?toolchainid=99c643c3-23d9-4030-9b1f-3aadfd7f9d09. O ID da cadeia de ferramentas é 99c643c3-23d9-4030-9b1f-3aadfd7f9d09.

O API_KEY usado no script para efetuar login no IBM Cloud deve ter acesso ao novo toolchain_id fornecido. Para obter mais informações sobre a criação e o gerenciamento de chaves de API, consulte Gerenciando as chaves de API do usuário.

Publicando registros em uma cadeia de ferramentas de destino centralizada

Para publicar dados em uma única cadeia de ferramentas, deve-se modificar os scripts de seus estágios de pipeline, mas deve-se modificar os estágios pelos quais você está publicando dados. Modifique os estágios apenas quando você deseja publicar os dados em uma cadeia de ferramentas diferente. Não quando você deseja publicar dados na cadeia de ferramentas atual em que o pipeline está.

Para publicar seus registros em uma cadeia de ferramentas centralizada, conclua as seguintes etapas:

  1. Clique no ícone de menu ( ícone de hambúrguer ) e selecione “Lista de recursos ”.
  2. Selecione sua cadeia de ferramentas.
  3. Na página de visão geral da sua cadeia de ferramentas, na placa Pipelines de entrega, clique no pipeline que você deseja utilizar.
  4. Clique no ícone Configurações ícone de engrenagem e em Configurar estágio.
  5. Faça suas mudanças na seção de script. Para cada estágio em que você chamou comandos para enviar registros de construção, teste e implementação, configure TOOLCHAIN_ID como a variável de ambiente para o ID da cadeia de ferramentas. Exporte o ID da cadeia de ferramentas antes que as variáveis chamem o comando.
  6. Chame comandos para decisões de porta ou envie registros de construção, teste e implementação para o DevOps Insights. Para obter mais informações, consulte Configurando valores de parâmetro consistentes usando a CLI do IBM Cloud®.

Exporte TOOLCHAIN_ID como variável de ambiente para estágios do pipeline em que eles estão usando a CLI do DevOps Insights.

O exemplo a seguir mostra como enviar registros de construção para o DevOps Insights em outra cadeia de ferramentas. Deve-se sobrescrever o ID da cadeia de ferramentas antes de chamar o comando para avaliar a porta e publicar os registros de construção, teste ou implementação.

#!/bin/bash
#install the latest version of the DevOps Insights plugin
ibmcloud plugin install -f doi
# Login to IBMCloud if you are not already logged in.  Assumes that $API_KEY environment variable has been set as a secured property in environment variable
ibmcloud login --apikey $API_KEY --no-region
# Overwrite the default TOOLCHAIN_ID with the Toolchain ID of the DevOps Insights instance you would like to send data to
export TOOLCHAIN_ID="$DEVOPS_INSIGHTS_TOOLCHAIN_ID"
# $GIT_BRANCH, $GIT_URL, $GIT_COMMIT are environment variables made available by the Continuous Delivery pipeline
# Assumes you have set $MY_APP_NAME and $MY_BUILD_NUMBER as described earlier
ibmcloud doi buildrecord-publish --logicalappname="$MY_APP_NAME" --buildnumber="$MY_BUILD_NUMBER" --branch $GIT_BRANCH --repositoryurl $GIT_URL --commitid $GIT_COMMIT --status pass

Agregação de dados de DevOps no painel de qualidade do Insights

O painel de qualidade fornece conjuntos de dados de qualidade, tais como testes de unidade, cobertura de código, testes de verificação funcional e varreduras de segurança estática para cada aplicativo. A página Painel de Qualidade trabalha com o IBM® Continuous Delivery Pipeline for IBM Cloud®, Jenkins, Travis e outras ferramentas de integração contínua e entrega contínua (CI/CD). Também é possível agregar dados de qualidade para aplicativos que são executados em múltiplas nuvens ou ambientes no local em uma única instância do IBM Cloud® DevOps Insights. Cada categoria fornece mais detalhes sobre testes específicos e a identificação de tendências. É possível especificar os tipos de testes que você deseja representar no painel. Para obter mais informações sobre conjuntos de dados, consulte Gerenciando conjuntos de dados.

Implantação Risco Painel de qualidade
Figura 1. Painel de Qualidade

A página Painel de qualidade mostra linhas de informações para cada app que está associado ao IBM Cloud® DevOps Insights. Todas as informações sobre sucessos e falhas para cada teste para cada app estão disponíveis em uma tela. A página Quality Dashboard também exibe as tags associadas aos testes no momento do upload. Ao selecionar uma tag no menu, você pode limitar as informações que são exibidas na página a essa tag. Por padrão, a página exibe todas as tags associadas aos testes.

É possível localizar a página Painel de qualidade no painel do DevOps Insights.

  1. No console IBM Cloud, clique no ícone de hambúrguer Menu > Automação da plataforma > Cadeias de ferramentas.
  2. Na página de Cadeias de ferramentas, clique em sua cadeia de ferramentas para abrir sua página de visão geral.
  3. Na placa Ferramentas da IBM Cloud, clique na integração de ferramenta DevOps Insights.
  4. No menu, selecione Painel de qualidade.