Azure API Management ゲートウェイを Azure Arc にデプロイする (プレビュー)

[アーティクル]
06/21/2023

適用対象: Developer | Premium

Azure API Management と Kubernetes 上の Azure Arc の統合により、API Management ゲートウェイコンポーネントを、Azure Arc 対応 Kubernetes クラスターの拡張機能としてデプロイできます。

API Management ゲートウェイを Azure Arc 対応 Kubernetes クラスターにデプロイすると、ハイブリッドおよびマルチクラウドの各環境のための API Management サポートが展開されます。クラスター拡張機能を使用したデプロイを有効にすると、ポリシーの管理と Azure Arc 対応クラスターへの適用を一貫した操作で行うことができます。

重要

Azure Arc での API Management セルフホステッドゲートウェイは、現在プレビュー段階です。プレビュー期間中、API Management ゲートウェイ拡張機能は次のリージョンで使用できます。

アジア (東、南東)
オーストラリア (中部、中部 2、東部、南東部)
ブラジル (南部と南東部)
カナダ (中部、東部)
ヨーロッパ (北、西)
フランス (中部と南部)
ドイツ (北部と西中部)
インド (中部、南、西、ジオ中央、ジオ西)
日本 (東部と西部)
韓国 (中部と南部)
ノルウェー (東部と西部)
南アフリカ (北部と西部)
スウェーデン (中部)
スイス (北部と西部)
アラブ首長国連邦 (UAE - 中部と北部)
イギリス (UK -南部)
米国 (US - 中部、中部 EUAP、東部、東部 2、東部 2 EUAP、北中部、南中部、西中部、西部、西部 2、西部 3)

Note

セルフホステッドゲートウェイを Kubernetes に直接デプロイすることもできます。

前提条件

サポートされている Azure Arc リージョン内で Kubernetes クラスターを接続する。
k8s-extension Azure CLI 拡張機能をインストールする。
```
az extension add --name k8s-extension
```
k8s-extension モジュールが既にインストールされている場合は、最新バージョンに更新する。
```
az extension update --name k8s-extension
```
Azure API Management インスタンスを作成する。
Azure API Management インスタンスにゲートウェイリソースをプロビジョニングする。

Azure CLI を使用して API Management ゲートウェイ拡張機能をデプロイする

Azure portal で、API Management インスタンスに移動します。
サイドナビゲーションメニューから [ゲートウェイ] を選択します。
一覧からプロビジョニング済みのゲートウェイリソースを選択して開きます。
プロビジョニング済みのゲートウェイリソースで、サイドナビゲーションメニューから [デプロイ] をクリックします。
次の手順のために、 [トークン] と [構成 URL] の値をメモします。

Azure CLI で、az k8s-extension create コマンドを使用してゲートウェイ拡張機能をデプロイします。 token と configuration URL の値を入力します。

次の例では、service.type='LoadBalancer' 拡張機能構成を使用しています。その他の使用可能な拡張機能構成も参照してください。

az k8s-extension create --cluster-type connectedClusters --cluster-name <cluster-name> \
    --resource-group <rg-name> --name <extension-name> --extension-type Microsoft.ApiManagement.Gateway \
    --scope namespace --target-namespace <namespace> \
    --configuration-settings gateway.configuration.uri='<Configuration URL>' \
    --config-protected-settings gateway.auth.token='<token>' \
    --configuration-settings service.type='LoadBalancer' --release-train preview

ヒント

gateway.auth.token の -protected- フラグは省略可能ですが、指定することをお勧めします。

次の CLI コマンドを使用してデプロイの状態を確認します。

az k8s-extension show --cluster-type connectedClusters --cluster-name <cluster-name> --resource-group <rg-name> --name <extension-name>

[ゲートウェイ] の一覧に戻り、ゲートウェイの状態で、ノード数と共に緑色のチェックマークが表示されていることを確認します。この状態は、デプロイされたセルフホステッドゲートウェイポッドが次の状態であることを示します。
- API Management サービスと正常に通信している。
- 定期的に "ハートビート" がある。

Azure portal を使用して API Management ゲートウェイ拡張機能をデプロイする

Azure portal で、Azure Arc 接続クラスターに移動します。
左側のメニューで、[拡張機能]>[+ 追加]>[API Management gateway (preview)](API Management ゲートウェイ (プレビュー)) を選択します。
［作成］ を選択します
[Install API Management gateway](API Management ゲートウェイのインストール) ウィンドウで、ゲートウェイ拡張機能を構成します。
- API Management インスタンスのサブスクリプションとリソースグループを選択します。
- [Gateway details](ゲートウェイの詳細) で、API Management インスタンスとゲートウェイ名 を選択します。拡張機能の [名前空間] スコープを入力し、必要に応じて [レプリカ] の数を入力します (お使いの API Management サービスレベルでサポートされている場合)。
- [Kubernetes 構成] で、クラスターの既定の構成または別の構成を選択します。オプションについては、「使用可能な拡張機能構成」を参照してください。
[監視] タブで、必要に応じて監視を有効にして、メトリック追跡要求をゲートウェイとバックエンドにアップロードします。有効にした場合、既存の Log Analytics ワークスペースを選択します。
[Review + install](確認とインストール) を選択し、 [インストール] を選択します。

使用可能な拡張機能構成

Azure Arc のセルフホステッドゲートウェイ拡張機能には、環境に合わせて拡張機能をカスタマイズするための多くの構成設定が用意されています。このセクションでは、Log Analytics との統合に必要なデプロイ設定とオプションの設定を示します。設定の完全なリストについては、セルフホステッドゲートウェイ拡張機能のリファレンスをご覧ください。

必須の設定

次の拡張機能構成は必須です。

設定	説明
`gateway.configuration.uri`	セルフホステッドゲートウェイの API Management サービスの構成エンドポイント。
`gateway.auth.token`	API Management サービスに対して認証するためのゲートウェイトークン (認証キー)。通常、`GatewayKey` で始まります。
`service.type`	ゲートウェイのための Kubernetes サービス構成: `LoadBalancer`、`NodePort`、または `ClusterIP`。

Log Analytics の設定

セルフホステッドゲートウェイの監視を有効にするには、次の Log Analytics 設定を構成します。

設定	Description
`monitoring.customResourceId`	API Management インスタンスの Azure Resource Manager リソース ID。
`monitoring.workspaceId`	Log Analytics のワークスペース ID。
`monitoring.ingestionKey`	Log Analytics からのインジェストキーを含むシークレット。