Como integrar o
Automation Pipelines
ao
Automation Orchestrator

O
Automation Pipelines
pode se integrar ao
Automation Orchestrator
(
Orchestrator
) para estender sua capacidade executando fluxos de trabalho do
Orchestrator
. O
Automation Orchestrator
inclui muitos fluxos de trabalho predefinidos que podem ser integrados a ferramentas de terceiros. Esses fluxos de trabalho ajudam a automatizar e gerenciar seus processos de DevOps, automatizar as operações em massa e muito mais.
  • Verifique se, como administrador, você pode acessar uma instância local do
    Automation Orchestrator
    . Para obter ajuda, consulte seu próprio administrador e a documentação do vRealize Orchestrator.
  • Verifique se você é membro de um projeto no
    Automation Pipelines
    . Se não for, peça a um administrador do
    Automation Pipelines
    para adicioná-lo como membro de um projeto. Consulte Como adicionar um projeto no Automation Pipelines.
  • No
    Automation Pipelines
    , crie um pipeline e adicione um estágio.
Por exemplo, é possível usar um fluxo de trabalho em uma tarefa do
Orchestrator
no pipeline para ativar um usuário, remover um usuário, mover VMs, integrar as estruturas de teste para testar o código enquanto o pipeline é executado, e muito mais. Para procurar exemplos de código para fluxos de trabalho do
Automation Orchestrator
, acesse https://developer.broadcom.com/ e clique em
Exemplo de Código
.
Com um fluxo de trabalho do
Automation Orchestrator
, seu pipeline pode executar uma ação enquanto compila, testa e implanta o aplicativo. É possível incluir fluxos de trabalho predefinidos no pipeline ou criar e usar fluxos de trabalho personalizados. Cada fluxo de trabalho inclui entradas, tarefas e saídas.
Para executar um fluxo de trabalho do
Orchestrator
no pipeline, o fluxo de trabalho deve aparecer na lista de fluxos de trabalho disponíveis na tarefa do
Orchestrator
incluída no pipeline.
Antes que o fluxo de trabalho possa aparecer na tarefa do
Orchestrator
no pipeline, um administrador deve realizar as seguintes etapas no
Automation Orchestrator
:
  1. Aplique a tag
    CODESTREAM
    ao fluxo de trabalho do
    Orchestrator
    .
  2. Marque o fluxo de trabalho do
    Orchestrator
    como global.
  1. Como administrador, prepare um fluxo de trabalho do
    Automation Orchestrator
    para que seu pipeline seja executado.
    1. No
      Automation Orchestrator
      , localize o fluxo de trabalho que você precisa usar no pipeline, como um fluxo de trabalho para habilitar um usuário.
      Se um fluxo de trabalho que não existe for necessário, é possível criá-lo.
    2. Na barra de pesquisa, insira
      Fluxo de trabalho de tag
      para encontrar o fluxo de trabalho denominado
      Fluxo de trabalho de tag
      .
    3. No cartão denominado
      Fluxo de trabalho de tag
      , clique em
      Executar
      , o que exibe a área de configuração.
    4. Na área de texto
      Fluxo de trabalho marcado
      , insira o nome do fluxo de trabalho a ser usado no pipeline do
      Automation Pipelines
      e, em seguida, selecione-o na lista.
    5. Nas áreas de texto
      Tag
      e
      Valor
      áreas de texto, insira
      CODESTREAM
      em letras maiúsculas.
    6. Clique na caixa de seleção denominada
      Tag global
      .
    7. Clique em
      Executar
      , o que anexa a tag chamada
      CODESTREAM
      ao fluxo de trabalho que você precisa selecionar no pipeline do
      Automation Pipelines
      .
    8. No painel de navegação, clique em
      Fluxos de trabalho
      e confirme se a tag chamada
      CODESTREAM
      aparece no cartão de fluxo de trabalho em que o pipeline será executado.
      Depois de fazer login no
      Automation Pipelines
      e adicionar uma tarefa do
      Orchestrator
      ao seu pipeline, o fluxo de trabalho marcado aparecerá na lista de fluxos de trabalho.
  2. No
    Automation Pipelines
    , crie um endpoint para a instância do
    Automation Orchestrator
    .
    1. Clique em
      Endpoints
      Novo Endpoint
      .
    2. Selecione um projeto.
    3. Digite um nome relevante.
    4. Insira a URL do endpoint do
      Automation Orchestrator
      .
      Use este formato:
      https://orchestrator-appliance.yourdomain.local:8281
      Não use este formato: https://orchestrator-appliance.yourdomain.local:8281/vco/api
      A URL para uma instância do
      Automation Orchestrator
      que está integrada no dispositivo do
      VMware Aria Automation
      , é o FQDN do dispositivo sem uma porta. Por exemplo:
      https://automation-appliance.yourdomain.local/vco
      Para dispositivos do
      Automation Orchestrator
      externos que começam com o
      VMware Aria Automation
      8.x, o FQDN do dispositivo é
      https://orchestrator-appliance.yourdomain.local
      Para dispositivos do
      Automation Orchestrator
      externos incluídos com o
      VMware Aria Automation
      7.x, o FQDN do dispositivo é
      https://orchestrator-appliance.yourdomain.local:8281/vco
      Se ocorrer um problema ao adicionar o endpoint, talvez você precise importar uma configuração do YAML com uma impressão digital de certificado SHA-256 com os dois pontos removidos. Por exemplo,
      B0:01:A2:72...
      se torna
      B001A272...
      . O código YAML de amostra é semelhante a:
      ``` --- project: Demo kind: ENDPOINT name: external-orchestrator description: '' type: orchestrator properties: url: https://yourVROhost.yourdomain.local username: yourusername password: yourpassword fingerprint: <your_fingerprint> ```
    5. Clique em
      Aceitar Certificado
      caso a URL inserida precise de um certificado.
    6. Se o endpoint do
      Automation Orchestrator
      tiver a versão 8.0 a 8.7, você poderá selecionar
      Autenticação Básica
      ou
      Token
      para o tipo de Autenticação. Se o endpoint do
      Automation Orchestrator
      tiver a versão 8.8 ou posterior, você deverá selecionar
      Token
      para o tipo de Autenticação.
      Se o endpoint do
      Automation Orchestrator
      tiver a versão 8.8 ou posterior, não selecione
      Autenticação Básica
      . Não há suporte para Autenticação Básica e a criação do endpoint falhará.
      • Se você selecionar
        Autenticação Básica
        , digite o nome de usuário e a senha do servidor do
        Automation Orchestrator
        .
        Se você estiver usando um usuário não local para autenticação, deverá omitir a parte do domínio do nome de usuário. Por exemplo, para se autenticar com
        svc_vro@yourdomain.local
        , você deve
        svc_vro
        na área de texto
        Nome de usuário
        .
      • Se você selecionar
        Token
        para o tipo de autenticação, gere o Token Particular.
        O token de API do VMware Cloud Services autentica você para conexões de API externas com o
        Automation Pipelines
        . Para obter o token de API:
        1. Clique em
          Gerar Token
          .
        2. Insira o endereço de e-mail associado ao seu nome de usuário e senha e clique em
          Gerar
          .
          O token gerado será válido por seis meses. Ele também é conhecido como token de atualização.
          • Para manter o token como uma variável para uso futuro, clique em
            Criar Variável
            , insira um nome para a variável e clique em
            Salvar
            .
          • Para manter o token como um valor de texto para uso futuro, clique em
            Copiar
            e cole o token em um arquivo de texto para salvar localmente.
          Você pode optar por criar uma variável e armazenar o token em um arquivo de texto para uso futuro.
        3. Clique em
          Fechar
          .
  3. Prepare seu pipeline para executar a tarefa do
    Orchestrator
    .
    1. Adicione uma tarefa do
      Orchestrator
      ao estágio do seu pipeline.
    2. Digite um nome relevante.
    3. Na área Propriedades do Fluxo de Trabalho, selecione o endpoint do
      Automation Orchestrator
      .
    4. Selecione o fluxo de trabalho que você marcou como
      CODESTREAM
      no
      Automation Orchestrator
      .
      Se selecionar um fluxo de trabalho personalizado seu, talvez seja necessário digitar os valores do parâmetro de entrada.
    5. Para
      Executar tarefa
      , clique em
      Na condição
      .
      Se você tiver que aplicar condições para a tarefa do Automation Orchestrator, insira-as na área Condição.
    6. Insira as condições aplicáveis à execução do pipeline.
      Quando executar o pipeline...
      Selecionar condições...
      Na Condição
      Executa a tarefa de pipeline somente se a condição definida for avaliada como verdadeira. Se a condição for falsa, a tarefa será ignorada.
      A tarefa do
      Orchestrator
      permite que você inclua uma expressão booleana que use os seguintes operandos e operadores.
      • Variáveis de pipeline, como
        ${pipeline.variableName}
        . Use chaves somente ao inserir variáveis.
      • Variáveis de saída da tarefa, como
        ${Stage1.task1.machines[0].value.hostIp[0]}
        .
      • Variáveis de associação de pipeline padrão, como
        ${releasePipelineName}
        .
      • Valores booleanos que não fazem distinção de maiúsculas e minúsculas, como
        true
        ,
        false
        ,
        'true'
        ,
        'false'
        .
      • Valores inteiros ou decimais sem aspas.
      • Valores de cadeia de caracteres usados com aspas simples ou duplas, como
        "test"
        ,
        'test'
        .
      • Tipos numéricos e de cadeia de caracteres de valores, como
        == Equals
        e
        != Not Equals
        .
      • Operadores relacionais, como
        >
        ,
        >=
        ,
        <
        e
        <=
        .
      • Lógica booleana, como
        &&
        e
        ||
        .
      • Operadores aritméticos, como
        +
        ,
        -
        ,
        *
        e
        /
        .
      • Expressões aninhadas usando parênteses.
      • As cadeias de caracteres que incluem o valor literal
        ABCD
        são avaliadas como falso e a tarefa é ignorada.
      • Não há suporte para operadores unários.
      Um exemplo de condição pode ser
      ${Stage1.task1.output} == “Passed” || ${pipeline.variableName} == 39
      Sempre
      Se você selecionar
      Sempre
      , o pipeline executará a tarefa sem condições.
    7. Digite uma mensagem de saudação.
    8. Clique em
      Validar Tarefa
      e corrija os erros que ocorrerem.
  4. Salve, ative e execute o pipeline.
  5. Após a execução do pipeline, examine os resultados.
    1. Clique em
      Execuções
      .
    2. Clique no pipeline.
    3. Clique na tarefa.
    4. Examine os resultados, o valor de entrada e as propriedades.
      É possível identificar o ID de execução do fluxo de trabalho, quem respondeu à tarefa e quando, bem como quaisquer comentários incluídos.
Parabéns! Você marcou um fluxo de trabalho do
Automation Orchestrator
para uso no
Automation Pipelines
e adicionou uma tarefa do
Orchestrator
no seu pipeline do
Automation Pipelines
para que ele execute um fluxo de trabalho que automatiza uma ação no seu ambiente do DevOps.
Formato de saída da tarefa do Orchestrator
O formato de saída para uma tarefa do
Orchestrator
é semelhante a este exemplo.
[{ "name": "result", "type": "STRING", "description": "Result of workflow run.", "value": "" }, { "name": "message", "type": "STRING", "description": "Message", "value": "" }]
Continue incluindo tarefas de fluxo de trabalho do
Orchestrator
nos pipelines para poder automatizar tarefas em seus ambientes de desenvolvimento, teste e produção.