Alterar um tipo de instância do Amazon EC2 com um script bash - AWS Command Line Interface
Antes de começarSobre este exemploParâmetrosArquivosReferências

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

Alterar um tipo de instância do Amazon EC2 com um script bash

Este exemplo de script bash para o Amazon EC2 altera o tipo de instância de uma instância do Amazon EC2 usando o (). AWS Command Line Interface AWS CLI Ele interrompe a instância se ela estiver em execução, altera o tipo de instância e, em seguida, se solicitado, a reinicia. Scripts shell são programas desenvolvidos para ser executados em uma interface de linha de comando.

nota

Para obter exemplos adicionais de comandos, consulte o de AWS CLI referência.

Antes de começar

Antes que você possa executar qualquer um dos exemplos abaixo, as seguintes tarefas deverão ser concluídas.

  • Instale e configure a AWS CLI. Para ter mais informações, consulte Instalar ou atualizar para a versão mais recente da AWS CLI e Autenticação e credenciais de acesso.

  • O perfil que você usa deve ter permissões que permitam as AWS operações executadas pelos exemplos.

  • Uma instância do Amazon EC2 em execução na conta para a qual você tem permissão para interromper e modificar. Se você executar o script de teste, ele iniciará uma instância para você, testará alterando o tipo e encerrará a instância.

  • Como prática AWS recomendada, conceda a esse código o menor privilégio ou somente as permissões necessárias para realizar uma tarefa. Para obter mais informações, consulte Conceder privilégio mínimo no Manual do usuário do AWS Identity and Access Management (IAM).

  • Esse código não foi testado em todas as AWS regiões. Alguns AWS serviços estão disponíveis somente em regiões específicas. Para obter mais informações, consulte Endpoints de serviço e cotas no Guia de referência geral da AWS .

  • A execução desse código pode resultar em cobranças em sua AWS conta. É sua responsabilidade garantir que todos os recursos criados por este script sejam removidos após você terminar de usá-los.

Sobre este exemplo

Este exemplo é escrito como uma função no arquivo de script shell change_ec2_instance_type.sh que você pode usar como source a partir de outro script ou da linha de comando. Cada arquivo de script contém comentários descrevendo cada uma das funções. Uma vez que a função esteja na memória, você poderá chamá-la via linha de comando. Por exemplo, os seguintes comandos alteram o tipo de instância especificada para t2.nano:

$ source ./change_ec2_instance_type.sh
$ ./change_ec2_instance_type -i *instance-id* -t new-type

Para ver o exemplo completo e os arquivos de script disponíveis para download, consulte Alterar o tipo de instância do Amazon EC2 no repositório de exemplos de código em AWS . GitHub

Parâmetros

-i: (string) especifica o ID da instância a ser modificada.

-t: (string) especifica o tipo de instância do Amazon EC2 de destino.

-r: (opção) por padrão, não está definida. Se -r estiver definido, reiniciará a instância após a alteração do tipo.

-f: (opção) por padrão, o script solicita ao usuário que confirme o encerramento da instância antes de fazer a mudança. Se -f estiver definida, a função não avisará o usuário antes de encerrar a instância para realizar a alteração de tipo.

-v: (opção) por padrão, o script opera silenciosamente e exibe a saída somente em caso de erro. Se -v estiver definida, a função exibirá o status ao longo de sua operação.

Arquivos

change_ec2_instance_type.sh

O arquivo de script principal contém a função change_ec2_instance_type() que executa as seguintes tarefas:

  • Verifica se a instância do Amazon EC2 especificada existe.

  • A menos que a opção -f esteja selecionada, avisará o usuário antes de interromper a instância.

  • Altera o tipo de instância

  • Se você definir -r, reiniciará a instância e confirmará que a instância está sendo executada

Veja o código para change_ec2_instance_type.sh on GitHub.

test_change_ec2_instance_type.sh

O script do arquivo test_change_ec2_instance_type.sh testa os vários caminhos de código para a função change_ec2_instance_type. Se todas as etapas no script de teste funcionarem corretamente, ele removerá todos os recursos que criou.

Você pode executar o script de teste com os seguintes parâmetros:

  • -v: (opção) cada teste mostra um status de aprovação/falha conforme eles são executados. Por padrão, os testes são executados silenciosamente e a saída inclui apenas o status final de aprovação/falha.

  • -i: (opção) o script faz uma pausa após cada teste para permitir que você navegue pelos resultados intermediários de cada etapa. Isso permite examinar o status atual da instância usando o console do Amazon EC2. O script avançará para a próxima etapa após você pressionar ENTER no prompt.

Veja o código para test_change_ec2_instance_type.sh on GitHub.

awsdocs_general.sh

O arquivo de script awsdocs_general.sh contém funções de uso geral usadas em exemplos avançados para a AWS CLI.

Veja o código para awsdocs_general.sh on GitHub.

Referências

AWS CLI referência:

Outra referência: