# 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](delete-launch-template.md#delete-launch-template-version) que não sejam mais necessárias. **Topics** + [Criar uma versão de modelo de execução](#create-launch-template-version) + [Definir a versão do modelo de execução padrão](#set-default-launch-template-version) + [Descrever uma versão de modelo de execução](#describe-launch-template-version) ## 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 uma descrição de cada parâmetro, consulte [Referência para parâmetros de configuração de instâncias do Amazon EC2](ec2-instance-launch-parameters.md). ------ #### [ 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/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, selecione **Launch Templates (Modelos de execução)**. 1. Selecione um modelo de execução e escolha **Actions (Ações)**, **Modify template (Create new version) (Modificar modelo (Criar versão))**. 1. Em **Template version description** (Descrição da versão do modelo), insira uma descrição para a versão do modelo de execução. 1. (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. 1. Modifique os parâmetros de execução conforme necessário. 1. Escolha **Criar modelo de execução**. ------ #### [ AWS CLI ] **Para criar uma versão de modelo de inicialização** Use o comando [create-launch-template-version](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-launch-template-version.html). É 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-0abcdef1234567890" ``` ------ #### [ PowerShell ] **Para criar uma versão de modelo de inicialização** Use o cmdlet [New-EC2LaunchTemplateVersion](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2LaunchTemplateVersion.html). É 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 `LaunchTemplateData`. 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. ``` New-EC2LaunchTemplateVersion ` -LaunchTemplateId lt-0abcd290751193123 ` -VersionDescription WebVersion2 ` -SourceVersion 1 ` -LaunchTemplateData ( New-Object ` -TypeName Amazon.EC2.Model.RequestLaunchTemplateData ` -Property @{ImageId = 'ami-0abcdef1234567890'} ) ``` ------ ## 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/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, selecione **Launch Templates (Modelos de execução)**. 1. Selecione o modelo de execução e escolha **Actions (Ações)**, **Set default version (Definir versão padrão)**. 1. 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](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-launch-template.html). ``` aws ec2 modify-launch-template \ --launch-template-id lt-0abcd290751193123 \ --default-version 2 ``` ------ #### [ PowerShell ] **Para definir a versão do modelo de inicialização padrão** Use o cmdlet [Edit-EC2LaunchTemplate](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2LaunchTemplate.html). ``` Edit-EC2LaunchTemplate ` -LaunchTemplateId lt-0abcd290751193123 ` -DefaultVersion 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/](https://console.aws.amazon.com/ec2/). 1. No painel de navegação, selecione **Launch Templates (Modelos de execução)**. 1. É 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](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-launch-template-versions.html) 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 as versões mais recentes e padrão do modelo de inicialização da sua conta** Use o comando [describe-launch-template-versions](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-launch-template-versions.html) 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" ``` ------ #### [ PowerShell ] **Para descrever uma versão de modelo de inicialização** Use o cmdlet [Get-EC2TemplateVersion](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2TemplateVersion.html) e especifique os números da versão. No exemplo a seguir, as versões `1` e *`3`* são especificadas. ``` Get-EC2TemplateVersion ` -LaunchTemplateId lt-0abcd290751193123 ` -Version 1,3 ``` **Para descrever as versões mais recentes e padrão do modelo de inicialização da sua conta** Use o cmdlet [Get-EC2TemplateVersion](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2TemplateVersion.html) 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. ``` Get-EC2TemplateVersion ` -Version '$Latest','$Default' ``` ------