Come integrare Automation Pipelines con VMware Aria Automation Orchestrator

Automation Pipelines può essere integrato con VMware Aria Automation Orchestrator (Orchestrator) per estenderne la funzionalità mediante l'esecuzione dei workflow di Orchestrator. VMware Aria Automation Orchestrator include molti workflow predefiniti che possono essere integrati con strumenti di terze parti. Questi workflow consentono di automatizzare e gestire i processi DevOps, automatizzare le operazioni in massa e molto altro.

Ad esempio, è possibile utilizzare un workflow in un'attività di Orchestrator nella pipeline per abilitare un utente, rimuovere un utente, spostare macchine virtuali, eseguire l'integrazione con i framework di test per testare il codice quando la pipeline viene eseguita e molto altro. È possibile trovare esempi di codice per i workflow VMware Aria Automation Orchestrator in code. vmware. com.

Con un workflow VMware Aria Automation Orchestrator, la pipeline può eseguire un'azione quando crea, testa e distribuisce l'applicazione. È possibile includere workflow predefiniti nella pipeline oppure si possono creare e utilizzare workflow personalizzati. Ciascun workflow include input, attività e output.

Per eseguire un workflow di Orchestrator nella pipeline, il workflow deve essere presente nell'elenco dei workflow disponibili nell'attività di Orchestrator che viene inclusa nella pipeline.

Affinché il workflow sia presente nell'attività di Orchestrator nella pipeline, è necessario che un amministratore esegua i passaggi seguenti in VMware Aria Automation Orchestrator:

Applicare il tag PIPELINES al workflow di Orchestrator.
Contrassegnare il workflow di Orchestrator come globale.

Come endpoint locale, VMware Aria Automation Orchestrator deve comunicare con Automation Pipelines tramite un proxy cloud.

Prerequisiti

Verificare che, in qualità di amministratore, sia possibile accedere a un'istanza locale di VMware Aria Automation Orchestrator. Per ricevere assistenza, consultare l'amministratore e la documentazione di vRealize Orchestrator.
Verificare di essere un membro di un progetto in Automation Pipelines. In caso contrario, chiedere a un amministratore di Automation Pipelines di essere aggiunti come membri di un progetto. Vedere Come aggiungere un progetto in Automation Pipelines.
In VMware Aria Automation Assembler, creare un proxy cloud che consenta la comunicazione tra Automation Pipelines e l'istanza locale di VMware Aria Automation Orchestrator. Per un esempio di come creare un proxy cloud, vedere Impostazione di Automation Pipelines per modellare il processo di rilascio.
Comprendere l'importanza dell'utilizzo di un proxy cloud per un endpoint locale. Vedere Che cosa sono gli endpoint in Automation Pipelines.
In Automation Pipelines creare una pipeline e aggiungere una fase.

Procedura

In qualità di amministratore, preparare un workflow di VMware Aria Automation Orchestrator per l'esecuzione della pipeline.
1. In VMware Aria Automation Orchestrator, trovare il workflow che è necessario utilizzare nella pipeline, ad esempio un workflow per abilitare un utente.
  Se è necessario un workflow che non esiste, è possibile crearlo.
2. Nella barra di ricerca, immettere Tag workflow per trovare il workflow denominato Tag workflow.
3. Nella scheda denominata Tag workflow, fare clic su Esegui. Viene visualizzata l'area di configurazione.
4. Nell'area di testo Tagged workflow, immettere il nome del workflow da utilizzare nella pipeline di Automation Pipelines, quindi selezionarlo nell'elenco.
5. Nelle aree di testo Tag e Valore, immettere PIPELINES in lettere maiuscole.
6. Fare clic sulla casella di controllo Tag globale.
7. Fare clic su Esegui per collegare il tag denominato PIPELINES al workflow che è necessario selezionare nella pipeline di Automation Pipelines.
8. Nel riquadro di navigazione, fare clic su Workflow e verificare che il tag denominato PIPELINES sia presente nella scheda del workflow che verrà eseguito dalla pipeline.
  Dopo aver effettuato l'accesso a Automation Pipelines e aver aggiunto un'attività di Orchestrator nella pipeline, nell'elenco dei workflow viene visualizzato il workflow con tag.
In Automation Pipelines creare un endpoint per l'istanza di VMware Aria Automation Orchestrator.
1. Fare clic su Endpoint > Nuovo endpoint.
2. Selezionare un progetto.
3. Immettere un nome pertinente.
4. Immettere l'URL dell'endpoint di VMware Aria Automation Orchestrator.
  Utilizzare il formato seguente: https://orchestrator-appliance.yourdomain.local:8281
  
  Non utilizzare il formato seguente: https://orchestrator-appliance.yourdomain.local:8281/vco/api
  
  L'URL di un'istanza di VMware Aria Automation Orchestrator integrata nell'appliance VMware Aria Automation è il nome di dominio completo per l'appliance senza porta. Ad esempio: https://automation-appliance.yourdomain.local/vco
  
  Per le appliance VMware Aria Automation Orchestrator esterne a partire da VMware Aria Automation 8.x, il nome di dominio completo per l'appliance è https://orchestrator-appliance.yourdomain.local
  
  Per le appliance VMware Aria Automation Orchestrator esterne incluse con VMware Aria Automation 7.x, il nome di dominio completo per l'appliance è https://orchestrator-appliance.yourdomain.local:8281/vco
  
  Se si verifica un problema quando si aggiunge l'endpoint, potrebbe essere necessario importare una configurazione YAML con un'impronta digitale del certificato SHA-256 con i due punti rimossi. Ad esempio, B0:01:A2:72... diventa B001A272.... Il codice YAML di esempio è simile 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. Selezionare un proxy cloud.
6. Fare clic su Accetta certificato nel caso in cui l'URL immesso necessiti di un certificato.
7. Se la versione dell'endpoint di VMware Aria Automation Orchestrator è compresa tra 8.0 e 8.7, è possibile selezionare Autenticazione di base o Token per il tipo di autenticazione. Se la versione dell'endpoint di VMware Aria Automation Orchestrator è 8.8 o successiva, è necessario selezionare Token come tipo di autenticazione.
  Nota: Se la versione dell'endpoint VMware Aria Automation Orchestrator è 8.8 o successiva, non selezionare Autenticazione di base. L'autenticazione di base non è supportata e la creazione dell'endpoint non riuscirà.
  - Se si seleziona Autorizzazione di base, immettere il nome utente e la password del server di VMware Aria Automation Orchestrator.
    Se si utilizza un utente non locale per l'autenticazione, è necessario omettere la parte del dominio del nome utente. Ad esempio, per eseguire l'autenticazione con [email protected], è necessario immettere svc_vro nell'area di testo Nome utente.
  - Se si seleziona Token per il tipo di autenticazione, generare e incollare il token privato.
    Il token dell'API VMware Cloud Services autentica l'utente per le connessioni API esterne con Automation Pipelines. Per ottenere il token API:
    
    Accedere a VMware Aria Automation.
    
    Accedere a
    
    Fare clic sul menu a discesa in base al proprio nome.
    
    Fare clic su Il mio account.
    
    Fare clic su Token API.
    
    Fare clic su Generare un nuovo token API.
    
    Assegnare un nome al token.
    
    In Ruoli organizzazione, fare clic per espandere Tutti i ruoli dell'organizzazione e selezionare Proprietario dell'organizzazione.
    
    In Ruoli servizio, fare clic per espandere VMware Aria Automation > Pipelines e selezionare Amministratore di Pipelines.
    
    Fare clic su Genera.
    La finestra Token generato mostra un token con il nome specificato e il nome dell'organizzazione.
    
    Fare clic sull'icona COPIA.
    Se si fa clic su COPIA si garantisce l'acquisizione della stringa esatta, ed è più affidabile rispetto all'utilizzo del puntatore per copiare la stringa.

Preparare la pipeline per eseguire l'attività di Orchestrator.

Aggiungere un'attività di Orchestrator alla fase della pipeline.
Immettere un nome pertinente.
Nell'area Proprietà workflow selezionare l'endpoint VMware Aria Automation Orchestrator.
Selezionare il workflow che è stato contrassegnato con PIPELINES in VMware Aria Automation Orchestrator.
Se si seleziona un workflow personalizzato creato dall'utente, potrebbe essere necessario immettere i valori dei parametri di input.
Per Esegui attività, fare clic su Su condizione.

Immettere le condizioni che si applicano quando viene eseguita la pipeline.

Quando eseguire pipeline...	Selezionare le condizioni...
Su condizione	Esegue l'attività della pipeline solo se la condizione definita viene valutata come true. Se la condizione è false, l'attività viene ignorata. L'attività di `Orchestrator` consente di includere un'espressione booleana, che utilizza gli operandi e gli operatori seguenti. Variabili di pipeline come ${pipeline.variableName}. Quando si immettono le variabili, utilizzare solo le parentesi graffe. Variabili di output dell'attività, ad esempio ${Stage1.task1.machines[0].value.hostIp[0]}. Variabili di associazione delle pipeline predefinite, ad esempio ${releasePipelineName}. Valori booleani con distinzione tra maiuscole e minuscole, ad esempio true, false, 'true', 'false'. Valori interi o decimali senza virgolette. Valori stringa utilizzati con virgolette singole o doppie, ad esempio "test", 'test'. Tipi stringa e numerici di valori, quali == Equals e != Not Equals. Operatori relazionali quali >, >=, < e <=. Logica booleana, ad esempio && e \|\|. Operatori aritmetici quali +, -, * e /. Espressioni nidificate che utilizzano parentesi tonde. Le stringhe che includono il valore letterale ABCD vengono valutate come false e l'attività viene ignorata. Gli operatori unari non sono supportati. Una condizione di esempio potrebbe essere ${Stage1.task1.output} == “Passed” \|\| ${pipeline.variableName} == 39
Sempre	Se si seleziona Sempre, la pipeline esegue l'attività senza condizioni.

Quando eseguire pipeline...

Selezionare le condizioni...

Su condizione

Esegue l'attività della pipeline solo se la condizione definita viene valutata come true. Se la condizione è false, l'attività viene ignorata.

L'attività di Orchestrator consente di includere un'espressione booleana, che utilizza gli operandi e gli operatori seguenti.

Variabili di pipeline come ${pipeline.variableName}. Quando si immettono le variabili, utilizzare solo le parentesi graffe.
Variabili di output dell'attività, ad esempio ${Stage1.task1.machines[0].value.hostIp[0]}.
Variabili di associazione delle pipeline predefinite, ad esempio ${releasePipelineName}.
Valori booleani con distinzione tra maiuscole e minuscole, ad esempio true, false, 'true', 'false'.
Valori interi o decimali senza virgolette.
Valori stringa utilizzati con virgolette singole o doppie, ad esempio "test", 'test'.
Tipi stringa e numerici di valori, quali == Equals e != Not Equals.
Operatori relazionali quali >, >=, < e <=.
Logica booleana, ad esempio && e ||.
Operatori aritmetici quali +, -, * e /.
Espressioni nidificate che utilizzano parentesi tonde.
Le stringhe che includono il valore letterale ABCD vengono valutate come false e l'attività viene ignorata.
Gli operatori unari non sono supportati.

Una condizione di esempio potrebbe essere ${Stage1.task1.output} == “Passed” || ${pipeline.variableName} == 39

Sempre

Se si seleziona Sempre, la pipeline esegue l'attività senza condizioni.

Immettere un messaggio di saluto.
Fare clic su Convalida attività e correggere gli eventuali errori che si verificano.

Salvare, abilitare ed eseguire la pipeline.
Dopo l'esecuzione della pipeline, esaminare i risultati.
1. Fare clic su Esecuzioni.
2. Fare clic sulla pipeline.
3. Fare clic sull'attività.
4. Esaminare i risultati, il valore di input e le proprietà.
  È possibile identificare l'ID di esecuzione del workflow, chi ha risposto all'attività e quando, nonché tutti i commenti che ha incluso.

risultati

Congratulazioni! È stato contrassegnato un workflow di VMware Aria Automation Orchestrator per l'utilizzo in Automation Pipelines ed è stata aggiunta un'attività di Orchestrator nella pipeline di Automation Pipelines in modo che esegua un workflow che automatizza un'azione nell'ambiente DevOps.

Esempio: Formato dell'output dell'attività di Orchestrator

Il formato dell'output di un'attività di Orchestrator è simile a questo esempio.

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

Operazioni successive

Continuare a includere attività del workflow di Orchestrator nelle pipeline in modo da poter automatizzare le attività negli ambienti di sviluppo, test e produzione.