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à.
# Crea un ambiente Amazon MWAA
Amazon Managed Workflows for Apache Airflow configura Apache Airflow su un ambiente nella versione prescelta utilizzando lo stesso Apache Airflow open source e la stessa interfaccia utente disponibili da Apache. Questa guida descrive i passaggi per creare un ambiente Amazon MWAA.
**Contents**
+ [Prima di iniziare](#create-environment-before)
+ [Versioni Apache Airflow](#create-environment-regions-aa-versions)
+ [Creazione di un ambiente](#create-environment-start)
+ [Fase uno: specificare i dettagli](#create-environment-start-details)
+ [Fase due: configurare le impostazioni avanzate](#create-environment-start-advanced)
+ [Fase tre: revisione e creazione](#create-environment-start-review)
## Prima di iniziare
+ La [rete VPC](vpc-create.md) specificata per l'ambiente non può essere modificata dopo la creazione dell'ambiente.
+ È necessario un bucket Amazon S3 configurato per **bloccare tutti gli accessi pubblici**, con **Bucket** Versioning abilitato.
+ È necessario un Account AWS with [permissions per usare Amazon MWAA e un](manage-access.md) permesso in AWS Identity and Access Management (IAM) per creare ruoli IAM. Se scegli la modalità di accesso alla **rete privata** per il server web Apache Airflow, che limita l'accesso ad Apache Airflow all'interno del tuo Amazon VPC, avrai bisogno dell'autorizzazione in IAM per creare endpoint Amazon VPC.
**Nota**
Amazon MWAA determina dinamicamente la rete durante la creazione. Se utilizzi IPv6 sottoreti, Amazon MWAA crea una connettività di collegamento IPv6 privata al database e al server web. Amazon MWAA non supporta la transizione tra tipi di rete e non può aggiornare gli ambienti esistenti a. IPv6
## Versioni Apache Airflow
Le seguenti versioni di Apache Airflow sono supportate su Amazon Managed Workflows for Apache Airflow.
**Nota**
A partire dal 30 dicembre 2025, Amazon MWAA terminerà il supporto per le versioni di Apache Airflow v2.4.3, v2.5.1 e v2.6.3. Per ulteriori informazioni, vedi [Supporto per la versione di Apache Airflow e domande frequenti](airflow-versions.md#airflow-versions-support).
A partire da Apache Airflow v2.2.2, Amazon MWAA supporta l'installazione di requisiti Python, pacchetti provider e plug-in personalizzati direttamente sul server web Apache Airflow.
A partire da Apache Airflow v2.7.2, il file dei requisiti deve includere una dichiarazione. `--constraint` Se non fornisci un vincolo, Amazon MWAA te ne specificherà uno per garantire che i pacchetti elencati nei tuoi requisiti siano compatibili con la versione di Apache Airflow che stai utilizzando.
Per ulteriori informazioni sull'impostazione dei vincoli nel file dei requisiti, consulta Installazione delle dipendenze in [Python](working-dags-dependencies.md#working-dags-dependencies-syntax-create).
| Versione Apache Airflow | Data di rilascio di Apache Airflow | Data di disponibilità di Amazon MWAA | Vincoli di Apache Airflow | Versione di Python |
| --- | --- | --- | --- | --- |
| [v2.11.0](https://airflow.apache.org/docs/apache-airflow/2.11.0) | [20 maggio 2025](https://airflow.apache.org/docs/apache-airflow/2.11.0/release_notes.html#airflow-2-11-0-2022-05-20) | 7 gennaio 2026 | [file di vincoli v2.11.0](https://raw.githubusercontent.com/apache/airflow/constraints-2.11.0/constraints-3.12.txt) | [Python 3.12](https://peps.python.org/pep-0693/) |
| [versione 3.0.6](https://airflow.apache.org/docs/apache-airflow/3.0.6) | [29 agosto 2025](https://airflow.apache.org/docs/apache-airflow/3.0.6/release_notes.html#airflow-3-0-6-2025-08-29) | 1° ottobre 2025 | [file di vincoli v3.0.6](https://raw.githubusercontent.com/apache/airflow/constraints-3.0.6/constraints-3.12.txt) | [Python 3.12](https://peps.python.org/pep-0693/) |
| [v2.10.3](https://airflow.apache.org/docs/apache-airflow/2.10.3) | [4 novembre 2024](https://airflow.apache.org/docs/apache-airflow/2.10.3/release_notes.html#airflow-2-10-3-2024-11-04) | 18 dicembre 2024 | [file dei vincoli v2.10.3](https://raw.githubusercontent.com/apache/airflow/constraints-2.10.3/constraints-3.11.txt) | [Python 3.11](https://peps.python.org/pep-0664/) |
| [v2.10.1](https://airflow.apache.org/docs/apache-airflow/2.10.1) | [5 settembre 2024](https://airflow.apache.org/docs/apache-airflow/2.10.1/release_notes.html#airflow-2-10-1-2024-09-05) | 26 settembre 2024 | [file dei vincoli v2.10.1](https://raw.githubusercontent.com/apache/airflow/constraints-2.10.1/constraints-3.11.txt) | [Python 3.11](https://peps.python.org/pep-0664/) |
| [v2.9.2](https://airflow.apache.org/docs/apache-airflow/2.9.2) | [10 giugno 2024](https://airflow.apache.org/docs/apache-airflow/2.10.1/release_notes.html#airflow-2-9-2-2024-06-10) | 9 luglio 2024 | [file dei vincoli v2.9.2](https://raw.githubusercontent.com/apache/airflow/constraints-2.9.2/constraints-3.11.txt) | [Python 3.11](https://peps.python.org/pep-0664/) |
| [v2.8.1](https://airflow.apache.org/docs/apache-airflow/2.8.1) | [19 gennaio 2024](https://airflow.apache.org/docs/apache-airflow/2.10.1/release_notes.html#airflow-2-8-1-2024-01-19) | 23 febbraio 2024 | [file di vincoli v2.8.1](https://raw.githubusercontent.com/apache/airflow/constraints-2.8.1/constraints-3.11.txt) | [Python 3.11](https://peps.python.org/pep-0664/) |
| [v2.7.2](https://airflow.apache.org/docs/apache-airflow/2.7.2) | [12 ottobre 2023](https://airflow.apache.org/docs/apache-airflow/2.10.1/release_notes.html#airflow-2-7-2-2023-10-12) | 6 novembre 2023 | [file dei vincoli v2.7.2](https://raw.githubusercontent.com/apache/airflow/constraints-2.7.2/constraints-3.11.txt) | [Python 3.11](https://peps.python.org/pep-0664/) |
[Per ulteriori informazioni sulla migrazione delle distribuzioni di Apache Airflow autogestite o sulla migrazione di un ambiente Amazon MWAA esistente, incluse le istruzioni per il backup del database di metadati, consulta la Amazon MWAA Migration Guide.](https://docs.aws.amazon.com/mwaa/latest/migrationguide/index.html)
## Creazione di un ambiente
La sezione seguente descrive i passaggi per creare un ambiente Amazon MWAA.
### Fase uno: specificare i dettagli
**Per specificare i dettagli per l'ambiente**
1. Apri la console [Amazon MWAA](https://console.aws.amazon.com/mwaa/home/).
1. Seleziona il tuo. Regione AWS
1. Seleziona **Create environment (Crea ambiente)**.
1. Nella pagina **Specificare i dettagli**, in **Dettagli sull'ambiente**:
1. Inserisci un nome univoco per il tuo ambiente in **Nome**.
1. Scegli la versione Apache Airflow in **Versione Airflow**.
**Nota**
Se non viene specificato alcun valore, per impostazione predefinita viene utilizzata la versione più recente di Apache Airflow. L'ultima versione disponibile è Apache Airflow v3.0.6.
1. **Nel codice DAG in Amazon** S3, specifica quanto segue:
1. **Bucket S3**. Scegli **Browse S3** e seleziona il tuo bucket Amazon S3 oppure inserisci l'URI Amazon S3.
1. **DAGs folder**. Scegli **Browse S3** e seleziona la `dags` cartella nel tuo bucket Amazon S3 oppure inserisci l'URI Amazon S3.
1. **File dei plugin***: opzionale.* Scegli **Browse S3** e seleziona il `plugins.zip` file nel tuo bucket Amazon S3 oppure inserisci l'URI Amazon S3.
1. **File dei requisiti***: opzionale.* Scegli **Browse S3** e seleziona il `requirements.txt` file nel tuo bucket Amazon S3 oppure inserisci l'URI Amazon S3.
1. **File di script di avvio: *facoltativo***, scegli **Sfoglia S3** e seleziona il file di script sul tuo bucket Amazon S3 oppure inserisci l'URI di Amazon S3.
1. Scegli **Next (Successivo)**.
### Fase due: configurare le impostazioni avanzate
**Configurazione delle impostazioni avanzate**
1. Nella pagina **Configura impostazioni avanzate**, in **Rete**:
1. Scegli il tuo [Amazon VPC](vpc-create.md).
Questo passaggio popola due sottoreti private nel tuo Amazon VPC.
1. In **Accesso al server web**, seleziona la modalità di accesso [Apache Airflow](configuring-networking.md) preferita:
1. **Rete privata.** Ciò limita l'accesso all'interfaccia utente di Apache Airflow agli utenti *all'interno del tuo Amazon VPC* a cui è stato concesso l'accesso alla policy IAM per [il](access-policies.md) tuo ambiente. È necessaria l'autorizzazione per creare endpoint Amazon VPC per questa fase.
**Nota**
Scegli l'opzione **Rete privata** se si accede all'interfaccia utente di Apache Airflow solo all'interno di una rete aziendale e non è necessario l'accesso a repository pubblici per l'installazione dei requisiti del server web. Se scegli questa opzione di modalità di accesso, devi creare un meccanismo per accedere al tuo server web Apache Airflow nel tuo Amazon VPC. Per ulteriori informazioni, vedi [Accesso all'endpoint VPC per il server web Apache Airflow (accesso alla rete privata)](vpc-vpe-access.md#vpc-vpe-access-endpoints).
1. **Rete pubblica.** Ciò consente l'accesso all'interfaccia utente di Apache Airflow tramite Internet agli utenti a cui è concesso l'accesso alla [policy IAM per il tuo ambiente](access-policies.md).
1. In **Gruppi di sicurezza**, scegli il gruppo di sicurezza utilizzato per proteggere il tuo [Amazon VPC](vpc-create.md):
1. **Per impostazione predefinita, Amazon MWAA crea un gruppo di sicurezza nel tuo Amazon VPC con regole specifiche in entrata e in uscita in Crea nuovo gruppo di sicurezza.**
1. **Facoltativo**. Deseleziona la casella di controllo in **Crea nuovo gruppo di sicurezza per selezionare fino a 5 gruppi** di sicurezza.
**Nota**
Un gruppo di sicurezza Amazon VPC esistente deve essere configurato con regole specifiche in entrata e in uscita per consentire il traffico di rete. Per ulteriori informazioni, consulta. [Sicurezza nel tuo VPC su Amazon MWAA](vpc-security.md)
1. In **Classe Ambiente**, scegliete una [classe di ambiente](environment-class.md).
Ti consigliamo di scegliere la dimensione più piccola necessaria per supportare il tuo carico di lavoro. Puoi cambiare la classe di ambiente in qualsiasi momento.
1. Per **Numero massimo di lavoratori**, specifica il numero massimo di lavoratori Apache Airflow da eseguire nell'ambiente.
Per ulteriori informazioni, vedi [Esempio di utilizzo ad alte prestazioni](mwaa-autoscaling.md#mwaa-autoscaling-high-volume).
1. Specificate il numero **massimo di server Web e il numero** **minimo di server Web** per configurare il modo in cui Amazon MWAA ridimensiona i server Web Apache Airflow nel tuo ambiente.
Per ulteriori informazioni sulla scalabilità automatica dei server Web, consulta. [Configurazione della scalabilità automatica del server web Amazon MWAA](mwaa-web-server-autoscaling.md)
1. In **Crittografia**, scegli un'opzione di crittografia dei dati:
1. Per impostazione predefinita, Amazon MWAA utilizza una chiave AWS di proprietà per crittografare i dati.
1. **Facoltativo**. Scegli **Personalizza le impostazioni di crittografia (avanzate)** per scegliere una chiave diversa. AWS KMS Se si sceglie di specificare una [chiave gestita dal cliente](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk) in questo passaggio, è necessario specificare un ID AWS KMS chiave o un ARN. [AWS KMS gli alias e le chiavi multiregionali non sono supportati da Amazon](custom-keys-certs.md) MWAA. Se hai specificato una chiave Amazon S3 per la crittografia lato server sul tuo bucket Amazon S3, devi specificare la stessa chiave per il tuo ambiente Amazon MWAA.
**Nota**
È necessario disporre delle autorizzazioni per la chiave per selezionarla sulla console Amazon MWAA. È inoltre necessario concedere le autorizzazioni ad Amazon MWAA per utilizzare la chiave allegando la politica descritta in. [Allega una politica chiave](custom-keys-certs.md#custom-keys-certs-grant-policies-attach)
1. **Consigliato**. In **Monitoraggio**, scegli una o più categorie di log per la **configurazione di registrazione Airflow per inviare i log** di Apache Airflow a Logs: CloudWatch
1. Registri delle **attività** di Airflow. **Scegli il tipo di log delle attività di Apache Airflow da inviare CloudWatch a Logs in Log level.**
1. **Registri del server web Airflow.** **Scegli il tipo di log del server web Apache Airflow da inviare CloudWatch al livello Logs in Log.**
1. **Registri dello scheduler Airflow.** **Scegli il tipo di log dello scheduler Apache Airflow da inviare CloudWatch a Logs in Log level.**
1. **Registri degli operatori di Airflow.** **Scegli il tipo di log di lavoro Apache Airflow da inviare CloudWatch a Logs in Log level.**
1. **Registri di elaborazione Airflow DAG**. **Scegli il tipo di log di elaborazione Apache Airflow DAG da inviare CloudWatch al livello Logs in Log.**
1. **Facoltativo**. **Per le opzioni di configurazione **Airflow, scegli Aggiungi opzione di configurazione** personalizzata.**
Puoi scegliere dall'elenco a discesa suggerito delle opzioni di configurazione di [Apache Airflow per la tua versione di Apache Airflow o specificare opzioni di configurazione](configuring-env-variables.md) personalizzate. Ad esempio, `core.default_task_retries` : `3`.
1. **Facoltativo**. In **Tag**, scegli **Aggiungi nuovo tag per associare i tag** al tuo ambiente. Ad esempio,`Environment`:`Staging`.
1. In **Autorizzazioni**, scegli un ruolo di esecuzione:
1. Per impostazione predefinita, Amazon MWAA crea un [ruolo di esecuzione](mwaa-create-role.md) in **Crea un nuovo** ruolo. È necessario disporre dell'autorizzazione per creare ruoli IAM per utilizzare questa opzione.
1. **Facoltativo**. Scegli **Inserisci ruolo ARN** per inserire l'Amazon Resource Name (ARN) di un ruolo di esecuzione esistente.
1. Scegli **Next (Successivo)**.
### Fase tre: revisione e creazione
**Per esaminare un riepilogo dell'ambiente**
+ Esamina il riepilogo dell'ambiente, scegli **Crea ambiente**.
**Nota**
Occorrono dai venti ai trenta minuti per creare un ambiente.