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.
# Verwenden der Apache Airflow Airflow-Konfigurationsoptionen auf Amazon MWAA
Apache Airflow Airflow-Konfigurationsoptionen können als Umgebungsvariablen an Ihre Amazon Managed Workflows for Apache Airflow Airflow-Umgebung angehängt werden. Sie können aus der vorgeschlagenen Drop-down-Liste wählen oder benutzerdefinierte Konfigurationsoptionen für Ihre Apache Airflow Airflow-Version auf der Amazon MWAA-Konsole angeben. In diesem Thema werden die verfügbaren Apache Airflow Airflow-Konfigurationsoptionen und die Verwendung dieser Optionen beschrieben, um die Apache Airflow Airflow-Konfigurationseinstellungen in Ihrer Umgebung zu überschreiben.
**Contents**
+ [Voraussetzungen](#configuring-env-variables-prereqs)
+ [Funktionsweise](#configuring-env-variables-how)
+ [Verwenden von Konfigurationsoptionen zum Laden von Plugins](#configuring-2.0-airflow-override)
+ [Übersicht über die Konfigurationsoptionen](#configuring-env-variables-customizing)
+ [Konfigurationsoptionen für Apache Airflow](#configuring-env-variables-airflow-ref)
+ [Apache Airflow Airflow-Referenz](#configuring-env-variables-reference-options)
+ [Verwenden der Amazon MWAA-Konsole](#configuring-env-variables-console-add)
+ [Konfigurationsreferenz](#configuring-env-variables-reference)
+ [E-Mail-Konfigurationen](#configuring-env-variables-email)
+ [Aufgabenkonfigurationen](#configuring-env-variables-tasks)
+ [Scheduler-Konfigurationen](#configuring-env-variables-scheduler)
+ [Worker-Konfigurationen](#configuring-env-variables-workers)
+ [Webserver-Konfigurationen](#configuring-env-variables-webserver)
+ [Konfigurationen auslösen](#configuring-env-variables-webserver)
+ [Beispiele und Beispielcode](#configuring-env-variables-code)
+ [Beispiel DAG](#configuring-env-variables-dag)
+ [Beispiel für Einstellungen für E-Mail-Benachrichtigungen](#configuring-env-variables-email)
+ [Als nächstes](#configuring-env-variables-next-up)
## Voraussetzungen
Sie benötigen Folgendes, bevor Sie die Schritte auf dieser Seite ausführen können.
+ **Berechtigungen** — Ihr Administrator AWS-Konto muss Ihnen Zugriff auf die [MWAAFullConsoleAccessAmazon-Zugriffskontrollrichtlinie](access-policies.md#console-full-access) für Ihre Umgebung gewährt haben. Darüber hinaus muss Ihrer Amazon MWAA-Umgebung von Ihrer [Ausführungsrolle](mwaa-create-role.md) der Zugriff auf die von Ihrer Umgebung verwendeten AWS Ressourcen gestattet werden.
+ **Zugriff** — Wenn Sie Zugriff auf öffentliche Repositorys benötigen, um Abhängigkeiten direkt auf dem Webserver zu installieren, muss Ihre Umgebung für den Zugriff auf **öffentliche** Netzwerk-Webserver konfiguriert sein. Weitere Informationen finden Sie unter [Apache-Airflow-Zugriffsmodi](configuring-networking.md).
+ **Amazon S3 S3-Konfiguration** — Der [Amazon S3 S3-Bucket](mwaa-s3-bucket.md) DAGs, in dem Ihre benutzerdefinierten Plugins und Python-Abhängigkeiten gespeichert werden`plugins.zip`, `requirements.txt` muss mit *geblocktem öffentlichem Zugriff* und *aktivierter Versionierung* konfiguriert sein.
## Funktionsweise
Wenn Sie eine Umgebung erstellen, fügt Amazon MWAA die Konfigurationseinstellungen, die Sie auf der Amazon MWAA-Konsole in den **Airflow-Konfigurationsoptionen** angeben, als Umgebungsvariablen an den Container für Ihre Umgebung an. AWS Fargate Wenn Sie eine Einstellung mit demselben Namen in verwenden, überschreiben die Optionen`airflow.cfg`, die Sie auf der Amazon MWAA-Konsole angeben, die Werte in. `airflow.cfg`
Wir stellen die `airflow.cfg` in der Apache Airflow-Benutzeroberfläche einer Amazon MWAA-Umgebung zwar nicht standardmäßig zur Verfügung, aber Sie können die Apache Airflow Airflow-Konfigurationsoptionen direkt in der Amazon MWAA-Konsole ändern, einschließlich der Einstellung, dass die Konfigurationen verfügbar gemacht werden. `webserver.expose_config`
## Verwenden von Konfigurationsoptionen zum Laden von Plugins
In Apache Airflow v2 und höher sind Plugins standardmäßig so konfiguriert, dass sie mithilfe der `core.lazy_load_plugins : True` Einstellung „träge“ geladen werden. Wenn Sie benutzerdefinierte Plugins verwenden, müssen Sie `core.lazy_load_plugins : False` als Apache Airflow Airflow-Konfigurationsoption hinzufügen, um Plugins zu Beginn jedes Airflow-Prozesses zu laden, um die Standardeinstellung zu überschreiben.
## Übersicht über die Konfigurationsoptionen
Wenn Sie eine Konfiguration auf der Amazon MWAA-Konsole hinzufügen, schreibt Amazon MWAA die Konfiguration als Umgebungsvariable.
+ **Aufgelistete Optionen.** In der Drop-down-Liste können Sie aus einer der für Ihre Apache Airflow Airflow-Version verfügbaren Konfigurationseinstellungen wählen. Beispiel: `dag_concurrency` : `16`. Die Konfigurationseinstellung wird in den Fargate-Container Ihrer Umgebung übersetzt als `AIRFLOW__CORE__DAG_CONCURRENCY : 16`
+ **Benutzerdefinierte Optionen**. Sie können auch Airflow-Konfigurationsoptionen angeben, die für Ihre Apache Airflow Airflow-Version nicht in der Drop-down-Liste aufgeführt sind. Beispiel: `foo.user` : `YOUR_USER_NAME`. Die Konfigurationseinstellung wird in den Fargate-Container Ihrer Umgebung übersetzt als `AIRFLOW__FOO__USER : YOUR_USER_NAME`
### Konfigurationsoptionen für Apache Airflow
Die folgende Abbildung zeigt, wo Sie die **Apache Airflow Airflow-Konfigurationsoptionen** auf der Amazon MWAA-Konsole anpassen können.
![\[Dieses Bild zeigt, wo Sie die Apache Airflow Airflow-Konfigurationsoptionen auf der Amazon MWAA-Konsole anpassen können.\]](http://docs.aws.amazon.com/de_de/mwaa/latest/userguide/images/mwaa-console-airflow-config.png)
### Apache Airflow Airflow-Referenz
Eine Liste der von Apache Airflow unterstützten Konfigurationsoptionen finden Sie unter [Configuration Reference](https://airflow.apache.org/docs/apache-airflow/stable/configurations-ref.html) im *Apache Airflow Airflow-Referenzhandbuch.* Um auf die Optionen für die Version von Apache Airflow zuzugreifen, die Sie auf Amazon MWAA ausführen, wählen Sie die Version aus der Drop-down-Liste aus.
### Verwenden der Amazon MWAA-Konsole
Das folgende Verfahren führt Sie durch die Schritte zum Hinzufügen einer Airflow-Konfigurationsoption zu Ihrer Umgebung.
1. Öffnen Sie die Seite [Umgebungen](https://console.aws.amazon.com/mwaa/home#/environments) auf der Amazon MWAA-Konsole.
1. Wählen Sie eine Umgebung aus.
1. Wählen Sie **Bearbeiten** aus.
1. Wählen Sie **Weiter** aus.
1. Wählen Sie im Bereich mit den ****Airflow-Konfigurationsoptionen die Option Benutzerdefinierte Konfiguration** hinzufügen** aus.
1. Wählen Sie eine Konfiguration aus der Dropdownliste aus und geben Sie einen Wert ein, oder geben Sie eine benutzerdefinierte Konfiguration ein und geben Sie einen Wert ein.
1. Wählen Sie für jede **Konfiguration, die Sie hinzufügen möchten, die Option Benutzerdefinierte** Konfiguration hinzufügen aus.
1. Wählen Sie **Speichern**.
## Konfigurationsreferenz
Der folgende Abschnitt enthält die Liste der verfügbaren Apache Airflow Airflow-Konfigurationen in der Drop-down-Liste auf der Amazon MWAA-Konsole.
### E-Mail-Konfigurationen
Die folgende Liste zeigt die Konfigurationsoptionen für Airflow-E-Mail-Benachrichtigungen, die auf Amazon MWAA für Apache Airflow v2 und v3 verfügbar sind.
Wir empfehlen die Verwendung von Port 587 für SMTP-Verkehr. AWS Blockiert standardmäßig ausgehenden SMTP-Verkehr auf Port 25 aller EC2 Amazon-Instances. Wenn Sie ausgehenden Verkehr auf Port 25 senden möchten, können Sie [beantragen, dass diese Einschränkung aufgehoben wird](https://aws.amazon.com/premiumsupport/knowledge-center/ec2-port-25-throttle/).
| Option zur Konfiguration des Luftstroms | Description | Beispielwert |
| --- | --- | --- |
| email.email\$1backend | Das Apache Airflow Airflow-Hilfsprogramm, das für E-Mail-Benachrichtigungen in [email\$1backend](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#email-backend) verwendet wird. | airflow.utils.email.send\$1email\$1smtp |
| smtp.smtp\$1host | [Der Name des Ausgangsservers, der für die E-Mail-Adresse in smtp\$1host verwendet wird.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-host) | localhost |
| smtp.smtp\$1starttls | [Transport Layer Security (TLS) wird verwendet, um die E-Mail über das Internet in smtp\$1starttls zu verschlüsseln.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-starttls) | Falsch |
| smtp.smtp\$1ssl | [Secure Sockets Layer (SSL) wird verwendet, um den Server und den E-Mail-Client in smtp\$1ssl zu verbinden.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-ssl) | Wahr |
| smtp.smtp\$1port | [Der TCP-Port (Transmission Control Protocol), der dem Server in smtp\$1port zugewiesen wurde.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-port) | 587 |
| smtp.smtp\$1mail\$1von | [Die ausgehende E-Mail-Adresse in smtp\$1mail\$1from.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-mail-from) | myemail@domain.com |
### Aufgabenkonfigurationen
In der folgenden Liste werden die Konfigurationen angezeigt, die in der Dropdownliste für Airflow-Aufgaben auf Amazon MWAA für Apache Airflow v2 und v3 verfügbar sind.
| Airflow-Konfigurationsoption | Description | Beispielwert |
| --- | --- | --- |
| core.default\$1task\$1retries | [Gibt an, wie oft eine Apache Airflow Airflow-Aufgabe in default\$1task\$1retries wiederholt werden soll.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#default-task-retries) | 3 |
| core.parallelism | Die maximale Anzahl von Task-Instanzen, die gleichzeitig in der gesamten Umgebung parallel ausgeführt werden können ([Parallelität](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#parallelism)). | 40 |
### Scheduler-Konfigurationen
Die folgende Liste zeigt die Apache Airflow Scheduler-Konfigurationen, die in der Dropdownliste auf Amazon MWAA für Apache Airflow v2 und v3 verfügbar sind.
| Airflow-Konfigurationsoption | Description | Beispielwert |
| --- | --- | --- |
| scheduler.catchup\$1by\$1default | Weist den Scheduler an, einen DAG-Lauf zu erstellen, um das in [catchup\$1by\$1default](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#catchup-by-default) angegebene Zeitintervall „catch“. | Falsch |
| scheduler.scheduler\$1zombie\$1task\$1threshold Nicht verfügbar in Apache Airflow v3. | [Teilt dem Scheduler mit, ob die Task-Instanz als fehlgeschlagen markiert und die Aufgabe in scheduler\$1zombie\$1task\$1threshold neu geplant werden soll.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#scheduler-zombie-task-threshold) | 300 |
### Worker-Konfigurationen
Die folgende Liste zeigt die Airflow-Worker-Konfigurationen, die in der Drop-down-Liste auf Amazon MWAA für Apache Airflow v2 und v3 verfügbar sind.
| Airflow-Konfigurationsoption | Description | Beispielwert |
| --- | --- | --- |
| celery.worker\$1autoscale | [https://airflow.apache.org/docs/apache-airflow/2.0.2/executor/celery.html](https://airflow.apache.org/docs/apache-airflow/2.0.2/executor/celery.html) Der Wert muss in der folgenden Reihenfolge durch Kommas getrennt werden:. `max_concurrency,min_concurrency` | 16,12 |
### Webserver-Konfigurationen
Die folgende Liste zeigt die Apache Airflow-Webserver-Konfigurationen, die in der Drop-down-Liste auf Amazon MWAA für Apache Airflow v2 und v3 verfügbar sind.
| Airflow-Konfigurationsoption | Description | Beispielwert |
| --- | --- | --- |
| webserver.default\$1ui\$1timezone Nicht verfügbar in Apache Airflow v3. | [Die standardmäßige Datetime-Einstellung der Apache Airflow Airflow-Benutzeroberfläche in default\$1ui\$1timezone.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#default-ui-timezone) Die Einstellung dieser `default_ui_timezone` Option ändert nichts an der Zeitzone, in der Ihre Ausführung geplant ist. DAGs Um die Zeitzone für Sie zu ändern DAGs, können Sie ein benutzerdefiniertes Plugin verwenden. Weitere Informationen finden Sie unter [Ändern der Zeitzone einer DAG auf Amazon MWAA](samples-plugins-timezone.md). | Amerika/New\$1York |
### Konfigurationen auslösen
Die folgende Liste zeigt die Apache [Airflow-Triggerkonfigurationen](https://airflow.apache.org/docs/apache-airflow/stable/authoring-and-scheduling/deferring.html), die auf Amazon MWAA für Apache Airflow v2 und v3 verfügbar sind.
| Airflow-Konfigurationsoption | Description | Beispielwert |
| --- | --- | --- |
| mwaa.triggerer\$1enabled | Wird für die Aktivierung und Deaktivierung des Triggers auf Amazon MWAA verwendet. Standardmäßig ist dieser Wert auf `True` festgelegt. Wenn auf gesetzt`False`, startet Amazon MWAA keine auslösenden Prozesse auf Schedulern. | Wahr |
| triggerer.default\$1capacity (in Version 2) triggerer.capacity (in v3) | Definiert die Anzahl der Trigger, die jeder Trigger parallel ausführen kann. Bei Amazon MWAA wird diese Kapazität für jeden Trigger und für jeden Scheduler festgelegt, da beide Komponenten parallel ausgeführt werden. Die Standardeinstellung pro Scheduler ist auf`60`,,`125`, und `1000` für kleine `250``500`, mittlere und große, xlarge- und 2xlarge-Instances festgelegt. | 125 |
## Beispiele und Beispielcode
### Beispiel DAG
Sie können die folgende DAG verwenden, um Ihre `email_backend` Apache Airflow Airflow-Konfigurationsoptionen zu drucken. Um ihn als Reaktion auf Amazon MWAA-Ereignisse auszuführen, kopieren Sie den Code in den DAGs Ordner Ihrer Umgebung auf Ihrem Amazon S3 S3-Speicher-Bucket.
```
from airflow.decorators import dag
from datetime import datetime
def print_var(**kwargs):
email_backend = kwargs['conf'].get(section='email', key='email_backend')
print("email_backend")
return email_backend
@dag(
dag_id="print_env_variable_example",
schedule_interval=None,
start_date=datetime(yyyy, m, d),
catchup=False,
)
def print_variable_dag():
email_backend_test = PythonOperator(
task_id="email_backend_test",
python_callable=print_var,
provide_context=True
)
print_variable_test = print_variable_dag()
```
### Beispiel für Einstellungen für E-Mail-Benachrichtigungen
Die folgenden Apache Airflow Airflow-Konfigurationsoptionen können für ein Gmail.com-E-Mail-Konto mit einem App-Passwort verwendet werden. Weitere Informationen finden Sie [im Referenzhandbuch der *Gmail-Hilfe* unter Mit App-Passwörtern anmelden](https://support.google.com/mail/answer/185833?hl=en-GB).
![\[Dieses Bild zeigt, wie Sie ein gmail.com-E-Mail-Konto mithilfe der Apache Airflow Airflow-Konfigurationsoptionen auf der MWAA-Konsole konfigurieren.\]](http://docs.aws.amazon.com/de_de/mwaa/latest/userguide/images/mwaa-console-config-email-configuration.png)
## Als nächstes
+ Erfahren Sie unter, wie Sie Ihren DAG-Ordner in Ihren Amazon S3 S3-Bucket hochladen[Hinzufügen oder Aktualisieren DAGs](configuring-dag-folder.md).