Automation Pipelines se puede integrar con VMware Aria Automation Orchestrator (Orchestrator) para ampliar su capacidad mediante la ejecución de flujos de trabajo de Orchestrator. VMware Aria Automation Orchestrator incluye muchos flujos de trabajo predefinidos que se pueden integrar con herramientas de terceros. Estos flujos de trabajo ayudan a automatizar y administrar los procesos de DevOps, automatizar operaciones en bloque, y más.

Por ejemplo, puede utilizar un flujo de trabajo en una tarea de Orchestrator en la canalización para habilitar un usuario, eliminar un usuario, mover máquinas virtuales, realizar integraciones con marcos de pruebas para probar el código mientras se ejecuta la canalización y mucho más. Puede buscar ejemplos de código para flujos de trabajo de VMware Aria Automation Orchestrator en code.vmware.com.

Con un flujo de trabajo de VMware Aria Automation Orchestrator, la canalización puede ejecutar una acción a medida que compila, prueba e implementa la aplicación. Puede incluir flujos de trabajo predefinidos en la canalización, o bien crear y utilizar flujos de trabajo personalizados. Cada flujo de trabajo incluye entradas, tareas y salidas.

Para ejecutar un flujo de trabajo de Orchestrator en la canalización, el flujo de trabajo debe aparecer en la lista de flujos de trabajo disponibles de la tarea de Orchestrator que incluya en la canalización.

Para que el flujo de trabajo pueda aparecer en la tarea de Orchestrator en la canalización, un administrador debe realizar los siguientes pasos en VMware Aria Automation Orchestrator:

  1. Aplicar la etiqueta PIPELINES al flujo de trabajo de Orchestrator.
  2. Marcar el flujo de trabajo de Orchestrator como global.

Requisitos previos

  • Compruebe que puede acceder a una instancia local de VMware Aria Automation Orchestrator como administrador. Para obtener ayuda, consulte a su propio administrador y la documentación de vRealize Orchestrator.
  • Compruebe si es un miembro de un proyecto en Automation Pipelines. Si no lo es, solicite al administrador de Automation Pipelines que lo agregue como miembro de un proyecto. Consulte Cómo agregar un proyecto en Automation Pipelines.
  • En Automation Pipelines, cree una canalización y agregue una etapa.

Procedimiento

  1. Como administrador, prepare un flujo de trabajo de VMware Aria Automation Orchestrator para que la canalización se ejecute.
    1. En VMware Aria Automation Orchestrator, busque el flujo de trabajo que necesita utilizar en la canalización, como un flujo de trabajo para habilitar un usuario.
      Si necesita un flujo de trabajo que no existe, puede crearlo.
    2. En la barra de búsqueda, introduzca Flujo de trabajo de etiqueta para buscar el flujo de trabajo con el nombre Flujo de trabajo de etiqueta.
    3. En la tarjeta llamada Flujo de trabajo de etiqueta, haga clic en Ejecutar, que muestra el área de configuración.
    4. En el área de texto Flujo de trabajo etiquetado, introduzca el nombre del flujo de trabajo que se utilizará en la canalización de Automation Pipelines y, a continuación, selecciónelo en la lista.
    5. En las áreas de texto Etiqueta y Valor, introduzca PIPELINES en mayúsculas.
    6. Haga clic en la casilla de verificación Etiqueta global.
    7. Haga clic en Ejecutar, que asocia la etiqueta con el nombre PIPELINES al flujo de trabajo que debe seleccionar en la canalización de Automation Pipelines.
    8. En el panel de navegación, haga clic en Flujos de trabajo y confirme que la etiqueta con el nombre PIPELINES aparezca en la tarjeta de flujo de trabajo que ejecutará la canalización.
      Después de iniciar sesión en Automation Pipelines y agregar una tarea de Orchestrator a la canalización, el flujo de trabajo etiquetado aparece en la lista de flujos de trabajo.
  2. En Automation Pipelines, cree un endpoint para la instancia de VMware Aria Automation Orchestrator.
    1. Haga clic en Endpoints > Nuevo endpoint.
    2. Seleccione un proyecto.
    3. Introduzca un nombre pertinente.
    4. Introduzca la URL del endpoint de VMware Aria Automation Orchestrator.
      Utilice este formato: https://orchestrator-appliance.yourdomain.local:8281
      No utilice este formato: https://orchestrator-appliance.yourdomain.local:8281/vco/api
      La URL de una instancia de VMware Aria Automation Orchestrator incorporada al dispositivo de VMware Aria Automation es el FQDN del dispositivo sin un puerto. Por ejemplo: https://automation-appliance.yourdomain.local/vco
      En el caso de los dispositivos de VMware Aria Automation Orchestrator externos a partir de VMware Aria Automation 8.x, el FQDN del dispositivo es https://orchestrator-appliance.yourdomain.local.
      En el caso de los dispositivos de VMware Aria Automation Orchestrator externos incluidos con VMware Aria Automation 7.x, el FQDN del dispositivo es https://orchestrator-appliance.yourdomain.local:8281/vco.
      Si se produce un problema al agregar el endpoint, es posible que deba importar una configuración de YAML con una huella digital de certificado SHA-256 sin los dos puntos. Por ejemplo, B0:01:A2:72... se convierte en B001A272... El código de YAML de ejemplo es similar al siguiente: 
      ```
---
project: Demo
kind: ENDPOINT
name: external-orchestrator
description: ''
type: orchestrator
properties:
  url: https://yourVROhost.yourdomain.local
  username: yourusername
  password: yourpassword
  fingerprint: <your_fingerprint>
```
    5. Haga clic en Aceptar certificado en caso de que la URL que introdujo necesite un certificado.
    6. Si la versión del endpoint de VMware Aria Automation Orchestrator es la 8.0 a la 8.7, puede seleccionar Autenticación o Token como tipo de autenticación. Si la versión del endpoint de VMware Aria Automation Orchestrator es la 8.8 o posterior, debe seleccionar Token como tipo de autenticación.
      Nota: Si el endpoint de VMware Aria Automation Orchestrator tiene la versión 8.8 o posterior, no seleccione Autenticación básica. La autenticación básica no se admite y se producirá un error al crear endpoints.
      • Si selecciona Autenticación básica, introduzca el nombre de usuario y la contraseña del servidor de VMware Aria Automation Orchestrator.

        Si utiliza un usuario no local para la autenticación, debe omitir la parte del dominio del nombre de usuario. Por ejemplo, para autenticarse con [email protected] debe introducir svc_vro en el área de texto Nombre de usuario.

      • Si selecciona Token para el tipo de autenticación, genere el token privado.
        El token de API de VMware Cloud Services lo autentica para las conexiones de API externas con Automation Pipelines. Para obtener el token de API:
        1. Haga clic en Generar token.
        2. Introduzca la dirección de correo electrónico asociada con el nombre de usuario y la contraseña y haga clic en Generar.
          El token que se genera es válido durante seis meses. También se conoce como token de actualización.
          • Para mantener el token como una variable para un uso futuro, haga clic en Crear variable, introduzca un nombre para la variable y haga clic en Guardar.
          • Para conservar el token como valor de texto para usarlo en el futuro, haga clic en Copiar y pegue el token en un archivo de texto para guardarlo de forma local.
          Puede elegir entre crear una variable y almacenar el token en un archivo de texto para utilizarlo en el futuro.
        3. Haga clic en Cerrar.
  3. Prepare la canalización para ejecutar la tarea de Orchestrator.
    1. Agregue una tarea de Orchestrator a la etapa de la canalización.
    2. Introduzca un nombre pertinente.
    3. En el área Propiedades de flujo de trabajo, seleccione el endpoint de VMware Aria Automation Orchestrator.
    4. Seleccione el flujo de trabajo etiquetado como PIPELINES en VMware Aria Automation Orchestrator.
      Si selecciona un flujo de trabajo personalizado que creó, es posible que deba introducir los valores de los parámetros de entrada.
    5. En Ejecutar tarea, haga clic en Con condición.
      Si debe aplicar condiciones para la tarea VMware Aria Automation Orchestrator, introdúzcalas en el área Condición.
    6. Introduzca las condiciones aplicables cuando se ejecuta la canalización.
      Cuándo ejecutar la canalización... Seleccionar condiciones...
      Con condición

      Ejecuta la tarea de canalización solo si la condición definida se evalúa como true. Si la condición es false, se omite la tarea.

      La tarea de Orchestrator permite incluir una expresión booleana, que usa los siguientes operandos y operadores.

      • Variables de canalización, como ${pipeline.variableName}. Utilice únicamente llaves al introducir variables.
      • Variables de salida de tarea, como ${Stage1.task1.machines[0].value.hostIp[0]}.
      • Variables de enlace de canalización predeterminadas, como ${releasePipelineName}.
      • Valores booleanos que no distinguen entre mayúsculas y minúsculas, como true, false, 'true' y 'false'.
      • Valores enteros o decimales sin comillas.
      • Valores de cadena utilizados con comillas simples o dobles, como "test" y 'test'.
      • Tipos de valores de cadena y numéricos, como == Equals y != Not Equals.
      • Operadores relacionales, como >, >=, < y <=.
      • Lógica booleana, como && y ||.
      • Operadores aritméticos, como +, -, * y /.
      • Expresiones anidadas que utilizan corchetes.
      • Las cadenas que incluyen el valor literal ABCD se evalúan como false, por lo que se omite la tarea.
      • No se admiten operadores unarios.

      Una condición de ejemplo podría ser ${Stage1.task1.output} == “Passed” || ${pipeline.variableName} == 39

      Siempre Si selecciona Siempre, la canalización ejecuta la tarea sin condiciones.
    7. Introduzca un mensaje de saludo.
    8. Haga clic en Validar tarea y corrija los errores que se produzcan.
  4. Guarde, habilite y ejecute la canalización.
  5. Una vez que se ejecute la canalización, examine los resultados.
    1. Haga clic en Ejecuciones.
    2. Haga clic en la canalización.
    3. Haga clic en la tarea.
    4. Examine los resultados, el valor de entrada y las propiedades.
      Puede identificar el identificador de ejecución del flujo de trabajo, quién respondió a la tarea y cuándo, así como cualquier comentario que haya incluido.

Resultados

Enhorabuena. Etiquetó un flujo de trabajo de VMware Aria Automation Orchestrator para su uso en Automation Pipelines y agregó una tarea de Orchestrator a la canalización de Automation Pipelines para que ejecute un flujo de trabajo que automatiza una acción en su entorno de DevOps.

Ejemplo: Formato de salida de la tarea de Orchestrator

El formato de salida de una tarea de Orchestrator es similar a este ejemplo. 

[{
                "name": "result",
                "type": "STRING",
                "description": "Result of workflow run.",
                "value": ""
},
{
                "name": "message",
                "type": "STRING",
                "description": "Message",
                "value": ""
}]

Qué hacer a continuación

Siga incluyendo tareas de flujo de trabajo de Orchestrator en las canalizaciones para poder automatizar tareas en los entornos de desarrollo, pruebas y producción.