Utilizzo dei documenti Systems Manager Automation - AWSToolkit for VS Code

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 Systems Manager Automation

AWS Systems Manageroffre visibilità e controllo dell'infrastrutturaAWS. 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 utilizzato per eseguire attività comuni di manutenzione e distribuzione, ad esempio la creazione o l'aggiornamento di una Amazon Machine Image (AMI). In questo argomento viene illustrato come creare, modificare, pubblicare ed eliminare i documenti di automazioneAWS Toolkit for Visual Studio Code.

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 contengaAWS Identity and Access Management(IAM) autorizzazioni necessarie per creare, modificare, pubblicare ed eliminare documenti di Systems Manager Automation. 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 delle credenziali, consultaConfigurazione dell'utenteAWScredenziali.

Creazione di un nuovo documento di Systems Manager Automation

È possibile creare un nuovo documento di automazione inJSONoYAMLutilizzo di Visual Studio Code. Quando crei un nuovo documento di automazione, questo verrà presentato in un file senza titolo. È possibile assegnare un nome al file e salvarlo in VS Code, tuttavia il nome del file non è visibileAWS.

Per creare un nuovo documento di automazione

  1. Apri il codice VS.

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

  3. Nella tavolozza dei comandi, immettereAWS: Creare un nuovo documento di Systems Manager localmente.

  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 nuovo documento Automation in VS Code non viene visualizzato automaticamente inAWS. Prima di poterlo eseguire, è necessario pubblicarlo su AWS.

Apertura di un documento Systems Manager Automation esistente

Utilizzi ilAWSExplorer per trovare i documenti esistenti di Systems Manager Automation. Quando si apre un documento di automazione esistente, viene visualizzato come un file senza titolo in VS Code.

Per aprire il documento Automation

  1. Apri il codice VS.

  2. Dalla navigazione a sinistra, scegliereAWSper aprireAWSExplorer.

  3. NellaAWSExplorer, perSystems Manager, scegli l'icona di download sul documento che vuoi aprire e quindi scegli la versione del documento. Il file verrà aperto nel formato per quella versione. Altrimenti scegli unoScarica come JSONoScarica come 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 Automation, questi vengono visualizzati nellaDi proprietà di Mecategoria di documenti di Systems Manager nellaAWSExplorer. È possibile possedere documenti di automazione già esistenti inAWSe puoi possedere documenti nuovi o aggiornati in cui hai pubblicato in precedenzaAWSdi VS Code.

Quando apri un documento di automazione per la modifica in VS Code, puoi fare di più rispetto a quello che puoi fare nellaAWS Management Console. Ad esempio:

  • Esiste la convalida dello schema su entrambiJSONeYAML.

  • Nell'editor di documenti sono disponibili snippet per creare qualsiasi tipo di fase di automazione.

  • È disponibile il supporto per il completamento automatico su varie opzioniJSONeYAML.

Utilizzo delle versioni

I documenti di Systems Manager Automation 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.

Pubblicazione di un documento di automazione Systems Manager

Dopo aver modificato il documento Automation in VS Code, è possibile pubblicarlo inAWS.

Per pubblicare il documento Automation

  1. Aprire il documento di automazione che si desidera pubblicare utilizzando la procedura descritta inApertura di un documento Systems Manager Automation esistente.

  2. Apportare le modifiche desiderate pubblicare. Per ulteriori informazioni, consultare Modifica di un documento di automazione di Systems Manager.

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

  4. Nella finestra di dialogo Flusso di lavoro di pubblicazione, scegliereAWSArea in cui pubblicare il documento di automazione.

  5. Se stai pubblicando un nuovo documento, scegliCreazione rapida. In caso contrario, scegliereAggiornamento rapidoper aggiornare un documento Automation esistente inAWSRegione .

  6. Immettere il nome per questo documento di automazione.

Quando si pubblica un aggiornamento di un documento di automazione esistente suAWS, 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 elimina ilAWSrisorse che sono state create o modificate al momento dell'avvio.

Per eliminare il documento Automation

  1. Apri il codice VS.

  2. Dalla navigazione a sinistra, scegliereAWSper aprireAWSExplorer.

  3. NellaAWSExplorer, perSystems Manager, apri il menu contestuale (pulsante destro del mouse) per il documento da eliminare e selezionaEliminazione documento.

Eseguire un documento di automazione Systems Manager

Una volta pubblicato il documento Automation suAWS, è possibile eseguirla per eseguire attività a tuo nome 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 risorseAWSe può sostenere costi di fatturazione. Ti consigliamo vivamente di capire cosa creerà il tuo documento Automation nel tuo account prima di avviarlo.