

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# CodeDeploy référence de configuration de l'agent
<a name="reference-agent-configuration"></a>

Lorsque l' CodeDeploy agent est installé, un fichier de configuration est placé sur l'instance. Ce fichier de configuration spécifie les chemins de répertoire et les autres paramètres CodeDeploy à utiliser lorsqu'il interagit avec l'instance. Vous pouvez modifier certaines options de configuration dans ce fichier.

Pour les instances Amazon Linux, Ubuntu Server et Red Hat Enterprise Linux (RHEL), le fichier de configuration est nommé`codedeployagent.yml`. Il est placé dans le répertoire `/etc/codedeploy-agent/conf`.

Pour les instances Windows Server, le fichier de configuration est nommé`conf.yml`. Il est placé dans le répertoire `C:\ProgramData\Amazon\CodeDeploy`.

Les paramètres de configuration incluent les éléments suivants :


****  

|  |  | 
| --- |--- |
|  **:log\$1aws\$1wire:**  |  **Définissez cette valeur `true` pour que l' CodeDeploy agent capture les journaux de transfert depuis Amazon S3 et les écrive `codedeploy-agent.wire.log` dans un fichier nommé à l'emplacement indiqué par le paramètre:log\$1dir :.**   Vous devez définir **:log\$1aws\$1wire:** sur `true` uniquement pendant le temps nécessaire à la capture des journaux avec connexion. Le fichier `codedeploy-agent.wire.log` peut atteindre rapidement une très grande taille. La sortie du journal des connexions dans ce fichier peut contenir des informations sensibles, notamment le contenu en texte brut des fichiers transférés vers ou depuis Amazon S3 lorsque ce paramètre était défini sur. `true` Les journaux de connexion contiennent des informations sur toutes les activités Amazon S3 associées au AWS compte lorsque ce paramètre était défini sur`true`, et pas uniquement sur les activités liées aux CodeDeploy déploiements.  Le paramètre par défaut est `false`. Ce paramètre s'applique à tous les types d'instance. Vous devez ajouter ce paramètre de configuration aux instances Windows Server pour pouvoir l'utiliser.  | 
|  **:log\$1dir:**  | Le dossier de l'instance dans lequel sont stockés les fichiers journaux relatifs aux opérations de l' CodeDeploy agent. Le paramètre par défaut est `'/var/log/aws/codedeploy-agent'` pour les instances Amazon Linux, Ubuntu Server et RHEL, ainsi que `C:\ProgramData\Amazon\CodeDeploy\log` pour les instances Windows Server. | 
|  **:pid\$1dir:**  | Dossier dans lequel `codedeploy-agent.pid` est stocké. Ce fichier contient l'identifiant de processus (PID) de l' CodeDeploy agent. Le paramètre par défaut est `'/opt/codedeploy-agent/state/.pid'`. Ce paramètre s'applique uniquement aux instances Amazon Linux, Ubuntu Server et RHEL. | 
|  **:program\$1name:**  | Le nom du programme de l' CodeDeploy agent. Le paramètre par défaut est `codedeploy-agent`.Ce paramètre s'applique uniquement aux instances Amazon Linux, Ubuntu Server et RHEL. | 
|  **:root\$1dir:**  | Dossier dans lequel les révisions, l'historique des déploiements et les scripts de déploiement associés sont stockés sur l'instance. Le paramètre par défaut est `/opt/codedeploy-agent/deployment-root` pour les instances Amazon Linux, Ubuntu Server et RHEL, ainsi que `C:\ProgramData\Amazon\CodeDeploy` pour les instances Windows Server. | 
|  **:verbose:**  | Définissez cette valeur `true` pour que l' CodeDeploy agent imprime les fichiers journaux des messages de débogage sur l'instance. Le paramètre par défaut est `false`. | 
|  **:wait\$1between\$1runs:**  | Intervalle, en secondes, entre l'interrogation de CodeDeploy l'agent et CodeDeploy les déploiements en attente. Le paramètre par défaut est `1`. | 
|  **:on\$1premises\$1config\$1file:**  | Pour les instances locales, chemin d'accès à un autre emplacement pour le fichier de configuration nommé `codedeploy.onpremises.yml` (pour Ubuntu Server et RHEL) ou `conf.onpremises.yml` (pour Windows Server). Par défaut, ces fichiers sont stockés dans`/etc/codedeploy-agent/conf`/`codedeploy.onpremises.yml`pour Ubuntu Server et RHEL et `C:\ProgramData\Amazon\CodeDeploy` \$1 `conf.onpremises.yml` pour Windows Server. Disponible dans la version 1.0.1.686 et les versions ultérieures de l'agent CodeDeploy.  | 
|  **:proxy\$1uri:**  |  (Facultatif) Le proxy HTTP via lequel vous souhaitez que l' CodeDeploy agent se connecte AWS pour vos CodeDeploy opérations. Utilisez un format semblable à `https://user:password@my.proxy:443/path?query`. Disponible dans la version 1.0.1.824 et les versions ultérieures de l'agent CodeDeploy.  | 
|  **:max\$1revisions:**  |  (Facultatif) Nombre de révisions d'applications pour un groupe de déploiement que vous souhaitez que l' CodeDeploy agent archive. Toutes les révisions qui dépassent le nombre spécifié sont supprimées.  Entrez un nombre entier positif quelconque. Si aucune valeur n'est spécifiée, les cinq révisions les plus récentes CodeDeploy seront conservées en plus de la révision actuellement déployée.  Pris en charge dans la version 1.0.1.966 et les versions ultérieures de l'agent CodeDeploy.  | 
|  **:enable\$1auth\$1policy :**  |  (Facultatif) Définissez cette option `true` si vous souhaitez utiliser l'[autorisation IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/intro-structure.html#intro-structure-authorization) pour configurer le contrôle d'accès et limiter les autorisations du rôle ou de l'utilisateur IAM utilisé par l' CodeDeploy agent. Pour[Utilisation CodeDeploy avec Amazon Virtual Private Cloud](vpc-endpoints.md), cette valeur doit être`true`.  Le paramètre par défaut est `false`.  | 
|  **:disable\$1imds\$1v1 :**  |  Ce paramètre est disponible avec CodeDeploy l'agent 1.7.0 et versions ultérieures. Définissez cette valeur `true` sur pour désactiver la solution de secours en IMDSv1 cas d' IMDSv2erreur. La valeur par défaut est `false` (active le repli). | 

## Rubriques en relation
<a name="reference-agent-configuration-related-topics"></a>

[Travailler avec l' CodeDeploy agent](codedeploy-agent.md)

[Gestion des opérations des CodeDeploy agents](codedeploy-agent-operations.md)