Referencia de configuración del agente de CodeDeploy

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_aws_wire:	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_dir:. aviso Debe establecer :log_aws_wire: 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_dir:	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_dir:	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_name:	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_dir:	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_between_runs:	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_premises_config_file:	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\conf.onpremises.yml para Windows Server. Está disponible en la versión 1.0.1.686 y versiones posteriores del agente de CodeDeploy.
:proxy_uri:	(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:[e-mail]:443/path?query. Está disponible en la versión 1.0.1.824 y versiones posteriores del agente de CodeDeploy.
:max_revisions:	(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_auth_policy:	(Opcional) Configúrelo en true si desea utilizar la autorización de IAM para configurar el control de acceso y limitar los permisos del rol o usuario de IAM que utiliza el agente de CodeDeploy. Para Uso de CodeDeploy con Amazon Virtual Private Cloud, este valor debe ser true. El ajuste predeterminado es false.
:disable_imds_v1:	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

Trabajando con el CodeDeploy agente

Gestión de las operaciones del agente de CodeDeploy