Construindo e implementando

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 IBM Cloud® Continuous Delivery inclui o Delivery Pipeline, que é possível usar para implementar um processo repetido de integração contínua e entrega contínua.

Conclua as tarefas a seguir para configurar um pipeline.

Incluindo um estágio

  1. Na página Pipeline, clique em INCLUIR ESTÁGIO. A página Configuração do estágio é aberta.

  2. Configure o estágio.

    a. Na guia ENTRADA, selecione uma entrada para o estágio. Para estágios de Construção, a guia de entrada inclui um campo Ramificação para especificar a ramificação no repositório a ser usada para entrada.

    b. Na guia TAREFAS, inclua e configure pelo menos uma tarefa. O primeiro estágio normalmente tem pelo menos uma tarefa de construção.

  3. Clique em Salvar.

Incluindo uma tarefa em um estágio

  1. No estágio, clique no ícone Configuração do estágio e, em seguida, clique em Configurar estágio.
  2. Clique na guia TAREFAS.
  3. Clique em INCLUIR TAREFA. Selecione o tipo de tarefa a ser incluído.
  4. Configure a tarefa.
  5. Clique em Salvar.

Adicionar um trabalho a um
um trabalho a um

Executando um estágio

É possível executar manualmente um estágio clicando no ícone Executar estágio na página Pipeline.

Clicar no ícone Run Stage em um
um

É possível também solicitar construções e implementações sob demanda na página de histórico de construções de uma de duas maneiras:

  • Arraste uma construção para a caixa que está sob um estágio configurado.
  • Na seção RESULTADO DA ÚLTIMA EXECUÇÃO, clique no ícone Enviar para e, em seguida, selecione um espaço para implementar.

O estágio Execute com esse ícone de
de um

Para cancelar um estágio em execução, no estágio, clique em Visualizar logs e histórico. Na lista de tarefas, clique no número da tarefa em execução e, em seguida, clique em CANCELAR. É possível também cancelar tarefas individualmente clicando em uma tarefa e, em seguida, clicando em CANCELAR ou clicando no ícone Parar para uma tarefa em seu estágio.

Implementando um app

Uma tarefa de implementação configurada adequadamente implementa um app no destino sempre que é executada. Para executar manualmente uma tarefa de implementação, clique no ícone Executar estágio do estágio em que a tarefa está.

Revisões de entrada

Quando você executar um estágio manualmente ou se ele for executado porque o estágio antes dele foi concluído, o estágio em execução seleciona sua revisão de entrada. Normalmente, a revisão de entrada é um número de construção. Para selecionar a revisão de entrada, o estágio segue estas condições:

  • Se uma revisão específica for selecionada, use-a.
  • Se uma revisão específica não for especificada, procure estágios anteriores até que seja encontrado um estágio que use a mesma entrada. Localize e use a última revisão executada com sucesso dessa entrada.
  • Se uma revisão específica não for especificada e nenhum outro estágio usar a origem especificada como entrada, use a revisão mais recente da entrada.

É possível implementar uma construção anterior. No estágio que contém a construção, clique em Visualizar logs e histórico. Na página que é aberta, clique para expandir o número da execução e, em seguida, clique na tarefa de construção. Clique em ENVIAR PARA e selecione um destino.

Incluindo serviços em apps

É possível incluir serviços em seus apps e gerenciar esses serviços em seu painel do IBM Cloud. Para obter mais informações sobre a inclusão de serviços, consulte Conectando serviços a aplicativos externos.

Visualizando logs do

É possível visualizar os logs para tarefas e visualizar os estágios conforme eles estão sendo executados na página Histórico de estágios.

  1. Para visualizar o log de uma tarefa, clique na tarefa. Como alternativa, em um estágio, clique em Visualizar logs e histórico.

  2. Para visualizar o log de tempo de execução de um aplicativo implementado, clique em Visualizar log de tempo de execução.

    Além dos logs de tarefas, é possível visualizar resultados de testes, artefatos gerados e mudanças de código para qualquer tarefa de construção.

    Também é possível executar, reimplementar, cancelar ou configurar um estágio na página Histórico de estágios. Clique em EXECUTAR para executar o estágio, REIMPLEMENTAR para reimplementar, caso seja uma tarefa de implementação ou CONFIGURAR para configurar um estágio. Enquanto um estágio está em execução, é possível cancelá-lo clicando no número da execução e depois clicando em CANCELAR.

Fazendo download de logs por meio de um script

É possível fazer download do arquivo de log para uma tarefa de pipeline por meio de um script e salvar a PIPELINE_LOG_URL que é fornecida enquanto a tarefa de pipeline está em execução. O exemplo a seguir mostra as etapas para fazer upload do arquivo de log da tarefa de pipeline para um sistema diferente.

  1. Configure uma propriedade de ambiente JOB_LOG para seu estágio.

  2. Em sua tarefa de pipeline, salve a PIPELINE_LOG_URL.

    export JOB_LOG="$PIPELINE_LOG_URL"
    
  3. Use a PIPELINE_LOG_URL em uma tarefa posterior, dentro do mesmo estágio, para fazer download do arquivo de log para exportá-lo para um sistema diferente. Use um token de acesso do IBM Cloud para acessar o arquivo de log.

    ibmcloud login -a cloud.ibm.com \
      --apikey <INSERT API KEY HERE>
    BEARER=$( ibmcloud iam oauth-tokens | grep "IAM token" | sed 's/^.*Bearer //g' )
    curl -H "Authorization: Bearer $BEARER"  \
      -H "Accept: text/plain" \
      -D /tmp/headers.txt \
      -o job_log.txt \
      "$JOB_LOG"
    
  4. Verifique o cabeçalho X-More-Data. Se o cabeçalho está configurado como true, o arquivo de log está sendo gerado ou processado. Se o cabeçalho está configurado como false, o arquivo de log está pronto para o uso.

    grep X-More-Data /tmp/headers.txt
    X-More-Data: false
    
  5. Faça upload do arquivo de log em seu sistema.

    scp job_log.txt user@example.org:/job1/logs
    

Fazendo download de artefatos por meio de um script

E possível fazer download dos artefatos para uma tarefa de Compilação de pipeline por meio de um script e salvar a PIPELINE_ARTIFACT_URL que é fornecida enquanto a tarefa de pipeline está em execução. O exemplo a seguir mostra as etapas para fazer upload dos artefatos da tarefa de pipeline para um sistema diferente.

  1. Configure uma propriedade de ambiente JOB_ARTIFACT para seu estágio.

  2. Em sua tarefa de pipeline, salve a PIPELINE_ARTIFACT_URL.

    export JOB_ARTIFACT="$PIPELINE_ARTIFACT_URL"
    
  3. Use a PIPELINE_ARTIFACT_URL em uma tarefa posterior, dentro do mesmo estágio, para fazer download dos artefatos para exportá-los para um sistema diferente. Use um token de acesso do IBM Cloud para acessar os artefatos.

    ibmcloud login -a cloud.ibm.com \
      --apikey <INSERT API KEY HERE>
    BEARER=$( ibmcloud iam oauth-tokens | grep "IAM token" | sed 's/^.*Bearer //g' )
    DOWNLOAD_URL=$( curl -H "Authorization: Bearer $BEARER"  \
      "$JOB_ARTIFACT" )
    curl -O  "$DOWNLOAD_URL"
    
  4. Faça upload dos artefatos em seu sistema.

    scp $(basename "$DOWNLOAD_URL") user@example.org:/job1/artifacts