La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Preparati a utilizzare i flussi di lavoro

07/30/2024 Collaboratori

PDF

Prima di utilizzarli con un'implementazione live, è necessario conoscere l'organizzazione e il formato dei flussi di lavoro Astra.

Introduzione

Un workflow è una sequenza di uno o più passaggi necessari per eseguire un'attività o un obiettivo amministrativo specifico. Ogni fase del flusso di lavoro di Astra Control è una delle seguenti:

REST API Call (con dettagli come ad esempio CURL e JSON)
Invocazione di un altro workflow Astra
Attività correlate a varie attività (come prendere una decisione di progettazione richiesta)

I flussi di lavoro includono i passaggi principali e i parametri necessari per eseguire ogni attività. Forniscono un punto di partenza per personalizzare il tuo ambiente di automazione.

Un flusso di lavoro può contenere un solo passaggio. Questi flussi di lavoro a fase singola sono formattati in modo leggermente diverso rispetto ai flussi di lavoro che contengono più passaggi. Ad esempio, il nome dell'operazione esplicita viene rimosso. L'azione o l'operazione deve essere chiara in base al titolo del flusso di lavoro.

Categorie di workflow

Sono disponibili due ampie categorie di flussi di lavoro Astra in base al modello di implementazione. Se si utilizza Astra Control Center, è necessario iniziare con i flussi di lavoro dell'infrastruttura e passare ai flussi di lavoro di gestione. Quando si utilizza Astra Control Service, in genere è possibile accedere direttamente ai flussi di lavoro di gestione.

Gli esempi di curl nei flussi di lavoro utilizzano l'URL per Astra Control Service. È necessario modificare l'URL quando si utilizza l'Astra Control Center on-premise in base all'ambiente in uso.

Flussi di lavoro dell'infrastruttura

Questi flussi di lavoro si occupano dell'infrastruttura Astra, inclusi credenziali, bucket e backend dello storage. Sono necessari con Astra Control Center, ma nella maggior parte dei casi possono essere utilizzati anche con Astra Control Service. I flussi di lavoro si concentrano sulle attività necessarie per stabilire e gestire un cluster gestito da Astra.

Workflow di gestione

Questi flussi di lavoro possono essere utilizzati dopo aver configurato un cluster gestito. I flussi di lavoro di gestione si concentrano sulla protezione delle applicazioni e supportano operazioni come backup, ripristino e cloning di un'applicazione.

Parametri di input comuni

I parametri di input descritti di seguito sono comuni a tutti gli esempi di curl utilizzati per illustrare una chiamata API REST.

Poiché questi parametri di input sono universalmente richiesti, non vengono descritti ulteriormente nei singoli flussi di lavoro. Se si utilizzano parametri di input aggiuntivi per un esempio specifico di curl, questi sono descritti nella sezione parametri di input aggiuntivi.

Parametri del percorso

Il percorso dell'endpoint utilizzato con ogni chiamata API REST include i seguenti parametri. Vedere anche "Formato URL" per ulteriori informazioni.

ID account: Questo è il valore UUIDv4 che identifica l'account Astra in cui viene eseguita l'operazione API. Vedere "Ottieni un token API" Per ulteriori informazioni su come individuare l'ID account.

Intestazioni delle richieste

A seconda della chiamata API REST, potrebbe essere necessario includere diverse intestazioni di richiesta.

Autorizzazione: Tutte le chiamate API nei flussi di lavoro richiedono un token API per identificare l'utente. È necessario includere il token in Authorization intestazione della richiesta. Vedere "Ottieni un token API" Per ulteriori informazioni sulla generazione di un token API.
Tipo di contenuto: Con le richieste HTTP POST e PUT in cui JSON è incluso nel corpo della richiesta, è necessario dichiarare il tipo di supporto in base alla risorsa Astra. Ad esempio, è possibile includere l'intestazione Content-Type: application/astra-appSnap+json quando si crea uno snapshot per un'applicazione gestita.
Accettare: È possibile dichiarare il tipo di supporto specifico del contenuto previsto nella risposta in base alla risorsa Astra. Ad esempio, è possibile includere l'intestazione Accept: application/astra-appBackup+json quando si elencano i backup per un'applicazione gestita. Tuttavia, per semplicità, i campioni di arricciatura nei flussi di lavoro accettano tutti i tipi di supporto.

Presentazione di token e identificatori

Il token API e gli altri valori ID utilizzati con gli esempi di curl sono opachi e non sono comprensibili. Per migliorare la leggibilità dei campioni, non vengono utilizzati i valori token e ID effettivi. Piuttosto, vengono utilizzate parole chiave riservate più piccole che hanno diversi benefici:

I campioni Curl e JSON sono più chiari e comprensibili.
Poiché tutte le parole chiave utilizzano lo stesso formato con parentesi quadre e lettere maiuscole, è possibile identificare rapidamente la posizione e il contenuto da inserire o estrarre.
Nessun valore viene perso perché i parametri originali non possono essere copiati e utilizzati con un'implementazione effettiva.

Le variabili sono formattate per l'uso in un ambiente di shell Bash. Ogni variabile inizia con un simbolo del dollaro ed è racchiusa tra virgolette doppie secondo necessità. Questo li rende riconoscibili per Bash. Il maiuscolo viene utilizzato costantemente per i nomi.

Ecco alcune delle parole chiave riservate più comuni utilizzate negli esempi di curl. Questo elenco non è esaustivo e vengono utilizzate parole chiave aggiuntive in base alle necessità. Il loro significato dovrebbe essere ovvio in base al contesto.

Parola chiave	Tipo	Descrizione
$ACCOUNT_ID	Percorso	Il valore UUIDv4 che identifica l'account in cui viene eseguita l'operazione API.
$API_TOKEN	Intestazione	Il token del bearer che identifica e autorizza il chiamante.
$APP_ID	Percorso	Il valore UUIDv4 che identifica l'applicazione per la chiamata API.

Parola chiave

Tipo

Descrizione

$ACCOUNT_ID

Percorso

Il valore UUIDv4 che identifica l'account in cui viene eseguita l'operazione API.

$API_TOKEN

Intestazione

Il token del bearer che identifica e autorizza il chiamante.

$APP_ID

Percorso

Il valore UUIDv4 che identifica l'applicazione per la chiamata API.

Uso degli esempi con Bash

Se si utilizzano direttamente gli esempi di curl del flusso di lavoro, è necessario aggiornare le variabili che contengono con i valori appropriati per l'ambiente in uso. Potete modificare manualmente gli esempi o affidarvi alla shell Bash per eseguire la sostituzione, come descritto di seguito.

Un vantaggio dell'utilizzo di Bash è che è possibile impostare i valori delle variabili una volta in una sessione di shell invece di una volta per comando curl.

Fasi

Aprire la shell Bash fornita con Linux o un sistema operativo simile.
Impostare i valori delle variabili inclusi nell'esempio di arricciatura che si desidera eseguire. Ad esempio:

$API_TOKEN=SGgpXHeco6M8PLxzIlgbztA4k3_eX4UCa842hOXHBFA=
Copiare l'esempio di arricciatura dalla pagina del flusso di lavoro e incollarlo nel terminale della shell.
Premere INVIO per eseguire le seguenti operazioni:
1. Sostituire i valori della variabile impostati.
2. Eseguire il comando curl.