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

# Crie uma instância do Amazon EC2 para CodeDeploy (modelo)CloudFormation
<a name="instances-ec2-create-cloudformation-template"></a>

Você pode usar nosso CloudFormation modelo para iniciar rapidamente uma instância do Amazon EC2 executando o Amazon Linux ou o Windows Server. Você pode usar o AWS CLI, o CodeDeploy console ou o AWS APIs para iniciar a instância com o modelo. Além de iniciar a instância, o template faz o seguinte:
+ Instrui CloudFormation a conceder permissão à instância para participar das CodeDeploy implantações.
+ Marca a instância para que CodeDeploy possa encontrá-la durante uma implantação.
+ Instala e executa o CodeDeploy agente na instância.

Você não precisa usar o nosso CloudFormation para configurar uma instância do Amazon EC2. Para conhecer alternativas, consulte [Trabalhando com instâncias para CodeDeploy](instances.md).

Não fornecemos um CloudFormation modelo para instâncias do Amazon EC2 executando o Ubuntu Server ou o Red Hat Enterprise Linux (RHEL).

**Topics**
+ [Antes de começar](#instances-ec2-create-cloudformation-template-before)
+ [Execute uma instância do Amazon EC2 com o CloudFormation modelo (console)](#instances-ec2-create-cloudformation-template-console)
+ [Execute uma instância do Amazon EC2 com o CloudFormation modelo ()AWS CLI](#instances-ec2-create-cloudformation-template-cli)

## Antes de começar
<a name="instances-ec2-create-cloudformation-template-before"></a>

Antes de usar o CloudFormation modelo para iniciar instâncias do Amazon EC2, certifique-se de concluir as etapas a seguir.

1. Certifique-se de ter criado um usuário administrativo, conforme descrito em [Etapa 1: configuração](getting-started-setting-up.md). Verifique se o usuário tem as seguintes permissões mínimas e adicione as que não estão presentes:
   + cloudformation:\$1
   + codedeploy:\$1
   + ec2:\$1
   + objetivo: AddRoleToInstanceProfile
   + objetivo: CreateInstanceProfile
   + objetivo: CreateRole
   + objetivo: DeleteInstanceProfile
   + objetivo: DeleteRole
   + objetivo: DeleteRolePolicy
   + objetivo: GetRole
   + objetivo: DeleteRolePolicy
   + objetivo: PutRolePolicy
   + objetivo: RemoveRoleFromInstanceProfile

1. Certifique-se de ter um par de chaves de instância para permitir o acesso SSH à instância do Amazon EC2 executando o Amazon Linux ou acesso RDP à instância que executa o Windows Server.

   [Para encontrar um nome de par de chaves, abra o console do Amazon EC2 em https://console.aws.amazon.com /ec2.](https://console.aws.amazon.com/ec2) No painel de navegação, em **Rede e segurança**, escolha **Pares de chaves** e anote o nome do par de chaves na lista. 

   Para gerar um novo par de chaves, consulte [Criando seu par de chaves com o Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html#having-ec2-create-your-key-pair). Verifique se o par de chaves foi criado em uma das regiões listadas em [Região e endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) no *Referência geral da AWS*. Caso contrário, você não poderá usar o par de chaves de instância com o CodeDeploy.

## Execute uma instância do Amazon EC2 com o CloudFormation modelo (console)
<a name="instances-ec2-create-cloudformation-template-console"></a>

1. Faça login no Console de gerenciamento da AWS e abra o CloudFormation console em [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).
**Importante**  
Faça login no Console de gerenciamento da AWS com a mesma conta que você usou[Começando com CodeDeploy](getting-started-codedeploy.md). Na barra de navegação, no seletor de região, escolha uma das regiões listadas em [Região e endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) em. *Referência geral da AWS* CodeDeploy suporta somente essas regiões.

1. Selecione **Create Stack** (Criar pilha).

1. Em **Escolher um modelo**, selecione **Especificar um URL do modelo do Amazon S3**. Na caixa, digite a localização do CloudFormation modelo para sua região e escolha **Avançar**.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codedeploy/latest/userguide/instances-ec2-create-cloudformation-template.html)

1. Na caixa **Stack name (Nome da pilha)**, digite um nome para a pilha (por exemplo, **CodeDeployDemoStack**).

1. Em **Parâmetros**, digite o seguinte e escolha **Avançar**.
   + Para **InstanceCount**, digite o número de instâncias que você deseja iniciar. (Recomendamos deixar o padrão de **1**.)
   + Para **InstanceType**, digite o tipo de instância que você deseja iniciar (ou deixe o padrão de **t1.micro**).
   + Para **KeyPairName**, digite o nome do par de chaves da instância. Digite apenas o nome do par de chaves, e não sua extensão de arquivo.
   + Em **OperatingSystem**box, digite **Windows** para iniciar instâncias executando o Windows Server (ou deixe o padrão do **Linux**).
   + Para **SSHLocation**, digite o intervalo de endereços IP a ser usado para se conectar à instância com SSH ou RDP (ou deixe o padrão de **0.0.0.0/0**).
**Importante**  
O padrão de **0.0.0.0/0** é fornecido apenas para fins de demonstração. CodeDeploy não exige que as instâncias do Amazon EC2 tenham acesso irrestrito às portas. Como prática recomendada, recomendamos restringir o acesso às portas SSH (e HTTP). Para obter mais informações, consulte [Dicas para proteger sua instância do Amazon EC2](https://aws.amazon.com/articles/1233).
   + Para **TagKey**, digite a tag de instância que a chave CodeDeploy usará para identificar as instâncias durante a implantação (ou deixe o padrão de **Nome**).
   + Para **TagValue**, digite o valor da tag de instância CodeDeploy que será usado para identificar as instâncias durante a implantação (ou deixe o padrão de **CodeDeployDemo**).

1. Na página **Opções**, deixe as caixas de opções em branco e escolha **Avançar**.
**Importante**  
CloudFormation as tags são diferentes das CodeDeploy tags. CloudFormation usa tags para simplificar a administração da sua infraestrutura. CodeDeploy usa tags para identificar instâncias do Amazon EC2. Você especificou tags do CodeDeploy na página **Specify Parameters (Especificar parâmetros)**.

1. Na página de **revisão**, em **Capacidades**, selecione a caixa **Eu reconheço que CloudFormation podem criar recursos do IAM** e, em seguida, escolha **Criar**.

   **Depois de criar CloudFormation a pilha e iniciar as instâncias do Amazon EC2, no CloudFormation console**,** CREATE\$1COMPLETE será exibido na coluna Status.** Esse processo pode levar alguns minutos.

Para verificar se o CodeDeploy agente está sendo executado nas instâncias do Amazon EC2[Gerenciando as operações CodeDeploy do agente](codedeploy-agent-operations.md), consulte e prossiga para. [Crie um aplicativo com CodeDeploy](applications-create.md)

## Execute uma instância do Amazon EC2 com o CloudFormation modelo ()AWS CLI
<a name="instances-ec2-create-cloudformation-template-cli"></a>

1. Use nosso CloudFormation modelo em uma chamada para o **create-stack** comando. Essa pilha iniciará uma nova instância do Amazon EC2 com CodeDeploy o agente instalado.

   Para iniciar uma instância do Amazon EC2 executando o Amazon Linux:

   ```
   aws cloudformation create-stack \
     --stack-name CodeDeployDemoStack \
     --template-url templateURL \
     --parameters ParameterKey=InstanceCount,ParameterValue=1 ParameterKey=InstanceType,ParameterValue=t1.micro \
       ParameterKey=KeyPairName,ParameterValue=keyName ParameterKey=OperatingSystem,ParameterValue=Linux \
       ParameterKey=SSHLocation,ParameterValue=0.0.0.0/0 ParameterKey=TagKey,ParameterValue=Name \
       ParameterKey=TagValue,ParameterValue=CodeDeployDemo \
     --capabilities CAPABILITY_IAM
   ```

   Para iniciar uma instância do Amazon EC2 executando o Windows Server: 

   ```
   aws cloudformation create-stack --stack-name CodeDeployDemoStack --template-url template-url --parameters ParameterKey=InstanceCount,ParameterValue=1 ParameterKey=InstanceType,ParameterValue=t1.micro ParameterKey=KeyPairName,ParameterValue=keyName ParameterKey=OperatingSystem,ParameterValue=Windows ParameterKey=SSHLocation,ParameterValue=0.0.0.0/0 ParameterKey=TagKey,ParameterValue=Name ParameterKey=TagValue,ParameterValue=CodeDeployDemo --capabilities CAPABILITY_IAM
   ```

   *keyName*é o nome do par de chaves da instância. Digite apenas o nome do par de chaves, e não sua extensão de arquivo.

   *template-url*é a localização do CloudFormation modelo para sua região:  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codedeploy/latest/userguide/instances-ec2-create-cloudformation-template.html)

   Esse comando cria uma CloudFormation pilha chamada**CodeDeployDemoStack**, usando o CloudFormation modelo no bucket do Amazon S3 especificado. A instância do Amazon EC2 se baseia no tipo de instância t1.micro, mas você pode usar qualquer tipo. Ela é marcada com o valor **CodeDeployDemo**, mas você pode marcá-la com qualquer valor. Ela tem o par de chaves de instância especificado aplicado.

1. Chame o **describe-stacks** comando para verificar se a CloudFormation pilha chamada **CodeDeployDemoStack** foi criada com sucesso:

   ```
   aws cloudformation describe-stacks --stack-name CodeDeployDemoStack --query "Stacks[0].StackStatus" --output text
   ```

   Não prossiga até que o valor `CREATE_COMPLETE` seja retornado.

Para verificar se o CodeDeploy agente está sendo executado na instância do Amazon EC2[Gerenciando as operações CodeDeploy do agente](codedeploy-agent-operations.md), consulte e prossiga para. [Crie um aplicativo com CodeDeploy](applications-create.md)