AWSPremiumSupport-TroubleshootEC2DiskUsage - AWS Systems Manager Referência do runbook de automação

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

AWSPremiumSupport-TroubleshootEC2DiskUsage

Descrição

O runbook AWSPremiumSupport-TroubleshootEC2DiskUsage ajuda você a investigar e potencialmente corrigir problemas com o uso de disco raiz e não raiz de instâncias do Amazon Elastic Compute Cloud (Amazon EC2). Se possível, o runbook tenta corrigir os problemas estendendo o volume e seu sistema de arquivos. Para realizar essas tarefas, esse runbook orquestra a execução de vários runbooks com base no sistema operacional da instância afetada.

O primeiro runbook, AWSPremiumSupport-DiagnoseDiskUsageOnWindows ou AWSPremiumSupport-DiagnoseDiskUsageOnLinux, determina se os problemas de disco podem ser atenuados com a expansão do volume.

O segundo runbook, AWSPremiumSupport-ExtendVolumesOnWindows ou AWSPremiumSupport-ExtendVolumesOnLinux, usa a saída do primeiro runbook para executar o código Python que modifica o volume. Depois que o volume for modificado, o runbook estende a partição e o sistema de arquivos dos volumes afetados.

Importante

O acesso aos runbooks AWSPremiumSupport-* requer uma assinatura do Enterprise ou Business Support. Para obter mais informações, consulte Comparar PlanosAWS Support.

Este documento foi criado em colaboração com o AWS Managed Services (AMS). O AMS ajuda você a gerenciar sua infraestrutura da AWS com mais eficiência e segurança. O AMS também oferece flexibilidade operacional, segurança e conformidade aprimoradas, otimização de capacidade e identificação de economia de custos. Para obter mais informações, consulte AWS Managed Services.

Execute esta automação (console)

Tipo de documento

Automation

Proprietário

Amazon

Plataformas

Linux, Windows

Parâmetros

  • InstanceId

    Tipo: sequência

    Valores permitidos: ^i-[a-z0-9]{8,17}$

    Descrição: (obrigatório) ID de sua instância do Amazon EC2.

  • VolumeExpansionEnabled

    Tipo: booliano

    Descrição: (opcional) sinalize para controlar se o documento estenderá os volumes e partições afetados.

    Padrão: true

  • VolumeExpansionUsageTrigger

    Tipo: sequência

    Descrição: (opcional) uso mínimo do espaço de partição necessário para acionar a extensão (em porcentagem).

    Valores permitidos: ^[0-9]{1,2}$

    Padrão: 85

  • VolumeExpansionCapSize

    Tipo: sequência

    Descrição: (opcional) o tamanho máximo para o qual o volume do Amazon Elastic Block Store (Amazon EBS) será aumentado (em GiB).

    Valores permitidos: ^[0-9]{1,4}$

    Padrão: 2048

  • VolumeExpansionGibIncrease

    Tipo: sequência

    Descrição: (opcional) aumento do volume em GiB. O maior aumento líquido entre VolumeExpansionGibIncrease e VolumeExpansionPercentageIncrease será usado.

    Valores permitidos: ^[0-9]{1,4}$

    Padrão: 20

  • VolumeExpansionPercentageIncrease

    Tipo: sequência

    Descrição: (opcional) aumento do volume em porcentagem. O maior aumento líquido entre VolumeExpansionGibIncrease e VolumeExpansionPercentageIncrease será usado.

    Valores permitidos: ^[0-9]{1,2}$

    Padrão: 20

  • AutomationAssumeRole

    Tipo: sequência

    Descrição: (opcional) o nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.

Permissões obrigatórias do IAM

O parâmetro AutomationAssumeRole requer as seguintes ações para usar o runbook com êxito.

  • ec2:DescribeVolumes

  • ec2:DescribeVolumesModifications

  • ec2:ModifyVolume

  • ec2:DescribeInstances

  • ec2:CreateImage

  • ec2:DescribeImages

  • ec2:DescribeTags

  • ec2:CreateTags

  • ec2:DeleteTags

  • ssm:StartAutomationExecution

  • ssm:GetAutomationExecution

  • ssm:DescribeAutomationStepExecutions

  • ssm:DescribeAutomationExecutions

  • ssm:SendCommand

  • ssm:DescribeInstanceInformation

  • ssm:ListCommands

  • ssm:ListCommandInvocations

Etapas do documento

  1. aws:assertAwsResourceProperty: verifica se a instância é gerenciada pelo Systems Manager

  2. aws:executeAwsApi: descreve a instância para obter a plataforma.

  3. aws:branch: ramifica a automação com base na plataforma da instância.

    1. Se a instância for Windows:

      1. aws:executeAutomation: executa o runbook AWSPremiumSupport-DiagnoseDiskUsageOnWindows para diagnosticar problemas de uso de disco na instância.

      2. aws:executeAwsApi: obtém a saída da automação anterior.

      3. aws:branch: ramifica com base na saída do diagnóstico e se houver volumes que possam ser expandidos para mitigar o alerta.

        1. Não há volumes que precisem ser expandidos: terminar a automação.

        2. Há volumes que precisam ser expandidos:

          1. aws:executeAwsApi: cria uma Amazon Machine Image (AMI) da instância.

          2. aws:waitForAwsResourceProperty: espera que o estado da AMI seja available.

          3. aws:executeAutomation: executa o runbook AWSPremiumSupport-ExtendVolumesOnWindows para realizar a modificação do volume, bem como as etapas necessárias no sistema operacional (SO) para disponibilizar o novo espaço.

    2. (A plataforma não é Windows) Se a instância de entrada não for Windows:

      1. aws:executeAutomation: executa o runbook AWSPremiumSupport-DiagnoseDiskUsageOnLinux para diagnosticar problemas de uso de disco na instância.

      2. aws:executeAwsApi: obtém a saída da automação anterior.

      3. aws:branch: ramifica com base na saída do diagnóstico e se houver volumes que possam ser expandidos para mitigar o alerta.

        1. Não há volumes que precisem ser expandidos: terminar a automação.

        2. Há volumes que precisam ser expandidos:

          1. aws:executeAwsApi: cria uma AMI da instância.

          2. aws:waitForAwsResourceProperty: espera que o estado da AMI seja available.

          3. aws:executeAutomation: executa o runbook AWSPremiumSupport-ExtendVolumesOnLinux para realizar a modificação do volume, bem como as etapas necessárias no OS para disponibilizar o novo espaço.

Saídas

diagnoseDiskUsageAlertOnWindows.Output

extendVolumesOnWindows.Output

diagnoseDiskUsageAlertOnLinux.Output

extendVolumesOnLinux.Output

BackupAMILinux.ImageId

BackupAMIWindows.ImageId