Cómo se integra Automation Pipelines con VMware Aria Automation Orchestrator

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:

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

Como endpoint local, VMware Aria Automation Orchestrator debe comunicarse con Automation Pipelines a través de un proxy de nube.

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 VMware Aria Automation Assembler, cree un proxy de nube que permita la comunicación entre Automation Pipelines y la instancia local de VMware Aria Automation Orchestrator. Para obtener un ejemplo de cómo crear un proxy de nube, consulte Configuración de Automation Pipelines para modelar el proceso de lanzamiento.
Comprenda la importancia de usar un proxy de nube para un endpoint local. Consulte Qué son los endpoints en Automation Pipelines.
En Automation Pipelines, cree una canalización y agregue una etapa.

Procedimiento

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.
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. Seleccione un proxy de nube.
6. Haga clic en Aceptar certificado en caso de que la URL que introdujo necesite un certificado.
7. 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 y pegue 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:
    
    Inicie sesión en VMware Aria Automation.
    
    Inicie sesión en
    
    Haga clic en la flecha del menú desplegable que aparece junto a su nombre.
    
    Haga clic en Mi cuenta.
    
    Haga clic en Tokens de API.
    
    Haga clic en Generar un nuevo token de API.
    
    Introduzca un nombre de token.
    
    En Funciones de organización, haga clic para expandir Todas las funciones de organización y seleccione Propietario de la organización.
    
    En Funciones de servicio, haga clic para expandir VMware Aria Automation > Pipelines y seleccione Administrador de Pipelines.
    
    Haga clic en Generar.
    La ventana Token generado muestra un token con el nombre que especificó y el nombre de la organización.
    
    Haga clic en el icono COPIAR.
    Si hace clic en COPIAR, se asegura de que se captura la cadena exacta, lo cual resulta más confiable que utilizar el puntero para copiar la cadena.

Prepare la canalización para ejecutar la tarea de Orchestrator.

Agregue una tarea de Orchestrator a la etapa de la canalización.
Introduzca un nombre pertinente.
En el área Propiedades de flujo de trabajo, seleccione el endpoint de VMware Aria Automation Orchestrator.
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.
En Ejecutar tarea, haga clic en Con condición.

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.

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.

Introduzca un mensaje de saludo.
Haga clic en Validar tarea y corrija los errores que se produzcan.

Guarde, habilite y ejecute la canalización.
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.