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á.
# AMI \$1 Criar
Crie uma Amazon Machine Image (AMI) com base em uma instância EC2 autônoma existente em sua conta AMS. A instância deve estar no estado interrompido antes de executar esse tipo de alteração.
**Classificação completa:** Implantação \$1 Componentes avançados de pilha \$1 AMI \$1 Create
## Detalhes do tipo de alteração
****
| | |
| --- |--- |
| ID do tipo de alteração | ct-3rqqu43 krekby |
| Versão atual | 2,0 |
| Duração esperada da execução | 360 minutos |
| Aprovação da AWS | Obrigatório |
| Aprovação do cliente | Não obrigatório |
| Modo de execução | Automatizado |
## Informações adicionais
### Criar uma AMI
#### Criação de uma AMI com o console
O seguinte mostra esse tipo de alteração no console AMS.
![\[Alteração type details for creating an Amazon Machine Image (AMI) from an EC2 instance.\]](http://docs.aws.amazon.com/pt_br/managedservices/latest/ctref/images/guiAmiCreateCT.png)
**Importante**
Antes de começar, prepare a instância do EC2 que você usará para criar a AMI. Sem uma preparação adequada, é provável que o RFC de criação da AMI seja rejeitado ou falhe. Para obter informações sobre como preparar sua instância para criar com sucesso uma AMI, consulte as instruções incluídas neste tutorial.
Como funciona:
1. Navegue até a página **Criar RFC**: No painel de navegação esquerdo do console AMS, clique **RFCs**para abrir a página da RFCs lista e, em seguida, clique em **Criar** RFC.
1. Escolha um tipo de alteração popular (CT) na visualização padrão **Procurar tipos de alteração** ou selecione uma CT na visualização **Escolher por categoria**.
+ **Navegar por tipo de alteração**: você pode clicar em um CT popular na área de **criação rápida** para abrir imediatamente a página **Executar RFC**. Observe que você não pode escolher uma versão mais antiga do CT com a criação rápida.
Para classificar CTs, use a área **Todos os tipos de alteração** na exibição **Cartão** ou **Tabela**. Em qualquer exibição, selecione uma CT e clique em **Criar RFC** para abrir a página **Executar RFC**. Se aplicável, a opção **Criar com uma versão mais antiga** aparece ao lado do botão **Criar RFC**.
+ **Escolha por categoria**: selecione uma categoria, subcategoria, item e operação e a caixa de detalhes do CT será aberta com a opção **Criar com uma versão mais antiga**, se aplicável. Clique em **Criar RFC** para abrir a página **Executar RFC**.
1. Na página **Executar RFC**, abra a área do nome do CT para ver a caixa de detalhes do CT. É necessário um **Assunto** (preenchido se você escolher seu CT na visualização **Procurar tipos de alteração**). Abra a área **Configuração adicional** para adicionar informações sobre o RFC.
Na área **Configuração de execução**, use as listas suspensas disponíveis ou insira valores para os parâmetros necessários. Para configurar parâmetros de execução opcionais, abra a área **Configuração adicional**.
1. Ao terminar, clique em **Executar**. Se não houver erros, a página **RFC criada com sucesso** será exibida com os detalhes da RFC enviada e a saída inicial de **execução**.
1. Abra a área **Parâmetros de execução** para ver as configurações que você enviou. Atualize a página para atualizar o status de execução do RFC. Opcionalmente, cancele a RFC ou crie uma cópia dela com as opções na parte superior da página.
#### Criação de uma AMI com a CLI
Como funciona:
1. Use o Inline Create (você emite um `create-rfc` comando com todos os parâmetros de RFC e execução incluídos) ou o Template Create (você cria dois arquivos JSON, um para os parâmetros RFC e outro para os parâmetros de execução) e emita o `create-rfc` comando com os dois arquivos como entrada. Ambos os métodos são descritos aqui.
1. Envie o `aws amscm submit-rfc --rfc-id ID` comando RFC: com o ID RFC retornado.
Monitore o `aws amscm get-rfc --rfc-id ID` comando RFC:.
Para verificar a versão do tipo de alteração, use este comando:
```
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID
```
**nota**
Você pode usar qualquer `CreateRfc` parâmetro com qualquer RFC, independentemente de eles fazerem parte do esquema para o tipo de alteração. Por exemplo, para receber notificações quando o status da RFC mudar, adicione essa linha `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` à parte dos parâmetros da RFC da solicitação (não aos parâmetros de execução). Para obter uma lista de todos os CreateRfc parâmetros, consulte a [Referência da API de gerenciamento de alterações do AMS](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html).
*CRIAÇÃO EM LINHA*:
Execute o comando create RFC com os parâmetros de execução fornecidos em linha (aspas de escape ao fornecer parâmetros de execução em linha) e, em seguida, envie a ID de RFC retornada. Por exemplo, você pode substituir o conteúdo por algo assim:
```
aws --profile saml --region us-east-1 amscm create-rfc --change-type-id "ct-3rqqu43krekby" --change-type-version "2.0" --title "AMI-Create-IC" --execution-parameters "{\"AMIName\":\"MyAmi\",\"VpcId\":\"VPC_ID\",\"EC2InstanceId\":\"INSTANCE_ID\"}"
```
*CRIAÇÃO DE MODELO*:
1. Exiba os parâmetros de execução do esquema JSON para esse tipo de alteração em um arquivo; este exemplo o chama de .json: CreateAmiParams
```
aws amscm get-change-type-version --change-type-id "ct-3rqqu43krekby" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateAmiParams.json
```
1. Modifique e salve o CreateAmiParams arquivo.json dos parâmetros de execução. Por exemplo, você pode substituir o conteúdo por algo assim:
```
{
"AMIName": "My-AMI",
"InstanceId": "EC2_INSTANCE_ID"
}
```
1. Envie o arquivo JSON do modelo RFC para um arquivo na sua pasta atual; este exemplo o chama de .json: CreateAmiRfc
```
aws amscm create-rfc --generate-cli-skeleton > CreateAmiRfc.json
```
1. Modifique e salve o CreateAmiRfc arquivo.json. Por exemplo, você pode substituir o conteúdo por algo assim:
```
{
"ChangeTypeId": "ct-3rqqu43krekby",
"ChangeTypeVersion": "2.0",
"Title": "AMI-Create-RFC"
}
```
1. Crie o RFC, especificando o CreateAmiRfc arquivo e o CreateAmiParams arquivo:
```
aws amscm create-rfc --cli-input-json file://CreateAmiRfc.json --execution-parameters file://CreateAmiParams.json
```
Você recebe a ID da nova RFC na resposta e pode usá-la para enviar e monitorar a RFC. Até que você o envie, o RFC permanece no estado de edição e não inicia.
#### Dicas
**nota**
Depois de criar uma AMI personalizada, você pode enviar uma solicitação de serviço ao AMS para que seu grupo atual do EC2 Auto Scaling use a nova AMI. Para obter informações sobre como criar uma solicitação de serviço, consulte [Exemplos de solicitações de serviço](https://docs.aws.amazon.com/managedservices/latest/userguide/serv-req-mgmt-examples.html).
**Importante**
Antes de começar, prepare a instância do EC2 que você usará para criar a AMI. Sem uma preparação adequada, é provável que o RFC de criação da AMI seja rejeitado ou falhe.
Para evitar problemas de autenticação de instâncias criadas a partir da nova AMI, execute esses comandos do sistema na instância depois de aplicar as alterações personalizadas e antes de chamar o Create AMI CT.
**Importante**
Se a instância especificada não for interrompida e separada do domínio atual, a RFC de criação da AMI falhará. Prepare a instância conforme descrito.
Para obter mais informações, consulte [Criar uma imagem de máquina padrão da Amazon usando o Sysprep](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Creating_EBSbacked_WinAMI.html#23ami-create-standard).
Você pode se inscrever em um tópico de notificação do AMS SNS AMI para receber um alerta sempre que um novo AMS AMIs de seu interesse for implantado. Para obter mais informações, consulte [Serviço de notificação de AMI](https://docs.aws.amazon.com/managedservices/latest/userguide/ams-ami-notify.html) do AMS.
##### Preparação do Linux para criação de AMI
Baixe e execute o script a seguir para preparar sua instância para a criação da AMI. Você deve executar esse script como usuário root.
```
curl https://amazon-ams-us-east-1.s3.amazonaws.com/latest/linux/prepare_instance_for_ami_and_shutdown.sh -o ./prepare_instance_for_ami_and_shutdown.sh
chmod 744 prepare_instance_for_ami_and_shutdown.sh
./prepare_instance_for_ami_and_shutdown.sh
```
Observação: o script anterior executa um encerramento na instância e os usuários conectados são desconectados da sessão.
##### Preparação do Windows para criação de AMI
Windows Powershell (executado como administrador):
```
Invoke-AMSSysprep
```
A instância é interrompida e qualquer usuário conectado é desconectado da sessão atual do Windows RDP.
Para obter mais informações sobre a criação do AWS Windows AMIs, consulte [Criar uma AMI personalizada do Windows](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Creating_EBSbacked_WinAMI.html#23ami-create-standard).
##### UserData para AMI Create
Se você precisar que os dados do usuário sejam executados na próxima inicialização da sua AMI, certifique-se do seguinte:
+ `HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\ManagedServices\RunUserDataViaAMSBootModule`A chave do registro está presente; se essa chave não estiver presente, os dados do usuário não serão executados na próxima vez.
+ Para permitir que os dados do usuário sejam executados na próxima inicialização:
1. Inicie um Windows PowerShell com privilégio de administrador (execute como administrador)
1. Execute este comando: .
```
Install-AMSDependencies
```
Para obter informações sobre falha na criação de AMI RFCs, consulte [Solução de problemas de falhas de RFC](https://docs.aws.amazon.com/managedservices/latest/userguide/rfc-failures.html).
## Parâmetros de entrada de execução
Para obter informações detalhadas sobre os parâmetros de entrada de execução, consulte[Esquema para alteração do tipo ct-3rqqu43krekby](schemas.md#ct-3rqqu43krekby-schema-section).
## Exemplo: parâmetros obrigatórios
```
{
"InstanceId": "i-01234567890abcdef",
"AmiName": "MyAMI"
}
```
## Exemplo: Todos os parâmetros
```
{
"InstanceId": "i-12345678",
"AmiName": "MyAMI",
"AmiTags": [
{
"Key": "foo",
"Value": "bar"
},
{
"Key": "testkey",
"Value": "testvalue"
}
]
}
```