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

適用於：開發人員 | 進階

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

注意

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

必要條件

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

注意

自我裝載閘道會封裝為 x86-64 Linux 型 Docker 容器。

將自我裝載閘道部署至 Docker

1. 從[部署和基礎結構] 下選取 [閘道]。

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

3. 選取 [部署]。

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. 執行 命令。 此命令會指示 Docker 環境使用 Microsoft Artifact Registry 中的容器映像來執行容器，並將容器的 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 命令來查看所有記錄檢視選項。

下一步

• 若要深入了解自我裝載閘道，請參閱 Azure API 管理自我裝載閘道概觀。
• 為自我裝載閘道設定自訂網域名稱。