Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Crear una instancia de Amazon EC2 para CodeDeploy (plantilla)CloudFormation
<a name="instances-ec2-create-cloudformation-template"></a>

Puede utilizar nuestra CloudFormation plantilla para lanzar rápidamente una instancia de Amazon EC2 que ejecute Amazon Linux o Windows Server. Puede usar la AWS CLI CodeDeploy consola o la AWS APIs para lanzar la instancia con la plantilla. Además de lanzar la instancia, la plantilla hace lo siguiente:
+ Indica CloudFormation que dé permiso a la instancia para participar en CodeDeploy las implementaciones.
+ Etiqueta la instancia para CodeDeploy poder encontrarla durante una implementación.
+ Instala y ejecuta el CodeDeploy agente en la instancia.

No es necesario que utilice nuestro CloudFormation para configurar una instancia de Amazon EC2. Si desea conocer otras alternativas, consulte [Trabajar con instancias para CodeDeploy](instances.md).

No proporcionamos una CloudFormation plantilla para las instancias de Amazon EC2 que ejecutan Ubuntu Server o Red Hat Enterprise Linux (RHEL).

**Topics**
+ [Antes de empezar](#instances-ec2-create-cloudformation-template-before)
+ [Lance una instancia de Amazon EC2 con la CloudFormation plantilla (consola)](#instances-ec2-create-cloudformation-template-console)
+ [Lance una instancia de Amazon EC2 con la CloudFormation plantilla ()AWS CLI](#instances-ec2-create-cloudformation-template-cli)

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

Antes de poder usar la CloudFormation plantilla para lanzar instancias de Amazon EC2, asegúrese de completar los siguientes pasos.

1. Asegúrese de haber creado un usuario administrativo, tal y como se describe en [Paso 1: Configurar](getting-started-setting-up.md). Compruebe que el usuario tiene los siguientes permisos mínimos y añada los que no estén presentes:
   + cloudformation:\$1
   + codedeploy:\$1
   + ec2:\$1
   + Soy: AddRoleToInstanceProfile
   + objetivo: CreateInstanceProfile
   + objetivo: CreateRole
   + objetivo: DeleteInstanceProfile
   + objetivo: DeleteRole
   + objetivo: DeleteRolePolicy
   + objetivo: GetRole
   + objetivo: DeleteRolePolicy
   + objetivo: PutRolePolicy
   + objetivo: RemoveRoleFromInstanceProfile

1. Asegúrese de tener un par de claves de instancia para permitir el acceso SSH a la instancia de Amazon EC2 que ejecuta Amazon Linux o el acceso RDP a la instancia que ejecuta Windows Server.

   [Para buscar el nombre de un par de claves, abra la consola Amazon EC2 en https://console.aws.amazon.com /ec2.](https://console.aws.amazon.com/ec2) En el panel de navegación, en **Network & Security (Red y seguridad)**, elija **Key Pairs (Pares de claves)** y anote el nombre del par de claves de la lista. 

   Para generar un nuevo par de claves, consulte [Crear un par de claves con Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html#having-ec2-create-your-key-pair). Asegúrese de que crea el par de claves en una de las regiones que se encuentran en la lista de [Regiones y puntos de conexión](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) de la *Referencia general de AWS*. De lo contrario, no puede utilizar el par de claves de la instancia con CodeDeploy.

## Lance una instancia de Amazon EC2 con la CloudFormation plantilla (consola)
<a name="instances-ec2-create-cloudformation-template-console"></a>

1. Inicie sesión Consola de administración de AWS y abra la CloudFormation consola en [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).
**importante**  
Inicia sesión en la Consola de administración de AWS con la misma cuenta que utilizaste. [Empezar con CodeDeploy](getting-started-codedeploy.md) En la barra de navegación, en el selector de regiones, elige una de las regiones que aparecen en [Región y los puntos finales](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) en *Referencia general de AWS*. CodeDeploy solo admite estas regiones.

1. Elija **Crear pila**.

1. En **Elegir una plantilla**, seleccione **Especificar una URL de plantilla de Amazon S3**. En el cuadro, escriba la ubicación de la CloudFormation plantilla para su región y, a continuación, seleccione **Siguiente**.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/codedeploy/latest/userguide/instances-ec2-create-cloudformation-template.html)

1. En el cuadro **Stack name (Nombre de la pila)**, escriba un nombre para la pila (por ejemplo, **CodeDeployDemoStack**).

1. En **Parameters (Parámetros)**, escriba lo siguiente y seleccione **Next (Siguiente)**.
   + Para **InstanceCount**, escriba el número de instancias que desea lanzar. (Le recomendamos que deje el valor predeterminado, **1**).
   + Para **InstanceType**, escriba el tipo de instancia que desee lanzar (o deje **t1.micro** como valor predeterminado).
   + Para **KeyPairName**, escriba el nombre del key pair de la instancia. Escriba solo el nombre del par de claves, no la extensión de archivo del par de claves.
   + En **OperatingSystem**Box, escriba **Windows** para lanzar instancias que ejecuten Windows Server (o deje **Linux** como predeterminado).
   + Para **SSHLocation**, escriba el intervalo de direcciones IP que se utilizará para conectarse a la instancia mediante SSH o RDP (o deje el valor predeterminado **0.0.0.0/0**).
**importante**  
El valor predeterminado de se proporciona únicamente con fines de **0.0.0.0/0** demostración. CodeDeploy no requiere que las instancias de Amazon EC2 tengan acceso ilimitado a los puertos. Es recomendable que restrinja el acceso a los puertos SSH (y HTTP). Para obtener más información, consulte [Sugerencias para proteger la instancia de Amazon EC2](https://aws.amazon.com/articles/1233).
   + Para **TagKey**ello, escriba la etiqueta de instancia que la clave CodeDeploy utilizará para identificar las instancias durante la implementación (o deje el **nombre** predeterminado).
   + Para **TagValue**, escriba el valor de la etiqueta de instancia que CodeDeploy se utilizará para identificar las instancias durante la implementación (o deje el valor predeterminado **CodeDeployDemo**).

1. En la página **Options (Opciones)**, deje las casillas de opción vacías y elija **Next (Siguiente)**.
**importante**  
CloudFormation las etiquetas son diferentes de las CodeDeploy etiquetas. CloudFormation usa etiquetas para simplificar la administración de su infraestructura. CodeDeploy utiliza etiquetas para identificar las instancias de Amazon EC2. Ha especificado etiquetas de CodeDeploy en la página **Specify Parameters (Especificar parámetros)**.

1. **En la página de **revisión**, en **Capacidades**, seleccione la casilla **Acepto que CloudFormation podría crear recursos de IAM** y, a continuación, elija Crear.**

   **Una vez CloudFormation creada la pila y lanzado las instancias de Amazon EC2, en la CloudFormation consola, se mostrará **CREATE\$1COMPLETE** en la columna Estado.** Este proceso puede tardar varios minutos.

Para comprobar que el CodeDeploy agente se está ejecutando en las instancias de Amazon EC2, consulte y, a continuación[Gestión de las operaciones CodeDeploy de los agentes](codedeploy-agent-operations.md), continúe con. [Cree una aplicación con CodeDeploy](applications-create.md)

## Lance una instancia de Amazon EC2 con la CloudFormation plantilla ()AWS CLI
<a name="instances-ec2-create-cloudformation-template-cli"></a>

1. Utilice nuestra CloudFormation plantilla en una llamada al **create-stack** comando. Esta pila lanzará una nueva instancia de Amazon EC2 con el CodeDeploy agente instalado.

   Para lanzar una instancia de Amazon EC2 que ejecute 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 lanzar una instancia de Amazon EC2 que ejecute 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*es el nombre del key pair de la instancia. Escriba solo el nombre del par de claves, no la extensión de archivo del par de claves.

   *template-url*es la ubicación de la CloudFormation plantilla para su región:  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/codedeploy/latest/userguide/instances-ec2-create-cloudformation-template.html)

   Este comando crea una CloudFormation pila denominada**CodeDeployDemoStack**, utilizando la CloudFormation plantilla del bucket de Amazon S3 especificado. La instancia de Amazon EC2 se basa en el tipo de instancia t1.micro, pero puede utilizar cualquier tipo. Está etiquetada con el valor **CodeDeployDemo**, pero se puede etiquetar con cualquier valor. Se le ha aplicado el par de claves de instancia especificado.

1. Llama al **describe-stacks** comando para comprobar que la CloudFormation pila nombrada **CodeDeployDemoStack** se creó correctamente:

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

   No continúe hasta que se devuelva el valor `CREATE_COMPLETE`.

Para comprobar que el CodeDeploy agente se está ejecutando en la instancia Amazon EC2, consulte y, a continuación[Gestión de las operaciones CodeDeploy de los agentes](codedeploy-agent-operations.md), continúe con. [Cree una aplicación con CodeDeploy](applications-create.md)