Creazione di snapshot VSS con documenti di comando AWS Systems Manager - 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à.

Creazione di snapshot VSS con documenti di comando AWS Systems Manager

È possibile utilizzare i documenti di AWS Systems Manager comando per creare istantanee abilitate per 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.

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:

ExcludeBootVolume(stringa, opzionale)

Questa impostazione esclude i volumi di avvio dal processo di backup se si creano snapshot. Per escludere i volumi di avvio dalle istantanee, imposta ExcludeBootVolumesu True e CreateAmisuFalse.

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

NoWriters(stringa, opzionale)

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.

CopyOnly(stringa, opzionale)

Se si utilizza il backup nativo di SQL Server oltre a AWS VSS, l'esecuzione di un backup di sola copia impedisce a 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, opzionale)

Per creare un'Amazon Machine Image (AMI) abilitata per 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 Crea un'AMI supportata da Amazon EBS.

AmiName(stringa, opzionale)

Se l'CreateAmiopzione è impostata suTrue, specifica il nome dell'AMI creato dal backup.

description (stringa, facoltativo)

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

tags (stringa, facoltativo)

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

Se desideri specificare tag aggiuntivi, separali con un punto e virgola in mezzo. Ad esempio, Key=Environment,Value=Test;Key=User,Value=TestUser1.

Per impostazione predefinita, il sistema aggiunge i seguenti tag riservati per istantanee e immagini compatibili con VSS.

  • Dispositivo: per le istantanee abilitate per VSS, questo è il nome del dispositivo del volume EBS acquisito dall'istantanea.

  • AppConsistent— Questo tag indica la corretta creazione di un'istantanea o di un AMI abilitato per VSS.

  • AwsVssConfig— Identifica le istantanee e le AMI create con VSS abilitato. Il tag include meta-informazioni come la versione. AwsVssComponents

avvertimento

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

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.

CollectDiagnosticLogs(stringa, opzionale)

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

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

VssVersion(stringa, opzionale)

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 AWS Cronologia delle versioni della soluzione VSS.

Esecuzione dei documenti di comando Systems Manager per snapshot VSS

È possibile creare istantanee EBS abilitate per VSS con AWS Systems Manager documenti di comando come segue.

Quando si utilizza AWS Systems Manager per eseguire il AWSEC2-VssInstallAndSnapshot documento, 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 abilitati per VSS dalla console

  1. Apri la AWS Systems Manager console 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 seguenti comandi in AWS CLI per creare istantanee EBS abilitate per VSS e ottenere lo stato della creazione delle istantanee.

Creazione di snapshot EBS con tecnologia VSS

Esegui il comando seguente per creare snapshot EBS con tecnologia 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 seguenti comandi con AWS Tools for Windows PowerShell per creare istantanee EBS abilitate per VSS e ottenere lo stato di runtime corrente per la creazione dell'output. Specifica i parametri descritti nell'elenco precedente per modificare il comportamento del processo di snapshot.

Crea istantanee EBS compatibili con VSS con Tools for Windows PowerShell

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

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 abilitati per VSS dalla console

  1. Apri la AWS Systems Manager console 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 seguente comando in AWS CLI per creare istantanee EBS abilitate per VSS.

Creazione di snapshot EBS con tecnologia VSS

Esegui il comando seguente per creare snapshot EBS con tecnologia 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 seguente comando con per creare istantanee EBS abilitate AWS Tools for Windows PowerShell per VSS.

Crea istantanee EBS abilitate per VSS con Tools for Windows PowerShell

Esegui il comando seguente per creare snapshot EBS con tecnologia 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 abilitato per 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 primario e il secondario cambiano dinamicamente, puoi AWS Systems Manager eseguire il documento Run Command su più nodi con l'aspettativa che il comando abbia esito positivo sul nodo primario e abbia esito negativo sui nodi secondari.

Con il seguente script e il documento predefinito SSM AWSEC2-ManageVssIO è possibile sospendere temporaneamente le operazioni di I/O, creare snapshot EBS con tecnologia VSS e riavviare le operazioni di I/O. Questo processo si verifica nel contesto dell'utente che esegue il comando. Se l'utente dispone di autorizzazioni sufficienti per creare e contrassegnare istantanee, AWS Systems Manager può creare e taggare istantanee EBS abilitate per VSS senza la necessità del ruolo aggiuntivo di snapshot IAM sull'istanza.

Al contrario, il documento del comando (AWSEC2-VssInstallAndSnapshot o AWSEC2-CreateVssSnapshot) richiede di assegnare il ruolo di snapshot IAM a ogni istanza per cui si intende creare snapshot EBS. Se non si desidera fornire ulteriori autorizzazioni IAM alle istanze per motivi di conformità o di policy, ci si può avvalere del seguente script.

Prima di iniziare

Tieni presenti queste importanti informazioni relative a questo processo:

  • Questo processo utilizza uno PowerShell script (CreateVssSnapshotAdvancedScript.ps1) per scattare istantanee di tutti i volumi sulle istanze specificate, ad eccezione dei volumi root. Per acquisire snapshot di volumi root, è necessario utilizzare il documento SSM AWSEC2-CreateVssSnapshot.

  • Lo script chiama il documento AWSEC2-ManageVssIO due volte. La prima volta, con il parametro Action impostato su Freeze, che sospende tutte le attività di I/O sulle istanze. La seconda volta, il parametro Action è impostato su Thaw, che forza la ripresa delle attività di I/O.

  • Non tentate di utilizzare il AWSEC2-ManageVssIO documento senza utilizzare lo CreateVssSnapshotAdvancedScript script.ps1. Il framework VSS di Microsoft prevede che le operazioni Freeze e Thaw vengano chiamate a non più di dieci secondi di distanza; la chiamata manuale di tali operazioni senza lo script potrebbe generare errori.

Come creare snapshot EBS con tecnologia VSS avvalendosi del documento AWSEC2-ManageVssIO

  1. Scarica il CreateVssSnapshotAdvancedScriptfile.zip ed estrai il contenuto del file.

  2. Apri CreateVssSnapshotAdvancedScript.ps1 in un editor di testo, modifica la chiamata di esempio nella parte inferiore dello script con un ID di istanza EC2 valido, una descrizione dell'istantanea e i valori dei tag desiderati, quindi esegui lo script da. PowerShell

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 sia stata completata con successo, ma non sia riuscito il backup di un determinato volume, è possibile risolvere il problema dall'elenco dei volumi EBS.

Nota

Per automatizzare i backup, puoi creare un'attività della finestra di AWS Systems Manager manutenzione che utilizzi il documento. AWSEC2-VssInstallAndSnapshot Per ulteriori informazioni, consulta Utilizzo delle finestre di manutenzione (console) nella Guida per l'utente di AWS Systems Manager .