Развертывание в Docker локального шлюза Управления API Azure

ОБЛАСТЬ ПРИМЕНЕНИЯ: Разработчик | Премиум

В этой статье описано, как в среде Docker развернуть компонент локального шлюза Управления API Azure.

Внимание

Поддержка azure Управление API локального шлюза версии 0 и версии 1 образов контейнеров заканчивается 1 октября 2023 г. вместе с соответствующим API конфигурации версии 1. Используйте наше руководство по миграции для использования локального шлюза версии 2.0.0 или более поздней версии с API конфигурации версии 2. Дополнительные сведения см. в нашей документации по нерекомендуемым

Примечание.

Размещение локального шлюза в Docker лучше всего подходит для оценки и разработки. Для рабочей среды рекомендуется использовать Kubernetes. Узнайте, как развернуть с помощью Helm или использовать YAML-файл развертывания для развертывания локального шлюза в Kubernetes.

Необходимые компоненты

• Выполните задачи из краткого руководства по созданию экземпляра службы управления API Azure
• Создайте среду Docker. Docker Desktop — это хороший вариант для разработки и оценки. Сведения о всех выпусках Docker и их функциях, а также исчерпывающую информацию о работе с Docker см. в документации по Docker.
• Подготовка ресурса шлюза в экземпляре Управления API

Примечание.

Локальный шлюз упаковывается как контейнер Docker на основе Linux x86-64.

Развертывание локального шлюза в Docker

1. Выберите Gateways (Шлюзы) в разделе Deployment and infrastructure (Развертывание и инфраструктура).

2. Выберите ресурс шлюза, который нужно развернуть.

3. Выберите Deployment (Развертывание).

4. Обратите внимание, что маркер доступа в текстовом поле Token (Маркер) был создан автоматически с использованием значений Expiry (Срок действия) и Secret Key (Секретный ключ) по умолчанию. При необходимости выберите нужные значения в одном или обоих элементах управления, чтобы создать новый маркер.

5. Убедитесь, что в разделе Deployment scripts (Сценарии развертывания) выбран вариант Docker.

6. Выберите ссылку на файл env.conf рядом с элементом Environment (Среда), чтобы скачать файл.

7. Щелкните значок копирования в правой части текстового поля Run (Выполнение), чтобы скопировать команду 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, чтобы вывести все параметры просмотра журнала.

Следующие шаги

• Дополнительные сведения о локальном шлюзе см. в этой статье.
• Настройте личное доменное имя для локального шлюза.