Apache Airflow バージョンの変更 - Amazon Managed Workflows for Apache Airflow
ワークフローリソースをアップグレードまたはダウングレードする新しいバージョンを指定してください

Apache Airflow バージョンの変更

Amazon MWAA はマイナーバージョンのアップグレードとダウングレードをサポートしています。これは、環境をバージョン x.4.z から x.5.z および x.5.z から x.4.z にアップグレードできることを意味します。メジャーバージョンのアップグレード、たとえばバージョン 1.y.z から 2.y.z へのアップグレードを行うには、新しい環境を作成し、リソースを移行する必要があります。Apache Airflow の新しいメジャーバージョンへのアップグレードの詳細については、Amazon MWAA 移行ガイド の 新しい Amazon MWAA 環境への移行 を参照してください。

アップグレードまたはダウングレードのプロセス中に、Amazon MWAA は環境メタデータのスナップショットをキャプチャし、ワーカー、スケジューラ、ウェブサーバーを新しい Apache Airflow バージョンにアップグレードまたはダウングレードし、最後にスナップショットを使用してメタデータデータベースを復元します。

アップグレードまたはダウングレードする前に、DAG やその他のワークフローリソースが、アップグレード先の新しい Apache Airflow バージョンと互換性があることを確認してください。requirements.txt を使用して依存関係を管理する場合は、要件で指定する依存関係が新しいバージョンと互換性があることも確認する必要があります。

ワークフローリソースをアップグレードまたはダウングレードする

Apache Airflow のバージョンを変更するときは必ず、--constraint 内の正しい requirements.txt URL お客様するようにしてください。

警告

アップグレードまたはダウングレード中に、対象の Apache Airflow バージョンと互換性のない要件を指定すると、以前の要件バージョンの Apache Airflow へのロールバックプロセスに時間がかかる可能性があります。

ワークフローリソースを移行するには

  1. aws-mwaa-docker-images リポジトリのフォークを作成し、Amazon MWAA ローカルランナーのコピーをクローンしてください。

  2. アップグレードまたはダウングレード後のバージョンに一致する aws-mwaa-docker-images リポジトリのブランチにチェックアウトします。

  3. requirements.txt を更新するには、Amazon MWAA ユーザーガイド の Python 依存関係の管理 で推奨されているベストプラクティスに従ってください。

  4. (オプション) アップグレードまたはダウングレードのプロセスを高速化するには、環境のメタデータデータベースをクリーンアップ します。メタデータの量が多い環境では、アップグレードにかなり時間がかかることがあります。

  5. ワークフローリソースのテストに成功したら、DAG、requirements.txt、およびプラグインを環境の Amazon S3 バケットにコピーします。

これで、環境を編集し、新しい Apache Airflow バージョンを指定して、更新手順を開始する準備ができました。

新しいバージョンを指定してください

ワークフローリソースの更新を完了して新しい Apache Airflow バージョンとの互換性を確認したら、次の手順を実行して環境の詳細を編集し、アップグレードする Apache Airflow のバージョンを指定します。

注記

アップグレードまたはダウングレードを実行すると、その手順の実行中に、環境上で現在実行されているすべてのタスクが終了します。アップデート手順には最大 2 時間かかることがあり、その間は環境が使用できなくなります。

コンソールを使用して新しいバージョンを指定する

  1. Amazon MWAA コンソールで、環境ページ を開きます。

  2. 環境 リストで、アップグレードまたはダウングレードする環境を選択します。

  3. 環境ページで 編集 を選択して環境を編集します。

  4. 環境の詳細 セクションの Airflow バージョン で、環境をアップグレードまたはダウングレードする新しい Apache Airflow バージョン番号をドロップダウンリストから選択します。

  5. レビューと保存 ページが表示されるまで、次へ を選択します。

  6. レビューと保存 ページで変更内容を確認し、保存 を選択します。

変更を適用すると、環境でアップグレードまたはダウングレードの手順が開始されます。この期間中、Amazon MWAA がどのようなアクションを実行しているか、および手順が成功したかどうかが環境の ステータス でわかります。

アップグレードまたはダウングレードが成功すると、ステータスは UPDATING が表示され、その後 CREATING_SNAPSHOT となり、Amazon MWAA がメタデータのバックアップをキャプチャします。最後に、ステータスはまず UPDATING に戻り、手順が完了すると AVAILABLE に戻ります。

環境のアップグレードに失敗した場合、環境のステータスは ROLLING_BACK を表示します。ロールバックが成功した場合、ステータスは最初に UPDATE_FAILED を表示し、これは更新が失敗したが環境は利用可能であることを示します。ロールバックが失敗した場合、ステータスは UNAVAILABLE を表示し、環境にアクセスできないことを示します。