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.
# Gestión de las operaciones CodeDeploy de los agentes
Las instrucciones de esta sección muestran cómo instalar, desinstalar, reinstalar o actualizar el CodeDeploy agente y cómo comprobar que el CodeDeploy agente se está ejecutando.
**Topics**
+ [Compruebe que el CodeDeploy agente se esté ejecutando](codedeploy-agent-operations-verify.md)
+ [Determine la versión del CodeDeploy agente](codedeploy-agent-operations-version.md)
+ [Instale el agente CodeDeploy](codedeploy-agent-operations-install.md)
+ [Actualice el CodeDeploy agente](codedeploy-agent-operations-update.md)
+ [Desinstale el CodeDeploy agente](codedeploy-agent-operations-uninstall.md)
+ [Enviar los registros CodeDeploy de los agentes a CloudWatch](codedeploy-agent-operations-cloudwatch-agent.md)
# Compruebe que el CodeDeploy agente se esté ejecutando
En esta sección, se describen los comandos que se deben ejecutar si sospecha que el CodeDeploy agente ha dejado de ejecutarse en una instancia.
**Topics**
+ [Compruebe que el CodeDeploy agente de Amazon Linux o RHEL se esté ejecutando](#codedeploy-agent-operations-verify-linux)
+ [Compruebe que el CodeDeploy agente del servidor Ubuntu esté en ejecución](#codedeploy-agent-operations-verify-ubuntu)
+ [Compruebe que el CodeDeploy agente de Windows Server se esté ejecutando](#codedeploy-agent-operations-verify-windows)
## Compruebe que el CodeDeploy agente de Amazon Linux o RHEL se esté ejecutando
Para comprobar si el CodeDeploy agente está instalado y en ejecución, inicie sesión en la instancia y ejecute el siguiente comando:
```
systemctl status codedeploy-agent
```
Si el comando devuelve un error, significa que el CodeDeploy agente no está instalado. Instálelo como se describe en [Instalar el CodeDeploy agente para Amazon Linux o RHEL](codedeploy-agent-operations-install-linux.md).
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
```
## Compruebe que el CodeDeploy agente del servidor Ubuntu esté en ejecución
Para comprobar si el CodeDeploy agente está instalado y en ejecución, inicia sesión en la instancia y ejecuta el siguiente comando:
```
systemctl status codedeploy-agent
```
Si el comando devuelve un error, significa que el CodeDeploy agente no está instalado. Instálelo como se describe en [Instale el CodeDeploy agente para Ubuntu Server](codedeploy-agent-operations-install-ubuntu.md).
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
```
## Compruebe que el CodeDeploy agente de Windows Server se esté ejecutando
Para comprobar si el CodeDeploy agente está instalado y en ejecución, inicia sesión en la instancia y ejecuta el siguiente comando:
```
powershell.exe -Command Get-Service -Name codedeployagent
```
Debería ver una salida similar a esta:
```
Status Name DisplayName
------ ---- -----------
Running codedeployagent CodeDeploy Host Agent Service
```
Si el comando devuelve un error, significa que el CodeDeploy agente no está instalado. Instálelo como se describe en [Instale el CodeDeploy agente para Windows Server](codedeploy-agent-operations-install-windows.md).
Si `Status` muestra algo distinto de `Running`, inicie el servicio con el comando siguiente:
```
powershell.exe -Command Start-Service -Name codedeployagent
```
Puede reiniciar el servicio con el comando siguiente:
```
powershell.exe -Command Restart-Service -Name codedeployagent
```
Puede detener el servicio con el comando siguiente:
```
powershell.exe -Command Stop-Service -Name codedeployagent
```
# Determine la versión del CodeDeploy agente
Puedes determinar la versión del CodeDeploy agente que se ejecuta en tu instancia de dos maneras.
En primer lugar, a partir de la versión 1.0.1.854 del CodeDeploy agente, puede ver el número de versión en un `.version` archivo de la instancia. La tabla siguiente muestra la ubicación y un ejemplo de cadena de versión para los distintos sistemas operativos compatibles.
| Sistema operativo | Ubicación del archivo | Ejemplo de cadena agent\$1version |
| --- | --- | --- |
| Amazon Linux y Red Hat Enterprise Linux (RHEL) | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1rpm |
| Servidor Ubuntu | /opt/codedeploy-agent/.version | OFFICIAL\$11.0.1.854\$1deb |
| Windows Server | C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1.version | OFFICIAL\$11.0.1.854\$1msi |
La segunda consiste en ejecutar un comando en una instancia para determinar la versión del agente de CodeDeploy.
**Topics**
+ [Determinación de la versión en Amazon Linux o RHEL](#codedeploy-agent-operations-version-linux)
+ [Determinación de la versión en Ubuntu Server](#codedeploy-agent-operations-version-ubuntu)
+ [Determinación de la versión en Windows Server](#codedeploy-agent-operations-version-windows)
## Determinación de la versión en Amazon Linux o RHEL
Inicie sesión en la instancia y ejecute el comando siguiente:
```
sudo yum info codedeploy-agent
```
## Determinación de la versión en Ubuntu Server
Inicie sesión en la instancia y ejecute el comando siguiente:
```
sudo dpkg -s codedeploy-agent
```
## Determinación de la versión en Windows Server
Inicie sesión en la instancia y ejecute el comando siguiente:
```
sc qdescription codedeployagent
```
# 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
```
# Actualice el CodeDeploy agente
Puede configurar las actualizaciones automáticas y programadas del CodeDeploy agente en todos los sistemas operativos compatibles mediante AWS Systems Manager. También puede forzar las actualizaciones en todos los sistemas operativos compatibles ejecutando un comando en una instancia.
**Topics**
+ [Actualizar el CodeDeploy agente en Amazon Linux o RHEL](codedeploy-agent-operations-update-linux.md)
+ [Actualiza el CodeDeploy agente en el servidor Ubuntu](codedeploy-agent-operations-update-ubuntu.md)
+ [Actualice el CodeDeploy agente en Windows Server](codedeploy-agent-operations-update-windows.md)
# Actualizar el CodeDeploy agente en Amazon Linux o RHEL
Para configurar las actualizaciones automáticas y programadas del CodeDeploy agente mediante AWS Systems Manager, siga los pasos que se indican en [Instalar el CodeDeploy agente con AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html).
Si quieres forzar una actualización del CodeDeploy agente, inicia sesión en la instancia y ejecuta el siguiente comando:
```
sudo /opt/codedeploy-agent/bin/install auto
```
# Actualiza el CodeDeploy agente en el servidor Ubuntu
Para configurar las actualizaciones automáticas y programadas del CodeDeploy agente mediante AWS Systems Manager, siga los pasos que se indican en [Instalar el CodeDeploy agente con AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html).
Si quieres forzar una actualización del CodeDeploy agente, inicia sesión en la instancia y ejecuta el siguiente comando:
```
sudo /opt/codedeploy-agent/bin/install auto
```
# Actualice el CodeDeploy agente en Windows Server
Puede activar las actualizaciones automáticas del CodeDeploy agente con AWS Systems Manager. Utilice State Manager para configurar una programación de actualización de las instancias de Amazon EC2 o en las instalaciones mediante la creación de una asociación con el Administrador de estados de Systems Manager. También puede actualizar el CodeDeploy agente manualmente desinstalando la versión actual e instalando una más reciente.
**Topics**
+ [Configure la actualización automática CodeDeploy del agente con AWS Systems Manager](#codedeploy-agent-operations-update-windows-ssm)
+ [Actualice el CodeDeploy agente manualmente](#codedeploy-agent-operations-update-windows-manual)
+ [(Obsoleto) Actualice el CodeDeploy agente con Windows Server Updater](#codedeploy-agent-operations-update-windows-updater)
## Configure la actualización automática CodeDeploy del agente con AWS Systems Manager
Para configurar Systems Manager y activar las actualizaciones automáticas del CodeDeploy agente, siga las instrucciones de [Instalar el CodeDeploy agente mediante AWS Systems Manager](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install-ssm.html).
## Actualice el CodeDeploy agente manualmente
Para actualizar el CodeDeploy agente manualmente, puede instalar la última versión desde la CLI o mediante Systems Manager. Siga las instrucciones descritas en [Instalación del agente de CodeDeploy](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-install.html). Se recomienda desinstalar las versiones anteriores del CodeDeploy agente siguiendo las instrucciones de [Desinstalar el CodeDeploy agente](https://docs.aws.amazon.com/codedeploy/latest/userguide/codedeploy-agent-operations-uninstall.html).
## (Obsoleto) Actualice el CodeDeploy agente con Windows Server Updater
**nota**
El actualizador de CodeDeploy agentes para Windows Server está obsoleto y no se actualizará a ninguna versión posterior a la 1.0.1.1597.
Para habilitar las actualizaciones automáticas del CodeDeploy agente, instale el actualizador de CodeDeploy agentes para Windows Server en instancias nuevas o existentes. El actualizador comprueba periódicamente si existen versiones nuevas. Cuando detecta una versión nueva del agente, el actualizador desinstala la versión actual, si la hay, antes de instalar la última versión.
Si una implementación ya está en curso cuando el actualizador detecta una nueva versión, continuará hasta su finalización. Si se intenta iniciar una implementación durante el proceso de actualización, la implementación falla.
Si quiere forzar una actualización del CodeDeploy agente, siga las instrucciones que se indican en[Instale el CodeDeploy agente para Windows Server](codedeploy-agent-operations-install-windows.md).
En las instancias de Windows Server, puede descargar e instalar el actualizador de CodeDeploy agentes ejecutando PowerShell comandos de Windows, utilizando un enlace de descarga directa o ejecutando un comando de copia de Amazon S3.
**Topics**
+ [Utilice Windows PowerShell](#codedeploy-agent-operations-update-windows-powershell)
+ [Uso de un enlace directo](#codedeploy-agent-operations-update-windows-direct-link)
+ [Uso de un comando copy de Amazon S3](#codedeploy-agent-operations-update-windows-s3-copy)
### Utilice Windows PowerShell
Inicia sesión en la instancia y ejecuta los siguientes comandos en Windows PowerShell, de uno en uno:
```
Set-ExecutionPolicy RemoteSigned
```
Si se te pide que cambies la política de ejecución, elige **Y** que Windows PowerShell requiera que todos los scripts y archivos de configuración descargados de Internet estén firmados por un editor de confianza.
```
Import-Module AWSPowerShell
```
```
New-Item -Path "c:\temp" -ItemType "directory" -Force
```
```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent-updater.msi -File c:\temp\codedeploy-agent-updater.msi
```
```
c:\temp\codedeploy-agent-updater.msi /quiet /l c:\temp\host-agent-updater-log.txt
```
```
powershell.exe -Command Get-Service -Name codedeployagent
```
*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).
Si necesita solucionar un error en el proceso de actualización, escriba el siguiente comando para abrir el archivo de registro del actualizador del CodeDeploy agente:
```
notepad C:\ProgramData\Amazon\CodeDeployUpdater\log\codedeploy-agent.updater.log
```
### Uso de un enlace directo
Si la configuración de seguridad del navegador de la instancia de Windows Server proporciona los permisos necesarios (por ejemplo, para ` http://s3.*.amazonaws.com `), puede utilizar un enlace directo para descargar el CodeDeploy actualizador del agente.
El enlace es:
```
https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent-updater.msi
```
... dónde *region* está la AWS región en la que vas a actualizar la aplicación.
Por ejemplo:
```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.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 actualizador del 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-updater.msi codedeploy-agent-updater.msi --region region
```
... dónde *region* está la AWS región en la que está actualizando la aplicación.
Por ejemplo:
```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent-updater.msi codedeploy-agent-updater.msi --region af-south-1
```
# Desinstale el CodeDeploy agente
Puede eliminar el CodeDeploy agente de las instancias cuando ya no lo necesite o cuando desee realizar una instalación nueva.
## Desinstalar el CodeDeploy agente de Amazon Linux o RHEL
Para desinstalar el CodeDeploy agente, inicie sesión en la instancia y ejecute el siguiente comando:
```
sudo yum erase codedeploy-agent
```
## Desinstala el CodeDeploy agente del servidor Ubuntu
Para desinstalar el CodeDeploy agente, inicia sesión en la instancia y ejecuta el siguiente comando:
```
sudo dpkg --purge codedeploy-agent
```
## Desinstale el CodeDeploy agente de Windows Server
Para desinstalar el CodeDeploy agente, inicia sesión en la instancia y ejecuta los tres comandos siguientes, de uno en uno:
```
wmic
```
```
product where name="CodeDeploy Host Agent" call uninstall /nointeractive
```
```
exit
```
También puedes iniciar sesión en la instancia y, en el **Panel de control**, abrir **Programas y características**, elegir **CodeDeploy Host Agent** y, a continuación, elegir **Desinstalar**.
# Enviar los registros CodeDeploy de los agentes a CloudWatch
Puede enviar las métricas y los datos de registro del CodeDeploy agente CloudWatch mediante el [ CloudWatch agente unificado](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/UseCloudWatchUnifiedAgent.html) o, más simplemente, el CloudWatch agente.
Siga las instrucciones siguientes para instalar el CloudWatch agente y configurarlo para su uso con CodeDeploy los agentes.
## Requisitos previos
Antes de empezar, complete las siguientes tareas:
+ Instale el CodeDeploy agente y asegúrese de que se esté ejecutando. Para obtener más información, consulte [Instale el agente CodeDeploy](codedeploy-agent-operations-install.md) y [Compruebe que el CodeDeploy agente se esté ejecutando](codedeploy-agent-operations-verify.md).
+ Instale el CloudWatch agente. Para obtener más información, consulte [Instalación del CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance.html).
+ Añada los siguientes permisos al perfil de instancia de CodeDeploy IAM:
+ CloudWatchLogsFullAccess
+ CloudWatchAgentServerPolicy
Para obtener más información sobre el perfil de la CodeDeploy instancia, consulte[Paso 4: Crear un perfil de instancia de IAM para las instancias de Amazon EC2](getting-started-create-iam-instance-profile.md). [Empezar con CodeDeploy](getting-started-codedeploy.md)
## Configure el CloudWatch agente para recopilar CodeDeploy registros
Puede configurar el CloudWatch agente siguiendo un asistente o creando o editando manualmente un archivo de configuración.
**Para configurar el CloudWatch agente mediante el asistente (Linux)**
1. Ejecute el asistente, tal y como se describe en [Ejecutar el asistente de configuración del CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard).
1. En el asistente, cuando se le pida `Do you want to monitor any log files?`, introduzca **1**.
1. Especifique el archivo de registro del CodeDeploy agente de la siguiente manera:
1. Para `Log file path` introducir la ruta del archivo de CodeDeploy registro, por ejemplo:**/var/log/aws/codedeploy-agent/codedeploy-agent.log**.
1. Para `Log group name`, introduzca un nombre de grupo de registro, por ejemplo: **codedeploy-agent-log**.
1. Para `Log stream name`, introduzca un nombre de flujo de registro, por ejemplo: **\$1instance\$1id\$1-codedeploy-agent-log**.
1. Cuando se le pida `Do you want to specify any additional log files?`, introduzca **1**.
1. Especifique los registros de despliegue del CodeDeploy agente, de la siguiente manera:
1. Para `Log file path` introducir la ruta del archivo de registro de CodeDeploy despliegue, por ejemplo:**/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log**.
1. Para `Log group name`, introduzca un nombre de grupo de registro, por ejemplo: **codedeploy-agent-deployment-log**.
1. Para `Log stream name`, introduzca un nombre de flujo de registro, por ejemplo: **\$1instance\$1id\$1-codedeploy-agent-deployment-log**.
1. Cuando se le pida `Do you want to specify any additional log files?`, introduzca **1**.
1. Especifique los registros del actualizador del CodeDeploy agente, de la siguiente manera:
1. Para `Log file path` introducir la ruta del archivo de registro del CodeDeploy actualizador, por ejemplo:. **/tmp/codedeploy-agent.update.log**
1. Para `Log group name`, introduzca un nombre de grupo de registro, por ejemplo: **codedeploy-agent-updater-log**.
1. Para `Log stream name`, introduzca un nombre de flujo de registro, por ejemplo: **\$1instance\$1id\$1-codedeploy-agent-updater-log**.
**Para configurar el CloudWatch agente mediante el asistente (Windows)**
1. Ejecute el asistente, tal y como se describe en [Ejecutar el asistente de configuración del CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-cloudwatch-agent-configuration-file-wizard.html#cloudwatch-agent-running-wizard).
1. En el asistente, cuando se le pida `Do you want to monitor any customized log files?`, introduzca **1**.
1. Especifique el archivo de CodeDeploy registro de la siguiente manera:
1. Para `Log file path` introducir la ruta o el archivo de registro del CodeDeploy agente, por ejemplo:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1log\$1codedeploy-agent-log.txt**.
1. Para `Log group name`, introduzca un nombre de grupo de registro, por ejemplo: **codedeploy-agent-log**.
1. Para `Log stream name`, introduzca un nombre de flujo de registro, por ejemplo: **\$1instance\$1id\$1-codedeploy-agent-log**.
1. Cuando se le pida `Do you want to specify any additional log files?`, introduzca **1**.
1. Especifique los registros de despliegue del CodeDeploy agente, de la siguiente manera:
1. Para `Log file path` introducir la ruta del archivo CodeDeploy de registro de despliegue, por ejemplo:**C:\$1ProgramData\$1Amazon\$1CodeDeploy\$1deployment-logs\$1codedeploy-agent-deployments.log**.
1. Para `Log group name`, introduzca un nombre de grupo de registro, por ejemplo: **codedeploy-agent-deployment-log**.
1. Para `Log stream name`, introduzca un nombre de flujo de registro, por ejemplo: **\$1instance\$1id\$1-codedeploy-agent-deployment-log**.
**Para configurar el CloudWatch agente mediante la creación o edición manual de un archivo de configuración (Linux)**
1. Cree o edite el archivo de configuración del CloudWatch agente como se describe en [Crear o editar manualmente el archivo de configuración del CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html).
1. Asegúrese de que el archivo se llame `/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json` y de que contenga el siguiente código:
```
...
"logs": {
"logs_collected": {
"files": {
"collect_list": [
{
"file_path": "/var/log/aws/codedeploy-agent/codedeploy-agent.log",
"log_group_name": "codedeploy-agent-log",
"log_stream_name": "{instance_id}-agent-log"
},
{
"file_path": "/opt/codedeploy-agent/deployment-root/deployment-logs/codedeploy-agent-deployments.log",
"log_group_name": "codedeploy-agent-deployment-log",
"log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
},
{
"file_path": "/tmp/codedeploy-agent.update.log",
"log_group_name": "codedeploy-agent-updater-log",
"log_stream_name": "{instance_id}-codedeploy-agent-updater-log"
}
]
}
}
}
...
```
**Para configurar el CloudWatch agente mediante la creación o edición manual de un archivo de configuración (Windows)**
1. Cree o edite el archivo de configuración del CloudWatch agente como se describe en [Crear o editar manualmente el archivo de configuración del CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-Configuration-File-Details.html).
1. Asegúrese de que el archivo se llame `C:\ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json` y de que contenga el siguiente código:
```
...
"logs": {
"logs_collected": {
"files": {
"collect_list": [
{
"file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\log\\codedeploy-agent-log.txt",
"log_group_name": "codedeploy-agent-log",
"log_stream_name": "{instance_id}-codedeploy-agent-log"
},
{
"file_path": "C:\\ProgramData\\Amazon\\CodeDeploy\\deployment-logs\\codedeploy-agent-deployments.log",
"log_group_name": "codedeploy-agent-deployment-log",
"log_stream_name": "{instance_id}-codedeploy-agent-deployment-log"
}
]
},
...
}
},
...
```
## Reinicie el CloudWatch agente
Tras realizar los cambios, reinicie el CloudWatch agente tal y como se describe en [Iniciar el CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/install-CloudWatch-Agent-on-EC2-Instance-fleet.html#start-CloudWatch-Agent-EC2-fleet).