

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.

# Referencia de configuración del agente de CodeDeploy
<a name="reference-agent-configuration"></a>

Cuando se instala el agente de CodeDeploy, se coloca un archivo de configuración en la instancia. Este archivo de configuración especifica las rutas de directorio y otros ajustes que usa CodeDeploy cuando interactúa con la instancia. Puede cambiar algunas de las opciones de configuración en el archivo.

En el caso de las instancias de Amazon Linux, Ubuntu Server y Red Hat Enterprise Linux (RHEL), el archivo de configuración se denomina `codedeployagent.yml`. Se coloca en el directorio `/etc/codedeploy-agent/conf`.

En las instancias de Windows Server, el archivo de configuración se denomina `conf.yml`. Se coloca en el directorio `C:\ProgramData\Amazon\CodeDeploy`.

Los valores de configuración incluyen:


****  

|  |  | 
| --- |--- |
|  **:log\$1aws\$1wire:**  |  Establézcalo en `true` para que el agente de CodeDeploy capture registros en red de Amazon S3 y los escriba en un archivo denominado `codedeploy-agent.wire.log` en la ubicación a la que apunta el valor **:log\$1dir:**.   Debe establecer **:log\$1aws\$1wire:** en `true` solo durante el tiempo necesario para capturar los registros en red. El archivo `codedeploy-agent.wire.log` puede aumentar de tamaño rápidamente. La salida del registro en red de este archivo puede contener información confidencial, incluido el contenido de texto sin formato de los archivos que se transfieren a o desde Amazon S3 mientras que esta configuración estaba establecida en `true`. Los registros en red contienen información sobre toda la actividad de Amazon S3 asociada a la cuenta de AWS mientras esta configuración estaba establecida en `true`, no solo la actividad relacionada con las implementaciones de CodeDeploy.  El ajuste predeterminado es `false`. Esta configuración se aplica a todos los tipos de instancias. Debe añadir esta opción de configuración a las instancias de Windows Server para que puedan utilizarla.  | 
|  **:log\$1dir:**  | La carpeta de la instancia donde se almacenan los archivos de registro relacionados con las operaciones del agente de CodeDeploy. La configuración predeterminada es `'/var/log/aws/codedeploy-agent'` para las instancias de Amazon Linux, Ubuntu Server y RHEL y `C:\ProgramData\Amazon\CodeDeploy\log` para las instancias de Windows Server. | 
|  **:pid\$1dir:**  | La carpeta en la que se almacena `codedeploy-agent.pid`. Este archivo contiene el ID de proceso (PID) del agente de CodeDeploy. El ajuste predeterminado es `'/opt/codedeploy-agent/state/.pid'`. Esta configuración se aplica únicamente a las instancias de Amazon Linux, Ubuntu Server y RHEL. | 
|  **:program\$1name:**  | El nombre del programa del agente de CodeDeploy. El ajuste predeterminado es `codedeploy-agent`.Esta configuración se aplica únicamente a las instancias de Amazon Linux, Ubuntu Server y RHEL. | 
|  **:root\$1dir:**  | La carpeta donde se almacenan las revisiones relacionadas, el historial de implementación y los scripts de implementación en la instancia. La configuración predeterminada es `/opt/codedeploy-agent/deployment-root` para las instancias de Amazon Linux, Ubuntu Server y RHEL y `C:\ProgramData\Amazon\CodeDeploy` para las instancias de Windows Server. | 
|  **:verbose:**  | Establézcalo en `true` para que el agente de CodeDeploy imprima los archivos de registro de mensajes de depuración en la instancia. El ajuste predeterminado es `false`. | 
|  **:wait\$1between\$1runs:**  | El intervalo, en segundos, entre los sondeos que hace el agente de CodeDeploy para ver si hay implementaciones de CodeDeploy pendientes. El ajuste predeterminado es `1`. | 
|  **:on\$1premises\$1config\$1file:**  | En las instancias en las instalaciones, la ruta a una ubicación alternativa para el archivo de configuración denominado `codedeploy.onpremises.yml` (para Ubuntu Server y RHEL) o `conf.onpremises.yml` (para Windows Server). De manera predeterminada, estos archivos se almacenan en `/etc/codedeploy-agent/conf`/`codedeploy.onpremises.yml` para Ubuntu Server y RHEL, y `C:\ProgramData\Amazon\CodeDeploy`\$1`conf.onpremises.yml` para Windows Server. Está disponible en la versión 1.0.1.686 y versiones posteriores del agente de CodeDeploy.  | 
|  **:proxy\$1uri:**  |  (Opcional) El proxy HTTP a través del que desea que el agente de CodeDeploy se conecte a AWS para las operaciones de CodeDeploy. Utilice un formato similar a `https://user:password@my.proxy:443/path?query`. Está disponible en la versión 1.0.1.824 y versiones posteriores del agente de CodeDeploy.  | 
|  **:max\$1revisions:**  |  (Opcional) El número de revisiones de aplicación para un grupo de implementación que desea que el agente de CodeDeploy archive. Se eliminarán todas las revisiones que superen el número especificado.  Introduzca un número entero positivo. Si no se especifica ningún valor, CodeDeploy conservará las cinco revisiones más recientes además de la revisión implementada en la actualidad.  Se admite en la versión 1.0.1.966 y versiones posteriores del agente de CodeDeploy.  | 
|  **:enable\$1auth\$1policy:**  |  (Opcional) Configúrelo en `true` si desea utilizar la [autorización de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/intro-structure.html#intro-structure-authorization) para configurar el control de acceso y limitar los permisos del rol o usuario de IAM que utiliza el agente de CodeDeploy. Para [Úselo CodeDeploy con Amazon Virtual Private Cloud](vpc-endpoints.md), este valor debe ser `true`.  El ajuste predeterminado es `false`.  | 
|  **:disable\$1imds\$1v1:**  |  Esta configuración está disponible con el agente de CodeDeploy 1.7.0 y versiones posteriores. Establézcala en `true` para deshabilitar la alternativa a IMDSv1 cuando se produzcan errores de IMDSv2. El valor predeterminado es `false` (habilita la alternativa). | 

## Temas relacionados
<a name="reference-agent-configuration-related-topics"></a>

[Trabajando con el CodeDeploy agente](codedeploy-agent.md)

[Gestión de las operaciones CodeDeploy de los agentes](codedeploy-agent-operations.md)