翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon MWAA 環境を更新する
**注記**
Amazon MWAA の正常なアップデートは、カナダ西部 (カルガリー) およびアジア太平洋 (マレーシア) リージョンではまだサポートされていません。
Amazon MWAA 環境の更新では、最新の変更とセキュリティパッチが適用されます。既存の設定を編集し、Apache Airflow バージョンをアップグレードすることもできます。このガイドでは、Amazon MWAA 環境を更新する手順について説明します。
**Contents**
+ [開始する前に](#update-environment-before)
+ [ワーカー置換戦略](#worker-replacement-strategy)
+ [環境リソースをアップデートする](#update-environment-resources)
+ [環境を更新する](#update-environment-start)
+ [ステップ1：詳細の指定](#update-environment-start-details)
+ [ステップ2：詳細設定の設定](#update-environment-start-advanced)
+ [ステップ 3: 確認と更新](#update-environment-start-review)
## 開始する前に
+ 環境に指定する [VPC ネットワーク](vpc-create.md) の内容は、環境作成後に変更することはできません。
+ **すべてのパブリックアクセスをブロック** し、**バケットバージョニング** 管理を有効にするには、Amazon S3 バケットを設定する必要があります。
+ [Amazon MWAA を使用する権限](manage-access.md) を持ち、AWS Identity and Access Management HIU(IAM) で IAM ロールを作成するアクセス許可を持つ AWS アカウント が必要です。Apache Airflow ウェブサーバー の **プライベートネットワーク** アクセスモードを選択して、Amazon VPC 内の Apache Airflow アクセスを制限する場合は、Amazon VPC エンドポイントを作成するために IAM のアクセス許可が必要になります。
+ 正常な環境更新を有効にするには、Apache Airflow バージョン 2.4.3 以上にアップグレードする必要があります。Airflow バージョンをアップグレードするには、[Apache Airflow バージョンの変更](upgrading-environment.md) を参照してください。
## ワーカー置換戦略
ワーカー置換戦略を選択して、環境の更新中に Amazon MWAA がアクティブなワーカーを処理する方法を制御できます。次のいずれかのオプションを選択できます。
**強制アップデート**
強制アップデートはデフォルトのワーカー置換戦略です。強制アップデートでは、すべてのアクティブなワーカーがすぐに停止し、アップデート中に実行中のタスクが失敗します。
**正常なアップデート**
正常なアップデートにより、ワーカーはシャットダウンする前に最大 12 時間タスクを実行し続けることができます。12 時間以内に終了する場合に限り、アップデートの中断によるタスクの失敗を防ぎます。新しいタスクはアップデートされたワーカーにルーティングされます。
既存の環境で正常なアップデートを有効にするには、**強制アップデート** を 1 回完了し、その環境が Apache Airflow バージョン 2.4.3 以降であることを確認する必要があります。
**注記**
環境のステータスが のときに更新を実行すると `MAINTENANCE`、進行中の環境更新のワーカー置換戦略は `GRACEFUL` から `FORCED` に切り替わります。アップデートは、メンテナンスが完了した後に実行されます。
## 環境リソースをアップデートする
Amazon MWAA 環境のアップデートでは、デフォルトで既存の環境設定が使用されます。現在の設定を変更せずに環境をアップデートするには:
1. Amazon MWAA コンソールで、[環境ページ](https://console.aws.amazon.com/mwaa/home#/environments) を開きます。
1. **環境** リストで、アップグレードしたい環境を選択します。
1. 環境ページで **編集** を選択して環境を編集します。
1. **レビューと保存** ページが表示されるまで、**次へ** を選択します。
1. **レビューと保存** ページで変更内容を確認し、**保存** を選択します。
## 環境を更新する
以下のセクションでは、Amazon MWAA 環境の更新手順について説明します。
### ステップ1：詳細の指定
**環境の詳細を指定します**
1. Amazon MWAA コンソールで、[環境ページ](https://console.aws.amazon.com/mwaa/home#/environments) を開きます。
1. **環境** リストで、アップグレードしたい環境を選択します。
1. 環境ページで **編集** を選択して環境を編集します。
1. [環境の詳細] セクションの [Airflow バージョン] で、環境をアップグレードしたい新しい Apache Airflow バージョン番号をドロップダウンリストから選択します。
**注記**
アップグレードする前に、DAG やその他のワークフローリソースが新しい Apache Airflow バージョンと互換性があることを確認してください。詳細については、[Apache Airflow バージョンの変更](upgrading-environment.md) を参照してください。
1. **Amazon S3 の DAG コード** で以下を指定します。
1. **S3 バケット**。**Browse S3**を選択して Amazon S3 バケットを選択するか、Amazon S3 URI を入力します。
1. **DAG フォルダー**。**Browse S3** を選択し、Amazon S3 バケット内の `dags` フォルダを選択するか、Amazon S3 URI を入力します。
1. **プラグインファイル - *オプション***。**Browse S3** を選択し、Amazon S3 バケット上の `plugins.zip` ファイルを選択するか、Amazon S3 の URI を入力します。
1. **要件ファイル - *オプション***.。**Browse S3** を選択し、Amazon S3 バケット上の `requirements.txt` ファイルを選択するか、Amazon S3 の URI を入力します。
1. **スタートアップスクリプトファイル - *オプション***、**参照S3** を選択し、Amazon S3 バケット上のスクリプトファイルを選択するか、Amazon S3 URI を入力します。
1. **次へ** を選択します。
### ステップ2：詳細設定の設定
**詳細設定を設定するには**
1. **ウェブサーバーアクセス**で、お好みの [Apache Airflow アクセスモード](configuring-networking.md) を選択します。
1. **プライベートネットワーク**。これは、Apache Airflow UI へのアクセスを、[あなたの環境の IAM ポリシー](access-policies.md)にアクセスを許可されたあなたの *Amazon VPC 内* のユーザーに制限します このステップには Amazon VPC エンドポイントを作成する権限が必要です。
**注記**
Apache Airflow UI にアクセスできるのは企業ネットワークのみで、ウェブサーバ要件をインストールするためにパブリックリポジトリにアクセスする必要がない場合は、**プライベートネットワーク** オプションを選択します。このアクセスモードオプションを選択する場合は、Amazon VPC 内の Apache Airflow ウェブサーバーにアクセスするメカニズムを作成する必要があります。詳細については、[Apache Airflow ウェブサーバーの VPC エンドポイントへのアクセス (プライベートネットワークアクセス)](vpc-vpe-access.md#vpc-vpe-access-endpoints) を参照してください。
1. **パブリックネットワーク**。これにより、[環境の IAM ポリシー](access-policies.md) へのアクセスを許可されたユーザーは、インターネット経由で Apache Airflow UI にアクセスできます。
1. **セキュリティグループ** で、[Amazon VPC](vpc-create.md) を保護するために使用するセキュリティグループを選択します。
1. デフォルトでは、Amazon MWAA は Amazon VPC にセキュリティグループを作成し、**新しいセキュリティグループの作成** で特定のインバウンドルールとアウトバウンドルールを設定します。
1. **オプション**。**新しいセキュリティグループの作成** のチェックボックスをオフにして、最大 5 つのセキュリティグループを選択します。
**注記**
既存の Amazon VPC セキュリティグループでは、ネットワークトラフィックを許可する特定のインバウンドルールとアウトバウンドルールを設定する必要があります。詳細については、[Amazon MWAA の VPC のセキュリティ](vpc-security.md) を参照してください。
1. **環境クラス** で、[環境クラス](environment-class.md) を選択します。
ワークロードをサポートするために必要な最小サイズを選択することをお勧めします。環境クラスは、随時変更できます。
1. **最大ワーカー数** は、環境内で実行する Apache Airflow ワーカーの最大数を指定します。
詳細については、[高パフォーマンスのユースケースの例](mwaa-autoscaling.md#mwaa-autoscaling-high-volume) を参照してください。
1. **最大ウェブサーバー数** と **最小ウェブサーバー数** を指定して、Amazon MWAA が環境内の Apache Airflow ウェブサーバーをスケールする方法を設定します。
ウェブサーバーの自動スケーリングの詳細については、[Amazon MWAA ウェブサーバーの自動スケーリングの設定](mwaa-web-server-autoscaling.md) を参照してください。
1. **暗号化** で、データ暗号化オプションを選択します。
1. デフォルトでは、Amazon MWAA AWS が所有キーを使用してデータを暗号化します。
1. **オプション**。**暗号化設定のカスタマイズ (アドバンスド)** を選択して別の AWS KMS キーを選択します。このステップで [カスタマーマネージドキー](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk) の指定を選択した場合は、AWS KMS キー ID または ARN を指定する必要があります。[Amazon MWAA は AWS KMS エイリアスとマルチゾーンキーをサポートしていません](custom-keys-certs.md)。Amazon S3 バケットでサーバー側の暗号化用に Amazon S3 キーを指定した場合、Amazon MWAA 環境にも同じキーを指定する必要があります。
**注記**
Amazon MWAA コンソールでキーを選択するには、そのキーに対するアクセス権限が必要です。また、[キーポリシーの添付](custom-keys-certs.md#custom-keys-certs-grant-policies-attach) で説明されているポリシーを追加して Amazon MWAA にキーを使用する権限を付与する必要があります。
1. **推奨**。**モニタリング** で、Apache Airflow ログを CloudWatch Logs に送信するための **Airflow ログ記録設定** のログカテゴリを 1 つ以上選択します。
1. **Airflow タスクログ**。**ログレベル** で CloudWatch ログに送信する Apache Airflow タスクログのタイプを選択します。
1. **Airflow ウェブサーバーのログ**。**ログレベル** で CloudWatch ログに送信する Apache Airflow タスクログのタイプを選択します。
1. **Airflow スケジューラーログ**。**ログレベル** で CloudWatch Logs に送信する Apache Airflow スケジューラログのタイプを選択します。
1. **Airflow ワーカーログ**。**ログレベル**で CloudWatch Logs に送信する Apache Airflow ワーカーログのタイプを選択します。
1. **Airflow DAG 処理ログ**。**ログレベル** で CloudWatch Logs に送信する Apache Airflow DAG 処理ログのタイプを選択します。
1. **オプション**。**エアフロー設定オプション**で、**カスタム設定オプションの追加** を選択します。
Apache Airflow バージョンの [Apache Airflow 構成オプション](configuring-env-variables.md) の推奨ドロップダウンリストから選択するか、カスタム設定オプションを指定できます。例えば、`core.default_task_retries` : `3` です。
1. **アクセス許可** で、実行ロールを選択する：
1. デフォルトでは、Amazon MWAA は **新しいロールの作成** で [実行ロール](mwaa-create-role.md)を作成します。このオプションを使用するには、IAM ロールを作成する権限が必要です。
1. **オプション**。**ロール ARN を入力** を選択して、既存の実行ロールの Amazon リソースネーム (ARN) を入力します。
1. **更新の仕様** で、[ワーカー置換戦略](#worker-replacement-strategy) を選択して、更新中のアクティブなワーカーの処理方法を制御します。
1. **次へ** を選択します。
### ステップ 3: 確認と更新
**環境の概要の表示**
+ 環境の概要を確認し、**保存** を選択します。
**注記**
強制更新を使用して環境を更新するには、約 20 ～ 30 分かかります。環境の正常なアップデートは、進行中のタスクが完了するまで待機するため、完了までに最大 12 時間かかる場合があります。