次の方法で共有

Azure API Management のセルフホステッド ゲートウェイを Docker にデプロイする

  • [アーティクル]

適用対象: Developer | Premium

この記事では、Azure API Management のセルフホステッド ゲートウェイ コンポーネントを Docker 環境にデプロイする手順について説明します。

重要

Azure API Management セルフホステッド ゲートウェイ バージョン 0 およびバージョン 1 コンテナー イメージのサポートは、それに対応する Configuration API v1 とともに 2023 年 10 月 1 日に終了します。 Configuration API v2 でセルフホステッド ゲートウェイ v2.0.0 以上を使用するには、移行ガイドを使用してください。 非推奨に関するドキュメントで詳細を確認する

注意

セルフホステッド ゲートウェイを Docker でホストすることは、評価と開発のユースケースに最適です。 運用環境での使用には Kubernetes が推奨されます。 Helm を使用してデプロイする方法、またはデプロイ YAML ファイルを使用して、セルフホステッド ゲートウェイを Kubernetes にデプロイする方法について説明します。

前提条件

注意

セルフホステッド ゲートウェイは、x86-64 の Linux ベースの Docker コンテナーとしてパッケージ化されます。

Docker にセルフホステッド ゲートウェイをデプロイする

  1. [Deployment and infrastructure](デプロイとインフラストラクチャ) から [ゲートウェイ] を選択します。

  2. デプロイするゲートウェイ リソースを選択します。

  3. [Deployment]/(デプロイ/) を選択します。

  4. [トークン] テキスト ボックスのアクセス トークンが、既定の [有効期限] および [秘密鍵] の値を使用して、自動生成されたことに注意してください。 必要に応じて、いずれかまたは両方のコントロールで必要な値を選択して、新しいトークンを生成します。

  5. [デプロイ スクリプト] 下で [Docker] が選択されていることを確認します。

  6. [環境] の横にある env.conf ファイル リンクを選択して、ファイルをダウンロードします。

  7. [実行] テキスト ボックスの右端にある [コピー] アイコンを選択して、Docker コマンドをクリップボードにコピーします。

  8. コマンドをターミナル (またはコマンド) ウィンドウに貼り付けます。 必要に応じて、ポート マッピングとコンテナー名を調整します。 コマンドでは、ダウンロードした環境ファイルが現在のディレクトリに存在することが前提であることに注意してください。

    docker run -d -p 80:8080 -p 443:8081 --name <gateway-name> --env-file env.conf mcr.microsoft.com/azure-api-management/gateway:<tag>

  9. コマンドを実行します。 このコマンドは、Microsoft Artifact Registry からコンテナー イメージを使用してコンテナーを実行し、コンテナーの HTTP (8080) ポートと HTTPS (8081) ポートをホスト上のポート 80 と 443 にマップするように、Docker 環境に対して指示します。

  10. 次のコマンドを実行して、ゲートウェイ コンテナーが実行中であるかどうかを確認します。

    docker ps
CONTAINER ID        IMAGE                                                 COMMAND                  CREATED             STATUS              PORTS                                         NAMES
895ef0ecf13b        mcr.microsoft.com/azure-api-management/gateway:latest   "/bin/sh -c 'dotnet …"   5 seconds ago       Up 3 seconds        0.0.0.0:80->8080/tcp, 0.0.0.0:443->8081/tcp   my-gateway

  11. Azure portal に戻り、 [概要] をクリックして、デプロイしたばかりのセルフホステッド ゲートウェイ コンテナーが正常な状態を報告していることを確認します。

    ゲートウェイの状態

ヒント

console docker container logs <gateway-name> コマンドを使用して、セルフホステッド ゲートウェイ ログのスナップショットを表示します。

docker container logs --help コマンドを使用して、すべてのログ表示オプションを表示します。

次のステップ