Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Cambio de versión de Apache Airflow
Amazon MWAA admite la actualización a versiones secundarias. Esto significa que puede actualizar su entorno de una versión `x.4.z` a otra `x.5.z` o de una versión `x.5.z` a otra `x.4.z`. Para realizar una actualización de una versión principal, por ejemplo, de una versión `1.y.z` a otra `2.y.z`, debe crear un entorno nuevo y migrar sus recursos. Para obtener más información sobre la actualización a una nueva versión principal de Apache Airflow, consulte [Migración a un nuevo entorno de Amazon MWAA](https://docs.aws.amazon.com/mwaa/latest/migrationguide/migrating-to-new-mwaa.html) en la *Guía de migración de Amazon MWAA*.
Durante el proceso de actualización, Amazon MWAA captura una instantánea de los metadatos del entorno, actualiza los procesos de trabajo, los programadores y el servidor web a la nueva versión de Apache Airflow y, finalmente, restaura la base de datos de metadatos con la instantánea.
Antes de actualizar, verifique que sus DAG y otros recursos de flujo de trabajo sean compatibles con la nueva versión de Apache Airflow a la que se está actualizando. Si usa `requirements.txt` para gestionar las dependencias, también debe verificar que las dependencias que especifique en los requisitos sean compatibles con la nueva versión.
**Topics**
+ [Actualice los recursos del flujo de trabajo](#upgrading-environment-resources)
+ [Especificación de la nueva versión](#upgrading-environment-specify-version)
## Actualice los recursos del flujo de trabajo
Siempre que cambie las versiones de Apache Airflow, asegúrese de hacer [referencia a la URL `--constraint` correcta](https://docs.aws.amazon.com/mwaa/latest/userguide/working-dags-dependencies.html#working-dags-dependencies-test-create) en su `requirements.txt`.
**aviso**
Si durante la actualización se especifican requisitos que no son compatibles con la versión de Apache Airflow de destino, el proceso de reversión a la versión anterior de Apache Airflow con la versión de requisitos anterior puede ser muy lento.
**Migre los recursos del flujo de trabajo**
1. Cree una bifurcación del repositorio [aws-mwaa-docker-images](https://github.com/aws/amazon-mwaa-docker-images) y clone una copia del ejecutor local de Amazon MWAA.
1. Diríjase a la rama del repositorio aws-mwaa-docker-images que coincida con la versión a la que se está actualizando.
1. Para actualizar los `requirements.txt`, siga las prácticas recomendadas que se indican en [Administrar las dependencias de Python](https://docs.aws.amazon.com/mwaa/latest/userguide/best-practices-dependencies.html), en la *Guía del usuario de Amazon MWAA*.
1. (Opcional) Para acelerar el proceso de actualización, [limpie la base de datos de metadatos del entorno](samples-database-cleanup.md). Los entornos con una gran cantidad de metadatos pueden tardar mucho más en actualizarse.
1. Una vez que haya probado correctamente los recursos de flujo de trabajo, copie los DAG, `requirements.txt` y plugins en el bucket de Amazon S3 de su entorno.
Ahora puede editar el entorno, especificar una nueva versión de Apache Airflow e iniciar el procedimiento de actualización.
## Especificación de la nueva versión
Cuando haya completado la actualización de los recursos de flujo de trabajo para garantizar la compatibilidad con la nueva versión de Apache Airflow, haga lo siguiente para editar los detalles del entorno y especificar la versión de Apache Airflow a la que desee actualizar.
**nota**
Al realizar una actualización, todas las tareas que se estén ejecutando en ese momento en el entorno finalizan durante el procedimiento. El procedimiento de actualización puede tardar hasta dos horas, durante las cuales el entorno no está disponible.
**Especifique una versión nueva mediante la consola**
1. Abra la página [Entornos](https://console.aws.amazon.com/mwaa/home#/environments) en la consola de Amazon MWAA.
1. En la lista **Environments** (Entornos), elija el entorno que desee actualizar.
1. En la página del entorno, elija **Editar** para editar el entorno.
1. En la sección **Detalles del entorno**, para la **versión Airflow**, elija en la lista desplegable el nuevo número de versión de Apache Airflow al que desee actualizar el entorno.
1. Elija **Siguiente** hasta llegar a la página **Revisar y guardar**.
1. En la página **Revisar y guardar**, revise los cambios y, a continuación, seleccione **Guardar**.
Al aplicar los cambios, el entorno comienza el procedimiento de actualización. Durante este proceso, el [estado](https://docs.aws.amazon.com/mwaa/latest/API/API_Environment.html#mwaa-Type-Environment-Status) de su entorno indica qué acciones está llevando a cabo Amazon MWAA y si el procedimiento se ha realizado correctamente.
Si la actualización se realiza correctamente, se mostrará el estado `UPDATING` y, a continuación `CREATING_SNAPSHOT`, cuando Amazon MWAA realice la copia de seguridad de los metadatos. Por último, el estado volverá primero a `UPDATING`, y después a `AVAILABLE`, cuando finalice el procedimiento.
Si el entorno no se actualiza, el entorno mostrará el estado `ROLLING_BACK`. Si la reversión se realiza correctamente, primero se mostrará el estado `UPDATE_FAILED`, lo que indica que la actualización no se ha realizado, pero que el entorno está disponible. Si se produce un error en la reversión, aparecerá el estado `UNAVAILABLE`, lo que indica que no se puede acceder al entorno.