Intégration de Automation Pipelines à VMware Aria Automation Orchestrator

Automation Pipelines peut s'intégrer à VMware Aria Automation Orchestrator (Orchestrator) pour étendre sa capacité en exécutant des workflows Orchestrator. VMware Aria Automation Orchestrator inclut de nombreux workflows prédéfinis qui peuvent s'intégrer à des outils tiers. Ces workflows permettent d'automatiser et de gérer vos processus DevOps, d'automatiser des opérations en bloc, etc.

Par exemple, vous pouvez utiliser un workflow dans une tâche Orchestrator de votre pipeline pour activer un utilisateur, supprimer un utilisateur, déplacer des machines virtuelles, procéder à une intégration à des structures de test pour tester votre code au fur et à mesure de l'exécution du pipeline, et bien plus encore. Vous pouvez parcourir des exemples de code pour les workflows VMware Aria Automation Orchestrator dans code.vmware. com.

Avec un workflow VMware Aria Automation Orchestrator, votre pipeline peut exécuter une action au fur et à mesure qu'il génère, teste et déploie votre application. Vous pouvez inclure des workflows prédéfinis dans votre pipeline, ou créer et utiliser des workflows personnalisés. Chaque workflow inclut des entrées, des tâches et des sorties.

Pour exécuter un workflow Orchestrator dans votre pipeline, le workflow doit figurer dans la liste des workflows disponibles dans la tâche Orchestrator que vous incluez dans votre pipeline.

Pour que le workflow puisse figurer dans la tâche Orchestrator de votre pipeline, un administrateur doit effectuer les étapes suivantes dans VMware Aria Automation Orchestrator :

Appliquez la balise PIPELINES au workflow Orchestrator.
Marquez le workflow Orchestrator comme étant global.

En tant que point de terminaison sur site, VMware Aria Automation Orchestrator doit communiquer avec Automation Pipelines via un proxy cloud.

Conditions préalables

Vérifiez que vous pouvez accéder en tant qu'administrateur à une instance sur site de VMware Aria Automation Orchestrator. Pour obtenir de l'aide, rapprochez-vous de votre propre administrateur et consultez la Documentation de vRealize Orchestrator.
Assurez-vous d'être membre d'un projet dans Automation Pipelines. Si ce n'est pas le cas, demandez à un administrateur de Automation Pipelines de vous ajouter en tant que membre d'un projet. Reportez-vous à la section Ajout d'un projet dans Automation Pipelines.
Dans VMware Aria Automation Assembler, créez un proxy cloud qui autorise la communication entre Automation Pipelines et l'instance sur site de VMware Aria Automation Orchestrator. Pour consulter un exemple de création de proxy cloud, reportez-vous à Configuration de Automation Pipelines pour modéliser le processus de publication.
Comprendre l'importance de l'utilisation d'un proxy cloud pour un point de terminaison sur site. Reportez-vous à la section Présentation des points de terminaison dans Automation Pipelines.
Dans Automation Pipelines, créez un pipeline et ajoutez une étape.

Procédure

En tant qu'administrateur, préparez un workflow VMware Aria Automation Orchestrator pour l'exécution de votre pipeline.
1. Dans VMware Aria Automation Orchestrator, recherchez le workflow que vous devez utiliser dans votre pipeline, tel qu'un workflow pour activer un utilisateur.
  Si vous avez besoin d'un workflow qui n'existe pas, vous pouvez le créer.
2. Dans la barre de recherche, entrez Workflow de balise pour trouver le workflow nommé Workflow de balise.
3. Sur la fiche nommée Workflow de balise, cliquez sur Exécuter afin d'afficher la zone de configuration.
4. Dans la zone de texte Workflow balisé, entrez le nom du workflow à utiliser dans votre pipeline Automation Pipelines, puis sélectionnez-le dans la liste.
5. Dans les zones de texte Balise et Valeur, entrez PIPELINES en lettres majuscules.
6. Cochez la case nommée Balise globale.
7. Cliquez sur Exécuter afin d'associer la balise nommée PIPELINES au workflow que vous devez sélectionner dans votre pipeline de Automation Pipelines.
8. Dans le volet de navigation, cliquez sur Workflows et vérifiez que la balise nommée PIPELINES apparaît sur la fiche du workflow que votre pipeline va exécuter.
  Après la connexion à Automation Pipelines et l'ajout d'une tâche PIPELINES à votre pipeline, le workflow balisé s'affiche dans la liste des workflows.
Dans Automation Pipelines, créez un point de terminaison pour votre instance de VMware Aria Automation Orchestrator.
1. Cliquez sur Points de terminaison > Nouveau point de terminaison.
2. Sélectionnez un projet.
3. Entrez un nom pertinent.
4. Entrez l'URL du point de terminaison VMware Aria Automation Orchestrator.
  Utilisez ce format : https://orchestrator-appliance.yourdomain.local:8281
  
  N'utilisez pas ce format : https://orchestrator-appliance.yourdomain.local:8281/vco/api
  
  L'URL d'une instance de VMware Aria Automation Orchestrator intégrée au dispositif VMware Aria Automation est le nom de domaine complet du dispositif sans port. Par exemple : https://automation-appliance.yourdomain.local/vco
  
  Pour les dispositifs VMware Aria Automation Orchestrator externes à partir de VMware Aria Automation 8.x, le nom de domaine complet du dispositif est https://orchestrator-appliance.yourdomain.local
  
  Pour les dispositifs VMware Aria Automation Orchestrator externes inclus avec VMware Aria Automation 7.x, le nom de domaine complet du dispositif est https://orchestrator-appliance.yourdomain.local:8281/vco
  
  Si un problème se produit lorsque vous ajoutez le point de terminaison, vous devrez peut-être importer une configuration YAML avec une empreinte digitale de certificat SHA-256 avec les deux-points supprimés. Par exemple, B0:01:A2:72... devient B001A272.... L'exemple de code YAML ressemble à ce qui suit :
```
```
  ---
  project: Demo
  kind: ENDPOINT
  name: external-orchestrator
  description: ''
  type: orchestrator
  properties:
    url: https://yourVROhost.yourdomain.local
    username: yourusername
    password: yourpassword
    fingerprint: <your_fingerprint>
```
```
5. Sélectionnez un proxy cloud.
6. Cliquez sur Accepter le certificat si l'URL que vous avez entrée a besoin d'un certificat.
7. Si la version du point de terminaison VMware Aria Automation Orchestrator est comprise entre la version 8.0 et la version 8.7, vous pouvez sélectionner Authentification de baseou Jeton pour le type d'authentification. Si le point de terminaison VMware Aria Automation Orchestrator est de version 8.8 ou de version ultérieure, vous devez sélectionner Jeton pour le type d'authentification.
  Note : Si le point de terminaison VMware Aria Automation Orchestrator est de version 8.8 ou de version ultérieure, ne sélectionnez pas Authentification de base. L'authentification de base n'est pas prise en charge et la création du point de terminaison échouera.
  - Si vous sélectionnez Authentification de base, entrez le nom d'utilisateur et le mot de passe du serveur VMware Aria Automation Orchestrator.
    Si vous utilisez un utilisateur non local pour l'authentification, vous devez omettre la partie domaine du nom d'utilisateur. Par exemple, pour vous authentifier avec [email protected] vous devez entrer svc_vro dans la zone de texte Nom d'utilisateur.
  - Si vous sélectionnez Jeton pour le type d'authentification, générez et collez le jeton privé.
    Le jeton d'API VMware Cloud Services vous authentifie pour les connexions d'API externes avec Automation Pipelines. Pour obtenir le jeton d'API :
    
    Connectez-vous à VMware Aria Automation.
    
    Connectez-vous à
    
    Cliquez sur la flèche vers le bas en regard de votre nom.
    
    Cliquez sur Mon compte.
    
    Cliquez sur Jetons d'API.
    
    Cliquez sur Générer un nouveau jeton d'API.
    
    Entrez le nom du jeton.
    
    Sous Rôles d'organisation, cliquez pour développer Tous les rôles d'organisation et sélectionnez Propriétaire de l'organisation.
    
    Sous Rôles de service, cliquez pour développer VMware Aria Automation > Pipelines et sélectionnez Administrateur de Pipelines.
    
    Cliquez sur Générer.
    La fenêtre Jeton généré affiche un jeton avec le nom que vous avez spécifié et le nom de votre organisation.
    
    Cliquez sur l'icône COPIER.
    Cliquer sur COPIER garantit que vous capturez la chaîne exacte et qu'elle est plus fiable que l'utilisation de votre pointeur pour la copier.

Préparez votre pipeline pour exécuter la tâche Orchestrator.

Ajoutez une tâche Orchestrator à votre étape de pipeline.
Entrez un nom pertinent.
Dans la zone Propriétés du workflow, sélectionnez le point de terminaison VMware Aria Automation Orchestrator.
Sélectionnez le workflow que vous avez marqué comme Orchestrator dans VMware Aria Automation Orchestrator.
Si vous sélectionnez un workflow personnalisé que vous avez créé, vous devrez peut-être entrer les valeurs des paramètres d'entrée.
Pour exécuter la tâche, cliquez sur Sur condition.

Entrez les conditions qui s'appliquent lors de l'exécution du pipeline.

Quand exécuter le pipeline...	Conditions à sélectionner…
Sur condition	Exécute la tâche de pipeline uniquement si la condition définie est évaluée comme étant true. Si la condition est false, la tâche est ignorée. La tâche `Orchestrator` vous permet d'inclure une expression booléenne qui utilise les opérandes et les opérateurs suivants. Variables de pipeline comme ${pipeline.variableName}. Utilisez uniquement des accolades lors de la saisie de variables. Variables de sortie de tâche comme ${Stage1.task1.machines[0].value.hostIp[0]}. Variables de liaison de pipeline par défaut comme ${releasePipelineName}. Valeurs booléennes insensibles à la casse comme true, false, 'true', 'false'. Valeurs entières ou décimales sans guillemets. Valeurs de chaîne utilisées avec des guillemets simples ou doubles, comme "test" ou 'test'. Types de chaînes et de valeurs numériques, comme == Equals et != Not Equals. Opérateurs relationnels comme >, >=, < et <=. Logique booléenne comme && et \|\|. Opérateurs arithmétiques comme +, -, * et /. Expressions imbriquées à l'aide de parenthèses. Les chaînes qui incluent la valeur littérale ABCD sont évaluées comme étant false et la tâche est ignorée. Les opérateurs unaires ne sont pas pris en charge. Un exemple de condition peut être ${Stage1.task1.output} == “Passed” \|\| ${pipeline.variableName} == 39
Toujours	Si vous sélectionnez Toujours, le pipeline exécute la tâche sans conditions.

Quand exécuter le pipeline...

Conditions à sélectionner…

Sur condition

Exécute la tâche de pipeline uniquement si la condition définie est évaluée comme étant true. Si la condition est false, la tâche est ignorée.

La tâche Orchestrator vous permet d'inclure une expression booléenne qui utilise les opérandes et les opérateurs suivants.

Variables de pipeline comme ${pipeline.variableName}. Utilisez uniquement des accolades lors de la saisie de variables.
Variables de sortie de tâche comme ${Stage1.task1.machines[0].value.hostIp[0]}.
Variables de liaison de pipeline par défaut comme ${releasePipelineName}.
Valeurs booléennes insensibles à la casse comme true, false, 'true', 'false'.
Valeurs entières ou décimales sans guillemets.
Valeurs de chaîne utilisées avec des guillemets simples ou doubles, comme "test" ou 'test'.
Types de chaînes et de valeurs numériques, comme == Equals et != Not Equals.
Opérateurs relationnels comme >, >=, < et <=.
Logique booléenne comme && et ||.
Opérateurs arithmétiques comme +, -, * et /.
Expressions imbriquées à l'aide de parenthèses.
Les chaînes qui incluent la valeur littérale ABCD sont évaluées comme étant false et la tâche est ignorée.
Les opérateurs unaires ne sont pas pris en charge.

Un exemple de condition peut être ${Stage1.task1.output} == “Passed” || ${pipeline.variableName} == 39

Toujours

Si vous sélectionnez Toujours, le pipeline exécute la tâche sans conditions.

Entrez un message d'accueil.
Cliquez sur Valider la tâche et corrigez les erreurs qui se sont éventuellement produites.

Enregistrez, activez et exécutez votre pipeline.
Une fois le pipeline exécuté, examinez les résultats.
1. Cliquez sur Exécutions.
2. Cliquez sur le pipeline.
3. Cliquez sur la tâche.
4. Examinez les résultats, la valeur d'entrée et les propriétés.
  Vous pouvez identifier l'ID d'exécution du workflow, la personne qui a répondu à la tâche, le moment auquel elle a répondu et les commentaires qu'elle a inclus.

Résultats

Félicitations ! Vous avez marqué un workflow VMware Aria Automation Orchestrator à utiliser dans Automation Pipelines et ajouté une tâche Orchestrator dans votre pipeline Automation Pipelines afin qu'il exécute un workflow qui automatise une action dans votre environnement DevOps.

Exemple : Format de sortie de tâche Orchestrator

Le format de sortie d'une tâche Orchestrator ressemble à cet exemple.

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

Que faire ensuite

Continuez à inclure des tâches de workflow Orchestrator dans vos pipelines afin de pouvoir automatiser des tâches dans vos environnements de développement, de test et de production.