Uso de documentos de comandos de Systems Manager para crear instantáneas basadas en VSS - Amazon Elastic Compute Cloud
Parámetros de los documentos para instantáneas de VSS de Systems ManagerEjecute los documentos de comandos para instantáneas de VSS de Systems Manager

Uso de documentos de comandos de Systems Manager para crear instantáneas basadas en VSS

Puede usar los documentos de comandos de AWS Systems Manager para crear instantáneas basadas en VSS. En el siguiente contenido, se presentan los documentos de comandos disponibles y los parámetros de tiempo de ejecución que usan los documentos para crear las instantáneas.

Antes de usar cualquiera de los documentos de comandos de Systems Manager, asegúrese de cumplir con todos los Requisitos previos para crear las instantáneas de EBS basadas en VSS de Windows.

Parámetros de los documentos para instantáneas de VSS de Systems Manager

Todos los documentos de Systems Manager que crean instantáneas de VSS usan los siguientes parámetros, excepto cuando se indica lo contrario:

AmiName (cadena, opcional)

Si el estado de CreateAmi es True, especifique el nombre de la AMI creada por la copia de seguridad.

description (cadena, opcional)

Especifique una descripción para las instantáneas o la imagen que crea este proceso.

CollectDiagnosticLogs (cadena, opcional)

Para recopilar más información durante los pasos de creación de la instantánea y la AMI, establezca este parámetro en “True”. El valor predeterminado para este parámetro es “False”. Los registros de diagnóstico consolidados se guardan como un archivo en formato .zip en la siguiente ubicación de la instancia:

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

CopyOnly (cadena, opcional)

Si utiliza la copia de seguridad nativa de SQL Server además de VSS de AWS, llevar a cabo una copia de seguridad de solo copia impide que VSS de AWS interrumpa la cadena de copia de seguridad diferencial nativa. Para realizar una operación de copia de seguridad de solo copia, establezca este parámetro en True.

El valor predeterminado de este parámetro es False, lo que hace que VSS de AWS realice una operación de copia de seguridad completa.

CreateAmi (cadena, opcional)

Para crear una imagen de máquina de Amazon (AMI) basada en VSS para hacer una copia de seguridad de la instancia, establezca este parámetro en True. El valor predeterminado de este parámetro es False, que en su lugar hace una copia de seguridad de la instancia con una instantánea de EBS.

Para obtener más información sobre la creación de una AMI a partir de una instancia, consulte Creación de una AMI basada en Amazon EBS.

executionTimeout (cadena, opcional)

Especifique el tiempo máximo en segundos para ejecutar el proceso de creación de instantáneas en la instancia o para crear una AMI a partir de la instancia. Al aumentar este tiempo de espera, el comando puede esperar más tiempo hasta que VSS inicie la congelación y complete el etiquetado de los recursos que crea. Este tiempo de espera solo se aplica a los pasos de creación de la instantánea o de la AMI. El paso inicial para instalar o actualizar el paquete AwsVssComponents no está incluido en el tiempo de espera.

ExcludeBootVolume (cadena, opcional)

Esta configuración excluye volúmenes de arranque del proceso de copia de seguridad si crea instantáneas. Para excluir los volúmenes de arranque de las instantáneas, configure ExcludeBootVolume en True y CreateAmi en False.

Si crea una AMI para la copia de seguridad, este parámetro se debe establecer en False. El valor predeterminado para este parámetro es False.

NoWriters (cadena, opcional)

Para excluir los escritores de VSS de la aplicación del proceso de instantáneas, establezca este parámetro en True. Excluir los escritores de VSS de la aplicación puede ayudar a resolver los conflictos con los componentes de copia de seguridad de VSS de terceros. El valor predeterminado para este parámetro es False.

Si SaveVssMetadata es True, este parámetro debe establecerse en False.

SaveVssMetadata (cadena, opcional)

Para guardar los archivos de metadatos de VSS durante cada instantánea, defina este parámetro en True. El valor predeterminado es False. Los archivos de metadatos de VSS ayudan a proporcionar información sobre los componentes o grabadores que se incluyeron en una operación de copia de seguridad y los archivos asociados a cada componente.

Los archivos de metadatos tienen el identificador del conjunto de instantáneas asociado en sus nombres. Puede encontrarlos en la siguiente ubicación de la instancia:

C:\ProgramData\Amazon\AwsVss\VssMetadata\
aviso

  • Para guardar archivos de metadatos de VSS, se requiere la versión 2.4.0 o posterior del paquete AwsVssComponents. Si la instancia tiene instalada una versión anterior, si se configura SaveVssMetadata en True, se produce un error en la creación de la instantánea.

  • Los parámetros NoWriters y SaveVssMetadata son mutuamente excluyentes. Si ambos se establecen en True, se produce un error en la creación de la instantánea.

tags (cadena, opcional)

Recomendamos etiquetar las instantáneas e imágenes para localizar y administrar los recursos, por ejemplo, para restaurar los volúmenes a partir de una lista de instantáneas. El sistema agrega la clave Name, con un valor en blanco, donde puede indicar el nombre que quiere aplicar a las instantáneas o imágenes de salida.

Si quiere especificar otras etiquetas, separe las etiquetas mediante un punto y coma. Por ejemplo, Key=Environment,Value=Test;Key=User,Value=TestUser1.

De manera predeterminada, el sistema agrega las siguientes etiquetas reservadas para las instantáneas e imágenes basadas en VSS.

  • Dispositivo: en el caso de las instantáneas compatibles con VSS, este es el nombre de dispositivo del volumen de EBS que captura la instantánea.

  • AppConsistent: esta etiqueta indica la creación correcta de una instantánea o AMI compatible con VSS.

  • AWSVSSConfig: identifica las instantáneas y las AMI que se crean con compatibilidad con VSS. La etiqueta incluye metadatos, como la versión de AwsVssComponents y el ID del conjunto de instantáneas.

aviso

Si se especifica alguna de estas etiquetas reservadas en la lista de parámetros, se producirá un error.

VssVersion (cadena, opcional)

Solo para el documento AWSEC2-VssInstallAndSnapshot, puede especificar el parámetro VssVersion para instalar una versión específica del paquete AwsVssComponents en la instancia. Deje en blanco este parámetro para instalar la versión predeterminada recomendada.

Si la versión especificada del paquete AwsVssComponents ya está instalada, el script omite el paso de instalación y procede a realizar el paso de copia de seguridad. Para obtener una lista de las versiones del paquete AwsVssComponents y la compatibilidad operativa, consulte Historial de versiones de la solución AWS VSS.

Ejecute los documentos de comandos para instantáneas de VSS de Systems Manager

Puede crear instantáneas de EBS basadas en VSS con los documentos de comandos de AWS Systems Manager de la siguiente forma.

Cuando usa AWS Systems Manager para ejecutar el documento AWSEC2-VssInstallAndSnapshot, el script ejecuta los siguientes pasos.

  1. El script primero instala o actualiza el paquete AwsVssComponents en la instancia, en función de si ya está instalado o no.

  2. El script crea las instantáneas coherentes con las aplicaciones una vez finalizado el primer paso.

Para ejecutar el documento AWSEC2-VssInstallAndSnapshot, siga los pasos de su entorno de preferencia.

Console
Creación de instantáneas de EBS basadas en VSS desde la consola

  1. Abra la consola de AWS Systems Manager en https://console.aws.amazon.com/systems-manager/.

  2. En el panel de navegación, seleccione Ejecutar comando. Se muestra una lista de los comandos que se están ejecutando actualmente en su cuenta, si corresponde.

  3. Elija Run command (Ejecutar comando). Se abre una lista de documentos de comandos a los que tiene acceso.

  4. Seleccione AWSEC2-VssInstallAndSnapshot de la lista de documentos de comandos. Para agilizar los resultados, puede ingresar todo el nombre del documento o una parte. También puede filtrar por propietario, por tipo de plataforma o por etiquetas.

    Al seleccionar un documento de comandos, los detalles aparecen debajo de la lista.

  5. Seleccione Default version at runtime de la lista Versión del documento.

  6. Configure Parámetros de comando para definir cómo AWSEC2-VssInstallAndSnapshot instalará el paquete AwsVssComponents y realizará la copia de seguridad con una AMI o instantáneas de VSS. Para obtener detalles sobre los parámetros, consulte Parámetros de los documentos para instantáneas de VSS de Systems Manager.

  7. En Selección de destino, especifique las etiquetas o seleccione manualmente las instancias para identificar las instancias en las que ejecutar esta operación.

    nota

    Si selecciona las instancias manualmente y una de las instancias que desea utilizar no figura en la lista, consulte ¿Dónde están mis instancias? para ver cómo resolver el problema.

  8. Para obtener parámetros adicionales que definan el comportamiento de Systems Manager Run Command, como Control de velocidad, ingrese los valores descritos en Ejecución de comandos desde la consola.

  9. Elija Run (Ejecutar).

    Si todo sale bien, el comando rellena la lista de instantáneas de EBS con las nuevas instantáneas. Puede encontrar estas instantáneas en la lista de instantáneas de EBS buscando las etiquetas que especificó o AppConsistent. Si se ha producido un error en la ejecución de comandos, consulte la información de salida del comando de Systems Manager para obtener detalles acerca de por qué se ha producido un error en la ejecución. Si el comando se ha completado correctamente, pero se ha producido un error en un backup de volumen específico, puede solucionar el error en la lista de volúmenes de EBS.

AWS CLI

Puede ejecutar los siguientes comandos en la AWS CLI para crear instantáneas de EBS basadas en VSS y obtener el estado de la creación de la instantánea.

Creación de instantáneas de EBS basadas en VSS

Para crear instantáneas de EBS basadas en VSS, ejecute el siguiente comando. Para crear las instantáneas, debe identificar las instancias con el parámetro --instance-ids. Para obtener más información acerca de otros parámetros que puede usar, consulte Parámetros de los documentos para instantáneas de VSS de 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":[""]}'

Si todo sale bien, el documento de comando rellena la lista de instantáneas de EBS con las nuevas instantáneas. Puede encontrar estas instantáneas en la lista de instantáneas de EBS buscando las etiquetas que especificó o AppConsistent. Si se ha producido un error en la ejecución de comandos, consulte la información de salida del comando de para obtener detalles acerca de por qué se ha producido un error en la ejecución.

Obtener el estado del comando

Para obtener el estado actual de las instantáneas, ejecute el siguiente comando con el ID de comando devuelto de send-command.

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

Ejecute los siguientes comandos con AWS Tools for Windows PowerShell para crear instantáneas de EBS basadas en VSS y obtener el estado de tiempo de ejecución actual de la creación de la salida. Especifique los parámetros descritos en la lista anterior para modificar el comportamiento del procesamiento de instantáneas.

Creación de instantáneas de EBS basadas en VSS mediante Herramientas para Windows PowerShell

Para crear AMI o instantáneas de EBS basadas en VSS, ejecute el siguiente comando.

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

Para obtener el estado actual de las instantáneas, ejecute el siguiente comando con el ID de comando devuelto de Send-SSMCommand.

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

Si todo sale bien, el comando rellena la lista de instantáneas de EBS con las nuevas instantáneas. Puede encontrar estas instantáneas en la lista de instantáneas de EBS buscando las etiquetas que especificó o AppConsistent. Si se ha producido un error en la ejecución de comandos, consulte la información de salida del comando de para obtener detalles acerca de por qué se ha producido un error en la ejecución.

Para ejecutar el documento AWSEC2-CreateVssSnapshot, siga los pasos de su entorno de preferencia.

Console
Creación de instantáneas de EBS basadas en VSS desde la consola

  1. Abra la consola de AWS Systems Manager en https://console.aws.amazon.com/systems-manager/.

  2. En el panel de navegación, seleccione Ejecutar comando. Se muestra una lista de los comandos que se están ejecutando actualmente en su cuenta, si corresponde.

  3. Elija Run command (Ejecutar comando). Se abre una lista de documentos de comandos a los que tiene acceso.

  4. Seleccione AWSEC2-CreateVssSnapshot de la lista de documentos de comandos. Para agilizar los resultados, puede ingresar todo el nombre del documento o una parte. También puede filtrar por propietario, por tipo de plataforma o por etiquetas.

    Al seleccionar un documento de comandos, los detalles aparecen debajo de la lista.

  5. Seleccione Default version at runtime de la lista Versión del documento.

  6. Configure los Parámetros de comando para definir cómo AWSEC2-CreateVssSnapshot realizará la copia de seguridad con instantáneas de VSS o con una AMI. Para obtener detalles sobre los parámetros, consulte Parámetros de los documentos para instantáneas de VSS de Systems Manager.

  7. En Selección de destino, especifique las etiquetas o seleccione manualmente las instancias para identificar las instancias en las que ejecutar esta operación.

    nota

    Si selecciona las instancias manualmente y una de las instancias que desea utilizar no figura en la lista, consulte ¿Dónde están mis instancias? para ver cómo resolver el problema.

  8. Para obtener parámetros adicionales que definan el comportamiento de Systems Manager Run Command, como Control de velocidad, ingrese los valores descritos en Ejecución de comandos desde la consola.

  9. Elija Run (Ejecutar).

    Si todo sale bien, el comando rellena la lista de instantáneas de EBS con las nuevas instantáneas. Puede encontrar estas instantáneas en la lista de instantáneas de EBS buscando las etiquetas que especificó o AppConsistent. Si se ha producido un error en la ejecución de comandos, consulte la información de salida del comando de Systems Manager para obtener detalles acerca de por qué se ha producido un error en la ejecución. Si el comando se ha completado correctamente, pero se ha producido un error en un backup de volumen específico, puede solucionar el error en la lista de volúmenes de EBS.

AWS CLI

Puede ejecutar el siguiente comando en la AWS CLI para crear instantáneas de EBS basadas en VSS.

Creación de instantáneas de EBS basadas en VSS

Para crear instantáneas de EBS basadas en VSS, ejecute el siguiente comando. Para crear las instantáneas, debe identificar las instancias con el parámetro --instance-ids. Para obtener más información acerca de otros parámetros que puede usar, consulte Parámetros de los documentos para instantáneas de VSS de 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"]}'

Si todo sale bien, el documento de comando rellena la lista de instantáneas de EBS con las nuevas instantáneas. Puede encontrar estas instantáneas en la lista de instantáneas de EBS buscando las etiquetas que especificó o AppConsistent. Si se ha producido un error en la ejecución de comandos, consulte la información de salida del comando de para obtener detalles acerca de por qué se ha producido un error en la ejecución.

PowerShell

Para crear instantáneas de EBS basadas en VSS, ejecute el siguiente comando con AWS Tools for Windows PowerShell.

Creación de instantáneas de EBS basadas en VSS mediante Herramientas para Windows PowerShell

Para crear instantáneas de EBS basadas en VSS, ejecute el siguiente comando. Para crear las instantáneas, debe identificar las instancias con el parámetro InstanceId. Puede especificar más de una instancia para crear instantáneas. Para obtener más información acerca de otros parámetros que puede usar, consulte Parámetros de los documentos para instantáneas de VSS de Systems Manager.

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

Si todo sale bien, el comando rellena la lista de instantáneas de EBS con las nuevas instantáneas. Puede encontrar estas instantáneas en la lista de instantáneas de EBS buscando las etiquetas que especificó o AppConsistent. Si se ha producido un error en la ejecución de comandos, consulte la información de salida del comando de para obtener detalles acerca de por qué se ha producido un error en la ejecución. Si el comando se ha completado correctamente, pero se ha producido un error en una copia de seguridad de volumen específico, puede solucionar el error en la lista de instantáneas de EBS.

Puede usar cualquiera de los procedimientos de línea de comandos descritos en la sección anterior para crear una instantánea basada en VSS. El documento de comandos (AWSEC2-VssInstallAndSnapshot o AWSEC2-CreateVssSnapshot) debe ejecutarse en el nodo principal del clúster. El documento fallará en los nodos secundarios, ya que no tienen acceso a los discos compartidos. Si el comando principal y el secundario cambian de forma dinámica, puede ejecutar el documento Ejecutar comandos de AWS Systems Manager en varios nodos con la expectativa de que el comando se ejecute correctamente en el nodo principal y falle en los nodos secundarios.

nota

Para automatizar las copias de seguridad, puede crear una tarea de periodo de mantenimiento de AWS Systems Manager que use el documento AWSEC2-VssInstallAndSnapshot. Para obtener más información, consulte Trabajo con periodos de mantenimiento (Consola) en la Guía del usuario de AWS Systems Manager.