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 agente CodeDeploy
Para usarlo CodeDeploy en instancias EC2 o servidores locales, primero se debe instalar el CodeDeploy agente. Se recomienda instalar y actualizar el CodeDeploy agente con. AWS Systems Manager Para obtener más información acerca de Systems Manager, consulte [¿Qué es AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html). Puede configurar la instalación y las actualizaciones programadas del CodeDeploy agente con Systems Manager en la consola al crear los grupos de despliegue.
También puede instalar el CodeDeploy agente directamente desde un bucket de S3 con la línea de comandos.
Para obtener información sobre la versión que se recomienda instalar, consulte [Historial de versiones del agente CodeDeploy](codedeploy-agent.md#codedeploy-agent-version-history).
**Topics**
+ [
# Instale el CodeDeploy agente mediante AWS Systems Manager
](codedeploy-agent-operations-install-ssm.md)
+ [
# Instale el CodeDeploy agente mediante la línea de comandos
](codedeploy-agent-operations-install-cli.md)
# Instale el CodeDeploy agente mediante AWS Systems Manager
Puede usar Consola de administración de AWS o AWS CLI para instalar el CodeDeploy agente en sus instancias de Amazon EC2 o locales mediante. AWS Systems Manager Puede elegir entre instalar una versión específica o instalar siempre la última versión del agente. Para obtener más información AWS Systems Manager, consulte [Qué es](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html). AWS Systems Manager
Se AWS Systems Manager recomienda utilizar el método para instalar y actualizar el CodeDeploy agente. También puede instalar el CodeDeploy agente desde un bucket de Amazon S3. Para obtener más información acerca del uso del enlace de descarga de Amazon S3, consulte [Instale el CodeDeploy agente mediante la línea de comandos](codedeploy-agent-operations-install-cli.md).
**Topics**
+ [
## Requisitos previos
](#install-codedeploy-agent-prereqs)
+ [
## Instale el agente CodeDeploy
](#download-codedeploy-agent-on-EC2-Instance)
## Requisitos previos
Siga los pasos de [Empezar con CodeDeploy](getting-started-codedeploy.md) para configurar los permisos de IAM y la AWS CLI.
Si va a instalar el CodeDeploy agente en un servidor local con Systems Manager, debe registrar el servidor local con Amazon EC2 Systems Manager. Para obtener más información, consulte [Configuración de Systems Manager en entornos híbridos](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html) en la *Guía del usuario de AWS Systems Manager *.
## Instale el agente CodeDeploy
Antes de poder usar Systems Manager para instalar el CodeDeploy agente, debe asegurarse de que la instancia está configurada correctamente para Systems Manager.
### Instalación o actualización del agente de SSM
En una instancia Amazon EC2, el CodeDeploy agente requiere que la instancia ejecute la versión 2.3.274.0 o posterior. Antes de instalar el CodeDeploy agente, actualice o instale el agente SSM en la instancia si aún no lo ha hecho.
El agente SSM viene preinstalado en algunos Amazon AMIs EC2 proporcionados por. AWS Para obtener más información, consulte [Amazon Machine Images (AMIs) con el agente SSM preinstalado](https://docs.aws.amazon.com/systems-manager/latest/userguide/ami-preinstalled-agent.html).
**nota**
Asegúrese de que el agente también admita el sistema operativo de la CodeDeploy instancia. Para obtener más información, consulte [Sistemas operativos compatibles con el agente CodeDeploy](codedeploy-agent.md#codedeploy-agent-supported-operating-systems).
Para obtener información sobre la instalación o actualización del agente de SSM en una instancia con Linux, consulte [Instalación y configuración del agente de SSM en instancias de Linux](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-agent.html) en la *Guía del usuario de AWS Systems Manager *.
Para obtener información acerca de la instalación o la actualización del agente de SSM en una instancia con Windows Server, consulte [Instalación y configuración del agente de SSM en instancias de Windows](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-ssm-win.html) en la *Guía del usuario de AWS Systems Manager *.
### (Opcional) Verificación de los requisitos previos de Systems Manager
Antes de usar Systems Manager Run Command para instalar el CodeDeploy agente, compruebe que las instancias cumplen los requisitos mínimos de Systems Manager. Para obtener más información, consulte [Configuración de AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up.html) en la *Guía del usuario de AWS Systems Manager *.
### Instale el CodeDeploy agente
Con SSM, puede instalarlo CodeDeploy una vez o programar la instalación de nuevas versiones.
Para instalar el CodeDeploy agente, elija el `AWSCodeDeployAgent` paquete siguiendo los pasos que se indican en [Instalar o actualizar paquetes con el AWS Systems Manager distribuidor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html).
# Instale el CodeDeploy agente mediante la línea de comandos
**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
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
**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
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
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
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
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
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
```