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 バージョンにアップグレードまたはダウングレードし、最後にスナップショットを使用してメタデータデータベースを復元します。

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

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

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

警告

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

ワークフローリソースの移行

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

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

3. Amazon MWAA ローカルランナー CLI ツールを使用して Docker イメージをビルドし、Apache Airflow をローカルで実行します。詳細については、GitHub リポジトリのローカル・ランナー README を参照してください。

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

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

6. ワークフローリソースのテストに成功したら、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_SNAPSHOTAmazon MWAA がメタデータのバックアップをキャプチャします。最後に、ステータスはまず UPDATING に戻り、手順が完了すると AVAILABLE に戻ります。

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