

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à.

# Modifica della versione di Apache Airflow
<a name="upgrading-environment"></a>

 Amazon MWAA supporta upgrade e downgrade di versioni minori. Ciò significa che puoi aggiornare il tuo ambiente da una versione `x.4.z` all'altra o viceversa. `x.5.z` `x.5.z` `x.4.z` Per eseguire un aggiornamento della versione principale, ad esempio dalla versione `1.y.z` alla precedente`2.y.z`, è necessario creare un nuovo ambiente e migrare le risorse. *Per ulteriori informazioni sull'aggiornamento a una nuova versione principale di Apache Airflow, consulta la sezione [Migrazione a un nuovo ambiente Amazon MWAA nella Amazon MWAA Migration](https://docs.aws.amazon.com/mwaa/latest/migrationguide/migrating-to-new-mwaa.html) Guide.* 

Durante il processo di upgrade o downgrade, Amazon MWAA acquisisce un'istantanea dei metadati dell'ambiente, aggiorna o declassa i worker, gli scheduler e il server Web alla nuova versione di Apache Airflow e infine ripristina il database di metadati utilizzando lo snapshot.

Prima di eseguire l'upgrade o il downgrade, assicurati che le tue DAGs e le altre risorse del flusso di lavoro siano compatibili con la nuova versione di Apache Airflow a cui stai effettuando l'aggiornamento. Se lo utilizzi `requirements.txt` per gestire le dipendenze, devi anche assicurarti che le dipendenze specificate nei requisiti siano compatibili con la nuova versione.

**Topics**
+ [Aggiorna o riduci le risorse del flusso di lavoro](#upgrading-environment-resources)
+ [Specificare la nuova versione](#upgrading-environment-specify-version)

## Aggiorna o riduci le risorse del flusso di lavoro
<a name="upgrading-environment-resources"></a>

Ogni volta che modifichi le versioni di Apache Airflow, assicurati di fare [riferimento all'URL `--constraint` corretto nel](https://docs.aws.amazon.com/mwaa/latest/userguide/working-dags-dependencies.html#working-dags-dependencies-test-create) tuo. `requirements.txt`

**avvertimento**  
 La specificazione di requisiti incompatibili con la versione di Apache Airflow di destinazione durante un upgrade o un downgrade potrebbe comportare un lungo processo di rollback alla versione precedente di Apache Airflow con la versione dei requisiti precedente.

**Migra le risorse del tuo flusso di lavoro**

1. Crea un fork del [aws-mwaa-docker-images](https://github.com/aws/amazon-mwaa-docker-images)repository e clona una copia del runner locale Amazon MWAA.

1.  Esegui il checkout nel ramo del aws-mwaa-docker-images repository corrispondente alla versione a cui stai effettuando l'upgrade o il downgrade. 

1. Per aggiornare le tue`requirements.txt`, segui le best practice consigliate nella sezione [Managing Python dependencies](https://docs.aws.amazon.com/mwaa/latest/userguide/best-practices-dependencies.html), nella *Amazon MWAA* User Guide.

1.  (Facoltativo) Per accelerare il processo di aggiornamento o downgrade, [pulisci il database dei metadati dell'ambiente](samples-database-cleanup.md). L'aggiornamento degli ambienti con una grande quantità di metadati può richiedere molto più tempo.

1. Dopo aver testato con successo le risorse del flusso di lavoro, copia i tuoi DAGs e i plug-in nel bucket Amazon S3 del tuo ambiente. `requirements.txt`

Ora sei pronto per modificare l'ambiente, specificare una nuova versione di Apache Airflow e avviare la procedura di aggiornamento.

## Specificare la nuova versione
<a name="upgrading-environment-specify-version"></a>

Dopo aver completato l'aggiornamento delle risorse del flusso di lavoro per garantire la compatibilità con la nuova versione di Apache Airflow, procedi come segue per modificare i dettagli dell'ambiente e specificare la versione di Apache Airflow a cui desideri eseguire l'aggiornamento.

**Nota**  
Quando si esegue un aggiornamento o un downgrade, tutte le attività attualmente in esecuzione nell'ambiente vengono terminate durante la procedura. La procedura di aggiornamento può richiedere fino a due ore, durante le quali l'ambiente non sarà disponibile.

**Specificare una nuova versione utilizzando la console**

1. Apri la pagina [Ambienti](https://console.aws.amazon.com/mwaa/home#/environments) sulla console Amazon MWAA.

1.  Dall'elenco **Ambienti**, scegli l'ambiente di cui desideri aggiornare o effettuare il downgrade. 

1. Nella pagina dell'ambiente, scegli **Modifica** per modificare l'ambiente.

1.  Nella sezione **Dettagli sull'ambiente**, per la **versione Airflow**, scegli il numero di versione di Apache Airflow a cui desideri aggiornare o eseguire il downgrade dell'ambiente dall'elenco a discesa.

1. **Scegli **Avanti** fino alla pagina Rivedi e salva.**

1. Nella pagina **Rivedi e salva**, rivedi le modifiche, quindi scegli **Salva**.

Quando si applicano le modifiche, l'ambiente avvia la procedura di aggiornamento o downgrade. Durante questo periodo, lo [stato](https://docs.aws.amazon.com/mwaa/latest/API/API_Environment.html#mwaa-Type-Environment-Status) dell'ambiente indica le azioni intraprese da Amazon MWAA e l'esito positivo della procedura.

In uno scenario di upgrade o downgrade riuscito, lo stato sarà `UPDATING` quello in cui Amazon MWAA acquisirà `CREATING_SNAPSHOT` un backup dei metadati. Infine, lo stato tornerà prima a`UPDATING`, poi a `AVAILABLE` quando la procedura sarà completata.

Se l'aggiornamento o il downgrade dell'ambiente non riescono, lo stato dell'ambiente sarà lo stesso. `ROLLING_BACK` Se il rollback ha esito positivo, verrà innanzitutto visualizzato lo stato`UPDATE_FAILED`, a indicare che l'aggiornamento non è riuscito ma che l'ambiente è disponibile. Se il rollback fallisce, lo stato sarà `UNAVAILABLE` indicativo dell'impossibilità di accedere all'ambiente.