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 codice YAML 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::EC2::Instance.

   3. Seleziona l'interruttore Richiesto.

   

3. Nel browser API AWS , immetti DescribeInstances nella barra di ricerca.

4. Trascina un' DescribeInstancesazione di 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 codice YAML per il valore di 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 Modifica dello 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, sotto Instance ID, 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 campo API, 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 e rilasci le operazioni dal browser Operazioni nell'area di lavoro, l'esperienza di progettazione visiva compone automaticamente il contenuto YAML o JSON 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. Scegli una o più opzioni nel pannello Document categories (Categorie di documenti) per filtrare i documenti SSM 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. Seleziona 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, puoi scegliere un ruolo di servizio IAM 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 responsabile IAM che avvia l'automazione deve disporre dell'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 utilizzi AWS CloudTrail, vedrai la chiamata API nel tuo percorso.

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.