Modificar um modelo de inicialização (gerenciar versões do modelo de inicialização)

Os modelos de inicialização são imutáveis. Após criar um modelo de inicialização, você não poderá modificá-lo. Em vez disso, é possível criar uma nova versão do modelo de inicialização que inclua as alterações necessárias.

É possível criar diferentes versões de um modelo de execução, definir a versão padrão, descrever uma versão de modelo de execução e excluir versões que não são mais necessárias.

Criar uma versão de modelo de execução

Ao criar uma versão de modelo de execução, é possível especificar novos parâmetros de execução ou usar uma versão existente como base para a nova versão. Para obter mais informações sobre os parâmetros de execução, consulte Criar um modelo de inicialização.

Console

Para criar uma versão de modelo de inicialização

1. Abra o console do Amazon EC2 em https://console.aws.amazon.com/ec2/.

2. No painel de navegação, selecione Launch Templates (Modelos de execução).

3. Selecione um modelo de execução e escolha Actions (Ações), Modify template (Create new version) (Modificar modelo (Criar versão)).

4. Em Template version description (Descrição da versão do modelo), insira uma descrição para a versão do modelo de execução.

5. (Opcional) Expanda o Source template (Modelo de origem) e selecione uma versão do modelo de execução a ser usado como base para a nova versão do modelo de execução. A nova versão de modelo de execução herdará os parâmetros de execução desta versão do modelo de execução.

6. Modifique os parâmetros de execução conforme necessário e escolha Create launch template (Criar modelo de execução).

AWS CLI

Para criar uma versão de modelo de inicialização

• Use o comando create-launch-template-version. É possível especificar uma versão de origem na qual a nova versão será baseada. A nova versão herdará os parâmetros de execução desta versão, e será possível substituí-los usando --launch-template-data. O exemplo a seguir cria uma nova versão com base na versão 1 do modelo de execução e especifica um ID de AMI diferente.

  aws ec2 create-launch-template-version \
      --launch-template-id lt-0abcd290751193123 \
      --version-description WebVersion2 \
      --source-version 1 \
      --launch-template-data "ImageId=ami-c998b6b2"

Definir a versão do modelo de execução padrão

É possível definir a versão padrão do modelo de execução. Quando você executa uma instância a partir de um modelo de execução e não especifica uma versão, a instância é executada por meio dos parâmetros da versão padrão.

Console

Para definir a versão do modelo de inicialização padrão

1. Abra o console do Amazon EC2 em https://console.aws.amazon.com/ec2/.

2. No painel de navegação, selecione Launch Templates (Modelos de execução).

3. Selecione o modelo de execução e escolha Actions (Ações), Set default version (Definir versão padrão).

4. Em Template version (Versão do modelo), selecione o número da versão a ser definida como versão padrão e escolha Set as default version (Definir como versão padrão).

AWS CLI

Para definir a versão do modelo de inicialização padrão

• Use o comando modify-launch-template e especifique a versão que deseja definir como padrão.

  aws ec2 modify-launch-template \
      --launch-template-id lt-0abcd290751193123 \
      --default-version 2

Descrever uma versão de modelo de execução

Usando o console, é possível visualizar todas as versões do modelo de execução selecionado ou obter uma lista dos modelos de execução cuja versão mais recente ou padrão corresponde a um número de versão específico. Usando o AWS CLI, é possível descrever todas as versões, versões individuais ou um intervalo de versões de um modelo de execução especificado. Também é possível descrever todas as versões mais recentes ou todas as versões padrão de todos os modelos de execução da sua conta.

Console

Para descrever uma versão de modelo de inicialização

1. Abra o console do Amazon EC2 em https://console.aws.amazon.com/ec2/.

2. No painel de navegação, selecione Launch Templates (Modelos de execução).

3. É possível visualizar uma versão de um modelo de lançamento específico ou obter uma lista dos modelos de execução cuja versão mais recente ou padrão corresponde a um número de versão específico.

   • Para visualizar uma versão de um modelo de execução: selecione o modelo de execução. Na guia Versões em Versão, selecione uma versão para visualizar seus detalhes.

   • Para obter uma lista de todos os modelos de execução cuja versão mais recente corresponde a um número de versão específico: na barra de pesquisa, escolha Versão mais recente e selecione um número de versão.

   • Para obter uma lista de todos os modelos de execução cuja versão padrão corresponde a um número de versão específico: na barra de pesquisa, escolha Versão padrão e selecione um número de versão.

AWS CLI

Para descrever uma versão de modelo de inicialização

• Use o comando delete-launch-template-versions e especifique os números de versão. No exemplo a seguir, as versões 1 e 3 são especificadas.

  aws ec2 describe-launch-template-versions \
      --launch-template-id lt-0abcd290751193123 \
      --versions 1 3

Para descrever todas as versões mais recentes e padrão do modelo de inicialização da sua conta

• Use o comando describe-launch-template-versions e especifique $Latest, $Default, ou ambos. É necessário omitir o ID e o nome do modelo de execução na chamada. Não é possível especificar números de versão.

  aws ec2 describe-launch-template-versions \
      --versions "$Latest,$Default"

Excluir uma versão de modelo de execução

Caso não precise mais de uma versão de modelo de execução, exclua-a.

Considerações

• Não é possível substituir o número de versão após excluí-lo.

• Não é possível excluir a versão padrão do modelo de execução; antes é necessário atribuir outra versão como a padrão. Se a versão padrão for a única versão para o modelo de execução, exclua todo o modelo de execução.

• No console, é possível excluir uma versão do modelo de execução por vez. Usando a AWS CLI, é possível excluir até 200 versões do modelo de execução em uma única solicitação. Para excluir mais de 200 versões em uma única solicitação, exclua o modelo de execução, o que também exclui todas as suas versões.

Console

Para excluir uma versão de modelo de inicialização

1. Abra o console do Amazon EC2 em https://console.aws.amazon.com/ec2/.

2. No painel de navegação, selecione Launch Templates (Modelos de execução).

3. Selecione o modelo de execução e escolha Actions (Ações), Delete template version (Excluir versão de modelo).

4. Selecione a versão a ser excluída e escolha Delete (Excluir).

AWS CLI

Para excluir uma versão de modelo de inicialização

• Use o comando delete-launch-template-versions e especifique os números de versão a serem excluídos. É possível especificar até 200 versões do modelo de execução para excluir em uma única solicitação.

  aws ec2 delete-launch-template-versions \
      --launch-template-id lt-0abcd290751193123 \
      --versions 1