

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Apache Airflow バージョンの変更
<a name="upgrading-environment"></a>

 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 環境への移行](https://docs.aws.amazon.com/mwaa/latest/migrationguide/migrating-to-new-mwaa.html) を参照してください。

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

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

**Topics**
+ [ワークフローリソースをアップグレードまたはダウングレードする](#upgrading-environment-resources)
+ [新しいバージョンを指定してください](#upgrading-environment-specify-version)

## ワークフローリソースをアップグレードまたはダウングレードする
<a name="upgrading-environment-resources"></a>

Apache Airflow のバージョンを変更するときは必ず、[`--constraint` 内の正しい `requirements.txt` URL お客様するようにしてください](https://docs.aws.amazon.com/mwaa/latest/userguide/working-dags-dependencies.html#working-dags-dependencies-test-create)。

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

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

1. [aws-mwaa-docker-images](https://github.com/aws/amazon-mwaa-docker-images) リポジトリのフォークを作成し、Amazon MWAA ローカルランナーのコピーをクローンしてください。

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

1. `requirements.txt` を更新するには、*Amazon MWAA ユーザーガイド* の [Python 依存関係の管理](https://docs.aws.amazon.com/mwaa/latest/userguide/best-practices-dependencies.html) で推奨されているベストプラクティスに従ってください。

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

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

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

## 新しいバージョンを指定してください
<a name="upgrading-environment-specify-version"></a>

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

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

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

1. Amazon MWAA コンソールで、[環境ページ](https://console.aws.amazon.com/mwaa/home#/environments) を開きます。

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

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

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

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

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

変更を適用すると、環境でアップグレードまたはダウングレードの手順が開始されます。この期間中、Amazon MWAA がどのようなアクションを実行しているか、および手順が成功したかどうかが環境の [ステータス](https://docs.aws.amazon.com/mwaa/latest/API/API_Environment.html#mwaa-Type-Environment-Status) でわかります。

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

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