Tutorial: Creazione di un runbook utilizzando l'esperienza di progettazione visiva

Questo tutorial ti illustrerà le basi per utilizzare l'esperienza di progettazione visiva fornita da Systems Manager Automation. Nell'esperienza di progettazione visiva, è possibile creare un runbook che utilizza più azioni. È possibile utilizzare la funzionalità di trascinamento e rilascio per disporre le azioni nell'area di lavoro. Puoi anche cercare, selezionare e configurare queste azioni. Quindi, puoi visualizzare il YAML codice generato automaticamente per il flusso di lavoro del runbook, uscire dall'esperienza di progettazione visiva, eseguire il runbook ed esaminare i dettagli di esecuzione.

Questo tutorial mostra anche come aggiornare il runbook e visualizzare la nuova versione. Alla fine del tutorial, eseguirai una fase di pulizia ed eliminerai il runbook.

Dopo aver completato questo tutorial, saprai come usare l'esperienza di progettazione visiva per creare un runbook. Saprai anche come aggiornare, eseguire ed eliminare il runbook.

Nota

Prima di iniziare questo tutorial, assicurati di completare Configurazione del servizio di automazione.

Fase 1: Passaggio all'esperienza di progettazione visiva

1. Accedi alla console di Systems Manager Automation.

2. Scegli Crea un runbook automazione.

Fase 2: Creazione di un flusso di lavoro

Nell'esperienza di progettazione visiva, un flusso di lavoro è una rappresentazione grafica del runbook nell'area di lavoro. Puoi usare l'esperienza di progettazione visiva per definire, configurare ed esaminare le singole azioni del tuo runbook.

Creazione di un flusso di lavoro

1. Accanto agli interruttori Progettazione e Codice, seleziona l'icona a forma di matita e inserisci un nome per il runbook. Per questo tutorial, digita VisualDesignExperienceTutorial.

   

2. Nella sezione Attributi del documento del pannello Modulo, espandi il menu a discesa Parametri di input e seleziona Aggiungi un parametro.

   1. Nel campo Nome del parametro, immetti InstanceId.

   2. Nel menu a discesa Tipo, scegli AWS::: :Instance. EC2

   3. Seleziona l'interruttore Richiesto.

   

3. Nel AWS APIsbrowser, inserisci DescribeInstances nella barra di ricerca.

4. Trascina un' DescribeInstancesazione Amazon EC2 sull'area di disegno vuota.

5. In Nome fase, immetti un valore. Per questo tutorial, puoi utilizzare il nome GetInstanceState.

   

   1. Espandi il menu a discesa Input aggiuntivi e, nel campo Nome input, inserisci InstanceIds.

   2. Scegli la scheda Input.

   3. Nel campo Valore di input, scegli l'input del documento InstanceId. Fa riferimento al valore del parametro di input creato all'inizio della procedura. Poiché l'InstanceIdsinput per l'DescribeInstancesazione accetta StringList valori, devi racchiudere l'InstanceIdinput tra parentesi quadre. Il valore YAML for the Input deve corrispondere al seguente:['{{ InstanceId }}'].

   4. Nella scheda Output, seleziona Aggiungi un output e inserisci InstanceState nel campo Nome.

   5. Nel campo Selettore, inserisci $.Reservations[0].Instances[0].State.Name.

   6. Dal menu a discesa Tipo, scegli Stringa.

6. Trascina un'azione Ramo dal browser Operazioni e rilasciala al di sotto della fase GetInstanceState.

7. In Nome fase, immetti un valore. Per questo tutorial, utilizza il nome BranchOnInstanceState.

   Per definire la logica di ramificazione, completa le operazioni seguenti:

   1. Scegli lo stato Branch nell'area di lavoro. Quindi, in Input e Scelte, seleziona l'icona a forma di matita per modificare la Regola # 1.

   2. Scegli Aggiungi condizione.

   3. Nella finestra di dialogo Condizioni per la regola # 1, scegli l'output della fase GetInstanceState.InstanceState dal menu a discesa Variabile.

   4. Per Operatore, scegli è uguale a.

   5. Per Valore, scegli Stringa dall'elenco a discesa. Specificare stopped.

      

   6. Seleziona Salva condizioni.

   7. Scegli Aggiungi una nuova regola di scelta.

   8. Scegli Aggiungi condizioni per la Regola # 2.

   9. Nella finestra di dialogo Condizioni per la regola # 2, scegli l'output della fase GetInstanceState.InstanceState dal menu a discesa Variabile.

   10. Per Operatore, scegli è uguale a.

   11. Per Valore, scegli Stringa dall'elenco a discesa. Specificare stopping.

   12. Seleziona Salva condizioni.

   13. Scegli Aggiungi una nuova regola di scelta.

   14. Scegli Aggiungi condizioni per Regola # 3.

   15. Nella finestra di dialogo Condizioni per la regola # 3, scegli l'output della fase GetInstanceState.InstanceState dal menu a discesa Variabile.

   16. Per Operatore, scegli è uguale a.

   17. Per Valore, scegli Stringa dall'elenco a discesa. Specificare running.

   18. Seleziona Salva condizioni.

   19. In Regola predefinita, scegli Vai alla fine per Fase predefinita.

8. Trascina un'azione Cambia lo stato di un'istanza nella casella vuota Trascina l'azione qui sotto {{ GetInstanceState. InstanceState }} == condizione «interrotta».

   1. Per Nome fase, immetti StartInstance.

   2. Nella scheda Input, in Istanza IDs, scegli il valore di input del InstanceIddocumento dal menu a discesa.

   3. Per Stato desiderato, specificare running.

9. Trascina un'azione Attendi l'azione relativa alla AWS risorsa nella casella vuota Trascina l'azione qui sotto {{. GetInstanceState InstanceState }} == condizione di «arresto».

10. In Nome fase, immetti un valore. Per questo tutorial, utilizza il nome WaitForInstanceStop.

    1. Per il campo Servizio, scegli Amazon EC2.

    2. Per il APIcampo, scegli DescribeInstances.

    3. Per il campo Selettore di proprietà, immetti $.Reservations[0].Instances[0].State.Name.

    4. Per il parametro Valori desiderati, immetti ["stopped"].

    5. Nella scheda WaitForInstanceStopConfigurazione dell'azione, scegli StartInstancedal menu a discesa Passaggio successivo.

11. Trascina un comando Esegui sull'azione dell'istanza nella casella vuota Trascina l'azione qui sotto {{. GetInstanceState InstanceState }} == condizione «in esecuzione».

12. Per Nome fase, immetti SayHello.

    1. Nella scheda Input, immetti AWS-RunShellScript per il parametro Nome del documento.

    2. Per InstanceIds, scegli il valore di input del InstanceIddocumento dal menu a discesa.

    3. Espandi il menu a discesa Input aggiuntivi e, dal menu a discesa Nome input, scegli Parametri.

    4. Nel campo Valore di input, immetti {"commands": "echo 'Hello World'"}.

13. Controlla il runbook completato nell'area di lavoro e seleziona Crea runbook per salvare il runbook del tutorial.

    

Fase 3: Revisione del codice generato automaticamente

Man mano che trascini le azioni dal browser Actions sull'area di disegno, l'esperienza di progettazione visiva compone automaticamente il JSON contenuto YAML o il contenuto del runbook in tempo reale. È possibile visualizzare e modificare questo codice. Per visualizzare il codice generato automaticamente, seleziona Codice per Progettazione e l'interruttore Codice.

Fase 4: Esecuzione del nuovo runbook

Dopo aver creato il runbook, puoi eseguire l'automazione.

Esecuzione del nuovo runbook di automazione

1. Apri la AWS Systems Manager console all'indirizzo. https://console.aws.amazon.com/systems-manager/

2. Nel pannello di navigazione, scegliere Automation (Automazione), quindi Execute automation (Esegui automazione).

3. Nell'elenco Automation document (Documento di automazione), scegliere un runbook. Scegliete una o più opzioni nel riquadro Categorie di documenti per filtrare SSM i documenti in base al loro scopo. Per visualizzare un runbook di cui si è proprietari, scegliere la scheda Owned by me (Posseduta da me). Per visualizzare un runbook condiviso con l'account, scegliere la scheda Shared with me (Condiviso con me). Per visualizzare tutti i runbook, scegliere la scheda All documents (Tutti i documenti).

   Nota

   È possibile visualizzare informazioni su un runbook scegliendo il nome del runbook.

4. Nella sezione Document details (Dettagli documento) verifica che l'opzione Document version (Versione documento) sia impostata sulla versione che si desidera eseguire. Il sistema include le seguenti opzioni di versione:

   • Versione predefinita al runtime: scegli questa opzione se il runbook di Automazione viene aggiornato periodicamente e viene assegnata una nuova versione predefinita.

   • Ultima versione al runtime: scegli questa opzione se il runbook di automazione viene aggiornato periodicamente e si desidera che venga eseguita la versione aggiornata più di recente.

   • 1 (predefinita): scegli questa opzione per eseguire la prima versione del documento (quella predefinita).

5. Scegli Next (Successivo).

6. Nella pagina Esegui il runbook di automazione, scegli Esecuzione semplice.

7. Nella sezione Input parameters (Parametri di input) specifica i parametri obbligatori. Facoltativamente, è possibile scegliere un ruolo IAM di servizio dall'AutomationAssumeRoleelenco.

8. (Facoltativo) Scegli un CloudWatch allarme Amazon da applicare alla tua automazione per il monitoraggio. Per collegare un CloudWatch allarme alla tua automazione, il IAM responsabile che avvia l'automazione deve avere l'autorizzazione per l'iam:createServiceLinkedRoleazione. Per ulteriori informazioni sugli CloudWatch allarmi, consulta Usare gli CloudWatch allarmi Amazon. Se l'allarme si attiva, l'automazione viene interrotta. Se lo utilizzi AWS CloudTrail, vedrai la API chiamata nelle tue tracce.

9. Scegliere Execute (Esegui).

Fase 5: rimozione

Eliminazione del runbook

1. Apri la AWS Systems Manager console all'indirizzo https://console.aws.amazon.com/systems-manager/.

2. Nel riquadro di navigazione, scegli Documenti.

3. Scegli la scheda Di mia proprietà.

4. Individua il VisualDesignExperienceTutorialrunbook.

5. Seleziona il pulsante nella pagina della scheda documento, quindi scegli Elimina documento dal menu a discesa Operazioni.