AWSPremiumSupport-ExtendVolumesOnWindows - AWS Systems Manager Referencia del manual de automatización

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AWSPremiumSupport-ExtendVolumesOnWindows

Descripción

El AWSPremiumSupport-ExtendVolumesOnWindows manual amplía los volúmenes de Amazon Elastic Block Store (Amazon EBS), sus particiones y sistemas de archivos en una instancia de Amazon Elastic Compute Cloud (Amazon EC2) de destino.

Consideraciones importantes
  • Impacto de la operación y estados del volumen: las modificaciones del volumen de Amazon EBS se producen en tres fases: modifyingoptimizing, ycompleted. Esta automatización continúa con la extensión del sistema de archivos cuando el volumen alcanza ese estado. optimizing Durante este optimizing estado, es posible que experimente un impacto temporal en el rendimiento y posibles interrupciones a nivel del sistema de archivos durante el cambio de tamaño de la partición. Puede supervisar el progreso de las modificaciones de los volúmenes de Amazon EBS.

  • Coste y limitaciones: aumentar el tamaño del volumen de Amazon EBS se traducirá en un aumento de los costes mensuales de almacenamiento. Para obtener más información, consulte los precios de Amazon EBS. La AMI de respaldo y las instantáneas asociadas creadas por este manual incurrirán en cargos adicionales en función de su tamaño y del tiempo que las guarde. Para algunos tipos de volúmenes, si necesita mantener la misma proporción de IOPS por GB después de la expansión, es posible que tenga que modificar las IOPS aprovisionadas.

  • Backup y recuperación: el runbook crea una AMI de respaldo antes de realizar cualquier cambio en los volúmenes. La AMI y las instantáneas asociadas no se eliminan automáticamente de su cuenta. Debe eliminar estas copias de seguridad manualmente si ya no las necesita. En caso de error, los volúmenes se pueden recuperar de las instantáneas de la AMI asociada, tal y como se describe en Sustituir un volumen de Amazon EBS por una instantánea.

¿Cómo funciona?

Este manual de ejecución realiza las siguientes operaciones:

  • Comprueba que la instancia de destino esté gestionada por Systems Manager y que ejecute Windows Server

  • Garantiza que solo haya una ejecución de este runbook dirigida a la instancia Amazon EC2 actual

  • Crea una copia de seguridad de Amazon Machine Image (AMI) desde la instancia de destino

  • Amplía los volúmenes de Amazon EBS que se especificaron para la expansión

  • Amplía los sistemas de archivos de la instancia de destino mediante comandos PowerShell

importante

El acceso a AWSPremiumSupport-* los manuales requiere una suscripción a Business + Support, Enterprise Support o Unified Operations. Para obtener más información, consulte Comparar planes de AWS Support.

Ejecuta esta automatización (consola)

Permisos de IAM necesarios

El parámetro AutomationAssumeRole requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.

  • ec2:DescribeInstances

  • ec2:CreateImage

  • ec2:DescribeImages

  • ec2:DescribeVolumes

  • ec2:ModifyVolume

  • ssm:SendCommand

  • ssm:ListCommandInvocations

  • ssm:DescribeInstanceInformation

Política de IAM de ejemplo:

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ec2:DescribeInstances", "ec2:CreateImage", "ec2:DescribeImages", "ec2:DescribeVolumes", "ec2:ModifyVolume", "ssm:SendCommand", "ssm:DescribeInstanceInformation", "ssm:ListCommandInvocations" ], "Resource": "*" } ] }

Instrucciones

Siga estos pasos para configurar la automatización:

  1. Navegue hasta AWSPremiumSupport-ExtendVolumesOnWindowsSystems Manager, en Documentos.

  2. Elija Execute automation (Ejecutar automatización).

  3. Para los parámetros de entrada, introduzca lo siguiente:

    • AutomationAssumeRole (Opcional):

      • Descripción: (opcional) El nombre del recurso de Amazon (ARN) de la función de IAM que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que comienza este manual de procedimientos.

      • Tipo: AWS::IAM::Role::Arn

    • InstanceId (Obligatorio):

      • Descripción: (Obligatorio) ID de la instancia Amazon EC2.

      • Tipo: String

      • Patrón de permiso: ^i-[0-9a-f]{8,17}$

    • VolumeExpansionCapSize (Obligatorio):

      • Descripción: (Obligatorio) Tamaño máximo (en GiB) en el que se aumentarán los volúmenes de Amazon EBS.

      • Tipo: String

      • Patrón de permisos: ^[0-9]{1,4}$

    • DiagnosticResults (Obligatorio):

      • Descripción: (Obligatorio) Los resultados del script de comprobaciones previas del DiagnoseDiskUsage documento, con el formato de CSV de una línea. La cadena comienza con la información del EXTEND; volumen separada por comas para cada volumen, con los volúmenes separados por punto y coma. La información de cada volumen incluye: el identificador del volumen, la letra de unidad, el indicador de extensión (1 para ampliar y 0 para omitir), el nuevo tamaño en GB, la AWS región y el motivo o la acción.

      • Tipo: String

      • Patrón de permisos: ^EXTEND;[0-9a-zA-Z\\.;_%:\\-\/,\\s]{7,5400}$

  4. Seleccione Ejecutar.

  5. Se inicia la automatización.

  6. Este documento realiza los siguientes pasos:

    • AssertInstanceIsManagedInstance:

      Verifica que la instancia de destino esté gestionada por Systems Manager.

    • DescribeInstance:

      Recupera la información de la plataforma de la instancia Amazon EC2 de destino.

    • BranchOnPlatform:

      Confirma que la plataforma de instancias Amazon EC2 de destino es Windows Server.

    • CheckConcurrency:

      Garantiza que solo haya una ejecución de este runbook dirigida a la instancia actual de Amazon EC2.

    • CreateImage:

      Crea una copia de seguridad de Amazon Machine Image (AMI) a partir de la instancia de destino.

    • WaitUntilImageReady:

      Espera a que la Amazon Machine Image (AMI) complete su creación y alcance el available estado.

    • Extienda EBSVolume:

      Amplía los volúmenes de Amazon EBS de la instancia de destino que se especificaron para la expansión.

    • DescribeVolumes:

      Describe los volúmenes de Amazon EBS de la instancia de destino que se especificaron para la expansión.

    • ExtendFilesystem:

      Amplía los sistemas de archivos de la instancia de destino mediante comandos. PowerShell

  7. Una vez finalizada, revise la sección de resultados para ver los resultados detallados de la ejecución.

Referencias

Automatización de Systems Manager