將 Azure API 管理自我裝載閘道部署至 Docker

適用於：開發人員 | 進階

本文說明將 Azure API 管理自我裝載閘道元件部署至 Docker 環境的步驟。

注意

在 Docker 中託管自託管閘道最適合評估和開發用例。 建議在生產環境中使用 Kubernetes。 瞭解如何使用 Helm 或使用 部署 YAML 檔案，將自我裝載閘道部署至 Kubernetes。

必要條件

• 完成下列快速入門：建立 Azure API 管理執行個體。
• 建立 Docker 環境： Docker for Desktop 是開發和評估目的的不錯選擇。 如需所有 Docker 版本、其功能及 Docker 完整說明文件的相關資訊，請參閱 Docker 說明文件。
• 在 Azure API 管理 執行個體中佈建閘道資源。

注意

自行託管的閘道會封裝為基於 x86-64 Linux 的 Docker 容器。

將自我裝載閘道部署至 Docker

1. 選取 部署 + 基礎設施 底下的 自我託管閘道。

2. 選取您要部署的閘道資源。

3. 選取設定>部署。

4. 請注意，Token 欄位中的存取權杖會使用預設的 到期 和 密鑰 值為您自動產生。 如有需要，請在兩個值中挑選需要的值，或同時使用這兩個值，來產生新的權杖。

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. 執行 命令。 此命令會指示您的 Docker 環境使用 Microsoft 成品登錄中的 容器映像 來執行容器，並將容器的 HTTP （8080） 和 HTTPS （8081） 埠對應至主機上的埠 80 和 443。

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 入口網站，選取 [ 概觀]，然後確認您剛才部署的自我裝載閘道容器會報告狀況良好的狀態。

    

提示

使用 console docker container logs <gateway-name> 命令來檢視自我裝載閘道記錄的快照集。

使用 docker container logs --help 命令來查看所有記錄檢視選項。

相關內容

• 若要深入瞭解自我裝載閘道，請參閱 自我裝載閘道概觀。
• 設定自我託管閘道的自訂網域名稱。