適用対象: Basic | Standard | Premium
この記事では、API Management インスタンスで サービス更新 設定 (プレビュー) を構成する方法について説明します。 Azure では、段階的なロールアウト アプローチを使用して、API Management インスタンスにサービス更新プログラムが定期的に自動的に適用されます。 これらの更新プログラムには、新機能、セキュリティの強化、信頼性の向上が含まれます。
Azure が各 API Management インスタンスを更新するタイミングを正確に制御することはできませんが、一部のサービス レベルでは、インスタンスの 更新グループ ( リリース チャネルとも呼ばれます) を選択して、更新プログラムのロールアウト時よりも前または後に更新プログラムを受け取ることができます。 また、インスタンスで更新プログラムを受信する日に メンテナンス期間 を構成することもできます。
更新グループ - 運用ロールアウト中に API Management サービスの更新プログラムを受け取るインスタンスのセット。完了までに数日から数週間かかる場合があります。
次から選択します。
- 早期 - ロールアウトの早い段階で、テストと新機能への早期アクセスのための更新プログラムを受け取ります。 運用環境のデプロイでは、このオプションは推奨されません。
- 既定値 - 通常のリリース ロールアウトの一環として更新プログラムを受け取ります。 このオプションは、運用環境のデプロイを含むほとんどのサービスに推奨されます。
- [遅延] - 前のグループより後 (通常は最初のロールアウトから数週間後) に更新プログラムを受け取ります。 このオプションは、ミッション クリティカルなデプロイにのみ推奨されます。
- AI Gateway Early (GenAI リリース チャネル) - 他の更新グループにアクセスする前に、最新の AI ゲートウェイの機能と更新プログラム に早期にアクセスできます。 レイトロールアウト グループの一部として、他のサービスの更新を受け取ります。
注
Azure では、 安全なデプロイ プラクティス (SDP) フレームワークを使用して、すべての更新プログラムがデプロイされます。 ロールアウトの早い段階でリリースされた更新プログラムは、安定性が低く、後で安定したリリースに置き換えられる可能性があります。 すべてのインスタンスは、最終的に最も安定したリリース ビルドに更新されます。
たとえば、 早期 更新グループにテスト インスタンスを追加できます。 このインスタンスは、実稼働インスタンスの前に更新プログラムを受け取ります。この更新は、 既定 または 遅延 更新グループに配置します。 テスト インスタンスが運用環境のインスタンスに到達する前に、更新によって発生した問題を監視できます。 API Management を使用したカナリア デプロイの詳細を確認してください
メンテナンス期間 - インスタンスで更新プログラムを受信する 1 日 8 時間の期間。 既定では、メンテナンス期間はインスタンスのタイムゾーンで午後 10 時から午前 6 時です。
更新中のサービスの中断はまれですが、サービスの使用率が低い時間を選択してリスクを軽減したい場合があります。 たとえば、運用インスタンスの場合は、平日の夜と週末の朝にメンテナンス期間を設定します。
サービスの更新設定を構成する
- Azure portal にサインインし、API Management インスタンスに移動します。
- 左側のメニューで、 展開とインフラストラクチャ>サービスの更新設定を選択します。
- [ 更新] グループで、現在の設定を確認し、[ 編集] を選択して変更します。
- [ メンテナンス期間] で、現在の設定を確認し、[ 編集] を選択して変更します。 1 日ごとに、既定のウィンドウ、別の標準ウィンドウ、または日別のカスタム ウィンドウを選択できます。
インスタンスがいつ更新プログラムを受信するかを認識する
想定されている、または進行中のサービス更新プログラムについて知る方法を次に示します。
API Management の更新は、API Management GitHub リポジトリで発表されます。 更新プログラムのロールアウトが開始されるタイミングを知るために、このリポジトリから通知を受け取るためにサブスクライブします。
Azure アクティビティ ログを使用して、API Management インスタンスで実行されるサービス更新を監視します。 "予定メンテナンス" イベントは、更新が開始されたときに出力されます。
通知を自動的に受信するには、アクティビティ ログでアラートを設定します。
既定では、更新は次のフェーズでリージョンにロールアウトされます。まず最初に、Azure EUAP リージョン、その後に米国中西部、最後にそれ以外のリージョンがいくつかのフェーズに分けて続きます。 後のデプロイ フェーズで更新されるリージョンのシーケンスは、サービスによって異なります。 実稼働ロールアウトの各フェーズの間に少なくとも 24 時間を予測できます。
1 つのリージョン内では、Premium レベルの API Management インスタンスが、その他のサービス レベルのインスタンスの数時間後に更新プログラムを受信します。
ヒント
API Management インスタンスが複数の場所 (リージョン) にデプロイされている場合、更新のタイミングは、そのインスタンスのプライマリの場所によって決定されます。
カナリア デプロイ戦略
特定の更新グループに割り当てられた API Management インスタンス (そのオプションが使用可能な場合) を使用することも、運用インスタンスよりも前の更新プログラムを受け取るカナリア デプロイとして特定の Azure リージョンにデプロイすることもできます。
早期更新グループにインスタンスを追加 する - 運用ロールアウトの早い段階で更新プログラムを検証するには、早期更新グループの API Management インスタンスを使用します。 このインスタンスが実質的にカナリア デプロイです。
カナリア リージョンにデプロイ する - Azure EUAP リージョンにアクセスできる場合は、そこでインスタンスを使用して、運用パイプラインにリリースされるとすぐに更新プログラムを検証します。 「Azure リージョンのアクセス リクエストのプロセス」を参照してください。
注
EUAP リージョンでの容量の制約のために、必要に応じて API Management インスタンスをスケーリングできない場合があります。
パイロット リージョンにデプロイする - 米国中西部でインスタンスを使用して実稼働環境をシミュレートするか、またはそれを重要度の低い API トラフィックに対して実稼働環境で使用します。 このリージョンは EUAP リージョンの後に更新プログラムを受信しますが、そこにあるデプロイの方が、サービス構成に固有の回帰を識別する可能性は高くなります。
1 つのリージョンに重複したインスタンスをデプロイする - 実稼働ワークロードが特定のリージョン内の Premium レベルのインスタンスである場合は、同様に構成されたインスタンスを、その前に更新プログラムを受信するより低いレベルにデプロイすることを検討してください。 たとえば、更新プログラムを検証するために、Developer レベルで実稼働前インスタンスを構成します。