リファレンス: セルフホステッド ゲートウェイ コンテナーの構成設定

適用対象: Developer | Premium

この記事では、API Management セルフホステッド ゲートウェイ コンテナーを構成するために使われる必要な設定と省略可能な設定のリファレンスを提供します。

詳細については、 本番環境でKubernetes上でセルフホストゲートウェイを運用するためのガイダンスをご覧ください。

構成 API の統合

セルフホスト型ゲートウェイはConfiguration APIを使ってAzure API Managementに接続し、最新の設定を取得し、有効時にメトリクスを送信します。

以下の表は、Configuration API統合のための設定オプションを示しています。

セルフホスト型ゲートウェイは、Configuration APIと統合するための複数の認証オプションをサポートしています。 これらの選択肢は config.service.authを使って定義してください。

認証方法を定義するには、以下の情報を提供します。

• ゲートウェイ トークンベースの認証の場合は、セルフホステッド ゲートウェイのアクセス トークン (認証キー) を Azure portal の [ゲートウェイ]>[デプロイ] で指定します。
• Microsoft Entra ID ベースの認証の場合は、azureAdApp を指定して、追加の config.service.auth.azureAd 認証設定を指定します。

クロスインスタンスの発見と同期

HTTP

Kubernetes の統合

Kubernetes Ingress (preview)

メトリック

ログ

セキュリティ

証明書と暗号

TLS

ソブリン クラウド

以下の表は、ソブリンクラウドで動作するために設定しなければならない設定を示しています。

設定の構成方法

Kubernetes YAML ファイル

YAMLファイルを使って自己ホストゲートウェイをKubernetesに展開する際は、ゲートウェイのConfigMapのdata要素で設定を名前と値のペアとして設定してください。 次に例を示します。

apiVersion: v1
    kind: ConfigMap
    metadata:
        name: contoso-gateway-environment
    data:
        config.service.endpoint: "contoso.configuration.azure-api.net"
        telemetry.logs.std: "text"
        telemetry.logs.local.localsyslog.endpoint: "/dev/log"
        telemetry.logs.local.localsyslog.facility: "7"

[...]

Helm チャート

Helmを使ってセルフホストゲートウェイをKubernetesにデプロイする際は、チャートの設定設定をパラメータとしてhelm installコマンドに渡してください。 次に例を示します。

helm install azure-api-management-gateway \
    --set gateway.configuration.uri='contoso.configuration.azure-api.net' \
    --set gateway.auth.key='GatewayKey contosogw&xxxxxxxxxxxxxx...' \
    --set secret.createSecret=false \
    --set secret.existingSecretName='mysecret' \
    azure-apim-gateway/azure-api-management-gateway

関連コンテンツ

• 本番環境でのKubernetes上でセルフホストゲートウェイを運用する方法について詳しく学びましょう
• Docker にセルフホステッド ゲートウェイをデプロイする
• Kubernetes にセルフホステッド ゲートウェイをデプロイする
• Azure Arc 対応 Kubernetes クラスターにセルフホステッド ゲートウェイをデプロイする
• セルフホステッド ゲートウェイでの Dapr サポートの有効化
• Azure Arc 拡張機能の構成オプションの詳細を確認する