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.
# Cree una instancia de Amazon EC2 para CodeDeploy (AWS CLI o una consola Amazon EC2)
Estas instrucciones le muestran cómo lanzar una nueva instancia de Amazon EC2 configurada para su uso en CodeDeploy implementaciones.
Puede utilizar nuestra CloudFormation plantilla para lanzar una instancia de Amazon EC2 que ejecute Amazon Linux o Windows Server y que ya esté configurada para su uso en CodeDeploy las implementaciones. No proporcionamos una CloudFormation plantilla para las instancias de Amazon EC2 que ejecutan Ubuntu Server o Red Hat Enterprise Linux (RHEL). Si desea conocer otras alternativas al uso de la plantilla, consulte [Trabajar con instancias para CodeDeploy](instances.md).
Puede utilizar la consola Amazon EC2 o las API de Amazon EC2 para lanzar una instancia de Amazon EC2. AWS CLI
## Lanzamiento de una instancia de Amazon EC2 (consola)
### Requisitos previos
Si aún no lo ha hecho, siga las instrucciones [Empezar con CodeDeploy](getting-started-codedeploy.md) para configurar AWS CLI y crear un perfil de instancia de IAM.
### Lanzamiento de una instancia de Amazon EC2
1. Inicie sesión en la consola Amazon EC2 Consola de administración de AWS y ábrala en. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. En el panel de navegación, elija **Instances (Instancias)** y seleccione **Launch Instance (Lanzar instancia)**.
1. En la página **Step 1: Choose an Amazon Machine Image (AMI) (Paso 1: Elegir una imagen de máquina de Amazon [AMI])** de la pestaña **Quick Start (Inicio rápido)**, busque el sistema operativo y la versión que quiera usar y luego elija **Select (Seleccionar)**. Debe elegir un sistema operativo AMI Amazon EC2 compatible con. CodeDeploy Para obtener más información, consulte [Sistemas operativos compatibles con el agente CodeDeploy](codedeploy-agent.md#codedeploy-agent-supported-operating-systems).
1. En la página **Paso 2: Elegir un tipo de instancia**, elija cualquier tipo de instancia de Amazon EC2 disponible y seleccione **Siguiente: Configurar los detalles de la instancia**.
1. En la página **Paso 3: Configurar los detalles de la instancia**, en la lista **IAM role** (Rol de IAM), elija el rol de instancia que ha creado en [Paso 4: Crear un perfil de instancia de IAM para las instancias de Amazon EC2](getting-started-create-iam-instance-profile.md). Si ha utilizado el nombre de rol sugerido, elija **CodeDeployDemo-EC2-Instance-Profile**. Si ha creado su propio nombre de rol, selecciónelo.
**nota**
Si una nube privada virtual (VPC) predeterminada no aparece en la lista **Red**, debe elegir o crear una VPC y una subred de Amazon. Elija **Crear nueva VPC** o **Crear nueva subred** o ambas opciones. Para obtener más información, consulte [VPC y subredes](https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html).
1. Elija **Siguiente: Agregar almacenamiento**.
1. Deje la página **Paso 4: Agregar almacenamiento** sin cambiar y elija **Siguiente: Añadir etiquetas**.
1. En la página **Paso 5: Añadir etiquetas**, elija **Añadir etiqueta**.
1. En el cuadro **Clave**, escriba **Name**. En el cuadro **Valor**, escriba **CodeDeployDemo**.
**importante**
El contenido de los cuadros **Clave** y **Valor** distingue entre mayúsculas y minúsculas.
1. Elija **Siguiente: Configurar un grupo de seguridad**.
1. En la página **Paso 6: Configurar un grupo de seguridad**, deje la opción **Crear un grupo de seguridad nuevo** seleccionada.
Se configura un rol de SSH predeterminado para instancias de Amazon EC2 que ejecutan Amazon Linux, Ubuntu Server o RHEL. Se configura un rol de RDP predeterminado para instancias de Amazon EC2 que ejecutan Windows Server.
1. Si desea abrir el puerto HTTP, elija el botón **Add Rule (Añadir regla)** y en la lista desplegable **Type (Tipo)**, elija **HTTP**. Acepte el valor **Source (Origen)** predeterminado de **Custom 0.0.0.0/0 (Personalizado 0.0.0.0/0)** y luego elija **Review and Launch (Revisar y lanzar)**.
**nota**
**En un entorno de producción, recomendamos restringir el acceso a los puertos SSH, RDP y HTTP, en lugar de especificar Anywhere 0.0.0.0/0.** CodeDeploy no requiere acceso a los puertos sin restricciones ni acceso HTTP. Para obtener más información, consulte [Sugerencias para proteger la instancia de Amazon EC2](https://aws.amazon.com/articles/1233).
Si aparece el cuadro de diálogo **Boot from General Purpose (SSD) (Arrancar desde uso general [SSD])**, siga las instrucciones y luego seleccione **Next (Siguiente)**.
1. Deje la página **Step 7: Review Instance Launch (Paso 7: Revisar el lanzamiento de la instancia)** sin cambiar y elija **Launch (Lanzar)**.
1. En el cuadro de diálogo **Select an existing key pair or create a new key pair (Seleccionar par de claves existentes o crear nuevo par de claves)**, elija **Choose an existing key pair (Elegir un par de claves existente)** o **Create a new key pair (Crear un nuevo par de claves)**. Si ya ha configurado un par de claves de la instancia de Amazon EC2, puede elegirlo aquí.
Si aún no tiene un par de claves de instancia de Amazon EC2, elija **Create a new key pair (Crear un nuevo par de claves)** y asígnele un nombre fácil de reconocer. Elija **Descargar par de claves** para descargar el par de claves de la instancia de Amazon EC2 en su equipo.
**importante**
Debe disponer de un par de claves si desea obtener acceso a su instancia de Amazon EC2 con SSH o RDP.
1. Elija **Iniciar instancias**.
1. Elija el ID de su instancia de Amazon EC2. No continúe hasta que la instancia se haya lanzado y haya superado todas las comprobaciones.
### Instale el agente CodeDeploy
El CodeDeploy agente debe estar instalado en la instancia de Amazon EC2 antes de usarlo en CodeDeploy las implementaciones. Para obtener más información, consulte [Instale el agente CodeDeploy](codedeploy-agent-operations-install.md).
**nota**
Puede configurar la instalación y las actualizaciones automáticas del CodeDeploy agente al crear el grupo de implementación en la consola.
## Lanzamiento de una instancia de Amazon EC2 (CLI)
### Requisitos previos
Si aún no lo ha hecho, siga las instrucciones [Empezar con CodeDeploy](getting-started-codedeploy.md) para configurar AWS CLI y crear un perfil de instancia de IAM.
### Lanzamiento de una instancia de Amazon EC2
1. **Solo para Windows Server** Si va a crear una instancia de Amazon EC2 que ejecuta Windows Server, llame a los comandos **create-security-group** y **authorize-security-group-ingress** para crear un grupo de seguridad que permita el acceso RDP (que no se permite de forma predeterminada) y, en su caso, el acceso HTTP. Por ejemplo, para crear un grupo de seguridad denominado *CodeDeployDemo-Windows-Security-Group*, ejecute los siguientes comandos, de uno en uno:
```
aws ec2 create-security-group --group-name CodeDeployDemo-Windows-Security-Group --description "For launching Windows Server images for use with CodeDeploy"
```
```
aws ec2 authorize-security-group-ingress --group-name CodeDeployDemo-Windows-Security-Group --to-port 3389 --ip-protocol tcp --cidr-ip 0.0.0.0/0 --from-port 3389
```
```
aws ec2 authorize-security-group-ingress --group-name CodeDeployDemo-Windows-Security-Group --to-port 80 --ip-protocol tcp --cidr-ip 0.0.0.0/0 --from-port 80
```
**nota**
Para fines de demostración, estos comandos crean un grupo de seguridad que permite acceso ilimitado a RDP a través del puerto 3389 y, en su caso, a HTTP a través del puerto 80. Es recomendable que restrinja el acceso a los puertos HTTP y RDP. CodeDeploy no requiere acceso ilimitado a los puertos y no requiere acceso HTTP. Para obtener más información, consulte [Sugerencias para proteger la instancia de Amazon EC2](https://aws.amazon.com/articles/1233).
1. Llame al comando **run-instances** para crear y lanzar la instancia de Amazon EC2.
Antes de llamar a este comando, debe recopilar lo siguiente:
+ El ID de una imagen de máquina de Amazon (AMI) (*ami-id*) que utilizas para la instancia. Para obtener el ID, consulte [Búsqueda de una AMI de Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/finding-an-ami.html).
+ El nombre del tipo de instancia de Amazon EC2 (*instance-type*) que cree, por ejemplo. `t1.micro` Para ver una lista, consulte [Tipos de instancias de Amazon EC2](https://aws.amazon.com/ec2/instance-types/).
+ El nombre de un perfil de instancia de IAM con permiso para acceder al bucket de Amazon S3 donde se almacenan los archivos de instalación del CodeDeploy agente de su región.
Para obtener información sobre la creación de un perfil de instancia de IAM, consulte [Paso 4: Crear un perfil de instancia de IAM para las instancias de Amazon EC2](getting-started-create-iam-instance-profile.md).
+ El nombre de un par de claves de instancia de Amazon EC2 (*key-name*) para permitir el acceso SSH a una instancia de Amazon EC2 que ejecute Amazon Linux, Ubuntu Server o el acceso RHEL o RDP a una instancia de Amazon EC2 que ejecute Windows Server.
**importante**
Escriba solo el nombre del par de claves, no la extensión de archivo del par de claves. Por ejemplo, *my-keypair*, no *my-keypair.pem*.
[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 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). Compruebe que crea el par de claves en una de las regiones que se encuentran en la lista de [Regiones y puntos de enlace](https://docs.aws.amazon.com/general/latest/gr/rande.html#codedeploy_region) de la *Referencia general de AWS*. De lo contrario, no podrá utilizar el par de claves de instancia de Amazon EC2 con. CodeDeploy
**Para Amazon Linux, RHEL y Ubuntu Server**
Para llamar al comando **run-instances** para lanzar una instancia de Amazon EC2 que ejecuta Amazon Linux, Ubuntu Server o RHEL y adjuntar el perfil de instancia de IAM que creó en [Paso 4: Crear un perfil de instancia de IAM para las instancias de Amazon EC2](getting-started-create-iam-instance-profile.md). Por ejemplo:
```
aws ec2 run-instances \
--image-id ami-id \
--key-name key-name \
--count 1 \
--instance-type instance-type \
--iam-instance-profile Name=iam-instance-profile
```
**nota**
Este comando crea un grupo de seguridad predeterminado para la instancia de Amazon EC2 que permite el acceso a varios puertos, incluido acceso ilimitado a SSH a través del puerto 22 y, en su caso, a HTTP a través del puerto 80. Como práctica recomendada, recomendamos restringir el acceso únicamente a los puertos SSH y HTTP. CodeDeploy no requiere acceso a los puertos sin restricciones ni acceso a los puertos HTTP. Para obtener más información, consulte [Sugerencias para proteger la instancia de Amazon EC2](https://aws.amazon.com/articles/1233).
**Para Windows Server**
Para llamar al comando **run-instances** y lanzar una instancia de Amazon EC2 ejecutando Windows Server, así como adjuntar el perfil de instancia de IAM que ha creado en [Paso 4: Crear un perfil de instancia de IAM para las instancias de Amazon EC2](getting-started-create-iam-instance-profile.md) y especificar el nombre del grupo de seguridad que ha creado en el paso 1. Por ejemplo:
```
aws ec2 run-instances --image-id ami-id --key-name key-name --count 1 --instance-type instance-type --iam-instance-profile Name=iam-instance-profile --security-groups CodeDeploy-Windows-Security-Group
```
Estos comandos lanzan una sola instancia de Amazon EC2 con la AMI, el par de claves y el tipo de instancia especificados, con el perfil de instancia de IAM indicado, y ejecutan el script especificado durante el lanzamiento.
1. Anote el valor de `InstanceID` en la salida. Si olvida este valor, puede obtenerlo más tarde si llama al comando **describe-instances** con el par de claves de la instancia de Amazon EC2.
```
aws ec2 describe-instances --filters "Name=key-name,Values=keyName" --query "Reservations[*].Instances[*].[InstanceId]" --output text
```
Use el ID de instancia para llamar al **create-tags** comando, que etiqueta la instancia de Amazon EC2 para que CodeDeploy pueda encontrarla más adelante durante una implementación. En el siguiente ejemplo, la etiqueta se denomina **CodeDeployDemo**, pero puede especificar cualquier etiqueta de instancia de Amazon EC2 que desee.
```
aws ec2 create-tags --resources instance-id --tags Key=Name,Value=CodeDeployDemo
```
Puede aplicar varias etiquetas a una instancia al mismo tiempo. Por ejemplo:
```
aws ec2 create-tags --resources instance-id --tags Key=Name,Value=testInstance Key=Region,Value=West Key=Environment,Value=Beta
```
Para verificar que la instancia de Amazon EC2 se ha lanzado y ha superado todas las comprobaciones, utilice el ID de instancia para llamar al comando **describe-instance-status**.
```
aws ec2 describe-instance-status --instance-ids instance-id --query "InstanceStatuses[*].InstanceStatus.[Status]" --output text
```
Si la instancia se ha lanzado y ha superado todas las comprobaciones, aparece `ok` en la salida:
### Instale el agente CodeDeploy
El CodeDeploy agente debe estar instalado en la instancia de Amazon EC2 antes de usarlo en CodeDeploy las implementaciones. Para obtener más información, consulte [Instale el agente CodeDeploy](codedeploy-agent-operations-install.md).
**nota**
Puede configurar la instalación y las actualizaciones automáticas del CodeDeploy agente al crear el grupo de implementación en la consola.