Utilizzo dei documenti di automazione di Systems Manager - AWSToolkit per VS Code
Presupposti e prerequisitiAutorizzazioni IAM per i documenti di automazione di Systems ManagerCreazione di un nuovo documento di automazione di Systems ManagerApertura di un documento di automazione di Systems Manager esistenteModifica di un documento di automazione di Systems ManagerCreazione di un documento di automazione di Systems ManagerEliminazione di un documento di automazione di Systems ManagerEsecuzione di un documento di automazione di Systems Manager

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à.

Utilizzo dei documenti di automazione di Systems Manager

AWS Systems Manageroffre visibilità e controllo dell'infrastruttura suAWS. Systems Manager offre un'interfaccia utente unificata attraverso la quale consultare dati operativi da diversi servizi AWS e automatizzare i processi operativi sulle risorse AWS.

Un documento di Systems Manager definisce le operazioni eseguite da Systems Manager sulle istanze gestite. Un documento di automazione è un tipo di documento di Systems Manager che si utilizza per l'esecuzione di attività comuni di manutenzione e implementazione, ad esempio la creazione o l'aggiornamento di una Amazon Machine Image (AMI). In questo argomento viene illustrato come creare, modificare ed eliminare documenti di automazione conAWS Toolkit for Visual Studio Code.

Argomenti

Presupposti e prerequisiti

Prima di iniziare, assicurati di:

Autorizzazioni IAM per i documenti di automazione di Systems Manager

Nel Toolkit for VS Code è necessario disporre di un profilo di credenziali che contenga ilAWS Identity and Access Management(IAM) le autorizzazioni necessarie per creare, modificare, pubblicare ed eliminare i documenti di automazione di Systems Manager. Il seguente documento di policy definisce le autorizzazioni IAM necessarie che possono essere utilizzate in una policy principale:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ssm:ListDocuments",
                "ssm:ListDocumentVersions",
                "ssm:DescribeDocument",
                "ssm:GetDocument",
                "ssm:CreateDocument",
                "ssm:UpdateDocument",
                "ssm:UpdateDocumentDefaultVersion",
                "ssm:DeleteDocument"
            ],
            "Resource": "*"
        }
    ]
}

Per informazioni sull'aggiornamento di una policy IAM, consulta la sezione Creazione di policy IAM nella Guida per l'utente di IAM. Per informazioni su come configurare il profilo di credenziali, consulta.AWSCredenziali IAM.

Creazione di un nuovo documento di automazione di Systems Manager

È possibile creare un nuovo documento di automazione inJSONoYAMLutilizzando Visual Studio Code. Quando si crea un nuovo documento di automazione, viene presentato come file senza titolo. È possibile assegnare un nome al file e salvarlo in VS Code, tuttavia il nome del file non è visibile aAWS.

Per creare un nuovo documento di automazione

  1. Apri VS Code.

  2. SulVisualizzazionemenu, scegliTavolozza dei comandiper aprire la tavolozza dei comandi.

  3. Nella tavolozza dei comandi, inserisciAWSToolkit Creazione locale di un nuovo documento di Systems Manager.

  4. Scegli uno dei modelli di avvio per un esempio di Hello World.

  5. Scegliere JSON o YAML.

    Viene creato un nuovo documento di automazione.

Nota

Il tuo nuovo documento di automazione in VS Code non viene visualizzato automaticamente inAWS. Prima di poterlo eseguire, è necessario pubblicarlo su AWS.

Apertura di un documento di automazione di Systems Manager esistente

È possibile utilizzare il pluginAWSExplorer per individuare i documenti di automazione di Systems Manager esistenti. Quando si apre un documento di automazione esistente, viene visualizzato come file senza titolo in VS Code.

Per aprire il documento Automation

  1. Apri VS Code.

  2. Nella barra di navigazione a sinistra, scegliereAWSper aprireAWSExplorer.

  3. NellaAWSExplorerSystems Manager, scegli l'icona di download sul documento che desideri aprire e quindi scegli la versione del documento. Il file verrà aperto nel formato per quella versione. Altrimenti scegli uno dei dueScarica come JSONoScarica come file YAML.

Nota

Il salvataggio locale di un documento di automazione come file in VS Code non lo fa apparire inAWS. Deve essere pubblicato perAWSprima dell'esecuzione.

Modifica di un documento di automazione di Systems Manager

Se possiedi documenti di Automation, questi vengono visualizzati nellaDi proprietà di Mecategoria di documenti di Systems Manager nelAWSExplorer. È possibile possedere documenti di automazione già esistenti inAWSe puoi possedere documenti nuovi o aggiornati che hai pubblicato in precedenzaAWSda VS Code.

Quando apri un documento di automazione per la modifica in VS Code, puoi farne di più di quanto tu possa fare inAWS Management Console. Ad esempio:

  • C'è una convalida dello schema su entrambiJSONeYAMLFormati.

  • Ci sono frammenti disponibili nell'editor di documenti per creare qualsiasi tipo di fase di automazione.

  • È disponibile il supporto per il completamento automatico su varie opzioni inJSONeYAML.

Utilizzo delle versioni

I documenti di automazione di Systems Manager utilizzano versioni per la gestione delle modifiche. È possibile scegliere la versione predefinita per un documento di automazione in VS Code.

Per impostare una versione di default

  • In AWS Explorer, individua il documento per il quale impostare la versione di default, apri il menu contestuale (facendo clic con il pulsante destro del mouse) del documento e scegli Set default version (Imposta versione predefinita).

    Nota

    Se il documento scelto ha una sola versione, non sarà possibile modificare l'impostazione predefinita.

Creazione di un documento di automazione di Systems Manager

Dopo avere modificato il documento di automazione in VS Code, è possibile pubblicarlo inAWS.

Per pubblicare il documento di automazione

  1. Apri il documento di automazione che desideri pubblicare utilizzando la procedura descritta nella sezione.Apertura di un documento di automazione di Systems Manager esistente.

  2. Apporta le modifiche desiderate per la pubblicazione. Per ulteriori informazioni, consulta la pagina Modifica di un documento di automazione di Systems Manager .

  3. In alto a destra del file aperto, scegliere l'icona di caricamento.

  4. Nella finestra di dialogo del flusso di lavoro di pubblicazione, scegliere laAWSRegione in cui effettuare la pubblicazione del documento di automazione.

  5. Se stai pubblicando un nuovo documento, scegliCreazione rapida. In caso contrario, scegliAggiornamento rapidoper aggiornare un documento di automazione esistenteAWSRegione .

  6. Immettere il nome per questo documento di automazione.

Quando si pubblica un aggiornamento di un documento di automazione esistente inAWS, viene aggiunta una nuova versione al documento.

Eliminazione di un documento di automazione di Systems Manager

È possibile eliminare i documenti di automazione in VS Code. Se si elimina un documento di automazione, oltre a quest'ultimo vengono eliminate anche tutte le rispettive versioni.

Importante

  • L'eliminazione è un'azione distruttiva che non può essere annullata.

  • L'eliminazione di un documento di automazione già eseguito non comporta l'eliminazione delAWSrisorse che sono state create o modificate all'avvio.

Per eliminare un documento di automazione

  1. Apri VS Code.

  2. Nella barra di navigazione a sinistra, scegliereAWSper aprireAWSExplorer.

  3. NellaAWSExplorerSystems Manager, apri il menu contestuale (pulsante destro del mouse) del documento che desideri eliminare, quindi scegliEliminazione di documento.

Esecuzione di un documento di automazione di Systems Manager

Una volta pubblicato il documento Automation suAWS, puoi eseguirlo affinché effettui operazioni per conto tuo nel tuoAWSconto. Puoi eseguire un documento di automazione utilizzando la AWS Management Console, le API di Systems Manager, la AWS CLI o AWS Tools for PowerShell. Per istruzioni sull'esecuzione di un documento di automazione, consulta.Esecuzione di un'automazione semplicenellaAWS Systems ManagerGuida per l’utente di.

In alternativa, se desideri utilizzare uno degli SDK AWS con le API di Systems Manager per eseguire il documento di automazione, consulta i riferimenti sugli SDK AWS.

Nota

L'esecuzione di un documento di automazione può creare nuove risorse inAWSe possono incorrere in costi di fatturazione. Prima di avviare il documento di automazione, ti consigliamo vivamente di verificare quali risorse creerà nell'account.