Configurando o Delivery Pipeline

DevOps Insights chegará ao fim de sua vida útil e será descontinuado em 31 de agosto de 2026. O serviço Continuous Delivery será descontinuado nas seguintes regiões em 12 de fevereiro de 2027: au-syd, ca-tor, us-east. O Code Risk Analyzer também será descontinuado em todas as regiões nessa data. Se uma região não apresentar uso ativo desses recursos, os recursos nessa região poderão ser descontinuados antecipadamente e deixar de aceitar novas instâncias. Saiba mais

O Delivery Pipeline automatiza a implementação contínua de seus projetos por meio de sequências de estágios que recuperam tarefas de entrada e de execução, como construções, testes e implementações.

Configure o Delivery Pipeline para automatizar a construção, o teste e a implementação contínua de seus apps:

Se você estiver configurando essa integração de ferramenta durante a criação da cadeia de ferramentas, na seção Integrações configuráveis, clique em Delivery Pipeline. Dependendo do modelo que usar, campos diferentes poderão estar disponíveis. Revise os valores de campo padrão e, se necessário, mude essas configurações.
Se você já possui uma cadeia de ferramentas e deseja adicionar essa integração de ferramenta a ela, no console do IBM Cloud, clique no ícone de menu ( ) > Automação de Plataforma > Cadeias de Ferramentas. Na página Cadeias de ferramentas, clique na cadeia de ferramentas na qual você deseja incluir o Delivery Pipeline.

a. Clique em Incluir ferramenta.

b. Na seção Integrações de ferramentas, clique em Delivery Pipeline.
Especifique um nome para seu novo pipeline.
Selecione o tipo de pipeline que deseja criar:
- Clássico: Oferece uma interface gráfica de usuário fácil de usar para definir etapas e tarefas executadas em uma infraestrutura pública compartilhada, com suporte para a execução de etapas individuais em workers privados.
- Tekton: fornece um painel que pode ser usado para visualizar a saída de execuções do pipeline Tekton em um cluster Kubernetes definido, com suporte para configurar repositórios de definições de pipeline, os acionadores de pipeline, onde o pipeline é executado e segredos simples.
Se você planeja usar seu pipeline para implantar uma interface de usuário e seu pipeline for do tipo Clássico, marque a caixa de seleção “Mostrar aplicativos no menu Exibir aplicativo ”. Todos os apps que seu pipeline criar serão mostrados na lista Visualizar app na página Visão geral da cadeia de ferramentas.
Clique em Criar integração para incluir o Delivery Pipeline em sua cadeia de ferramentas.
Na sua cadeia de ferramentas, na placa Pipelines de entrega, clique no pipeline de entrega para visualizá-lo e configurá-lo. Para aprender os fundamentos da configuração de um pipeline, consulte Construindo e implementando pipelines.

Se desejar que o pipeline seja executado automaticamente quando uma confirmação é enviada por push para o seu repositório GitHub ou Git (repositório), siga estas etapas:

a. Configure o GitHub ou o Git Repos and Issue Tracking para a sua cadeia de ferramentas antes de definir os estágios para o seu pipeline. Os estágios de pipeline precisam das URLs do Git para os seus repositórios. Cada estágio de pipeline pode referenciar apenas um dos repositórios GitHub ou Git que estão associados à sua cadeia de ferramentas. Para obter instruções para configurar o GitHub, consulte a seção GitHub. Para obter instruções para configurar o Git Repos and Issue Tracking, consulte a seção Git Repos and Issue Tracking.

b. Use um webhook. Sem um webhook, só será possível executar pipelines manualmente. Para usar um webhook ao vincular-se a um repositório GitHub ou GitHub Enterprise, é preciso ter privilégios do administrador. Para vincular-se a um proprietário do Git Repos and Issue Tracking, é preciso ter privilégios de Principal ou Proprietário.
Opcional: se você estiver usando uma cadeia de ferramentas no IBM Cloud Public e desejar que os Sauce Labs sigam testes em seu aplicativo, configure o Delivery Pipeline para incluir uma tarefa de teste dos Sauce Labs. Para obter instruções para configurar a tarefa de teste, consulte a seção Configurando uma tarefa de teste Sauce Labs em seu pipeline.

Configurando uma tarefa de teste Sauce Labs em seu pipeline

Antes de configurar uma tarefa de teste do Sauce Labs em seu pipeline, é necessário um pipeline de trabalho que tenha estágios para construir e implementar seu app. Deve-se também configurar o Sauce Labs para sua cadeia de ferramentas. Para obter instruções sobre como configurar Sauce Labs, consulte a seção Sauce Labs.

Configure o Delivery Pipeline para incluir uma tarefa de teste Sauce Labs:

Se você não tiver um estágio que implemente uma versão de teste de seu app, crie um.
No estágio, inclua uma tarefa de teste após a tarefa de implementação. Ao colocar essas tarefas no mesmo estágio, elas poderão acessar o mesmo conjunto de propriedades do ambiente.

de
Configure o estágio. Na guia PROPRIEDADES DO AMBIENTE, crie a propriedade CF_APP_NAME.

O nome de usuário e a chave de acesso do Sauce Labs estão disponíveis no script da tarefa de teste como as variáveis de ambiente SAUCE_USERNAME e SAUCE_ACCESS_KEY. Ao escrever seus testes, deve-se usar essas variáveis de ambiente para autenticar com Sauce Labs.
Configure a tarefa de implementação. No campo Implementar script, inclua esse comando: export CF_APP_NAME="$CF_APP". Esse comando exporta o nome do app como uma propriedade do ambiente.
Configure a tarefa de teste.

Os campos “Instância do serviço ”, “Destino”, “Organização” e “Espaço” são preenchidos com o nome de usuário, a região, a organização e o espaço do Sauce Labs que você está utilizando.

a. Para o tipo de testador, selecione Sauce Labs.

b. Para a instância do serviço, selecione o nome de usuário do Sauce Labs que você utilizou ao configurar o Sauce Labs para sua cadeia de ferramentas.

Para visualizar o nome de usuário e a chave de acesso que você utilizou ao configurar o Sauce Labs para sua cadeia de ferramentas, clique em “Configurar ”.

c. No campo Comando de execução de teste, insira os comandos que instalam as dependências que são requeridas por seus testes e, em seguida, execute os testes. Por exemplo, para um aplicativo Node.js, você pode inserir esses comandos:
```
npm install
node_modules/grunt-cli/bin/grunt test:sauce:parallel
```
d. Se quiser ver seus relatórios de teste nos logs da tarefa de teste, marque a caixa de seleção Ativar relatório de teste e configure o Padrão do arquivo de resultado de teste como test/*.xml.
Clique em Salvar. Sempre que a sua pipeline for executada, os seus testes dos Sauce Labs serão executados.

Configurando o Delivery Pipeline por meio da API

A integração de Delivery Pipeline ferramentas suporta os seguintes parâmetros de configuração que você pode usar com a API e os SDKs HTTP da Toolchain ao criar, ler e atualizar integrações de ferramentas.

Você deve especificar a propriedade tool_type_id no corpo da solicitação com o valor pipeline.

parâmetros de integração da ferramentaDelivery Pipeline
Parâmetro	Uso	Tipo	Argumento de Terraform	Descrição
nome	opcional, atualizável	Sequência	nome	O nome dessa integração de ferramenta.