Utilisez des documents de commande de Systems Manager pour créer des instantanés basés pour VSS - 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.

Utilisez des documents de commande de Systems Manager pour créer des instantanés basés pour VSS

Vous pouvez utiliser les documents de commande AWS Systems Manager pour créer des instantanés basés sur 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 Conditions préalables à la création d’instantanés EBS basés sur Windows VSS.

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 :

AmiName (chaîne, facultatif)

Si CreateAmi est défini sur True, 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.

CollectDiagnosticLogs (chaîne, facultatif)

Pour collecter plus d’informations lors des étapes de création d’instantanés 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

CopyOnly (chaîne, facultatif)

Si vous utilisez la sauvegarde native de SQL Server en plus d’AWS VSS, l’exécution d’une sauvegarde par copie uniquement empêche AWS VSS de casser 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 est False, 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) basée sur 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éer une AMI basée sur Amazon EBS.

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.

ExcludeBootVolume (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 ExcludeBootVolume sur True et CreateAmi sur False.

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.

Si SaveVssMetadata est True, ce paramètre doit être réglé sur False.

SaveVSSMetadata (chaîne, facultatif)

Pour enregistrer les fichiers de métadonnées VSS lors de chaque instantané, définissez ce paramètre surTrue. La valeur par défaut est  False. Les fichiers de métadonnées VSS permettent de savoir quels composants ou rédacteurs ont été inclus dans une opération de sauvegarde, ainsi que les fichiers associés à chaque composant.

Le nom des fichiers de métadonnées contient l’identifiant du jeu de snapshots associé. Vous pouvez les trouver à l’emplacement suivant sur votre instance :

C:\ProgramData\Amazon\AwsVss\VssMetadata\
Avertissement

  • L’enregistrement des fichiers de métadonnées VSS nécessite la version 2.4.0 ou ultérieure AwsVssComponents du package. Si une version antérieure de votre instance est installée, la définition sur SaveVssMetadata True entraîne l’échec de la création du snapshot.

  • Les paramètres de NoWriters et de SaveVssMetadata s’excluent mutuellement. Si les deux sont définis sur, la création d’un instantané True échoue.

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. Par exemple, Key=Environment,Value=Test;Key=User,Value=TestUser1.

Note

Les clés et valeurs des balises ne doivent contenir que des caractères alphanumériques et les caractères spéciaux suivants : () ./\-"'@_+:={}.

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

  • Appareil : pour les instantanés basés sur 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’un AMI basé sur VSS.

  • AWSvssConfig — Cela identifie les instantanés et les AMI créés avec VSS activé. La balise inclut des méta-informations telles que la AwsVssComponents version et l’ID du Snapshot Set.

Avertissement

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

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 Historique des versions de la solution AWS VSS.

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

Vous pouvez créer des instantanés EBS basés sur VSS à l’aide de documents de commande AWS Systems Manager comme suit.

Lorsque vous utilisez AWS Systems Manager pour exécuter le document AWSEC2-VssInstallAndSnapshot, 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éer des instantanés EBS basés sur VSS à partir de la console

  1. Ouvrez la console AWS Systems Manager à 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 l’AWS CLI pour créer des instantanés EBS basés sur VSS et obtenir l’état de votre création d’instantanés.

Créez des instantanés EBS basés sur VSS

Exécutez la commande suivante pour créer des instantanés EBS basés sur 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 avec AWS Tools for Windows PowerShell pour créer des instantanés EBS basés sur 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éer des instantanés EBS basés sur VSS à l’aide des outils pour Windows PowerShell

Exécutez la commande suivante pour créer des instantanés ou des AMI EBS basées sur 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éer des instantanés EBS basés sur VSS à partir de la console

  1. Ouvrez la console AWS Systems Manager à 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 l’AWS CLI pour créer des instantanés EBS basés sur VSS.

Créez des instantanés EBS basés sur VSS

Exécutez la commande suivante pour créer des instantanés EBS basés sur 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 avec AWS Tools for Windows PowerShell pour créer des instantanés EBS basés sur VSS.

Créer des instantanés EBS basés sur VSS à l’aide des outils pour Windows PowerShell

Exécutez la commande suivante pour créer des instantanés EBS basés sur 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é basé sur 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 nœuds primaire et secondaire changent de manière dynamique, vous pouvez exécuter le document Exécuter la commande AWS Systems Manager sur plusieurs nœuds dans l’espoir que la commande réussisse sur le nœud primaire et échoue sur les nœuds secondaires.

Note

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