View a markdown version of this page

AWSPremiumSupport-ExtendVolumesOnLinux - AWS Systems Manager Referencia del manual de procedimientos 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-ExtendVolumesOnLinux

Descripción

El AWSPremiumSupport-ExtendVolumesOnLinux 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
  • Estados de impacto y volumen de la operación: las modificaciones de los volúmenes de Amazon EBS se producen en tres fases:, y. modifying optimizing completed Esta automatización continúa con la extensión del sistema de archivos cuando el volumen alcanza el optimizing estado. Durante el optimizing estado, es posible que experimente un impacto temporal en el rendimiento y posibles interrupciones a nivel del sistema de archivos al cambiar el tamaño de la partición. Puede supervisar el progreso de las modificaciones de los volúmenes de Amazon EBS.

  • Costos y limitaciones: aumentar el tamaño de un volumen de Amazon EBS se traducirá en un aumento de los costos de almacenamiento mensuales. Para obtener más información, consulte los precios de Amazon EBS. La AMI de respaldo y las instantáneas asociadas creadas por este libro de operaciones incurrirán en cargos adicionales en función de su tamaño y del tiempo que las conserve. 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 deba modificar las IOPS aprovisionadas. No se admiten los dispositivos RAID ni los volúmenes LVM.

  • Respaldo 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 manualmente estas copias de seguridad si ya no son necesarias. En caso de error, los volúmenes se pueden recuperar a partir de las instantáneas de la AMI asociada, tal y como se describe en Reemplazar un volumen de Amazon EBS por una instantánea.

¿Cómo funciona?

Este libro de operaciones realiza las siguientes operaciones:

  • Verifica que la instancia de destino esté administrada por Systems Manager y que ejecute Linux

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

  • Crea una imagen de máquina de Amazon (AMI) de respaldo a partir de 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 de script de shell

importante

El acceso a los AWSPremiumSupport-* runbooks 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)

Tipo de documento

Automatización

Propietario

Amazon

Plataformas

Linux

Parámetros

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:DescribeVolumesModifications

  • ec2:ModifyVolume

  • ssm:SendCommand

  • ssm:ListCommandInvocations

  • ssm:DescribeInstanceInformation

  • ssm:DescribeAutomationExecutions

  • ssm:GetAutomationExecution

Política de IAM de ejemplo:

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

Instrucciones

Siga estos pasos para configurar la automatización:

  1. AWSPremiumSupport-ExtendVolumesOnLinuxÁbralo en Systems Manager, en la sección Documentos.

  2. Elija Ejecutar automatización.

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

    • AutomationAssumeRole (Opcional):

      • Descripción: (opcional) El nombre de recurso de Amazon (ARN) del rol AWS Identity and Access Management (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 permitido: ^i-[a-z0-9]{8,17}$

    • VolumeExpansionCapSize (Obligatorio):

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

      • Tipo: String

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

    • DiagnosticResults (Obligatorio):

      • Descripción: (Obligatorio) Los resultados del script de verificación previa del DiagnoseDiskUsage documento, con formato CSV de una línea. La cadena comienza EXTEND; seguida de información de 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 partición, el indicador de extensión (1 para extender, 0 para omitir), el nuevo tamaño en GB, AWS la región y. Reason/Action

      • Tipo: String

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

  4. Elija Ejecutar.

  5. Se inicia la automatización.

  6. El libro de ejercicios lleva a cabo los siguientes pasos:

    • AssertInstanceIsManagedInstance:

      Verifica que Systems Manager administre la instancia de destino.

    • DescribeInstance:

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

    • BranchOnPlatform:

      Confirma que la plataforma de instancias Amazon EC2 de destino es Linux.

    • CheckConcurrency:

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

    • CreateImage:

      Crea una imagen de máquina de Amazon (AMI) de respaldo a partir de la instancia de destino.

    • WaitUntilImageReady:

      Espera a que la imagen de máquina de Amazon (AMI) finalice su creación y alcance el available estado.

    • Ampliar el volumen de BS:

      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 adjuntos a la instancia de destino.

    • ExtendFilesystem:

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

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

Referencias

Automatización de Systems Manager