

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.

# Instale el CodeDeploy agente mediante la línea de comandos
<a name="codedeploy-agent-operations-install-cli"></a>

**nota**  
Se recomienda instalar el CodeDeploy agente con el AWS Systems Manager fin de poder configurar las actualizaciones programadas del agente. Para obtener más información, consulte [Instale el CodeDeploy agente mediante AWS Systems Manager](codedeploy-agent-operations-install-ssm.md).

Utilice los siguientes temas para instalar y ejecutar el CodeDeploy agente mediante la línea de comandos.

**Topics**
+ [Instalar el CodeDeploy agente para Amazon Linux o RHEL](codedeploy-agent-operations-install-linux.md)
+ [Instale el CodeDeploy agente para Ubuntu Server](codedeploy-agent-operations-install-ubuntu.md)
+ [Instale el CodeDeploy agente para Windows Server](codedeploy-agent-operations-install-windows.md)

# Instalar el CodeDeploy agente para Amazon Linux o RHEL
<a name="codedeploy-agent-operations-install-linux"></a>

Inicie sesión en la instancia y ejecute uno a uno los comandos siguientes. Ejecutar primero el comando `sudo yum update` se considera una práctica recomendada cuando se usa `yum` para instalar paquetes, pero puede omitirlo si no desea actualizar todos sus paquetes.

```
sudo yum update
```

```
sudo yum install ruby
```

```
sudo yum install wget
```

(Opcional) Para limpiar la AMI de cualquier información de almacenamiento en caché del agente anterior, ejecute el siguiente script:

```
#!/bin/bash
CODEDEPLOY_BIN="/opt/codedeploy-agent/bin/codedeploy-agent"
$CODEDEPLOY_BIN stop
yum erase codedeploy-agent -y
```

Vaya al directorio de inicio:

```
cd /home/ec2-user
```

**nota**  
En el comando anterior, `/home/ec2-user` representa el nombre de usuario predeterminado de una instancia de Amazon EC2 de Amazon Linux o RHEL. Si la instancia se creó con una AMI personalizada, el propietario de la AMI puede haber especificado otro nombre de usuario predeterminado. 

Descargue el instalador del CodeDeploy agente:

```
wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install
```

*bucket-name*es el nombre del depósito de Amazon S3 que contiene los archivos del kit de CodeDeploy recursos de su región y *region-identifier* es el identificador de su región.

Por ejemplo:

`https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install`

Para obtener una lista de los nombres de buckets e identificadores de región, consulte [Nombres de bucket del kit de recursos por región](resource-kit.md#resource-kit-bucket-names).

Defina los permisos de ejecución en el archivo `install`:

```
chmod +x ./install
```

Para instalar la versión más reciente del CodeDeploy agente:
+ 

  ```
  sudo ./install auto
  ```

Para instalar una versión específica del CodeDeploy agente:
+ Obtenga una lista de versiones disponibles en su región:

  ```
  aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.rpm$'
  ```
+ Instale una de las versiones:

  ```
  sudo ./install auto -v releases/codedeploy-agent-version.noarch.rpm
  ```
**nota**  
AWS admite la última versión secundaria del CodeDeploy agente. Actualmente, la última versión secundaria es la 1.7.x.

Para comprobar que el servicio se está ejecutando, ejecute el siguiente comando:

```
systemctl status codedeploy-agent
```

Si el CodeDeploy agente está instalado y en ejecución, debería aparecer un mensaje como`The AWS CodeDeploy agent is running`.

Si ve un mensaje similar a `error: No AWS CodeDeploy agent running`, inicie el servicio y ejecute uno por uno los dos comandos siguientes:

```
systemctl start codedeploy-agent
```

```
systemctl status codedeploy-agent
```

# Instale el CodeDeploy agente para Ubuntu Server
<a name="codedeploy-agent-operations-install-ubuntu"></a>

**nota**  
Se recomienda instalar el CodeDeploy agente con AWS Systems Manager para poder configurar las actualizaciones programadas del agente. Para obtener más información, consulte [Instale el CodeDeploy agente mediante AWS Systems Manager](codedeploy-agent-operations-install-ssm.md).

**Para instalar el CodeDeploy agente en el servidor Ubuntu**

1. Inicie sesión en la instancia.

1. Introduzca los comandos siguientes, uno tras otro:

   ```
   sudo apt update
   ```

   ```
   sudo apt install ruby-full
   ```

   ```
   sudo apt install wget
   ```

1. Introduzca el siguiente comando:

   ```
   cd /home/ubuntu
   ```

   */home/ubuntu*representa el nombre de usuario predeterminado de una instancia del servidor Ubuntu. Si la instancia se creó con una AMI personalizada, el propietario de la AMI puede haber especificado otro nombre de usuario predeterminado. 

1. Introduzca el siguiente comando:

   ```
   wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install
   ```

   *bucket-name*es el nombre del depósito de Amazon S3 que contiene los archivos del kit de CodeDeploy recursos de su región y *region-identifier* es el identificador de su región.

   Por ejemplo:

   `https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install`

   Para obtener una lista de los nombres de buckets e identificadores de región, consulte [Nombres de bucket del kit de recursos por región](resource-kit.md#resource-kit-bucket-names).

1. Introduzca el siguiente comando:

   ```
   chmod +x ./install
   ```

1. Realice una de las siguientes acciones:
   + Para instalar la última versión del CodeDeploy agente en cualquier versión compatible de Ubuntu Server, *excepto* la 20.04:

     ```
     sudo ./install auto
     ```
   + Para instalar la última versión del CodeDeploy agente en Ubuntu Server 20.04:
**nota**  
Escribir el resultado en un archivo de registro temporal es una solución alternativa que debería utilizarse mientras solucionamos un error conocido en el script `install` de Ubuntu Server 20.04.

     ```
     sudo ./install auto > /tmp/logfile
     ```
   + Para instalar una versión específica del CodeDeploy agente en cualquier versión compatible de Ubuntu Server, *excepto la 20.04*:
     + Obtenga una lista de versiones disponibles en su región:

       ```
       aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$'
       ```
     + Instale una de las versiones:

       ```
       sudo ./install auto -v releases/codedeploy-agent-###.deb
       ```
**nota**  
AWS es compatible con la última versión secundaria del CodeDeploy agente. Actualmente, la última versión secundaria es la 1.7.x.
   + Para instalar una versión específica del CodeDeploy agente en Ubuntu Server 20.04:
     + Obtenga una lista de versiones disponibles en su región:

       ```
       aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$'
       ```
     + Instale una de las versiones:

       ```
       sudo ./install auto -v releases/codedeploy-agent-###.deb > /tmp/logfile
       ```
**nota**  
Escribir el resultado en un archivo de registro temporal es una solución alternativa que debería utilizarse mientras solucionamos un error conocido en el script `install` de Ubuntu Server 20.04.
**nota**  
AWS admite la última versión secundaria del CodeDeploy agente. Actualmente, la última versión secundaria es la 1.7.x.

**Para comprobar que el servicio está en ejecución**

1. Introduzca el siguiente comando:

   ```
   systemctl status codedeploy-agent
   ```

   Si el CodeDeploy agente está instalado y en ejecución, debería aparecer un mensaje como`The AWS CodeDeploy agent is running`.

1. Si ve un mensaje similar a `error: No AWS CodeDeploy agent running`, inicie el servicio y ejecute uno por uno los dos comandos siguientes:

   ```
   systemctl start codedeploy-agent
   ```

   ```
   systemctl status codedeploy-agent
   ```

# Instale el CodeDeploy agente para Windows Server
<a name="codedeploy-agent-operations-install-windows"></a>

En las instancias de Windows Server, puede usar uno de estos métodos para descargar e instalar el CodeDeploy agente:
+ Uso AWS Systems Manager (recomendado)
+ Ejecute una serie de PowerShell comandos de Windows.
+ Elegir un enlace de descarga directa.
+ Ejecutar un comando copy de Amazon S3.

**nota**  
La carpeta en la que está instalado el CodeDeploy agente es`C:\Program Data\Amazon\CodeDeploy`. Asegúrese de que no haya nudos de directorio ni enlaces simbólicos en esta ruta.

**Topics**
+ [Uso de Systems Manager](#codedeploy-agent-operations-install-system-manager)
+ [Utilice Windows PowerShell](#codedeploy-agent-operations-install-windows-powershell)
+ [Uso de un enlace directo](#codedeploy-agent-operations-install-windows-direct-link)
+ [Uso de un comando copy de Amazon S3](#codedeploy-agent-operations-install-windows-s3-copy)

## Uso de Systems Manager
<a name="codedeploy-agent-operations-install-system-manager"></a>

Siga las instrucciones [Instale el CodeDeploy agente mediante AWS Systems Manager](codedeploy-agent-operations-install-ssm.md) para instalar el CodeDeploy agente.

## Utilice Windows PowerShell
<a name="codedeploy-agent-operations-install-windows-powershell"></a>

Inicia sesión en la instancia y ejecuta los siguientes comandos en Windows PowerShell:

1.  Es necesario que todos los scripts y archivos de configuración que se hayan descargado de Internet estén firmados por un editor de confianza. Si se le pide que cambie la política de ejecución, escriba "**Y**". 

   ```
    Set-ExecutionPolicy RemoteSigned
   ```

1.  Carga el AWS Tools for Windows PowerShell. 

   ```
   Import-Module AWSPowerShell
   ```

1.  Cree un directorio en el que se descargue el archivo de instalación del CodeDeploy agente. 

   ```
   New-Item -Path "c:\temp" -ItemType "directory" -Force
   ```

1. Configure AWS las credenciales mediante los `Initialize-AWSDefaultConfiguration` comandos `Set-AWSCredential` y. Para obtener más información, consulte [Uso de AWS credenciales](https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html) en la *Guía del PowerShell usuario de AWS las herramientas*.

1.  Descargue el archivo CodeDeploy de instalación del agente. 
**nota**  
AWS es compatible con la última versión secundaria del CodeDeploy agente. Actualmente, la última versión secundaria es la 1.7.x.

   Para instalar la versión más reciente del CodeDeploy agente:
   + 

     ```
     powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi
     ```

   Para instalar una versión específica del CodeDeploy agente:
   + 

     ```
     powershell.exe -Command Read-S3Object -BucketName bucket-name -Key releases/codedeploy-agent-###.msi -File c:\temp\codedeploy-agent.msi
     ```

   *bucket-name*es el nombre del depósito de Amazon S3 que contiene los archivos del kit de CodeDeploy recursos de su región. Por ejemplo, para la región EE.UU. Este (Ohio), *bucket-name* sustitúyala por`aws-codedeploy-us-east-2`. Para obtener una lista de los nombres de los buckets, consulte [Nombres de bucket del kit de recursos por región](resource-kit.md#resource-kit-bucket-names).

1.  Ejecute el archivo de instalación del CodeDeploy agente. 

   ```
   c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt
   ```

Para comprobar que el servicio se está ejecutando, ejecute el siguiente comando:

```
powershell.exe -Command Get-Service -Name codedeployagent
```

 Si el CodeDeploy agente se acaba de instalar y no se ha iniciado, después de ejecutar el **Get-Service** comando, en **Estado**, debería ver**Start...**:

```
Status     Name                DisplayName
------     ----                -----------
Start...   codedeployagent    CodeDeploy Host Agent Service
```

Si el CodeDeploy agente ya se está ejecutando, después de ejecutar el **Get-Service** comando, en **Estado**, debería ver**Running**:

```
Status     Name                DisplayName
------     ----                -----------
Running    codedeployagent    CodeDeploy Host Agent Service
```

## Uso de un enlace directo
<a name="codedeploy-agent-operations-install-windows-direct-link"></a>

Si la configuración de seguridad del navegador de la instancia de Windows Server proporciona los permisos (por ejemplo, para`https://s3.*.amazonaws.com`), puede utilizar un enlace directo a su región para descargar el CodeDeploy agente y, a continuación, ejecutar el instalador manualmente.

El enlace es:

```
https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent.msi
```

... dónde *region* está la AWS región en la que va a implementar la aplicación.

Por ejemplo:

```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent.msi
```

**importante**  
Obtenga el `.msi` archivo de la misma región que su CodeDeploy aplicación. La elección de una región diferente puede provocar errores de `inconsistent region` en el archivo `codedeploy-agent-log` al ejecutar el archivo `.msi`.

## Uso de un comando copy de Amazon S3
<a name="codedeploy-agent-operations-install-windows-s3-copy"></a>

Si AWS CLI está instalado en la instancia, puede usar el comando [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) de Amazon S3 para descargar el CodeDeploy agente y, a continuación, ejecutar el instalador manualmente. Para obtener más información, consulte [Instalar AWS Command Line Interface en Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html). 

El comando de Amazon S3 es:

```
aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent.msi codedeploy-agent.msi --region region
```

... dónde *region* está la AWS región en la que va a implementar la aplicación.

Por ejemplo:

```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi --region af-south-1
```