View a markdown version of this page

AWSPremiumSupport-ExtendVolumesOnWindows - AWS Systems Manager Referência do Automation Runbook

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-ExtendVolumesOnWindows

Descrição

O AWSPremiumSupport-ExtendVolumesOnWindows 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 de 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 experimentar 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 período de tempo em que você os mantém. Para alguns tipos de volume, se você precisar manter a mesma taxa de IOPS por GB após a expansão, talvez seja necessário modificar as IOPS provisionadas.

  • 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 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 Windows Server

  • 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 PowerShell

Importante

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

Execute esta automação (console)

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

  • ssm:SendCommand

  • ssm:ListCommandInvocations

  • ssm:DescribeInstanceInformation

Exemplo de política do IAM:


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

Instruções

Siga estas etapas para configurar a automação:

  1. Navegue até AWSPremiumSupport-ExtendVolumesOnWindowsem Systems Manager em Documentos.

  2. Selecione Execute automation (Executar automação).

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

    • AutomationAssumeRole (Opcional):

      • Descrição: (Opcional) O Amazon Resource Name (ARN) da função do 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-[0-9a-f]{8,17}$

    • VolumeExpansionCapSize (Obrigatório):

      • Descrição: (Obrigatório) Tamanho máximo (em GiB) em que 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 string começa com, EXTEND; seguida por 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, letra da unidade, sinalizador de extensão (1 para estender, 0 para ignorar), novo tamanho em GB, AWS região e motivo/ação.

      • Tipo: String

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

  4. Selecione Executar.

  5. A automação é iniciada.

  6. O bucket realiza as seguintes etapas:

    • AssertInstanceIsManagedInstance:

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

    • DescribeInstance:

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

    • BranchOnPlatform:

      Confirma que a plataforma de instância do Amazon EC2 de destino é o Windows Server.

    • 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 chegue ao available estado.

    • Estender EBSVolume:

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

    • DescribeVolumes:

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

    • ExtendFilesystem:

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

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

Referências

Automação do Systems Manager