Развертывание в 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.

Предварительные требования

Примечание

Локальный шлюз упаковывается как контейнер 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, чтобы вывести все параметры просмотра журнала.

Дальнейшие действия