Você pode executar um pipeline a partir do cartão de pipeline, no modo de edição de pipeline e a partir da execução do pipeline. Você também pode usar os gatilhos disponíveis para que o Code Stream execute um pipeline quando determinados eventos ocorrerem.

Quando todos os estágios e tarefas do pipeline forem válidos, ele estará pronto para ser liberado, executado ou disparado.

Para executar ou disparar seu pipeline usando o Code Stream, você pode ativar e executar o pipeline do cartão de pipeline ou enquanto estiver no pipeline. Em seguida, você pode visualizar a execução do pipeline para confirmar se o pipeline criou, testou e implantou seu código.

Quando uma execução de pipeline estiver em andamento, você poderá excluir a execução se for um administrador ou um usuário não administrador.

  • Administrador: para excluir a execução de um pipeline quando estiver em execução, clique em Execuções. Na execução a ser excluída, clique em Ações > Excluir.
  • Usuário não administrador: para excluir uma execução de pipeline em execução, clique em Execuções e em Alt Shift d.

Quando uma execução de pipeline estiver em andamento e parecer travada, um administrador poderá atualizá-la na página de Execuções ou na página de Detalhes da execução.

  • Página Execuções: clique em Execuções. Na execução a ser atualizada, clique em Ações > Sincronizar.
  • Página Detalhes da execução: clique em Execuções, no link para ver os detalhes da execução e em Ações > Sincronizar.

Para executar um pipeline quando ocorrerem eventos específicos, use os gatilhos.

  • O gatilho Git poderá executar um pipeline quando os desenvolvedores atualizarem o código.
  • O gatilho Gerrit poderá executar um pipeline quando ocorrerem revisões de código.
  • O gatilho Docker poderá executar um pipeline quando um artefato for criado em um registro de Docker.
  • Os comandos curl ou wget podem fazer com que o Jenkins execute um pipeline após a conclusão de uma compilação do Jenkins.

Para obter mais informações sobre como usar os gatilhos, consulte Disparando pipelines no Code Stream.

O procedimento a seguir mostra como executar um pipeline do cartão de pipeline, visualizar execuções, ver os detalhes da execução e usar as ações. Ele também mostra como liberar um pipeline para que você possa adicioná-lo ao vRealize Automation Service Broker.

Pré-requisitos

Procedimento

  1. Habilite seu pipeline.
    Para executar ou liberar um pipeline, você deve habilitá-lo primeiro.
    1. Clique em Pipelines.
    2. No seu cartão de pipeline, clique em Ações > Ativar.
      No menu Ações do cartão de pipeline, você deve ativar o pipeline antes de o executar.

      Você também pode habilitar seu pipeline enquanto estiver nele. Se o seu pipeline já estiver habilitado, o comando Executar estará ativo, e o menu Ações exibirá Desativar.

  2. (Opcional) Liberte seu pipeline.
    Se quiser disponibilizar o pipeline como um item de catálogo no vRealize Automation Service Broker, deverá liberá-lo no Code Stream.
    1. Clique em Pipelines.
    2. No seu cartão de pipeline, clique em Ações > Liberar.
      Você também pode liberar seu pipeline enquanto estiver nele.
      No menu Ações da configuração do modelo de pipeline, você pode liberar o pipeline.

      Depois de liberar o pipeline, abra o Service Broker para adicionar o pipeline como um item de catálogo e executá-lo. Consulte Adicionar pipelines do Code Stream ao catálogo do Service Broker, em Usando e gerenciando o Service Broker.

      Observação: Se o pipeline exigir mais de 120 minutos para ser executado, forneça um tempo de execução aproximado como um valor de tempo limite da solicitação. Para definir ou revisar o tempo limite da solicitação para um projeto, abra o Service Broker como administrador e selecione Infraestrutura > Projetos. Clique no nome do projeto e depois em Provisionando.

      Se o valor de tempo limite da solicitação não estiver definido, uma execução que exige mais de 120 minutos para ser executada aparece como falha com um erro de solicitação de tempo limite de retorno de chamada. No entanto, a execução do pipeline não é afetada.

  3. No cartão de pipeline, clique em Executar.
  4. Para exibir o pipeline enquanto ele é executado, clique em Execuções.
    O pipeline executa cada estágio em sequência, e a execução do pipeline exibe um ícone de status para cada estágio. Se o pipeline incluir uma tarefa de operação do usuário, um usuário deverá aprovar a tarefa para que o pipeline continue a ser executado. Quando uma tarefa de operação do usuário é usada, o pipeline para de ser executado e aguarda o usuário necessário aprovar a tarefa.
    Por exemplo, você pode usar a tarefa de operação do usuário para aprovar a implantação do código em um ambiente de produção.
    Se a tarefa Operação do Usuário tiver um tempo limite de expiração definido em dias, horas ou minutos, o usuário necessário deverá aprovar o pipeline antes da expiração da tarefa. Caso contrário, o pipeline falhará conforme esperado.
    Um pipeline que foi executado e está aguardando aprovação exibe o status de espera próximo a Estágios.
  5. Para ver o estágio do pipeline que está aguardando a aprovação do usuário, clique no ícone de status do estágio.
    O estágio do pipeline que está aguardando aprovação exibe as tarefas no estágio.
  6. Para ver os detalhes da tarefa, clique na tarefa.
    Após o usuário necessário aprovar a tarefa, um usuário que tiver a função apropriada deverá retomar o pipeline. Para conhecer as funções necessárias, consulte Como gerenciar o acesso do usuário e as aprovações no Code Stream.
    Se uma execução falhar, você deverá fazer a triagem e corrigir a causa da falha. Em seguida, vá até a execução e clique em Ações > Executar novamente.
    Você poderá retomar as execuções de pipelines primários e execuções aninhadas.
    Uma tarefa de pipeline que está aguardando aprovação exibe um link que abre essa tarefa.
  7. Na execução do pipeline, você pode clicar em Ações para visualizar o pipeline e selecionar uma ação, como Pausar, Cancelar e muito mais. Quando uma execução de pipeline estiver em andamento se você for um administrador, poderá excluir ou sincronizar a execução do pipeline. Se você for um usuário não administrador, poderá excluir um pipeline em execução.
  8. Para navegar facilmente entre as execuções e ver os detalhes de uma tarefa, clique em Execuções e clique em uma execução de pipeline. Em seguida, clique na guia na parte superior e selecione a execução do pipeline.
    Para examinar uma execução de pipeline específica, clique em um dos números de execução de pipeline na parte superior.

Resultados

Parabéns! Você executou um pipeline, examinou a execução do pipeline e visualizou uma tarefa de operação do usuário que exigiu aprovação para que o pipeline continuasse a ser executado. Você também usou o menu Ações na execução do pipeline para retornar ao modelo de pipeline, para poder fazer quaisquer alterações necessárias.

O que Fazer Depois

Para saber mais sobre como usar o Code Stream para automatizar o ciclo de liberação do software, consulte Tutoriais para usar o Code Stream.