As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Alterar a versão do Apache Airflow
O Amazon MWAA é compatível com atualizações e downgrades de versões secundárias. Isso significa que é possível atualizar seu ambiente de versão `x.4.z` para `x.5.z` ou da `x.5.z` para `x.4.z`. Para realizar uma atualização de versão principal, por exemplo, da versão `1.y.z` para `2.y.z`, você deve criar um novo ambiente e migrar seus recursos. Para obter mais informações sobre a atualização para uma nova versão principal do Apache Airflow, consulte [Migração para um novo ambiente do Amazon MWAA](https://docs.aws.amazon.com/mwaa/latest/migrationguide/migrating-to-new-mwaa.html) no *Guia de migração do Amazon MWAA*.
Durante o processo de atualização ou de downgrade, o Amazon MWAA captura um snapshot dos metadados do seu ambiente, atualiza ou faz downgrade dos operadores, dos agendadores e do servidor Web para a nova versão do Apache Airflow e, finalmente, restaura o banco de dados de metadados usando o snapshot.
Antes de atualizar ou fazer downgrade, certifique-se de que seus DAGs e outros recursos de fluxo de trabalho são compatíveis com a nova versão do Apache Airflow para a qual você está fazendo a atualização. Se você usa `requirements.txt` para gerenciar dependências, também deve garantir que as dependências especificadas em seus requisitos sejam compatíveis com a nova versão.
**Topics**
+ [Atualização ou downgrade de seus recursos de fluxo de trabalho](#upgrading-environment-resources)
+ [Especifique a nova versão](#upgrading-environment-specify-version)
## Atualização ou downgrade de seus recursos de fluxo de trabalho
Sempre que você estiver alterando as versões do Apache Airflow, certifique-se de [referenciar o URL correto do `--constraint`](https://docs.aws.amazon.com/mwaa/latest/userguide/working-dags-dependencies.html#working-dags-dependencies-test-create) no seu `requirements.txt`.
**Atenção**
Especificar requisitos que são incompatíveis com sua versão de destino do Apache Airflow durante uma atualização ou downgrade pode resultar em um longo processo de reversão para a versão anterior do Apache Airflow com a versão de requisitos anterior.
**Migrar seus recursos de fluxo de trabalho**
1. Crie uma bifurcação do repositório [aws-mwaa-docker-images](https://github.com/aws/amazon-mwaa-docker-images) e clone uma cópia do executor local do Amazon MWAA.
1. Acesse a ramificação do repositório aws-mwaa-docker-images que corresponda à versão para a qual você está atualizando ou fazendo downgrade.
1. Para atualizar seu `requirements.txt`, siga as melhores práticas que recomendamos em [Gerenciar dependências do Python](https://docs.aws.amazon.com/mwaa/latest/userguide/best-practices-dependencies.html), no *Guia do usuário do Amazon MWAA*.
1. Opcional: para acelerar o processo de atualização ou de downgrade, [limpe o banco de dados de metadados do ambiente](samples-database-cleanup.md). Ambientes com uma grande quantidade de metadados podem levar muito mais tempo para serem atualizados.
1. Depois de testar com sucesso seus recursos de fluxo de trabalho, copie seus DAGs, `requirements.txt` e plug-ins para o bucket DO Amazon S3 do seu ambiente.
Agora que você se preparou para editar o ambiente, especifique uma nova versão do Apache Airflow e inicie o procedimento de atualização.
## Especifique a nova versão
Depois de concluir a atualização dos recursos do fluxo de trabalho para garantir a compatibilidade com a nova versão do Apache Airflow, faça o que se segue para editar os detalhes do ambiente e especificar a versão do Apache Airflow para a qual você deseja atualizar.
**nota**
Quando você executa uma atualização ou downgrade, todas as tarefas atualmente em execução no ambiente são encerradas durante o procedimento. O procedimento de atualização pode levar até duas horas, período durante o qual seu ambiente ficará indisponível.
**Especificar uma nova versão usando o console**
1. Abra a [página Ambientes](https://console.aws.amazon.com/mwaa/home#/environments) no console do Amazon MWAA.
1. Na lista de **Ambientes**, escolha o ambiente que você deseja atualizar ou fazer downgrade.
1. Na página do ambiente, escolha **Editar** para editar o ambiente.
1. Na seção **Detalhes do ambiente**, para a **versão do Airflow**, escolha o novo número da versão do Apache Airflow para a qual você deseja atualizar ou fazer downgrade do ambiente na lista suspensa.
1. Escolha **Avançar** até que você esteja na página **Revisar e salvar**.
1. Na página **Revisar e salvar**, revise o resumo da política e depois escolha **Salvar alterações** para salvar seu trabalho.
Ao aplicar as alterações, seu ambiente inicia o procedimento de atualização ou downgrade. Durante esse período, o [status](https://docs.aws.amazon.com/mwaa/latest/API/API_Environment.html#mwaa-Type-Environment-Status) do seu ambiente indica quais ações o Amazon MWAA está tomando e se o procedimento foi bem-sucedido.
Em um cenário de atualização ou downgrade bem-sucedido, o status será `UPDATING` e depois `CREATING_SNAPSHOT`, à medida que o Amazon MWAA captura um backup dos seus metadados. Por fim, o status retornará primeiro para `UPDATING` e depois para `AVAILABLE` quando o procedimento for concluído.
Se o ambiente falhar na atualização ou downgrade, o status do seu ambiente será `ROLLING_BACK`. Se a reversão for bem-sucedida, o status mostrará primeiro `UPDATE_FAILED`, indicando que a atualização falhou, mas o ambiente está disponível. Se a reversão falhar, o status mostrará `UNAVAILABLE`, indicando que você não pode acessar o ambiente.