Usa i documenti di comando di Systems Manager per creare snapshot basati su VSS - Amazon Elastic Compute Cloud
Parametri per i documenti Systems Manager per snapshot VSSEsecuzione dei documenti di comando Systems Manager per snapshot VSS

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

Usa i documenti di comando di Systems Manager per creare snapshot basati su VSS

È possibile utilizzare i documenti di comando AWS Systems Manager per creare snapshot basati su VSS. Il seguente contenuto introduce i documenti di comando disponibili e i parametri di runtime utilizzati dai documenti per creare gli snapshot.

Prima di utilizzare uno dei documenti di comando di Systems Manager, assicurati di aver soddisfatto tutti i Prerequisiti per creare snapshot EBS basati su Windows VSS.

Parametri per i documenti Systems Manager per snapshot VSS

I documenti Systems Manager che creano snapshot VSS utilizzano tutti i seguenti parametri, eccetto dove segnalato:

AmiName (stringa, facoltativo)

Se l'opzione CreateAMI è impostata su True, specifica il nome dell'AMI creato dal backup.

description (stringa, facoltativo)

Specifica una descrizione per gli snapshot o l'immagine creata da questo processo.

CollectDiagnosticLogs (stringa, facoltativo)

Per raccogliere ulteriori informazioni durante le fasi di creazione di snapshot e AMI, imposta questo parametro su "True". Il valore predefinito per questo parametro è "False". I log di diagnostica consolidati vengono salvati come formato archivio .zip nella seguente posizione sull'istanza:

C:\ProgramData\Amazon\AwsVss\Logs\timestamp.zip

CopyOnly (stringa, facoltativo)

Se si utilizza il backup nativo di SQL Server oltre a AWS VSS, l'esecuzione di un backup di sola copia impedisce ad AWS VSS di interrompere la catena di backup differenziale nativa. Per eseguire un'operazione di backup di sola copia, imposta questo parametro su True.

Il valore predefinito per questo parametro è False, che fa sì che AWS VSS esegua un'operazione di backup completa.

CreateAmi (stringa, facoltativo)

Per creare un'Amazon Machine Image (AMI) basata su VSS per il backup dell'istanza, imposta questo parametro su True. Il valore predefinito per questo parametro è False, che esegue invece il backup dell'istanza con uno snapshot EBS.

Per ulteriori informazioni sulla creazione di un'AMI da un'istanza, consulta la pagina Creare un'AMI supportata da Amazon EBS.

executionTimeout (stringa, facoltativo)

Specifica il tempo massimo in secondi per eseguire il processo di creazione degli snapshot sull'istanza o per creare un'AMI dall'istanza. L'aumento di questo timeout consente al comando di attendere più a lungo l'avvio del blocco da parte di VSS e di completare il tagging delle risorse create. Questo timeout si applica solo alle fasi di creazione degli snapshot o dell'AMI. Il passaggio iniziale per installare o aggiornare il pacchetto AwsVssComponents non è incluso nel timeout.

ExcludeBootVolume (stringa, facoltativo)

Questa impostazione esclude i volumi di avvio dal processo di backup se si creano snapshot. Per escludere i volumi di avvio dalle istantanee, imposta ExcludeBootVolume su True e CreateAMI su False.

Se si crea un'AMI per il backup, questo parametro deve essere impostato su False. Il valore predefinito per questo parametro è False.

NoWriters (stringa, facoltativo)

Per escludere i writer VSS dell'applicazione dal processo di snapshot, imposta questo parametro suTrue. L'esclusione dei writer VSS dell'applicazione può aiutarti a risolvere i conflitti con componenti di backup VSS di terze parti. Il valore predefinito per questo parametro è False.

Se SaveVssMetadata è True, questo parametro deve essere impostato su False.

SaveVSSMetadata (stringa, facoltativa)

Per salvare i file di metadati VSS durante ogni snapshot, imposta questo parametro su True. Il valore predefinito è False. I file di metadati VSS aiutano a fornire informazioni dettagliate su quali componenti o scrittori sono stati inclusi in un'operazione di backup e sui file associati per ciascun componente.

I file di metadati hanno l'ID del set di snapshot associato nei loro nomi. Puoi trovarli nella seguente posizione sull'istanza:

C:\ProgramData\Amazon\AwsVss\VssMetadata\
avvertimento

  • Il salvataggio dei file di metadati VSS richiede AwsVssComponents la versione del pacchetto 2.4.0 o successive. Se nell'istanza è installata una versione precedente, l'impostazione di SaveVssMetadata su Truecompromette la creazione dello snapshot.

  • I parametri NoWriters e SaveVssMetadata si escludono a vicenda. Se entrambi sono impostati su True, la creazione dello snapshot non va a buon fine.

tags (stringa, facoltativo)

Si consiglia di assegnare tag agli snapshot e alle immagini per facilitare l'individuazione e la gestione delle risorse, ad esempio per ripristinare i volumi da un elenco di snapshot. Il sistema aggiunge la chiave Name, con un valore vuoto in cui è possibile specificare il nome che si desidera applicare agli snapshot o alle immagini di output.

Ulteriori tag possono essere elencati separandoli con un punto e virgola. Ad esempio, Key=Environment,Value=Test;Key=User,Value=TestUser1.

Nota

Le chiavi e i valori dei tag devono contenere solo caratteri alfanumerici e i caratteri speciali: () ./\-"'@_+:={}.

Per impostazione predefinita, il sistema aggiunge i seguenti tag riservati per snapshot e immagini basate su VSS.

  • Dispositivo: per snapshot basati su VSS, questo è il nome del dispositivo del volume EBS acquisito dallo snapshot.

  • AppConsistent: questo tag indica che la creazione di uno snapshot o di un'AMI basata su VSS è andata a buon fine.

  • AwsVssConfig: identifica gli snapshot e le AMI create con VSS abilitato. Il tag include meta informazioni come la versione AwsVssComponents e l'ID del set di snapshot nei loro nomi.

avvertimento

Specificare uno di questi tag riservati nell'elenco dei parametri causerà un errore.

VssVersion (stringa, facoltativo)

Solo per il documento AWSEC2-VssInstallAndSnapshot, puoi specificare il parametro VssVersion per installare una versione specifica del pacchetto AwsVssComponents sull'istanza. Lascia vuoto questo parametro per installare la versione predefinita consigliata.

Se la versione specificata del pacchetto AwsVssComponents è già installata, lo script salta la fase di installazione e passa alla fase di backup. Per un elenco delle versioni del pacchetto AwsVssComponents e del supporto operativo, consulta Cronologia delle versioni della soluzione AWS VSS.

Esecuzione dei documenti di comando Systems Manager per snapshot VSS

È possibile creare snapshot basati su VSS con documenti di comando AWS Systems Manager come indicato di seguito.

Quando si utilizza AWS Systems Manager per eseguire il documento AWSEC2-VssInstallAndSnapshot, lo script esegue i seguenti passaggi.

  1. Lo script installa o aggiorna innanzitutto il pacchetto AwsVssComponents sull'istanza, a seconda che sia già installato.

  2. Lo script crea snapshot coerenti con l'applicazione dopo il completamento del primo passaggio.

Per eseguire il documento AWSEC2-VssInstallAndSnapshot, segui i passaggi relativi al tuo ambiente preferito.

Console
Creazione di snapshot EBS basatu su VSS dalla console

  1. Aprire la console AWS Systems Manager all'indirizzo https://console.aws.amazon.com/systems-manager/.

  2. Nel riquadro di navigazione, seleziona Esegui comando. Questo mostra un elenco di comandi correntemente in esecuzione nel tuo account, se applicabile.

  3. Seleziona Run command (Esegui comando). Si apre un elenco di documenti di comando a cui si ha accesso.

  4. Seleziona AWSEC2-VssInstallAndSnapshot dall'elenco dei documenti di comando. Per semplificare i risultati, puoi inserire tutto o parte del nome del documento. Puoi anche filtrare per proprietario, per tipo di piattaforma o per tag.

    Quando si seleziona un documento di comando, i dettagli vengono inseriti sotto l'elenco.

  5. Seleziona Default version at runtime dall'elenco delle versioni del documento.

  6. Configura i parametri del comando per definire come AWSEC2-VssInstallAndSnapshot installerà il pacchetto AwsVssComponents ed eseguire il backup con snapshot VSS o un'AMI. Per i dettagli dei parametri, consulta Parametri per i documenti Systems Manager per snapshot VSS.

  7. In Selezione della destinazione, specifica i tag o seleziona manualmente le istanze per identificare le istanze su cui eseguire questa operazione.

    Nota

    Se selezioni manualmente le istanze e l'istanza prevista non è inclusa nell'elenco, consulta Dove sono le mie istanze? per suggerimenti sulla risoluzione dei problemi.

  8. Per i parametri aggiuntivi per la definizione del comportamento dei comandi di esecuzione di Systems Manager, ad esempio il controllo della velocità, immetti i valori come descritto in Esecuzione di comandi dalla console.

  9. Selezionare Run (Esegui).

    In caso di esito positivo, il comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco degli snapshot EBS cercando i tag specificati o AppConsistent. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando di Systems Manager. Nel caso in cui l'esecuzione del comando risulti completata con successo, ma non sia riuscito il backup di un determinato volume, è possibile risolvere il problema dall'elenco dei volumi EBS.

AWS CLI

Puoi eseguire i comandi riportati nella AWS CLI per creare snapshot EBS basati su VSS e ottenere lo stato della creazione dello snapshot.

Creazione di snapshot basati su VSS

Esegui il comando seguente per creare snapshot EBS basati su VSS. Per creare gli snapshot, devi identificare le istanze con il parametro --instance-ids. Per ulteriori informazioni sugli altri parametri che è possibile utilizzare, consulta Parametri per i documenti Systems Manager per snapshot VSS.

aws ssm send-command \
	--document-name "AWSEC2-VssInstallAndSnapshot" \
	--instance-ids "i-01234567890abcdef" \
	--parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"],"VssVersion":[""]}'

In caso di esito positivo, il documento di comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco degli snapshot EBS cercando i tag specificati o AppConsistent. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando.

Ottenere lo stato del comando

Per ottenere lo stato corrente degli snapshot, esegui il comando riportato utilizzando l'ID del comando restituito da send-command.

aws ssm get-command-invocation
	--instance-ids "i-01234567890abcdef" \
	--command-id "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" \
	--plugin-name "CreateVssSnapshot"
PowerShell

Esegui i comandi riportati con AWS Tools for Windows PowerShell per creare snapshot EBS basati su VSS e ottenere lo stato di runtime corrente durante la creazione dell'output. Specifica i parametri descritti nell'elenco precedente per modificare il comportamento del processo di snapshot.

Creazione di snapshot EBS basati su VSS con Strumenti per Windows PowerShell

Esegui il comando riportato per creare snapshot EBS o AMI basati su VSS.

Send-SSMCommand -DocumentName "AWSEC2-VssInstallAndSnapshot" -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
	;'tags'='Key=key_name,Value=tag_value';'VssVersion'=''}
Ottenere lo stato del comando

Per ottenere lo stato corrente degli snapshot, esegui il comando riportato utilizzando l'ID del comando restituito da Send-SSMCommand.

Get-SSMCommandInvocationDetail -InstanceId "i-01234567890abcdef" -CommandId "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" -PluginName "CreateVssSnapshot"

In caso di esito positivo, il comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco degli snapshot EBS cercando i tag specificati o AppConsistent. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando.

Per eseguire il documento AWSEC2-CreateVssSnapshot, segui i passaggi relativi al tuo ambiente preferito.

Console
Creazione di snapshot EBS basatu su VSS dalla console

  1. Aprire la console AWS Systems Manager all'indirizzo https://console.aws.amazon.com/systems-manager/.

  2. Nel riquadro di navigazione, seleziona Esegui comando. Questo mostra un elenco di comandi correntemente in esecuzione nel tuo account, se applicabile.

  3. Seleziona Run command (Esegui comando). Si apre un elenco di documenti di comando a cui si ha accesso.

  4. Seleziona AWSEC2-CreateVssSnapshot dall'elenco dei documenti di comando. Per semplificare i risultati, puoi inserire tutto o parte del nome del documento. Puoi anche filtrare per proprietario, per tipo di piattaforma o per tag.

    Quando si seleziona un documento di comando, i dettagli vengono inseriti sotto l'elenco.

  5. Seleziona Default version at runtime dall'elenco delle versioni del documento.

  6. Configura i parametri del comando per definire come AWSEC2-CreateVssSnapshot eseguirà il backup con snapshot VSS o un'AMI. Per i dettagli dei parametri, consulta Parametri per i documenti Systems Manager per snapshot VSS.

  7. In Selezione della destinazione, specifica i tag o seleziona manualmente le istanze per identificare le istanze su cui eseguire questa operazione.

    Nota

    Se selezioni manualmente le istanze e l'istanza prevista non è inclusa nell'elenco, consulta Dove sono le mie istanze? per suggerimenti sulla risoluzione dei problemi.

  8. Per i parametri aggiuntivi per la definizione del comportamento dei comandi di esecuzione di Systems Manager, ad esempio il controllo della velocità, immetti i valori come descritto in Esecuzione di comandi dalla console.

  9. Selezionare Run (Esegui).

    In caso di esito positivo, il comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco degli snapshot EBS cercando i tag specificati o AppConsistent. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando di Systems Manager. Nel caso in cui l'esecuzione del comando risulti completata con successo, ma non sia riuscito il backup di un determinato volume, è possibile risolvere il problema dall'elenco dei volumi EBS.

AWS CLI

Puoi eseguire il comando seguente nella AWS CLI per creare snapshot EBS basati su VSS.

Creazione di snapshot basati su VSS

Esegui il comando seguente per creare snapshot EBS basati su VSS. Per creare gli snapshot, devi identificare le istanze con il parametro --instance-ids. Per ulteriori informazioni sugli altri parametri che è possibile utilizzare, consulta Parametri per i documenti Systems Manager per snapshot VSS.

aws ssm send-command \
	--document-name "AWSEC2-CreateVssSnapshot" \
	--instance-ids "i-01234567890abcdef" \
	--parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"]}'

In caso di esito positivo, il documento di comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco degli snapshot EBS cercando i tag specificati o AppConsistent. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando.

PowerShell

Esegui il comando seguente con AWS Tools for Windows PowerShell per creare snapshot EBS basati su VSS.

Creazione di snapshot EBS basati su VSS con Strumenti per Windows PowerShell

Esegui il comando seguente per creare snapshot EBS basati su VSS. Per creare gli snapshot, devi identificare le istanze con il parametro InstanceId. È possibile specificare più di un'istanza per cui creare snapshot. Per ulteriori informazioni sugli altri parametri che è possibile utilizzare, consulta Parametri per i documenti Systems Manager per snapshot VSS.

Send-SSMCommand -DocumentName AWSEC2-CreateVssSnapshot -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
	;'tags'='Key=key_name,Value=tag_value'}

In caso di esito positivo, il comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco degli snapshot EBS cercando i tag specificati o AppConsistent. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando. Nel caso in cui l'esecuzione del comando risulti completata con successo, ma non sia riuscito il backup di un determinato volume, è possibile risolvere il problema dall'elenco degli snapshot EBS.

È possibile utilizzare una qualsiasi delle procedure della linea di comando descritte nella sezione precedente per creare uno snapshot basato su VSS. Il documento del comando (AWSEC2-VssInstallAndSnapshot o AWSEC2-CreateVssSnapshot) deve essere eseguito sul nodo primario del cluster. Il documento avrà esito negativo sui nodi secondari in quanto non hanno accesso ai dischi condivisi. Se il nodo primario e quello secondario cambiano dinamicamente, puoi eseguire il documento Run Command AWS Systems Manager su più nodi aspettandosi che il comando abbia esito positivo sul nodo primario ed esito negativo sui nodi secondari.

Nota

Per automatizzare i backup, è possibile creare una finestra di manutenzione AWS Systems Manager che utilizza il documento AWSEC2-VssInstallAndSnapshot. Per ulteriori informazioni, consulta Utilizzo delle finestre di manutenzione (console) nella Guida per l'utente di AWS Systems Manager.