

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`
<a name="automation-awspremiumsupport-extendvolumesonlinux"></a>

 **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: `modifying``optimizing`, 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 ](https://docs.aws.amazon.com/ebs/latest/userguide/monitoring-volume-modifications.html) 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 ](https://aws.amazon.com/ebs/pricing) 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. ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-restoring-volume.html)

 **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](https://aws.amazon.com/premiumsupport/plans/).

 [Executar esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSPremiumSupport-ExtendVolumesOnLinux) 

**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 ](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnLinux/description) no Systems Manager em Documentos.

1. Escolha **Execute automation**.

1. 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}$`

1. Clique em **Executar**.

1. A automação é iniciada.

1. 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.

1. 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
+ [Execute esta automação (console)](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnLinux/description)
+ [Executar uma automação](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-working-executing.html)
+ [Configurar a automação](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-setup.html)
+ [Fluxos de trabalho de automação de suporte ](https://aws.amazon.com/premiumsupport/technology/saw/)
+ [Solicite modificações de volume do Amazon EBS ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/requesting-ebs-volume-modifications.html)