Como integrar o Automation Pipelines ao Automation Orchestrator
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 doAutomation Orchestrator. Para obter ajuda, consulte seu próprio administrador e a documentação do vRealize Orchestrator.
- Verifique se você é membro de um projeto noAutomation Pipelines. Se não for, peça a um administrador doAutomation Pipelinespara adicioná-lo como membro de um projeto. Consulte Como adicionar um projeto no Automation Pipelines.
- NoAutomation 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
: - Aplique a tagCODESTREAMao fluxo de trabalho doOrchestrator.
- Marque o fluxo de trabalho doOrchestratorcomo global.
- Como administrador, prepare um fluxo de trabalho doAutomation Orchestratorpara que seu pipeline seja executado.
- NoAutomation 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.
- Na barra de pesquisa, insiraFluxo de trabalho de tagpara encontrar o fluxo de trabalho denominadoFluxo de trabalho de tag.
- No cartão denominadoFluxo de trabalho de tag, clique emExecutar, o que exibe a área de configuração.
- Na área de textoFluxo de trabalho marcado, insira o nome do fluxo de trabalho a ser usado no pipeline doAutomation Pipelinese, em seguida, selecione-o na lista.
- Nas áreas de textoTageValoráreas de texto, insiraCODESTREAMem letras maiúsculas.
- Clique na caixa de seleção denominadaTag global.
- Clique emExecutar, o que anexa a tag chamadaCODESTREAMao fluxo de trabalho que você precisa selecionar no pipeline doAutomation Pipelines.
- No painel de navegação, clique emFluxos de trabalhoe confirme se a tag chamadaCODESTREAMaparece no cartão de fluxo de trabalho em que o pipeline será executado.Depois de fazer login noAutomation Pipelinese adicionar uma tarefa doOrchestratorao seu pipeline, o fluxo de trabalho marcado aparecerá na lista de fluxos de trabalho.
- NoAutomation Pipelines, crie um endpoint para a instância doAutomation Orchestrator.
- Clique em.
- Selecione um projeto.
- Digite um nome relevante.
- Insira a URL do endpoint doAutomation Orchestrator.Use este formato:https://orchestrator-appliance.yourdomain.local:8281Não use este formato: https://orchestrator-appliance.yourdomain.local:8281/vco/apiA URL para uma instância doAutomation Orchestratorque está integrada no dispositivo doVMware Aria Automation, é o FQDN do dispositivo sem uma porta. Por exemplo:https://automation-appliance.yourdomain.local/vcoPara dispositivos doAutomation Orchestratorexternos que começam com oVMware Aria Automation8.x, o FQDN do dispositivo éhttps://orchestrator-appliance.yourdomain.localPara dispositivos doAutomation Orchestratorexternos incluídos com oVMware Aria Automation7.x, o FQDN do dispositivo éhttps://orchestrator-appliance.yourdomain.local:8281/vcoSe 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 tornaB001A272.... 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> ```
- Clique emAceitar Certificadocaso a URL inserida precise de um certificado.
- Se o endpoint doAutomation Orchestratortiver a versão 8.0 a 8.7, você poderá selecionarAutenticação BásicaouTokenpara o tipo de Autenticação. Se o endpoint doAutomation Orchestratortiver a versão 8.8 ou posterior, você deverá selecionarTokenpara o tipo de Autenticação.Se o endpoint doAutomation Orchestratortiver a versão 8.8 ou posterior, não selecioneAutenticação Básica. Não há suporte para Autenticação Básica e a criação do endpoint falhará.
- Se você selecionarAutenticação Básica, digite o nome de usuário e a senha do servidor doAutomation 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 comsvc_vro@yourdomain.local, você devesvc_vrona área de textoNome de usuário.
- Se você selecionarTokenpara 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 oAutomation Pipelines. Para obter o token de API:
- Clique emGerar Token.
- Insira o endereço de e-mail associado ao seu nome de usuário e senha e clique emGerar.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 emCriar Variável, insira um nome para a variável e clique emSalvar.
- Para manter o token como um valor de texto para uso futuro, clique emCopiare cole o token em um arquivo de texto para salvar localmente.
- Clique emFechar.
- Prepare seu pipeline para executar a tarefa doOrchestrator.
- Adicione uma tarefa doOrchestratorao estágio do seu pipeline.
- Digite um nome relevante.
- Na área Propriedades do Fluxo de Trabalho, selecione o endpoint doAutomation Orchestrator.
- Selecione o fluxo de trabalho que você marcou comoCODESTREAMnoAutomation Orchestrator.Se selecionar um fluxo de trabalho personalizado seu, talvez seja necessário digitar os valores do parâmetro de entrada.
- ParaExecutar tarefa, clique emNa condição.
- Insira as condições aplicáveis à execução do pipeline.Quando executar o pipeline...Selecionar condições...Na CondiçãoExecuta 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 doOrchestratorpermite 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, comotrue,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== Equalse!= 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 literalABCDsã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} == 39SempreSe você selecionarSempre, o pipeline executará a tarefa sem condições. - Digite uma mensagem de saudação.
- Clique emValidar Tarefae corrija os erros que ocorrerem.
- Salve, ative e execute o pipeline.
- Após a execução do pipeline, examine os resultados.
- Clique emExecuções.
- Clique no pipeline.
- Clique na tarefa.
- 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.