• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la [documentazione di Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Tutorial: Creazione di un runbook utilizzando l'esperienza di progettazione visiva
<a name="visual-designer-tutorial"></a>

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ù operazioni. È possibile utilizzare la funzionalità di trascinamento e rilascio per disporre le operazioni nell'area di lavoro. È possibile anche cercare, selezionare e configurare queste operazioni. Quindi, è possibile 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](automation-setup.md).

**Topics**
+ [Fase 1: Passaggio all'esperienza di progettazione visiva](#navigate-console)
+ [Fase 2: Creazione di un flusso di lavoro](#create-workflow)
+ [Fase 3: Revisione del codice generato automaticamente](#view-generated-code)
+ [Fase 4: Esecuzione del nuovo runbook](#use-tutorial-runbook)
+ [Fase 5: rimozione](#cleanup-tutorial-runbook)

## Fase 1: Passaggio all'esperienza di progettazione visiva
<a name="navigate-console"></a>

1. Accedi alla [console di Systems Manager Automation](https://console.aws.amazon.com/systems-manager/automation/home?region=us-east-1#/).

1. Scegli **Crea un runbook automazione**.

## Fase 2: Creazione di un flusso di lavoro
<a name="create-workflow"></a>

Nell'esperienza di progettazione visiva, un flusso di lavoro è una rappresentazione grafica del runbook nell'area di lavoro. È possibile usare l'esperienza di progettazione visiva per definire, configurare ed esaminare le singole operazioni 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**.  
![\[Assegnazione di un nome al runbook per l'esperienza di progettazione visiva\]](http://docs.aws.amazon.com/it_it/systems-manager/latest/userguide/images/visual_designer_tutorial_name.png)

1. 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**.

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

   1. Seleziona l'interruttore **Richiesto**.  
![\[Creazione di un parametro per il runbook\]](http://docs.aws.amazon.com/it_it/systems-manager/latest/userguide/images/visual_designer_actions_tutorial_parameter.png)

1. Nel **AWS APIs**browser, accedi **DescribeInstances** alla barra di ricerca.

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

1. In **Nome fase**, immetti un valore. Per questo tutorial, è possibile utilizzare il nome **GetInstanceState**.  
![\[Scegli un'operazione API per la descrizione delle istanze di Amazon EC2.\]](http://docs.aws.amazon.com/it_it/systems-manager/latest/userguide/images/visual_designer_tutorial_api_action.png)

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

   1. Scegli la scheda **Input**.

   1. 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'**InstanceIds**input per l'`DescribeInstances`azione accetta `StringList` valori, è necessario racchiudere l'**InstanceId**input tra parentesi quadre. È necessario che il codice YAML per il **valore di input** corrisponda al seguente: **['\$1\$1 InstanceId \$1\$1']**.

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

   1. Nel campo **Selettore**, inserisci **\$1.Reservations[0].Instances[0].State.Name**.

   1. Dal menu a discesa **Tipo**, scegli **Stringa**.

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

1. 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 1**.

   1. Scegli **Aggiungi condizione**.

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

   1. Per **Operatore**, scegli **è uguale a**.

   1. Per **Valore**, scegli **Stringa** dall'elenco a discesa. Specificare **stopped**.  
![\[Definisci una condizione per un'azione di ramificazione.\]](http://docs.aws.amazon.com/it_it/systems-manager/latest/userguide/images/visual_designer_tutorial_condition.png)

   1. Seleziona **Salva condizioni**.

   1. Scegli **Aggiungi una nuova regola di scelta**.

   1. Scegli **Aggiungi condizioni** per la **Regola \$1 2**.

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

   1. Per **Operatore**, scegli **è uguale a**.

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

   1. Seleziona **Salva condizioni**.

   1. Scegli **Aggiungi una nuova regola di scelta**.

   1. Scegli **Aggiungi condizioni** per **Regola \$1 3**.

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

   1. Per **Operatore**, scegli **è uguale a**.

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

   1. Seleziona **Salva condizioni**.

   1. In **Regola predefinita**, scegli **Vai alla fine** per **Fase predefinita**.

1. Trascina **un'azione Cambia lo stato di un'istanza** nella casella vuota **Trascina l'azione qui** sotto **\$1\$1 GetInstanceState. InstanceState \$1\$1 == condizione «interrotta».**

   1. Per **Nome fase**, immetti **StartInstance**.

   1. Nella scheda **Input**, in **Istanza IDs**, scegli il valore di input del **InstanceId**documento dal menu a discesa.

   1. Per **Stato desiderato**, specificare **`running`**.

1. Trascina un'azione **Attendi l'azione relativa alla AWS risorsa** nella casella vuota **Trascina l'azione qui** sotto **\$1\$1. GetInstanceState InstanceState \$1\$1 == condizione di «arresto».**

1. In **Nome fase**, immetti un valore. Per questo tutorial, utilizza il nome `WaitForInstanceStop`.

   1. Per il campo **Servizio**, scegli **Amazon EC2**.

   1. Per il campo **API**, scegli. **DescribeInstances**

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

   1. Per il parametro **Valori desiderati**, immetti **`["stopped"]`**.

   1. Nella scheda ****WaitForInstanceStop**Configurazione** dell'azione, scegli **StartInstance**dal menu a discesa **Passaggio successivo**.

1. Trascina un **comando Esegui sull'azione dell'istanza** nella casella vuota **Trascina l'azione qui** sotto **\$1\$1. GetInstanceState InstanceState \$1\$1 == condizione «in esecuzione».**

1. Per **Nome fase**, immetti **SayHello**.

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

   1. Per **InstanceIds**, scegli il valore di input del **InstanceId**documento dal menu a discesa.

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

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

1. Controlla il runbook completato nell'area di lavoro e seleziona **Crea runbook** per salvare il runbook del tutorial.  
![\[Rivedi e crea il runbook.\]](http://docs.aws.amazon.com/it_it/systems-manager/latest/userguide/images/visual_designer_tutorial_complete.png)

## Fase 3: Revisione del codice generato automaticamente
<a name="view-generated-code"></a>

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
<a name="use-tutorial-runbook"></a>

Dopo aver creato il runbook, è possibile eseguire l'automazione.

**Esecuzione del nuovo runbook Automation**

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

1. Nel pannello di navigazione, scegli **Automazione**, quindi **Esegui automazione**.

1. Nell'elenco **Documento di automazione**, scegli un runbook. Scegli una o più opzioni nel pannello **Categorie di documenti** per filtrare i documenti SSM in base al loro scopo. Per visualizzare un runbook di cui si è proprietari, scegliere la scheda **Posseduto da me**. Per visualizzare un runbook condiviso con l'account, scegliere la scheda **Condiviso con me**. Per visualizzare tutti i runbook, scegliere la scheda **Tutti i documenti**.
**Nota**  
È possibile visualizzare informazioni su un runbook scegliendo il nome del runbook.

1. Nella sezione **Dettagli documento** verifica che l'opzione **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 Automation viene aggiornato periodicamente e viene assegnata una nuova versione predefinita.
   + **Ultima versione al runtime**: scegli questa opzione se il runbook Automation 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).

1. Scegli **Next (Successivo)**.

1. Nella pagina **Esegui il runbook Automation**, scegli **Esecuzione semplice**.

1. Nella sezione **Input parameters (Parametri di input)** specifica i parametri obbligatori. Facoltativamente, puoi scegliere un ruolo di servizio IAM dall'**AutomationAssumeRole**elenco.

1. (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:createServiceLinkedRole`azione. Per ulteriori informazioni sugli CloudWatch allarmi, consulta [Usare gli CloudWatch allarmi Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html). Se l'allarme si attiva, l'automazione viene interrotta. Se utilizzi AWS CloudTrail, vedrai la chiamata API nel tuo percorso. 

1. Scegli **Esegui**. 

## Fase 5: rimozione
<a name="cleanup-tutorial-runbook"></a>

**Eliminazione del runbook**

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

1. Nel pannello di navigazione, scegli **Documenti**.

1. Scegli la scheda **Di mia proprietà**.

1. Individua il **VisualDesignExperienceTutorial**runbook.

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