Progettare un Runbook con Visual Designer
Utilizzare Visual Designer per progettare e creare runbook personalizzati in Fleet Application Management. Il designer fornisce un'interfaccia di trascinamento con un'opzione per aggiungere codice in modo da poter creare e modificare i runbook più facilmente. Runbook può essere scritto in YAML o JSON. Tuttavia, puoi creare un runbook senza la necessità di crearlo in JSON o YAML nativi utilizzando il visual designer.
Con Visual Designer è possibile eseguire i task riportati di seguito.
- Progettare un runbook utilizzando i componenti del runbook.
- Semplifica l'esecuzione del runbook.
- Configurare le istruzioni condizionali con la Costruzione guidata condizione.
- Configura le esecuzioni dei task condizionali in base ai componenti del prodotto, alle variabili di input e output o a entrambe.
- Configurare la gestione degli errori.
- Illustrare i runbook forniti da Fleet Application Management.
- Copiare i runbook illustrati per creare runbook personalizzati in cui aggiungere il codice in modalità di origine o di progettazione.
Quando si crea un runbook, il visual designer convalida il lavoro e genera automaticamente il codice. È possibile rivedere il codice generato o esportarlo per lo sviluppo locale. Dopo aver creato il runbook, è possibile salvarlo, pubblicarlo ed esaminare i risultati nella console.
- Il riquadro Azioni sul lato destro contiene le schede Componenti e Proprietà.
- L'area di creazione al centro è un segnaposto in cui si progetta il runbook. È possibile trascinare i componenti dal riquadro delle azioni, ad esempio gruppi di risorse paralleli o in sequenza, e trascinare i task in questi gruppi. È possibile modificare l'ordine dei componenti nello sfondo inserendoli nell'ordine in cui si desidera eseguire i task oppure selezionare le azioni per configurare le proprietà o gestire gli errori.
L'area di creazione contiene anche l'icona di modifica accanto a ciascun componente del task per visualizzare e modificare il task del runbook.
Per visualizzare il codice YAML o JSON generato automaticamente per il runbook mentre si utilizza Visual Designer, selezionare Vista codice sullo sfondo. Quando si aggiorna YAML o JSON, le modifiche vengono generate automaticamente in modalità Designer.
Riquadro Azioni
Nel riquadro delle azioni è possibile selezionare i componenti da trascinare nell'area di lavoro dello sfondo. Il riquadro contiene gli elementi riportati di seguito.
Scheda Componenti
Per aggiungere un task, è innanzitutto necessario aggiungere un gruppo di risorse in sequenza o parallelo. Un task deve essere all'interno di un gruppo. Per ulteriori informazioni sull'uso dei tipi di gruppo, vedere Creazione di un Runbook.
- Nuovo task: utilizzare questo pulsante per creare task per un runbook. Ora è possibile aggiungere un task che può eseguire uno script specificando il tipo di azione come script.
- Gruppo di task parallelo: qualsiasi task parte di un gruppo di task parallelo viene eseguito in parallelo su una risorsa (risorse di calcolo e di database) che fa parte di una flotta.
Ad esempio, se una flotta dispone di due risorse e due task (task1 e task2) che fanno parte del gruppo di task parallelo, task1 e task2 vengono eseguiti in parallelo su resource1 e resource2.
- Gruppo di risorse parallele: qualsiasi task parte di un gruppo di risorse parallele viene eseguito in parallelo tra le risorse (risorse di calcolo e di database) che fanno parte di una flotta. All'interno di una risorsa, i task che fanno parte di un gruppo di risorse parallelo vengono eseguiti in sequenza.
Ad esempio, se una flotta dispone di due risorse e due task (task1 e task2) che fanno parte del gruppo di risorse parallele, task1 e task2 vengono eseguiti in sequenza su resource1 e resource2 e l'esecuzione su resource1 e resource2 viene eseguita in parallelo.
- Gruppo di risorse in sequenza: qualsiasi task parte di un gruppo di risorse in sequenza viene eseguito in sequenza tra le risorse (risorse di calcolo e di database) che fanno parte di una flotta. All'interno di una risorsa, i task che fanno parte di un gruppo di risorse in sequenza vengono eseguiti in modo sequenziale.
Ad esempio, se una flotta dispone di due risorse e due task (task1 e task2) che fanno parte del gruppo di risorse in sequenza, task1 e task2 vengono eseguiti in sequenza su resource1. Al termine dei task di resource1, task1 e task2 vengono eseguiti in sequenza su resource2.
Scheda Proprietà
La scheda Proprietà fornisce le impostazioni per controllare le istruzioni condizionali e configurare la gestione degli errori dei componenti aggiunti allo sfondo. Dopo aver aggiunto un componente all'area di lavoro sullo sfondo in Task o Task di rollback, configurarlo per soddisfare il caso d'uso. Selezionare l'icona delle proprietà (
) del componente per configurarne le proprietà e le opzioni. È inoltre possibile visualizzare il codice YAML o JSON selezionando Vista Codice. Le proprietà sono disponibili per un runbook, gruppi e task.
Proprietà runbook
Di seguito sono riportate le due proprietà per un runbook.
- In caso di errore delle attività: l'opzione selezionata per questa proprietà è il valore predefinito per tutti i gruppi e le attività all'interno di un runbook.
- Esegui il: l'opzione selezionata descrive dove e come vengono eseguiti i task. Può coinvolgere istanze pianificate, ambienti self-hosted o istanze selezionate in base ai risultati delle attività precedenti. Di seguito sono riportate le proprietà secondarie di Esegui su.
- Istanze specificate dalla pianificazione: questa proprietà viene utilizzata per l'esecuzione condizionale di un runbook su una destinazione quando la condizione restituisce true. È la soluzione più adatta per gestire i flussi di lavoro dello stack di prodotti all'interno di un runbook.
- Istanza self-hosted: questa proprietà consente di individuare e selezionare un'istanza self-hosted per i task successivi al provisioning
- Istanza specificata dal task precedente: questa proprietà indica che l'esecuzione di un task si basa sul completamento di un task precedente.
Proprietà gruppo
Di seguito sono riportate le cinque proprietà di un gruppo.
- In caso di errore: l'opzione selezionata per questa proprietà determina il successivo set di azioni se uno dei task di un gruppo non riesce. L'esecuzione del runbook sulla destinazione continua se si seleziona Continua, l'esecuzione del runbook del prodotto sulla destinazione si interrompe e l'esecuzione del runbook dello stack del prodotto sul gruppo di azioni si interrompe se si seleziona Interrompi e l'esecuzione del runbook viene spostata al passo di rollback se si seleziona Rollback. In base all'ambito di rollback, l'azione di rollback può essere a livello di destinazione o di gruppo di azioni.
- Precondizione: specifica la condizione utilizzando variabili di input del task corrente e variabili di output di tutti i task precedenti. Un task viene eseguito sulla destinazione solo se la condizione restituisce true.
- Esegui su: specifica la condizione utilizzando il nome del prodotto di destinazione (per il runbook dello stack di prodotti), le proprietà del prodotto, il nome del componente e le proprietà del componente di una destinazione. Un task viene eseguito sulla destinazione solo se la condizione restituisce true.
Ad esempio, nel runbook dello stack di prodotti Oracle WebLogic Server e Java Patching, per eseguire un task solo nella destinazione Oracle WebLogic Server se il valore della proprietà java_version è
1.8.0_391e quando il componente ADMIN_SERVER è disponibile, immettere la condizione seguente.target.product.name == "Oracle Weblogic Server" AND target.product.properties.java_home == "1.8.0_391" AND target.product.components.ADMIN_SERVER.properties.Server == "AdminServer" - Sospendi esecuzione: opzione che arresta l'esecuzione del runbook finché non si interviene o la durata impostata non scade. La sospensione viene eseguita prima dell'esecuzione di un task.
- Notifica: notifica all'utente utilizzando il servizio di notifica OCI lo stato del task.
Proprietà task
I task includono una proprietà aggiuntiva rispetto a un gruppo. Di seguito è riportata la descrizione della proprietà.
Mapping delle variabili di output: per il tipo di task Esegui uno script, l'output dei log di script viene analizzato per valutare il valore della variabile di input con una corrispondenza di pattern pari a $$VARIABLE=VALUE$$.
- Selezionare la casella di controllo Variabile di output e aggiungere una variabile di output. L'esecuzione dello script Fleet Application Management garantisce che la variabile di output venga popolata.
- Nel task successivo, selezionare la casella di controllo della variabile di input e aggiungere una variabile di input.
- Mappare il nome della variabile di input al nome della variabile di output dei task precedenti utilizzando il mapping della variabile di output.
Lo script Fleet Application Management ora analizza i log di output per identificare un pattern quale $$VARIABLE=VALUE$$.
Scheda libreria
La scheda Libreria dei task fornisce un elenco di task riutilizzabili pronti all'uso esistenti in Fleet Application Management o creati dall'utente. È possibile utilizzare l'icona della maniglia di trascinamento (
) nell'angolo destro di un'attività per trascinarla nell'area di lavoro del runbook sullo sfondo. Nella libreria sono visualizzati solo i task rilevanti per un runbook in base allo stack di prodotti o di prodotti e al tipo di sistema operativo.
Task di rollback
Per eseguire il rollback di un task definito in caso di errore, è possibile aggiungere un gruppo e quindi aggiungere i task di cui eseguire il rollback all'interno del segnaposto Task di rollback nell'area di lavoro dello sfondo. Per eseguire il rollback, assicurarsi di selezionare la proprietà del task In caso di errore come Rollback in Task per il task specifico.
È possibile definire l'ambito del rollback a un livello di destinazione o di gruppo di azioni. Questo ambito indica che Fleet Application Management esegue i task di rollback su una destinazione specifica o su tutti i gruppi di destinazioni. I task di rollback vengono eseguiti sulla destinazione che non riesce se si prevede l'ambito per una destinazione, mentre i task di rollback vengono eseguiti su tutto il gruppo di destinazioni se si prevede l'ambito per un gruppo di azioni.
Sfondo
Dopo aver determinato un'azione da aggiungere a Visual Designer, trascinare un componente nell'area di lavoro dello sfondo. Per modificare l'ordine dei componenti, utilizzare l'icona della maniglia di trascinamento () nell'angolo destro di un componente per trascinarlo in una posizione diversa nell'area di lavoro del runbook. Questa nuova azione viene aggiunta all'area di lavoro e il relativo codice viene generato automaticamente.
Collegamenti da tastiera per la navigazione
| Scelta rapida da tastiera | Azione |
|---|---|
| Tab | Spostare lo stato attivo sull'elemento runbook successivo. |
| Shift+Tab | Spostare lo stato attivo sull'elemento runbook precedente. |
| Tasti freccia | Spostare un componente dopo che si trova nell'area di creazione. Ad esempio:
|
| Barra spaziatrice o Invio/Invio | Selezionare un componente dalla scheda Componenti o Proprietà oppure un elemento runbook. |
| Pass. di liv. | Annullare lo spostamento di un componente nell'area di creazione o di qualsiasi azione prima che venga attivato. |
| Barra spaziatrice o Invio | Attiva un'attività appropriata quando l'attenzione è rivolta a uno qualsiasi dei componenti, delle proprietà o degli elementi del runbook. Ad esempio:
|