Gerenciar pacote de componentes do VSS para snapshots do EBS baseados no VSS do Windows

Antes de criar snapshots do EBS baseados no VSS, verifique se você tem a versão mais recente do pacote de componentes do VSS instalada na sua instância do Windows. Existem várias maneiras possíveis de instalar o pacote AwsVssComponents em uma instância existente. Veja abaixo:

• (Recomendado) Execução do documento de comando AWSEC2-VssInstallAndSnapshot (recomendado). Se necessário, isso faz a instalação ou a atualização automaticamente toda vez que for executado.

• Instalar manualmente os componentes do VSS em uma instância EC2 Windows.

• Atualizar o pacote de componentes do VSS na instância EC2 Windows.

Você também pode criar uma AMI com o EC2 Image Builder que usa o componente gerenciado aws-vss-components-windows para instalar o pacote AwsVssComponents da imagem. O componente gerenciado usa o AWS Systems Manager Distributor para instalar o pacote. Depois que o Image Builder criar a imagem, toda instância que você executar na AMI associada terá o pacote VSS instalado nela. Para obter mais informações sobre como criar uma AMI com o pacote VSS instalado, consulte Componentes gerenciados do pacote do Distributor para Windows no Guia do usuário do EC2 Image Builder.

Instalar manualmente os componentes do VSS em uma instância EC2 Windows

Sua instância do EC2 para Windows deve ter componentes VSS instalados antes de criar snapshots consistentes com aplicações usando o Systems Manager. Se você não executar o documento do comando AWSEC2-VssInstallAndSnapshot para instalar ou atualizar automaticamente o pacote toda vez que criar snapshots consistentes com aplicações, deverá instalar o pacote manualmente.

Você também deve fazer a instalação manualmente se planeja usar um dos métodos a seguir para criar snapshots consistentes com aplicações usando a instância do EC2.

• Criar snapshots do VSS usando o AWS Backup

• Criar snapshots do VSS usando o Amazon Data Lifecycle Manager

Se precisar fazer uma instalação manual, recomendamos usar o pacote de componentes do AWS VSS mais recente para melhorar a confiabilidade e a performance de snapshots consistentes com aplicações nas suas instâncias do EC2 para Windows.

nota

Para instalar ou atualizar automaticamente o pacote AwsVssComponents sempre que você criar snapshots consistentes com a aplicação, recomendamos que use o Systems Manager para executar o documento AWSEC2-VssInstallAndSnapshot. Para ter mais informações, consulte Execução do documento de comando AWSEC2-VssInstallAndSnapshot (recomendado).

Para instalar os componentes do VSS em uma instância do Windows do Amazon EC2, siga as etapas para o ambiente de sua preferência.

Console

Instalar os componentes do VSS usando o SSM Distributor

1. Abra o console do AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.

2. No painel de navegação, selecione Executar comando.

3. Selecione Run command (Executar comando).

4. Em Command document (Documento do comando), selecione o botão ao lado de AWS-ConfigureAWSPackage.

5. Em Command parameters (Parâmetros do comando), faça o seguinte:

   1. Verifique se Action (Ação) está definida como Install (Instalar).

   2. Em Name (Nome), insira AwsVssComponents.

   3. Em Versão, insira uma versão ou deixe o campo vazio para que o Systems Manager instale a versão mais recente.

6. Em Targets (Destinos), identifique as instâncias nas quais você deseja executar essa operação especificando tags ou selecionando instâncias manualmente.

   nota

   Se você optar por selecionar manualmente as instâncias e uma instância que você espera visualizar não estiver incluída na lista, consulte Algumas das minhas instâncias estão ausentes no Manual do usuário do AWS Systems Manager para obter dicas para solução de problemas.

7. Para Other parameters (Outros parâmetros):

   • (Opcional) Em Comment (Comentário), digite informações sobre esse comando.

   • Em Timeout (seconds) (Tempo limite [segundos]), especifique o número de segundos para o sistema aguardar até a falha de execução do comando total.

8. (Opcional) Em Rate control (Controle de taxa):

   • Em Concurrency (Concorrência), especifique um número ou uma porcentagem de instâncias nas quais executar o comando ao mesmo tempo.

     nota

     Se tiver selecionado destinos escolhendo tags do Amazon EC2 e não tiver certeza de quantas instâncias usam tags selecionadas, limite o número de instâncias que podem executar o documento ao mesmo tempo especificando uma porcentagem.

   • Em Error threshold (Limite de erro), especifique quando parar de executar o comando em outras instâncias depois de falhar em alguns ou em uma porcentagem de instâncias. Por exemplo, se você especificar três erros, o Systems Manager deixará de enviar o comando quando o 4° erro for recebido. As instâncias que continuam processando o comando também podem enviar erros.

9. (Opcional) Na seção Output options (Opções de saída), se você quiser salvar a saída de comando em um arquivo, selecione a caixa ao lado de Enable writing to an S3 bucket (Habilitar a gravação em um bucket do S3). Especifique o bucket e os nomes (de pastas) de prefixo (opcional).

   nota

   As permissões do S3 que concedem a possibilidade de gravar os dados em um bucket do S3 são as do perfil de instância atribuído à instância, e não as do usuário que realiza essa tarefa. Para obter mais informações, consulte Configurar permissões de instância do EC2 no Guia do usuário do AWS Systems Manager.

10. (Opcional) Especifique opções para SNS notifications (Notificações do SNS).

    Para obter informações sobre como configurar notificações do Amazon SNS para o Run Command, consulte Configuração das notificações do Amazon SNS para o AWS Systems Manager.

11. Escolha Run.

AWS CLI

Use o procedimento a seguir para baixar e instalar o pacote AwsVssComponents em suas instâncias usando o Run Command por meio da AWS CLI. O pacote instala dois componentes: um solicitante de VSS e um fornecedor de VSS. O sistema copia esses componentes para um diretório na instância e, em seguida, registra a DLL do fornecedor como um fornecedor de VSS.

Para instalar o pacote do VSS por meio da AWS CLI

• Execute o comando a seguir para fazer download e instalar os componentes do VSS necessários para o Systems Manager.

  aws ssm send-command \
  --document-name "AWS-ConfigureAWSPackage" \
  --instance-ids "i-01234567890abcdef" \
  --parameters '{"action":["Install"],"name":["AwsVssComponents"]}'

PowerShell

Use o procedimento a seguir para fazer baixar e instalar o pacote AwsVssComponents em suas instâncias usando o Run Command por meio do Tools for Windows PowerShell. O pacote instala dois componentes: um solicitante de VSS e um fornecedor de VSS. O sistema copia esses componentes para um diretório na instância e, em seguida, registra a DLL do fornecedor como um fornecedor de VSS.

Para instalar o pacote do VSS usando o AWS Tools for Windows PowerShell

• Execute o comando a seguir para fazer download e instalar os componentes do VSS necessários para o Systems Manager.

  Send-SSMCommand -DocumentName AWS-ConfigureAWSPackage -InstanceId "i-01234567890abcdef" -Parameter @{'action'='Install';'name'='AwsVssComponents'}

Verifique a assinatura nos componentes do AWS VSS

Use o procedimento a seguir para verificar a assinatura no pacote AwsVssComponents.

1. Conecte-se à sua instância do Windows. Para ter mais informações, consulte Conectar-se à instância do Windows no usando RDP.

2. Navegue até C:\Program Files\Amazon\AwsVssComponents.

3. Abra o menu de contexto de ec2-vss-agent.exe (clique com o botão direito do mouse) e escolha Propriedades.

4. Navegue até a guia Assinaturas digitais e verifique se o nome do signatário é Amazon Web Services Inc.

5. Use as etapas anteriores para verificar a assinatura em Ec2VssInstaller e Ec2VssProvider.dll.

Atualizar o pacote de componentes do VSS na instância EC2 Windows

Recomendamos que você sempre mantenha os componentes do VSS atualizados com a versão mais recente recomendada. Existem diversas maneiras diferentes de atualizar componentes quando uma nova versão do pacote AwsVssComponents é lançada.

Métodos de atualização

• É possível repetir as etapas descritas em Instalar manualmente os componentes do VSS em uma instância EC2 Windows quando uma nova versão dos componentes do AWS VSS é lançada.

• É possível configurar uma associação do State Manager do Systems Manager para baixar e instalar automaticamente os componentes novos ou atualizados do VSS quando o pacote AwsVssComponents ficar disponível.

• Para instalar ou atualizar automaticamente o pacote AwsVssComponents sempre que você criar snapshots consistentes com a aplicação, ao usar o Systems Manager para executar o documento AWSEC2-VssInstallAndSnapshot.

nota

Recomendamos que você use o Systems Manager para executar o documento de comando AWSEC2-VssInstallAndSnapshot, que instala ou atualiza automaticamente o pacote AwsVssComponents antes de criar snapshots consistentes com a aplicação. Para ter mais informações, consulte Execução do documento de comando AWSEC2-VssInstallAndSnapshot (recomendado).

Para criar uma associação do State Manager do Systems Manager, siga as etapas do ambiente de sua preferência.

Console

Ao configurar uma associação no Gerenciador de Estados do Systems Manager, é possível atualizar o pacote AwsVssComponents de duas formas, conforme abaixo:

Desinstalar e instalar novamente

Esse método faz o download e instala o pacote sem necessidade de pré-requisitos adicionais.

Atualizar no local

Este método executa uma atualização no local para o pacote e requer os seguintes pré-requisitos:

• A versão do SSM Agent instalada na instância deve ser a 3.3.808.0 ou posterior. Para obter mais informações, consulte Trabalhar com o SSM Agent em instâncias do Amazon EC2 para Windows Server no Guia do usuário do AWS Systems Manager.

• Caso seja especificado, o pacote AwsVssComponents deve estar na versão 2.5.0 ou posterior. As versões anteriores não são compatíveis com a atualização no local.

nota

Caso sua instância não cumpra esses pré-requisitos, a atualização no local não será bem-sucedida. Use a opção Desinstalar e instalar novamente em vez disso.

Criação de uma associação do Gerenciador de Estados usando o AWS Management Console

1. Abra o console AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.

2. No painel de navegação, escolha State Manager.

   Ou, se a página inicial do Systems Manager abrir primeiro, abra o painel de navegação e escolha Gerenciador de Estados.

3. Selecione Criar associação.

4. No campo Association Name (Nome da associação), insira um nome descritivo.

5. Na lista Documento, escolha AWS-ConfigureAWSPackage.

6. Na seção Parameters Parâmetros), escolha Install (Instalar) na lista Action (Ação).

7. Em Tipo de instalação, escolha Desinstalar e instalar novamente ou Atualização no local.

8. No campo Name (Nome), insira AwsVssComponents. É possível manter os campos Version (Versão) e Additional Arguments (Argumentos adicionais) vazios.

9. Na seção Select Targets by, escolha uma opção.

   nota

   Se você optar por especificar instâncias de destino usando tags e especificar tags que são mapeadas para instâncias do Linux, a associação será bem-sucedida na instância do Windows, mas falhará nas instâncias do Linux. O status geral da associação mostra Failed.

10. Na seção Specify schedule, escolha uma opção.

11. Na seção Advanced options (Opções avançadas), em Compliance severity (Severidade de conformidade), escolha um nível de gravidade para a associação. Para obter mais informações, consulte Saiba mais sobre a conformidade de associações. Em Calendários de alteração, selecione um calendário de alterações pré-configurado. Para obter mais informações, consulte Calendário de alterações do AWS Systems Manager.

12. Em Controle de taxa, faça o seguinte:

    • Em Concurrency (Concorrência), especifique um número ou uma porcentagem de nós gerenciados nos quais executar o comando ao mesmo tempo.

    • Em Error threshold (Limite de erro), especifique quando parar de executar o comando em outros nós depois de falhar em alguns ou em uma porcentagem de nós.

13. (Opcional) Em Opções de saída, para salvar a saída de comando em um arquivo, selecione a caixa Habilitar gravação da saída no S3. Digite os nomes de bucket e prefixo (pastas) nas caixas de texto.

14. Escolha Create Association (Criar associação) e, em seguida, Close (Fechar). O sistema tenta criar a associação nas instâncias e aplicar imediatamente o estado.

    nota

    Se as instâncias do EC2 para o Windows Server mostrarem o status Com falha, verifique se o SSM Agent está sendo executado na instância e se a instância está configurada com um perfil do AWS Identity and Access Management (IAM) para o Systems Manager. Para obter mais informações, consulte Configurar o AWS Systems Manager.

AWS CLI

É possível executar o comando create-association para atualizar um pacote do distributor segundo uma programação sem deixar a aplicação associada offline. Somente arquivos novos ou atualizados no pacote são substituídos.

Criar uma associação do Gerenciador de Estados usando a AWS CLI

1. Instale e configure o AWS CLI, caso ainda não o tenha feito. Para obter mais informações, consulte Instalar ou atualizar a versão mais recente da AWS CLI.

2. Execute o comando a seguir para criar uma associação. O valor de --name, o nome do documento, é sempre AWS-ConfigureAWSPackage. O comando a seguir usa a chave InstanceIds para especificar as instâncias de destino.

   aws ssm create-association \
   --name "AWS-ConfigureAWSPackage" \
   --parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["AwsVssComponents"]}' \
   --targets [{\"Key\":\"InstanceIds\",\"Values\":[\"i-01234567890abcdef\",\"i-000011112222abcde\"]}]

Para obter mais informações sobre outras opções que podem ser usadas com o comando create-association, consulte create-association na seção AWS Systems Manager da AWS CLI Command Reference.