Alterando a versão do Apache Airflow

O Amazon MWAA oferece suporte a atualizações e downgrades de versões menores. Isso significa que você pode atualizar seu ambiente de x.4.z uma versão para x.5.z ou de x.5.zx.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 no Guia de migração do Amazon MWAA.

Durante o processo de upgrade ou downgrade, o Amazon MWAA captura um instantâneo dos metadados do seu ambiente, atualiza ou rebaixa os trabalhadores, os programadores e o servidor web para a nova versão do Apache Airflow e, finalmente, restaura o banco de dados de metadados usando o snapshot.

Antes de fazer o upgrade ou o downgrade, verifique se seus recursos de fluxo de trabalho 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 o upgrade. Se você usa a 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.

Atualize ou rebaixe 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 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.

Migre seus recursos de fluxo de trabalho

1. Crie uma bifurcação do aws-mwaa-local-runnerrepositório e clone uma cópia do executor local do Amazon MWAA.

2. Faça o check-out na ramificação do aws-mwaa-local-runner repositório que corresponde à versão para a qual você está atualizando ou fazendo downgrade.

3. Use a ferramenta CLI do executor local Amazon MWAA para criar a imagem do Docker e executar o Apache Airflow localmente. Para obter mais informações, consulte o executor local README no GitHub repositório.

4. Para atualizar seu requirements.txt, siga as melhores práticas que recomendamos em Gerenciar dependências do Python, no Guia do usuário do Amazon MWAA.

5. (Opcional) Para acelerar o processo de upgrade ou downgrade, limpe o banco de dados de metadados do ambiente. Ambientes com uma grande quantidade de metadados podem levar muito mais tempo para serem atualizados.

6. Depois de testar com sucesso seus recursos de fluxo de trabalho, copie seus DAGs plug-ins para o bucket Amazon S3 do seu ambiente. requirements.txt

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 um upgrade 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.

Especifique uma nova versão usando o console

1. Abra a página Ambientes no console do Amazon MWAA.

2. Na lista Ambientes, escolha o ambiente que você deseja atualizar ou rebaixar.

3. Na página do ambiente, escolha Editar para editar o ambiente.

4. Na seção Detalhes do ambiente, para a versão do Airflow, escolha o número da versão do Apache Airflow para o qual você deseja atualizar ou rebaixar o ambiente na lista suspensa.

5. Escolha Avançar até que você esteja na página Revisar e salvar.

6. Na página Revisar e salvar, revise o resumo da política e depois escolha Salvar alterações para salvar seu trabalho.

Quando você aplica as alterações, seu ambiente inicia o procedimento de upgrade ou downgrade. Durante esse período, o status do seu ambiente indica quais ações o Amazon MWAA está tomando e se o procedimento foi bem-sucedido.

Em um cenário bem-sucedido de upgrade ou downgrade, o status será exibido UPDATING CREATING_SNAPSHOT quando o Amazon MWAA capturar 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 no downgrade, o status do seu ambiente será exibido. 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.