View a markdown version of this page

AWSPremiumSupport-ExtendVolumesOnLinux - AWS Systems Manager Referência do runbooks 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-ExtendVolumesOnLinux

Descrição

O AWSPremiumSupport-ExtendVolumesOnLinux runbook estende os volumes do Amazon Elastic Block Store (Amazon EBS), suas partições e sistemas de arquivos em uma instância de destino do Amazon Elastic Compute Cloud (Amazon EC2).

Considerações importantes

  • Impacto da operação e estados do volume: as modificações de volume do Amazon EBS ocorrem em três fases: modifyingoptimizing, e. completed Essa automação prossegue com a extensão do sistema de arquivos quando o volume atinge o estado. optimizing Durante o optimizing estado, você pode enfrentar um impacto temporário no desempenho e possíveis interrupções no nível do sistema de arquivos durante o redimensionamento da partição. Você pode monitorar o progresso das modificações de volume do Amazon EBS.

  • Custo e limitações: Aumentar o tamanho do volume do Amazon EBS resultará em maiores custos mensais de armazenamento. Para obter mais informações, consulte os preços do Amazon EBS. A AMI de backup e os snapshots associados criados por esse runbook incorrerão em cobranças adicionais com base no tamanho e no tempo em que você os mantém. Para alguns tipos de volume, se você precisar manter a mesma proporção de IOPS por GB após a expansão, talvez seja necessário modificar as IOPS provisionadas. Dispositivos RAID e volumes LVM não são suportados.

  • Backup e recuperação: o runbook cria uma AMI de backup antes de fazer qualquer alteração nos volumes. A AMI e os snapshots associados não são removidos automaticamente da sua conta. Você deve remover manualmente esses backups se eles não forem mais necessários. Em caso de falha, os volumes podem ser recuperados dos snapshots da AMI associada, conforme descrito em Substituir um volume do Amazon EBS usando um snapshot.

Como funciona?

Esse runbook executa as seguintes operações:

  • Verifica se a instância de destino é gerenciada pelo Systems Manager e está executando o Linux

  • Garante que haja apenas uma execução desse runbook direcionada à instância atual do Amazon EC2

  • Cria um backup da Amazon Machine Image (AMI) a partir da instância de destino

  • Estende os volumes do Amazon EBS que foram especificados para expansão

  • Estende os sistemas de arquivos na instância de destino usando comandos de shell script

Importante

O acesso aos AWSPremiumSupport-* runbooks exige uma assinatura Business + Support, Enterprise Support ou Unified Operations. Para obter mais informações, consulte Comparar Planos AWS Support.

Executar esta automação (console)

Tipo de documento

Automação

Proprietário

Amazon

Plataformas

Linux

Parâmetros

Permissões obrigatórias do IAM

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

  • ec2:DescribeInstances

  • ec2:CreateImage

  • ec2:DescribeImages

  • ec2:DescribeVolumes

  • ec2:DescribeVolumesModifications

  • ec2:ModifyVolume

  • ssm:SendCommand

  • ssm:ListCommandInvocations

  • ssm:DescribeInstanceInformation

  • ssm:DescribeAutomationExecutions

  • ssm:GetAutomationExecution

Exemplo de política do IAM:


 {
     "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": "*"
         }
     ]
 }

Instruções

Siga estas etapas para configurar a automação:

  1. Abra AWSPremiumSupport-ExtendVolumesOnLinux no Systems Manager em Documentos.

  2. Escolha Execute automation.

  3. Para os parâmetros de entrada, insira o seguinte:

    • AutomationAssumeRole (Opcional):

      • Descrição: (Opcional) O nome de recurso da Amazon (ARN) da função AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation execute as 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.

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

    • InstanceId (Obrigatório):

      • Descrição: (obrigatório) O ID da instância do Amazon EC2.

      • Tipo: String

      • Padrão de permissão: ^i-[a-z0-9]{8,17}$

    • VolumeExpansionCapSize (Obrigatório):

      • Descrição: (Obrigatório) Tamanho máximo (em GiB) para o qual os volumes do Amazon EBS serão aumentados.

      • Tipo: String

      • Padrão de permissão: ^[0-9]{1,4}$

    • DiagnosticResults (Obrigatório):

      • Descrição: (Obrigatório) Os resultados do script de pré-verificação do DiagnoseDiskUsage documento, formatado como CSV de uma linha. A sequência de caracteres começa com EXTEND; informações de volume separadas por vírgula para cada volume, com volumes separados por ponto e vírgula. As informações de cada volume incluem: ID do volume, partição, sinalizador de extensão (1 para estender, 0 para pular), novo tamanho em GB, AWS região e. Reason/Action

      • Tipo: String

      • Padrão de permissão: ^EXTEND;[0-9a-zA-Z\\.;_%:\\-\/,\\s]{7,5400}$

  4. Clique em Executar.

  5. A automação é iniciada.

  6. O runbook executa as seguintes etapas:

    • AssertInstanceIsManagedInstance:

      Verifica se a instância de destino é gerenciada pelo Systems Manager.

    • DescribeInstance:

      Recupera as Platform informações da instância de destino do Amazon EC2.

    • BranchOnPlatform:

      Confirma que a plataforma de instância do Amazon EC2 de destino é Linux.

    • CheckConcurrency:

      Garante que haja apenas uma execução desse runbook direcionada à instância atual do Amazon EC2.

    • CreateImage:

      Cria um backup da Amazon Machine Image (AMI) a partir da instância de destino.

    • WaitUntilImageReady:

      Espera que a Amazon Machine Image (AMI) conclua a criação e alcance o available estado.

    • Aumentar o volume do BS:

      Estende os volumes do Amazon EBS da instância de destino que foram especificados para expansão.

    • DescribeVolumes:

      Descreve os volumes do Amazon EBS vinculados à instância de destino.

    • ExtendFilesystem:

      Estende os sistemas de arquivos da instância de destino usando comandos de shell script.

  7. Após a conclusão, revise a seção Saídas para ver os resultados detalhados da execução.

Referências

Automação do Systems Manager