Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Utilizzo delle opzioni di configurazione Apache Airflow su Amazon MWAA
Le opzioni di configurazione di Apache Airflow possono essere collegate all'ambiente Amazon Managed Workflows for Apache Airflow come variabili di ambiente. Puoi scegliere dall'elenco a discesa suggerito o specificare opzioni di configurazione personalizzate per la tua versione di Apache Airflow sulla console Amazon MWAA. Questo argomento descrive le opzioni di configurazione di Apache Airflow disponibili e come utilizzarle per sovrascrivere le impostazioni di configurazione di Apache Airflow nel proprio ambiente.
**Contents**
+ [Prerequisiti](#configuring-env-variables-prereqs)
+ [Come funziona](#configuring-env-variables-how)
+ [Utilizzo delle opzioni di configurazione per caricare i plugin](#configuring-2.0-airflow-override)
+ [Panoramica delle opzioni di configurazione](#configuring-env-variables-customizing)
+ [Opzioni di configurazione di Apache Airflow](#configuring-env-variables-airflow-ref)
+ [Riferimento Apache Airflow](#configuring-env-variables-reference-options)
+ [Utilizzo della console Amazon MWAA](#configuring-env-variables-console-add)
+ [Informazioni di riferimento sulla configurazione](#configuring-env-variables-reference)
+ [Configurazioni e-mail](#configuring-env-variables-email)
+ [Configurazioni delle attività](#configuring-env-variables-tasks)
+ [Configurazioni dello scheduler](#configuring-env-variables-scheduler)
+ [Configurazioni dei lavoratori](#configuring-env-variables-workers)
+ [Configurazioni del server Web](#configuring-env-variables-webserver)
+ [Configurazioni Triggerer](#configuring-env-variables-webserver)
+ [Esempi e codice di esempio](#configuring-env-variables-code)
+ [Esempio DAG](#configuring-env-variables-dag)
+ [Esempio di impostazioni di notifica e-mail](#configuring-env-variables-email)
+ [Fasi successive](#configuring-env-variables-next-up)
## Prerequisiti
Avrai bisogno di quanto segue prima di completare i passaggi di questa pagina.
+ **Autorizzazioni**: Account AWS devi aver ottenuto l'accesso dal tuo amministratore alla politica di controllo degli MWAAFull ConsoleAccess accessi di [Amazon](access-policies.md#console-full-access) per il tuo ambiente. Inoltre, il tuo ambiente Amazon MWAA deve essere autorizzato dal tuo [ruolo di esecuzione](mwaa-create-role.md) ad accedere alle AWS risorse utilizzate dal tuo ambiente.
+ **Accesso****: se è necessario accedere agli archivi pubblici per installare le dipendenze direttamente sul server Web, l'ambiente deve essere configurato con l'accesso al server Web di rete pubblica.** Per ulteriori informazioni, vedi [Modalità di accesso ad Apache Airflow](configuring-networking.md).
+ **Configurazione Amazon S3** **: il bucket [Amazon S3](mwaa-s3-bucket.md) utilizzato per archiviare i plug-in `plugins.zip` personalizzati e DAGs le `requirements.txt` dipendenze Python deve essere configurato con Public Access Blocked e Versioning Enabled.**
## Come funziona
Quando crei un ambiente, Amazon MWAA allega le impostazioni di configurazione specificate nella console Amazon MWAA nelle **opzioni di configurazione Airflow** come variabili di ambiente al contenitore per il tuo ambiente. AWS Fargate Se utilizzi un'impostazione con lo stesso nome in`airflow.cfg`, le opzioni specificate nella console Amazon MWAA sostituiscono i valori in. `airflow.cfg`
Sebbene per impostazione predefinita non esponiamo le `airflow.cfg` opzioni di configurazione di Apache Airflow di un ambiente Amazon MWAA, puoi modificare le opzioni di configurazione di Apache Airflow direttamente sulla console Amazon MWAA, inclusa l'impostazione per l'esposizione delle configurazioni. `webserver.expose_config`
## Utilizzo delle opzioni di configurazione per caricare i plugin
Per impostazione predefinita, in Apache Airflow v2 e versioni successive, i plugin sono configurati per essere caricati «pigramente» utilizzando l'impostazione. `core.lazy_load_plugins : True` Se utilizzi plug-in personalizzati, devi aggiungere `core.lazy_load_plugins : False` un'opzione di configurazione Apache Airflow per caricare i plug-in all'inizio di ogni processo Airflow per sovrascrivere l'impostazione predefinita.
## Panoramica delle opzioni di configurazione
Quando aggiungi una configurazione sulla console Amazon MWAA, Amazon MWAA scrive la configurazione come variabile di ambiente.
+ **Opzioni elencate.** Puoi scegliere una delle impostazioni di configurazione disponibili per la tua versione di Apache Airflow nell'elenco a discesa. Ad esempio, `dag_concurrency` : `16`. L'impostazione di configurazione viene tradotta nel contenitore Fargate dell'ambiente come `AIRFLOW__CORE__DAG_CONCURRENCY : 16`
+ **Opzioni personalizzate**. Puoi anche specificare opzioni di configurazione Airflow che non sono elencate per la tua versione di Apache Airflow nell'elenco a discesa. Ad esempio, `foo.user` : `YOUR_USER_NAME`. L'impostazione di configurazione viene tradotta nel contenitore Fargate dell'ambiente come `AIRFLOW__FOO__USER : YOUR_USER_NAME`
### Opzioni di configurazione di Apache Airflow
L'immagine seguente mostra dove è possibile personalizzare le **opzioni di configurazione di Apache Airflow** sulla console Amazon MWAA.
![\[Questa immagine mostra dove è possibile personalizzare le opzioni di configurazione di Apache Airflow sulla console Amazon MWAA.\]](http://docs.aws.amazon.com/it_it/mwaa/latest/userguide/images/mwaa-console-airflow-config.png)
### Riferimento Apache Airflow
Per un elenco delle opzioni di configurazione supportate da Apache Airflow, consulta [Configuration Reference nella guida di](https://airflow.apache.org/docs/apache-airflow/stable/configurations-ref.html) riferimento di Apache *Airflow*. Per accedere alle opzioni per la versione di Apache Airflow in esecuzione su Amazon MWAA, seleziona la versione dall'elenco a discesa.
### Utilizzo della console Amazon MWAA
La procedura seguente illustra i passaggi per aggiungere un'opzione di configurazione Airflow al tuo ambiente.
1. Apri la pagina [Ambienti](https://console.aws.amazon.com/mwaa/home#/environments) sulla console Amazon MWAA.
1. Scegli un ambiente.
1. Scegli **Modifica**.
1. Scegli **Next (Successivo)**.
1. Scegli **Aggiungi configurazione personalizzata** nel riquadro delle **opzioni di configurazione Airflow**.
1. Scegli una configurazione dall'elenco a discesa e inserisci un valore, oppure inserisci una configurazione personalizzata e inserisci un valore.
1. Scegli **Aggiungi configurazione personalizzata** per ogni configurazione che desideri aggiungere.
1. Scegli **Save** (Salva).
## Informazioni di riferimento sulla configurazione
La sezione seguente contiene l'elenco delle configurazioni Apache Airflow disponibili nell'elenco a discesa sulla console Amazon MWAA.
### Configurazioni e-mail
L'elenco seguente mostra le opzioni di configurazione delle notifiche e-mail Airflow disponibili su Amazon MWAA per Apache Airflow v2 e v3.
Si consiglia di utilizzare la porta 587 per il traffico SMTP. Per impostazione predefinita, AWS blocca il traffico SMTP in uscita sulla porta 25 di tutte le istanze Amazon EC2 . Se desideri inviare traffico in uscita sulla porta 25, puoi [richiedere la rimozione di questa restrizione](https://aws.amazon.com/premiumsupport/knowledge-center/ec2-port-25-throttle/).
| Opzione di configurazione del flusso d'aria | Description | Valore di esempio |
| --- | --- | --- |
| email.email\$1backend | [L'utilità Apache Airflow utilizzata per le notifiche e-mail in email\$1backend.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#email-backend) | airflow.utils.email.send\$1email\$1smtp |
| smtp.smtp\$1host | [Il nome del server in uscita utilizzato per l'indirizzo e-mail in smtp\$1host.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-host) | localhost |
| smtp.smtp\$1starttls | [Transport Layer Security (TLS) viene utilizzato per crittografare le e-mail su Internet in smtp\$1starttls.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-starttls) | False |
| smtp.smtp\$1ssl | [Secure Sockets Layer (SSL) viene utilizzato per connettere il server e il client di posta elettronica in smtp\$1ssl.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-ssl) | True |
| porta smtp.smtp\$1 | [La porta TCP (Transmission Control Protocol) designata al server in smtp\$1port.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-port) | 587 |
| smtp.smtp\$1mail\$1from | [L'indirizzo e-mail in uscita in smtp\$1mail\$1from.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-mail-from) | myemail@domain.com |
### Configurazioni delle attività
L'elenco seguente mostra le configurazioni disponibili nell'elenco a discesa per le attività Airflow su Amazon MWAA per Apache Airflow v2 e v3.
| Opzione di configurazione Airflow | Description | Valore di esempio |
| --- | --- | --- |
| core.default\$1task\$1retries | [Il numero di volte in cui riprovare un'attività Apache Airflow in default\$1task\$1retries.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#default-task-retries) | 3 |
| core.parallelismo | Il numero massimo di istanze di attività che possono essere eseguite contemporaneamente nell'intero ambiente in parallelo ([parallelismo](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#parallelism)). | 40 |
### Configurazioni dello scheduler
L'elenco seguente mostra le configurazioni dello scheduler di Apache Airflow disponibili nell'elenco a discesa di Amazon MWAA per Apache Airflow v2 e v3.
| Opzione di configurazione Airflow | Description | Valore di esempio |
| --- | --- | --- |
| scheduler.catchup\$1by\$1default | [Indica allo scheduler di creare un'esecuzione DAG per «recuperare» l'intervallo di tempo specifico in catchup\$1by\$1default.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#catchup-by-default) | False |
| scheduler.scheduler\$1zombie\$1task\$1threshold Non disponibile in Apache Airflow v3. | [Indica allo scheduler se contrassegnare l'istanza dell'attività come non riuscita e riprogrammarla in scheduler\$1zombie\$1task\$1threshold.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#scheduler-zombie-task-threshold) | 300 |
### Configurazioni dei lavoratori
L'elenco seguente mostra le configurazioni Airflow Worker disponibili nell'elenco a discesa di Amazon MWAA per Apache Airflow v2 e v3.
| Opzione di configurazione Airflow | Description | Valore di esempio |
| --- | --- | --- |
| 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) Il valore deve essere separato da virgole nel seguente ordine:. `max_concurrency,min_concurrency` | 16,12 |
### Configurazioni del server Web
L'elenco seguente mostra le configurazioni del server web Apache Airflow disponibili nell'elenco a discesa di Amazon MWAA per Apache Airflow v2 e v3.
| Opzione di configurazione Airflow | Description | Valore di esempio |
| --- | --- | --- |
| webserver.default\$1ui\$1timezone Non disponibile in Apache Airflow v3. | [L'impostazione datetime predefinita dell'interfaccia utente Apache Airflow in default\$1ui\$1timezone.](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#default-ui-timezone) L'impostazione dell'`default_ui_timezone`opzione non modifica il fuso orario in cui è programmata l'esecuzione. DAGs Per modificare il fuso orario del tuo DAGs, puoi utilizzare un plug-in personalizzato. Per ulteriori informazioni, vedi [Modifica del fuso orario di un DAG su Amazon MWAA](samples-plugins-timezone.md). | America/New\$1York |
### Configurazioni Triggerer
L'elenco seguente mostra le configurazioni dei trigger di Apache [Airflow](https://airflow.apache.org/docs/apache-airflow/stable/authoring-and-scheduling/deferring.html) disponibili su Amazon MWAA per Apache Airflow v2 e v3.
| Opzione di configurazione Airflow | Description | Valore di esempio |
| --- | --- | --- |
| mwaa.triggerer\$1enabled | Utilizzato per attivare e disattivare il trigger su Amazon MWAA. Per impostazione predefinita, questo valore è impostato su `True`. Se impostato su`False`, Amazon MWAA non avvierà alcun processo di attivazione sugli scheduler. | True |
| triggerer.default\$1capacity (nella v2) triggerer.capacity (nella v3) | Definisce il numero di trigger che ogni trigger può eseguire in parallelo. Su Amazon MWAA, questa capacità è impostata per ogni trigger e per ogni scheduler poiché entrambi i componenti funzionano insieme. L'impostazione predefinita per scheduler è impostata su`60`,, `125``250`, e `1000` per istanze piccole`500`, medie e grandi, xlarge e 2xlarge, rispettivamente. | 125 |
## Esempi e codice di esempio
### Esempio DAG
È possibile utilizzare il seguente DAG per stampare le opzioni di configurazione di `email_backend` Apache Airflow. Per eseguirlo in risposta agli eventi di Amazon MWAA, copia il codice DAGs nella cartella del tuo ambiente sul bucket di storage Amazon S3.
```
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()
```
### Esempio di impostazioni di notifica e-mail
Le seguenti opzioni di configurazione di Apache Airflow possono essere utilizzate per un account di posta elettronica Gmail.com utilizzando una password dell'app. *Per ulteriori informazioni, consulta [Accedi utilizzando le password delle app nella guida](https://support.google.com/mail/answer/185833?hl=en-GB) di riferimento dell'assistenza di Gmail.*
![\[Questa immagine mostra come configurare un account di posta elettronica gmail.com utilizzando le opzioni di configurazione Apache Airflow sulla console MWAA.\]](http://docs.aws.amazon.com/it_it/mwaa/latest/userguide/images/mwaa-console-config-email-configuration.png)
## Fasi successive
+ Scopri come caricare la tua cartella DAG nel tuo bucket Amazon S3 in. [Aggiungere o aggiornare DAGs](configuring-dag-folder.md)