Création d’instantanés VSS à l’aide des documents de commande AWS Systems Manager - Amazon Elastic Compute Cloud
Paramètres des documents d’instantanés VSS Systems ManagerExécution de documents de commande d’instantanés VSS Systems Manager

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Création d’instantanés VSS à l’aide des documents de commande AWS Systems Manager

Vous pouvez utiliser des documents de AWS Systems Manager commande pour créer des instantanés compatibles VSS. Le contenu suivant présente les documents de commande disponibles et les paramètres d’exécution utilisés par ces documents pour créer vos instantanés.

Avant d’utiliser l’un des documents de commande de Systems Manager, assurez-vous d’avoir respecté toutes les Prérequis.

Paramètres des documents d’instantanés VSS Systems Manager

Les documents Systems Manager qui créent des instantanés VSS utilisent tous les paramètres suivants, sauf indication contraire :

ExcludeBootVolume(chaîne, facultatif)

Ce paramètre exclut les volumes de démarrage du processus de sauvegarde si vous créez des instantanés. Pour exclure les volumes de démarrage de vos instantanés, définissez ExcludeBootVolumeles paramètres sur True et CreateAmisurFalse.

Si vous créez une AMI pour votre sauvegarde, ce paramètre doit être défini sur False. La valeur par défaut de ce paramètre est False.

NoWriters(chaîne, facultatif)

Définissez ce paramètre sur True pour exclure les enregistreurs VSS d’application du processus de capture instantanée. L’exclusion d’enregistreurs VSS d’application peut vous aider à résoudre les conflits avec des composants de sauvegarde VSS tiers. La valeur par défaut de ce paramètre est False.

CopyOnly(chaîne, facultatif)

Si vous utilisez la sauvegarde native de SQL Server en plus de AWS VSS, l'exécution d'une sauvegarde avec copie uniquement empêche AWS VSS de rompre la chaîne de sauvegarde différentielle native. Pour effectuer une opération de sauvegarde par copie uniquement, définissez ce paramètre sur True.

La valeur par défaut de ce paramètre estFalse, ce qui oblige AWS VSS à effectuer une opération de sauvegarde complète.

CreateAmi(chaîne, facultatif)

Pour créer une Amazon Machine Image (AMI) compatible AVEC VSS afin de sauvegarder votre instance, définissez ce paramètre sur True. La valeur par défaut de ce paramètre est False, qui sauvegarde votre instance avec un instantané EBS à la place.

Pour plus d’informations sur la création d’une AMI à partir d’une instance , consultez la page Création d'une AMI basée sur Amazon EBS.

AmiName(chaîne, facultatif)

Si l'CreateAmioption est définie surTrue, spécifiez le nom de l'AMI créée par la sauvegarde.

description : (chaîne, facultatif)

Spécifiez une description pour les instantanés ou les images créés par ce processus.

tags (chaîne, facultatif)

Nous vous recommandons de baliser vos instantanés et vos images pour vous aider à localiser et à gérer vos ressources, par exemple pour restaurer des volumes à partir d'une liste d'instantanés. Le système ajoute la Name clé, avec une valeur vide dans laquelle vous pouvez spécifier le nom que vous souhaitez appliquer à vos instantanés ou images de sortie.

Si vous souhaitez spécifier des balises supplémentaires, séparez-les par un point-virgule entre les deux. Par exemple, Key=Environment,Value=Test;Key=User,Value=TestUser1.

Par défaut, le système ajoute les balises réservées suivantes pour les instantanés et les images compatibles VSS.

  • Appareil : pour les instantanés compatibles VSS, il s'agit du nom de périphérique du volume EBS capturé par le cliché.

  • AppConsistent— Cette balise indique la création réussie d'un instantané ou d'une AMI compatible VSS.

  • AwsVssConfig— Cela identifie les instantanés et les AMI créés avec le VSS activé. La balise inclut des méta-informations telles que la AwsVssComponents version.

Avertissement

La spécification de l'une de ces balises réservées dans votre liste de paramètres provoquera une erreur.

executionTimeout (chaîne, facultatif)

Indiquez la durée maximale en secondes pour exécuter le processus de création d’instantanés sur l’instance ou pour créer une AMI à partir de l’instance. L’augmentation de ce délai d’expiration permet à la commande d’attendre plus longtemps pour que VSS commence à se figer et termine le balisage des ressources qu’elle crée. Ce délai ne s’applique qu’aux étapes de création d’instantané ou d’AMI. L’étape initiale d’installation ou de mise à jour du package AwsVssComponents n’est pas incluse dans le délai d’expiration.

CollectDiagnosticLogs(chaîne, facultatif)

Pour collecter plus d'informations lors des étapes de création de snapshots et d'AMI, définissez ce paramètre sur « True ». La valeur par défaut de ce paramètre est « False ». Les journaux de diagnostic consolidés sont enregistrés sous .zip forme d'archive au format à l'emplacement suivant sur votre instance :

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

VssVersion(chaîne, facultatif)

Pour le document AWSEC2-VssInstallAndSnapshot uniquement, vous pouvez spécifier le paramètre VssVersion pour installer une version spécifique du package AwsVssComponents sur votre instance. Laissez ce paramètre vide pour installer la version par défaut recommandée.

Si la version spécifiée du package AwsVssComponents est déjà installée, le script ignore l’étape d’installation et passe à l’étape de sauvegarde. Pour obtenir la liste des versions de package AwsVssComponents et du support d’exploitation, consultez AWS Historique des versions de la solution VSS.

Exécution de documents de commande d’instantanés VSS Systems Manager

Vous pouvez créer des instantanés EBS compatibles VSS avec des documents de AWS Systems Manager commande comme suit.

Lorsque vous exécutez AWS Systems Manager le AWSEC2-VssInstallAndSnapshot document, le script exécute les étapes suivantes.

  1. Le script commence par installer ou mettre à jour le package AwsVssComponents sur votre instance, selon qu’il est déjà installé ou non.

  2. Le script crée les instantanés cohérents avec l’application une fois la première étape terminée.

Pour exécuter le document AWSEC2-VssInstallAndSnapshot, suivez les étapes correspondant à votre environnement préféré.

Console
Création d’instantanés EBS compatibles avec VSS depuis la console

  1. Ouvrez la AWS Systems Manager console à l'adresse https://console.aws.amazon.com/systems-manager/.

  2. Dans le volet de navigation, sélectionnez Exécuter une commande. Cela permet d’afficher une liste des commandes en cours d’exécution dans votre compte, le cas échéant.

  3. Sélectionnez Run Command (Exécuter la commande). Cela permet d’ouvrir la liste des documents de commande auxquels vous avez accès.

  4. Sélectionnez AWSEC2-VssInstallAndSnapshot dans la liste des documents de commande. Pour rationaliser les résultats, vous pouvez saisir tout ou partie du nom du document. Vous pouvez également filtrer par propriétaire, par type de plateforme ou par balise.

    Lorsque vous sélectionnez un document de commande, les détails apparaissent sous la liste.

  5. Sélectionnez Default version at runtime dans la liste Version du document.

  6. Configurez les paramètres de commande pour définir la manière dont AWSEC2-VssInstallAndSnapshot va installer le package AwsVssComponents et va effectuer une sauvegarde à l’aide d’une AMI ou d’instantanés VSS. Pour plus de détails sur les paramètres, veuillez consulter la rubrique Paramètres des documents d’instantanés VSS Systems Manager.

  7. Pour Sélection de la cible, spécifiez des balises ou sélectionnez des instances manuellement afin d’identifier les instances sur lesquelles vous souhaitez exécuter cette opération.

    Note

    Si vous sélectionnez les instances manuellement et qu’une instance que vous vous attendez à voir ne figure pas dans la liste, consultez Où sont mes instances ? pour obtenir des conseils de résolution d’incident.

  8. Pour des paramètres supplémentaires permettant de définir le comportement de Exécuter la commande Systems Manager, tels que Contrôle du débit, entrez des valeurs comme décrit dans Exécution des commande à partir de la console.

  9. Cliquez sur Run (Exécuter).

    En cas de réussite, la commande complète automatiquement la liste des instantanés EBS avec les nouveaux instantanés. Vous pouvez localiser ces instantanés dans la liste des instantanés EBS en recherchant les balises que vous avez précisées ou en recherchant AppConsistent. Si l’exécution de la commande a échoué, consultez la sortie de commande Systems Manager pour en connaître les raisons. Si la commande a réussi mais que la sauvegarde d’un volume spécifique a échoué, vous pouvez résoudre l’échec dans la liste des volumes EBS.

AWS CLI

Vous pouvez exécuter les commandes suivantes dans le AWS CLI pour créer des instantanés EBS compatibles VSS et obtenir l'état de la création de vos instantanés.

Création d’instantanés EBS compatibles avec VSS

Exécutez la commande suivante pour créer des instantanés EBS activés pour VSS. Pour créer les instantanés, vous devez identifier les instances à l’aide du paramètre --instance-ids. Pour plus d’informations sur les autres paramètres que vous pouvez utiliser, veuillez consulter la rubrique Paramètres des documents d’instantanés VSS Systems Manager.

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":[""]}'

En cas de réussite, le document de commande complète automatiquement la liste des instantanés EBS avec les nouveaux instantanés. Vous pouvez localiser ces instantanés dans la liste des instantanés EBS en recherchant les balises que vous avez précisées ou en recherchant AppConsistent. Si l’exécution de la commande a échoué, consultez la sortie de commande pour en connaître les raisons.

Obtenir le statut de la commande

Pour obtenir l’état actuel des instantanés, exécutez la commande suivante à l’aide de l’ID de commande renvoyé par send-command.

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

Exécutez les commandes suivantes AWS Tools for Windows PowerShell pour créer des instantanés EBS compatibles VSS et obtenir l'état d'exécution actuel pour la création de votre sortie. Spécifiez les paramètres décrits dans la liste précédente pour modifier le comportement du processus de capture instantanée.

Créez des instantanés EBS compatibles VSS avec Tools for Windows PowerShell

Exécutez la commande suivante pour créer des AMI ou des instantanés EBS compatible avec VSS.

Send-SSMCommand -DocumentName "AWSEC2-VssInstallAndSnapshot" -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
	;'tags'='Key=key_name,Value=tag_value';'VssVersion'=''}
Obtenir le statut de la commande

Pour obtenir l’état actuel des instantanés, exécutez la commande suivante à l’aide de l’ID de commande renvoyé par Send-SSMCommand.

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

En cas de réussite, la commande complète automatiquement la liste des instantanés EBS avec les nouveaux instantanés. Vous pouvez localiser ces instantanés dans la liste des instantanés EBS en recherchant les balises que vous avez précisées ou en recherchant AppConsistent. Si l’exécution de la commande a échoué, consultez la sortie de commande pour en connaître les raisons.

Pour exécuter le document AWSEC2-CreateVssSnapshot, suivez les étapes correspondant à votre environnement préféré.

Console
Création d’instantanés EBS compatibles avec VSS depuis la console

  1. Ouvrez la AWS Systems Manager console à l'adresse https://console.aws.amazon.com/systems-manager/.

  2. Dans le volet de navigation, sélectionnez Exécuter une commande. Cela permet d’afficher une liste des commandes en cours d’exécution dans votre compte, le cas échéant.

  3. Sélectionnez Run Command (Exécuter la commande). Cela permet d’ouvrir la liste des documents de commande auxquels vous avez accès.

  4. Sélectionnez AWSEC2-CreateVssSnapshot dans la liste des documents de commande. Pour rationaliser les résultats, vous pouvez saisir tout ou partie du nom du document. Vous pouvez également filtrer par propriétaire, par type de plateforme ou par balise.

    Lorsque vous sélectionnez un document de commande, les détails apparaissent sous la liste.

  5. Sélectionnez Default version at runtime dans la liste Version du document.

  6. Configurez les Paramètres de la commande pour définir la manière dont AWSEC2-CreateVssSnapshot effectuera la sauvegarde avec des instantanés VSS ou une AMI. Pour plus de détails sur les paramètres, veuillez consulter la rubrique Paramètres des documents d’instantanés VSS Systems Manager.

  7. Pour Sélection de la cible, spécifiez des balises ou sélectionnez des instances manuellement afin d’identifier les instances sur lesquelles vous souhaitez exécuter cette opération.

    Note

    Si vous sélectionnez les instances manuellement et qu’une instance que vous vous attendez à voir ne figure pas dans la liste, consultez Où sont mes instances ? pour obtenir des conseils de résolution d’incident.

  8. Pour des paramètres supplémentaires permettant de définir le comportement de Exécuter la commande Systems Manager, tels que Contrôle du débit, entrez des valeurs comme décrit dans Exécution des commande à partir de la console.

  9. Cliquez sur Run (Exécuter).

    En cas de réussite, la commande complète automatiquement la liste des instantanés EBS avec les nouveaux instantanés. Vous pouvez localiser ces instantanés dans la liste des instantanés EBS en recherchant les balises que vous avez précisées ou en recherchant AppConsistent. Si l’exécution de la commande a échoué, consultez la sortie de commande Systems Manager pour en connaître les raisons. Si la commande a réussi mais que la sauvegarde d’un volume spécifique a échoué, vous pouvez résoudre l’échec dans la liste des volumes EBS.

AWS CLI

Vous pouvez exécuter la commande suivante dans le AWS CLI pour créer des instantanés EBS compatibles VSS.

Création d’instantanés EBS compatibles avec VSS

Exécutez la commande suivante pour créer des instantanés EBS activés pour VSS. Pour créer les instantanés, vous devez identifier les instances à l’aide du paramètre --instance-ids. Pour plus d’informations sur les autres paramètres que vous pouvez utiliser, veuillez consulter la rubrique Paramètres des documents d’instantanés VSS Systems Manager.

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

En cas de réussite, le document de commande complète automatiquement la liste des instantanés EBS avec les nouveaux instantanés. Vous pouvez localiser ces instantanés dans la liste des instantanés EBS en recherchant les balises que vous avez précisées ou en recherchant AppConsistent. Si l’exécution de la commande a échoué, consultez la sortie de commande pour en connaître les raisons.

PowerShell

Exécutez la commande suivante AWS Tools for Windows PowerShell pour créer des instantanés EBS compatibles VSS.

Créez des instantanés EBS compatibles VSS avec Tools for Windows PowerShell

Exécutez la commande suivante pour créer des instantanés EBS activés pour VSS. Pour créer les instantanés, vous devez identifier les instances à l’aide du paramètre InstanceId. Vous pouvez spécifier plusieurs instances pour lesquelles créer des instantanés. Pour plus d’informations sur les autres paramètres que vous pouvez utiliser, veuillez consulter la rubrique Paramètres des documents d’instantanés VSS Systems Manager.

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

En cas de réussite, la commande complète automatiquement la liste des instantanés EBS avec les nouveaux instantanés. Vous pouvez localiser ces instantanés dans la liste des instantanés EBS en recherchant les balises que vous avez précisées ou en recherchant AppConsistent. Si l’exécution de la commande a échoué, consultez la sortie de commande pour en connaître les raisons. Si la commande a réussi mais que la sauvegarde d’un volume spécifique a échoué, vous pouvez résoudre l’échec dans la liste des instantanés EBS.

Vous pouvez utiliser l’une des procédures de ligne de commande décrites dans la section précédente pour créer un instantané compatible avec VSS. Le document de commande (AWSEC2-VssInstallAndSnapshot ou AWSEC2-CreateVssSnapshot) doit être exécuté sur le nœud primaire de votre cluster. Le document échoue sur les nœuds secondaires, car ils n’ont pas accès aux disques partagés. Si vos paramètres principal et secondaire changent de manière dynamique, vous pouvez exécuter le document AWS Systems Manager Exécuter la commande sur plusieurs nœuds en espérant que la commande réussira sur le nœud principal et échouera sur les nœuds secondaires.

Vous pouvez utiliser le script suivant et le document SSM AWSEC2-ManageVssIO prédéfini pour suspendre provisoirement les I/O, créer des instantanés EBS activés pour VSS, puis redémarrer les I/O. Si l'utilisateur dispose des autorisations suffisantes pour créer et étiqueter des instantanés, il AWS Systems Manager peut créer et étiqueter des instantanés EBS compatibles VSS sans avoir besoin du rôle de snapshot IAM supplémentaire sur l'instance.

Par contre, le document de commande (AWSEC2-VssInstallAndSnapshot ou AWSEC2-CreateVssSnapshot) requiert l’attribution du rôle d’instantané IAM à chaque instance pour laquelle vous souhaitez créer des instantanés EBS. Si, pour des raisons de politique ou de conformité, vous ne souhaitez pas fournir d’autorisations IAM supplémentaires pour vos instances, vous pouvez utiliser le script suivant.

Avant de commencer

Notez les informations importantes suivantes sur ce processus :

  • Ce processus utilise un PowerShell script (CreateVssSnapshotAdvancedScript.ps1) pour prendre des instantanés de tous les volumes sur les instances que vous spécifiez, à l'exception des volumes racine. Si vous avez besoin de prendre des instantanés des volumes racines, vous devez utiliser le document SSM AWSEC2-CreateVssSnapshot.

  • Le script appelle le document AWSEC2-ManageVssIO à deux reprises. La première fois avec le paramètre Action défini sur Freeze, ce qui suspend toutes les I/O sur les instances. La seconde fois, le paramètre Action est défini sur Thaw, ce qui force la reprise des I/O.

  • N'essayez pas d'utiliser le AWSEC2-ManageVssIO document sans utiliser le script CreateVssSnapshotAdvancedScript .ps1. Le cadre VSS de Microsoft requiert que les actions Freeze et Thaw ne soient pas appelées à plus de dix secondes d’intervalle. L’appel manuel de ces actions sans le script risque de générer des erreurs.

Création d’instantanés EBS activés pour VSS à partir du document SSM AWSEC2-ManageVssIO

  1. Téléchargez le fichier CreateVssSnapshotAdvancedScript.zip et extrayez le contenu du fichier.

  2. Ouvrez CreateVssSnapshotAdvancedScript.ps1 dans un éditeur de texte, modifiez l'exemple d'appel au bas du script avec un ID d'instance EC2 valide, une description de l'instantané et les valeurs de balise souhaitées, puis exécutez le script depuis PowerShell.

En cas de réussite, la commande complète automatiquement la liste des instantanés EBS avec les nouveaux instantanés. Vous pouvez localiser ces instantanés dans la liste des instantanés EBS en recherchant les balises que vous avez précisées ou en recherchant AppConsistent. Si l’exécution de la commande a échoué, consultez la sortie de commande pour en connaître les raisons. Si la commande a réussi mais que la sauvegarde d’un volume spécifique a échoué, vous pouvez résoudre l’échec dans la liste des volumes EBS.

Note

Pour automatiser les sauvegardes, vous pouvez créer une tâche de fenêtre de AWS Systems Manager maintenance qui utilise le AWSEC2-VssInstallAndSnapshot document. Pour plus d’informations, consultez Utilisation des fenêtres de maintenance (console) dans le Guide de l’utilisateur AWS Systems Manager .