

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# CodeDeploy Referenz zur Agentenkonfiguration
<a name="reference-agent-configuration"></a>

Wenn der CodeDeploy Agent installiert ist, wird eine Konfigurationsdatei auf der Instanz platziert. Diese Konfigurationsdatei gibt Verzeichnispfade und andere Einstellungen an CodeDeploy , die bei der Interaktion mit der Instanz verwendet werden sollen. Sie können einige der Konfigurationsoptionen in der Datei ändern.

Für Amazon Linux-, Ubuntu Server- und Red Hat Enterprise Linux (RHEL) -Instances hat die Konfigurationsdatei einen Namen`codedeployagent.yml`. Sie befindet sich im Verzeichnis `/etc/codedeploy-agent/conf`.

Für Windows Server-Instances hat die Konfigurationsdatei einen Namen`conf.yml`. Sie befindet sich im Verzeichnis `C:\ProgramData\Amazon\CodeDeploy`.

Die Konfigurationseinstellungen sind:



|  |  | 
| --- |--- |
| **:log\_aws\_wire:** | **Ist auf eingestellt, `true` damit der CodeDeploy Agent Wire-Logs von Amazon S3 erfasst und in eine Protokolldatei an dem Ort schreibt, auf den die Einstellung:log\_dir: verweist.**<br />Für Version 2.0.x und höher lautet der Dateiname `codedeploy-agent.aws_wire.log` (erstellt mit 0640-Berechtigungen).<br />Für Version 1.8.x und früher lautet der Dateiname. `codedeploy-agent.wire.log` Setzen Sie für **: log\_aws\_wire:** die Einstellung nur für die Dauer der Wire-Protokollerfassung auf `true`. Die Wire-Log-Datei kann schnell sehr groß werden. Die Wire-Log-Ausgabe kann vertrauliche Informationen enthalten, darunter Klartext-Inhalte von Dateien, die in Amazon S3 oder aus Amazon S3 übertragen wurden, während diese Einstellung auf gesetzt war. `true` Die Wire-Logs enthalten Informationen über alle Amazon S3 S3-Aktivitäten, die mit dem AWS Konto verknüpft waren, während diese Einstellung aktiviert war`true`, nicht nur über Aktivitäten im Zusammenhang mit CodeDeploy Bereitstellungen. <br />Die Standardeinstellung lautet `false`.<br />Diese Einstellung gilt für alle Instance-Typen. Sie müssen diese Konfigurationseinstellung zu Windows Server-Instances hinzufügen, um sie verwenden zu können. | 
| **:log\_dir:** | Der Ordner auf der Instanz, in dem Protokolldateien zu CodeDeploy Agentenvorgängen gespeichert werden.<br />Die Standardeinstellung gilt `'/var/log/aws/codedeploy-agent'` für Amazon Linux-, Ubuntu Server- und RHEL-Instances sowie `C:\ProgramData\Amazon\CodeDeploy\log` für Windows Server-Instances. | 
| **:pid\_dir:** | Der Ordner, in dem `codedeploy-agent.pid` gespeichert ist.<br />Diese Datei enthält die Prozess-ID (PID) des CodeDeploy Agenten. Die Standardeinstellung lautet `'/opt/codedeploy-agent/state/.pid'`.<br />Diese Einstellung gilt nur für Amazon Linux-, Ubuntu Server- und RHEL-Instances. | 
| **:program\_name:** | Der Name des CodeDeploy Agent-Programms.<br />Die Standardeinstellung lautet `codedeploy-agent`.<br />Diese Einstellung gilt nur für Amazon Linux-, Ubuntu Server- und RHEL-Instances. | 
| **:root\_dir:** | Der Ordner, in dem verwandte Revisionen, Bereitstellungsverlauf und Bereitstellungsscripts auf der Instance gespeichert werden.<br />Die Standardeinstellung gilt `/opt/codedeploy-agent/deployment-root` für Amazon Linux-, Ubuntu Server- und RHEL-Instances sowie `C:\ProgramData\Amazon\CodeDeploy` für Windows Server-Instances. | 
| **:verbose:** | Ist auf eingestellt, `true` damit der CodeDeploy Agent Debug-Meldungen und Protokolldateien auf der Instance ausgibt.<br />Die Standardeinstellung lautet `false`. | 
| **:wait\_between\_runs:** | Das Intervall in Sekunden zwischen der Abfrage ausstehender Bereitstellungen durch CodeDeploy den CodeDeploy Agenten.<br />Für Version 2.0.x und höher ist die Standardeinstellung. `30`<br />Für Version 1.8.x und früher ist die Standardeinstellung. `1` | 
| **:on\_premises\_config\_file:** | Für lokale Instanzen der Pfad zu einem alternativen Speicherort für die Konfigurationsdatei mit dem Namen `codedeploy.onpremises.yml` (für Ubuntu Server und RHEL) oder `conf.onpremises.yml` (für Windows Server). <br />Standardmäßig werden diese Dateien in`/etc/codedeploy-agent/conf`/`codedeploy.onpremises.yml`für Ubuntu Server und RHEL und in`C:\ProgramData\Amazon\CodeDeploy`\\ `conf.onpremises.yml` für Windows Server gespeichert.<br />In Version 1.0.1.686 und höheren Versionen des CodeDeploy-Agenten verfügbar. | 
| **:proxy\_uri:** | (Optional) Der HTTP-Proxy, über den der CodeDeploy Agent AWS für Ihre CodeDeploy Operationen eine Verbindung herstellen soll. Verwenden Sie ein Format wie dieses: `https://user:password@my.proxy:443/path?query`.<br />In Version 1.0.1.824 und höheren Versionen des CodeDeploy-Agenten verfügbar. | 
| **:max\_revisions:** | (Optional) Die Anzahl der Anwendungsrevisionen für eine Bereitstellungsgruppe, die der CodeDeploy Agent archivieren soll. Revisionen, die die angegebene Zahl überschreiten, werden gelöscht. <br />Geben Sie eine positive Ganzzahl ein. Wenn kein Wert angegeben ist, CodeDeploy werden zusätzlich zur aktuell bereitgestellten Version die fünf neuesten Versionen beibehalten. <br />Unterstützt in Version 1.0.1.966 und in höheren Versionen des CodeDeploy-Agenten. | 
| **Wenn kein Wert angegeben ist, werden die fünf neuesten Versionen zusätzlich zur aktuell bereitgestellten Version beibehalten. ----sep----:enable\_auth\_policy:** | (Optional) Stellen Sie diese Option ein, `true` wenn Sie die [IAM-Autorisierung](https://docs.aws.amazon.com/IAM/latest/UserGuide/intro-structure.html#intro-structure-authorization) verwenden möchten, um die Zugriffskontrolle zu konfigurieren und die Berechtigungen der IAM-Rolle oder des Benutzers, die der Agent verwendet, einzuschränken. CodeDeploy Zu[Verwendung CodeDeploy mit Amazon Virtual Private Cloud](vpc-endpoints.md), dieser Wert muss sein. `true` <br />Die Standardeinstellung lautet `false`. | 
| **Für muss dieser Wert sein. ----sep----:disable\_imds\_v1:** | Diese Einstellung ist mit Agent 1.7.0 und höher verfügbar. CodeDeploy <br />Wird auf gesetzt, `true` um den Fallback auf IMDSv1 zu deaktivieren, wenn IMDSv2-Fehler auftreten. Die Standardeinstellung ist (aktiviert den Fallback). `false` | 
| **Standardmäßig (aktiviert den Fallback). ----sep----:disable\_core\_dumps:** | Für Version 2.0.x und höher.<br />Auf einstellen, `true` um Core-Dumps zu unterdrücken. Auf `false` für die Absturzuntersuchung eingestellt.<br />Die Standardeinstellung lautet `true`. | 
| **Auf für die Absturzuntersuchung gesetzt. ----sep----:enable\_command\_port:** | Für Version 2.0.x und höher.<br />Wird auf gesetzt, `true` um die lokale Verwaltungsschnittstelle (127.0.0.1) nur für Loopback zu aktivieren, um den Agentenstatus abzufragen und Befehle lokal einzufügen.<br />Die Standardeinstellung lautet `false`. | 
| **Wird auf gesetzt, um die lokale Verwaltungsschnittstelle nur für Loopback (127.0.0.1) zum Abfragen des Agentenstatus und zum lokalen Einfügen von Befehlen zu aktivieren. ----sep----:reject\_symlinks\_in\_bundle:** | Für Version 2.0.x und höher.<br />Auf einstellen, `true` um Bundles abzulehnen, die Symlinks oder Hardlinks enthalten.<br />Die Standardeinstellung lautet `false`. | 
| **Wird auf gesetzt, um Bundles abzulehnen, die Symlinks oder Hardlinks enthalten. ----sep----:reject\_path\_traversal\_in\_bundle:** | Für Version 2.0.x und höher.<br />Auf einstellen, `true` um Archiveinträge zurückzuweisen, die `../` Pfaddurchquerung oder absolute Pfade enthalten, sowie AppSpec Quellfelder, die dem Bundle-Stammverzeichnis entgehen.<br />Die Standardeinstellung lautet `false`. | 
| **Wird auf gesetzt, um Archiveinträge zurückzuweisen, die Pfaddurchquerung oder absolute Pfade enthalten, sowie Quellfelder, die dem Paketstamm entgehen. ----sep----:reject\_unsafe\_permissions\_in\_bundle:** | Für Version 2.0.x und höher.<br />Auf einstellen, `true` um Bundles abzulehnen, die SUID/SGID Dateien oder festgelegte AppSpec Berechtigungsmodi enthalten. SUID/SGID<br />Die Standardeinstellung lautet `false`. | 
| **Auf setzen, um Pakete abzulehnen, die Dateien enthalten, oder Berechtigungsmodi, die festgelegt sind. ----sep----:reject\_unconfined\_selinux\_in\_bundle:** | Für Version 2.0.x und höher.<br />Auf einstellen, `true` um Bundles abzulehnen, die Dateien mit MAC-disabling SELinux-Typen enthalten.<br />Die Standardeinstellung lautet `false`. | 
| **Wird auf gesetzt, um Bundles abzulehnen, die Dateien mit SELinux-Typen enthalten. ----sep----:reject\_symlink\_permission\_targets:** | Für Version 2.0.x und höher.<br />Wird auf gesetzt`true`, um einen AppSpec `permissions` Dateieintrag zurückzuweisen, dessen Ziel ein symbolischer Link ist. Standardmäßig folgt der Agent dem Link, wenn er Eigentums-, Modus-, ACL- und SELinux-Änderungen vornimmt.<br />Die Standardeinstellung lautet `false`. | 
| **Standardmäßig folgt der Agent dem Link, wenn er Eigentümer-, Modus-, ACL- und SELinux-Änderungen anwendet. ----sep----:ignore\_ownership\_in\_bundle:** | Für Version 2.0.x und höher.<br />Stellen Sie diese `true` Option ein, um den Besitz von Dateien, aus denen extrahiert wurde, `tar` und `tgz` Bundles auf zurückzusetzen, `root` anstatt die im Archiv aufgezeichnete Benutzer-ID und Gruppen-ID zu übernehmen. Dateien in `zip` Paketen gehören `root` unabhängig von dieser Einstellung dem Eigentümer.<br />Die Standardeinstellung lautet `false`. | 
| **Dateien in Bundles gehören unabhängig von dieser Einstellung dem Eigentümer. ----sep----:restrict\_agent\_dir\_permissions:** | Für Version 2.0.x und höher. Nur Linux-Instanzen.<br />Stellen Sie diese Option ein`true`, um die Verzeichnisse und Dateien im Stammverzeichnis der Agenteninstallation auf den reinen Root-Zugriff zu beschränken und nicht auf die standardmäßig verwendeten Modi, die für alle lesbar sind.<br />Die Standardeinstellung lautet `false`. | 
| **Wird auf gesetzt, um die Verzeichnisse und Dateien im Stammverzeichnis der Agenteninstallation auf reinen Root-Zugriff zu beschränken und nicht auf die standardmäßig für alle lesbaren Modi. ----sep----:restrict\_log\_dir\_permissions:** | Für Version 2.0.x und höher. Nur Linux-Instanzen.<br />Wird auf gesetzt, `true` um das Agent-Log-Verzeichnis, das das Agent-Log und das Updater-Log enthält, auf den reinen Root-Zugriff statt auf die standardmäßig verwendeten, allgemein lesbaren Modi zu beschränken.<br />Die Standardeinstellung lautet `false`. | 
| **Wird auf gesetzt, um das Agent-Log-Verzeichnis, das das Agent-Log und das Updater-Log enthält, auf reinen Root-Zugriff statt auf die standardmäßig für alle lesbaren Modi zu beschränken. ----sep----:restrict\_hook\_env\_to\_allowlist:** | Für Version 2.0.x und höher.<br />Auf einstellen, `true` um Lifecycle-Event-Hooks mit einer minimalen Umgebung auszuführen, die nur grundlegende Shell-Variablen und die CodeDeploy Deployment-Variablen enthält. Standardmäßig erben Hooks die gesamte Umgebung des Agentenprozesses.<br />Die Standardeinstellung lautet `false`. | 
| **Standardmäßig erben Hooks die gesamte Umgebung des Agentenprozesses. ----sep----:strip\_loader\_env\_in\_hooks:** | Für Version 2.0.x und höher. Nur Linux-Instanzen.<br />Auf setzen, `true` um die `LD_AUDIT` Variablen `LD_PRELOAD``LD_LIBRARY_PATH`, und aus der Umgebung von Lifecycle-Event-Hooks zu entfernen.<br />Die Standardeinstellung lautet `false`. | 
| **Wird auf gesetzt, um die Variablen, und aus der Umgebung von Lifecycle-Event-Hooks zu entfernen. ----sep----:disable\_powershell\_profile\_in\_hooks:** | Für Version 2.0.x und höher. Nur Windows Server-Instanzen.<br />Auf einstellen, `true` um `.ps1` Lifecycle-Event-Hooks mit den `-NonInteractive` Optionen `-NoProfile` und auszuführen. Standardmäßig laden diese Hooks das PowerShell Profil des Benutzers, unter dem der Agent ausgeführt wird.<br />Die Standardeinstellung lautet `false`. | 
| **Standardmäßig laden diese Hooks das Profil des Benutzers, unter dem der Agent läuft. ----sep----:archive\_max\_extraction\_size:** | Für Version 2.0.x und höher.<br />Legt eine Obergrenze für die deklarierte unkomprimierte Bundle-Größe fest. Wenn der extrahierte Inhalt diesen Wert überschreitet, schlägt die Bereitstellung fehl.<br />Die Standardeinstellung ist keine Obergrenze (unbegrenzt). | 
| **Die Standardeinstellung ist keine Obergrenze (unbegrenzt). ----sep----:wait\_after\_error:** | Die Anzahl der Sekunden, die der Agent nach dem Auftreten eines Fehlers wartet, bevor er den normalen Betrieb wieder aufnimmt.<br />Die Standardeinstellung lautet `30`. | 
| **Die Anzahl der Sekunden, die der Agent nach einem Fehler wartet, bevor er den normalen Betrieb wieder aufnimmt. ----sep----:http\_read\_timeout:** | Das HTTP-Lese-Timeout in Sekunden für Service-API-Aufrufe.<br />Die Standardeinstellung lautet `80`. | 
| **Das HTTP-Lese-Timeout in Sekunden für Service-API-Aufrufe. ----sep----:kill\_agent\_max\_wait\_time\_seconds:** | Die maximale Anzahl von Sekunden, die der Agent auf ein ordnungsgemäßes Herunterfahren wartet, bevor er den Vorgang erzwingt. Für Version 2.0.x und höher ist dieser Wert auf 24 Stunden (86400 Sekunden) begrenzt.<br />Die Standardeinstellung ist `7200` (2 Stunden). | 
| **Die Standardeinstellung ist (2 Stunden). ----sep----:enable\_deployments\_log:** | Auf setzen, um das aggregierte `true` Bereitstellungsprotokoll () zu schreiben. `codedeploy-agent-deployments.log`<br />Die Standardeinstellung lautet `true`. | 
| **Legt fest, dass das aggregierte Bereitstellungsprotokoll () geschrieben werden soll. ----sep----:use\_fips\_mode:** | Auf einstellen, um Endpunkte zu verwenden. `true` FIPS-compliant Gilt nur für US-Regionen.<br />Die Standardeinstellung lautet `false`. | 
| **Gilt nur für US-Regionen. ----sep----:deploy\_control\_endpoint:** | (Optional) Eine benutzerdefinierte URL für den Steuerungsebenen-Endpunkt für den Service. CodeDeploy <br />Die Standardeinstellung ist kein Überschreiben (der Agent löst den Endpunkt aus der Region auf). | 
| **Die Standardeinstellung ist kein Override (der Agent löst den Endpunkt aus der Region auf). ----sep----:s3\_endpoint\_override:** | (Optional) Eine benutzerdefinierte Amazon S3 S3-Endpunkt-URL für Bundle-Downloads.<br />Die Standardeinstellung ist kein Überschreiben (der Agent löst den Amazon S3 S3-Endpunkt aus der Region auf). | 
| **Die Standardeinstellung ist kein Überschreiben (der Agent löst den Amazon S3-Endpunkt aus der Region auf). ----sep----:ongoing\_deployment\_tracking:** | Der Name des Unterverzeichnisses, das für die Statusverfolgung der Bereitstellung verwendet wird.<br />Die Standardeinstellung lautet `ongoing-deployment`. | 

## Verwandte Themen
<a name="reference-agent-configuration-related-topics"></a>

[Zusammenarbeit mit dem CodeDeploy Agenten](codedeploy-agent.md)

[Verwaltung des CodeDeploy Agentenbetriebs](codedeploy-agent-operations.md)