Atualizando a versão do Apache Airflow

O Amazon MWAA é compatível com atualizações de versões anteriores. Isso significa que você pode atualizar seu ambiente de versão x.4.z para x.5.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 atualização, o Amazon MWAA captura um snapshot dos metadados do seu ambiente, atualiza os operadores, 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.

nota

Você não pode fazer regredir a versão do Apache Airflow para seu ambiente.

Antes de atualizar, 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 um 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 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 pode resultar em um longo processo de reversão para a versão anterior do Apache Airflow com a versão de requisitos anterior.

Para migrar seus recursos de fluxo de trabalho

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

2. Acesse a ramificação do repositório aws-mwaa-local-runner que corresponda à versão para a qual você está atualizando.

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 repositório GitHub.

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 atualização, 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, 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, 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.

Para especificar uma nova versão usando o console

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

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

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 novo número da versão do Apache Airflow para o qual você deseja atualizar 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.

Ao aplicar as alterações, seu ambiente inicia o procedimento de atualização. 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 de upgrade bem-sucedido, o status mostrará UPDATING, e depois CREATING_SNAPSHOT enquanto 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, o status do seu ambiente mostrará 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.