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 Systems Manager Automation
AWS Systems Manager ti offre visibilità e controllo della tua infrastruttura su AWS. Systems Manager fornisce un'interfaccia utente unificata in modo da poter visualizzare i dati operativi di più AWS servizi e automatizzare le attività operative tra le AWS risorse.
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 utilizzi per eseguire attività di manutenzione e distribuzione comuni come la creazione o l'aggiornamento di un'Amazon Machine Image (AMI). Questo argomento descrive come creare, modificare, pubblicare ed eliminare documenti di automazione con. AWS Toolkit for Visual Studio Code
Argomenti
Presupposti e prerequisiti
Prima di iniziare, assicurati di:
-
Hai installato Visual Studio Code e la versione più recente di AWS Toolkit for Visual Studio Code. Per ulteriori informazioni, consulta Installazione del AWS Toolkit for Visual Studio Code.
-
Sapere come funziona Systems Manager. Per ulteriori informazioni, consulta la Guida per l'utente di AWS Systems Manager .
-
Conosci i casi d'uso di Systems Manager Automation. Per ulteriori informazioni, consulta la sezione Automazione di AWS Systems Manager nella Guida per l'utente di AWS Systems Manager .
Autorizzazioni IAM per i documenti di automazione di Systems Manager
Nel Toolkit for VS Code è necessario disporre di un profilo di credenziali che contenga le autorizzazioni AWS Identity and Access Management (IAM) necessarie per creare, modificare, pubblicare ed eliminare i documenti di Systems Manager Automation. Il seguente documento di policy definisce le autorizzazioni IAM necessarie che possono essere utilizzate in una policy principale:
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, vedere. AWS Credenziali IAM
Creazione di un nuovo documento di Systems Manager Automation
È possibile creare un nuovo documento di automazione in JSON o YAML utilizzando Visual Studio Code. Quando si crea un nuovo documento di automazione, questo verrà presentato in un file senza titolo. Puoi assegnare un nome al file e salvarlo in VS Code, tuttavia il nome del file non è visibile. AWS
Per creare un nuovo documento di automazione
-
Apri VS Code.
-
Nel menu Visualizza, scegli Command Palette per aprire la Palette dei comandi.
-
Nella palette dei comandi, inserisci AWS Toolkit Crea un nuovo documento di Systems Manager localmente.
-
Scegli uno dei modelli di avvio per un esempio di Hello World.
-
Scegliere
JSONoYAML.Viene creato un nuovo documento di automazione.
Nota
Il tuo nuovo documento di automazione in VS Code non viene visualizzato automaticamente in AWS. È necessario pubblicarlo su AWS prima di poterlo eseguire.
Apertura di un documento di Systems Manager Automation esistente
Si utilizza AWS Explorer per trovare i documenti di Systems Manager Automation esistenti. Quando si apre un documento di automazione esistente, questo viene visualizzato come file senza titolo in VS Code.
Per aprire il documento Automation
-
Apri VS Code.
-
Dalla barra di navigazione a sinistra, scegli di AWS aprire Explorer. AWS
-
In AWS Explorer, per Systems Manager, scegli l'icona di download sul documento che desideri aprire, quindi scegli la versione del documento. Il file verrà aperto nel formato corrispondente a quella versione. Altrimenti scegli Scarica come JSON o Scarica come YAML.
Nota
Il salvataggio locale di un documento di automazione come file in VS Code non lo fa apparire in. AWS Deve essere pubblicato su AWS prima dell'esecuzione.
Modifica di un documento di Systems Manager Automation
Se possiedi dei documenti di automazione, questi vengono visualizzati nella categoria Owned by Me dei documenti di Systems Manager in AWS Explorer. Puoi essere proprietario di documenti di automazione già esistenti e puoi possedere documenti nuovi o aggiornati pubblicati in precedenza AWS da VS Code. AWS
Quando apri un documento di Automation per la modifica in VS Code, puoi utilizzarlo più di quanto puoi fare in Console di gestione AWS. Ad esempio:
-
È prevista la convalida dello schema su entrambi
JSONiYAMLformati. -
Nell'editor di documenti sono disponibili degli snippet per creare qualsiasi tipo di fase di automazione.
-
È disponibile il supporto per il completamento automatico di varie opzioni in e.
JSONYAML
Utilizzo delle versioni
I documenti di Systems Manager Automation utilizzano le 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, accedi al documento su cui desideri impostare la versione predefinita, apri il menu contestuale (clic con il pulsante destro del mouse) per il documento e scegli Imposta versione predefinita.
Nota
Se il documento scelto ha una sola versione, non sarà possibile modificare l'impostazione predefinita.
Pubblicazione di un documento di Systems Manager Automation
Dopo aver modificato il documento di automazione in VS Code, puoi pubblicarlo su AWS.
Per pubblicare il tuo documento di automazione
-
Apri il documento di automazione che desideri pubblicare utilizzando la procedura descritta inApertura di un documento di Systems Manager Automation esistente.
-
Apporta le modifiche che desideri vengano pubblicate. Per ulteriori informazioni, consulta Modifica di un documento di Systems Manager Automation.
-
In alto a destra del file aperto, scegli l'icona di caricamento.
-
Nella finestra di dialogo del flusso di pubblicazione, scegli la AWS regione in cui desideri pubblicare il documento di automazione.
-
Se stai pubblicando un nuovo documento, scegli Creazione rapida. Altrimenti, scegli Aggiornamento rapido per aggiornare un documento di automazione esistente in quella AWS regione.
-
Inserisci il nome di questo documento di automazione.
Quando si pubblica un aggiornamento di un documento di automazione esistente in AWS, viene aggiunta una nuova versione al documento.
Eliminazione di un documento di Systems Manager Automation
È 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 che è già stato eseguito non elimina le AWS risorse che sono state create o modificate all'avvio.
Per eliminare il documento di automazione
-
Apri VS Code.
-
Dalla barra di navigazione a sinistra, scegli di AWS aprire Explorer. AWS
-
In AWS Explorer, per Systems Manager, apri il menu contestuale (clic con il pulsante destro del mouse) per il documento che desideri eliminare e scegli Elimina documento.
Esecuzione di un documento di Systems Manager Automation
Una volta pubblicato il documento di automazione su AWS, puoi eseguirlo per eseguire attività per tuo conto nel tuo AWS account. Per eseguire il documento di automazione Console di gestione AWS, utilizzi le API di Systems Manager AWS CLI, o. AWS Strumenti per PowerShell Per istruzioni su come eseguire un documento di automazione, consulta Running a simple automation nella Guida per l'AWS Systems Manager utente.
In alternativa, se desideri utilizzare uno degli AWS SDK con le API di Systems Manager per eseguire il documento di automazione, consulta i riferimenti AWS SDK.
Nota
L'esecuzione di un documento di automazione può creare nuove risorse AWS e comportare costi di fatturazione. Ti consigliamo vivamente di capire cosa creerà il documento Automation nel tuo account prima di avviarlo.
