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

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

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

Примечание.

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

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

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

Примечание.

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

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

1. Выберите локальные шлюзы в разделе "Развертывание и инфраструктура".

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

3. Выберите Параметры>Развертывание.

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

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

6. Выберите ссылку env.conf рядом с Environment для загрузки файла.

7. Щелкните значок Copy, расположенный в правом конце текстового поля 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 запустить контейнер с помощью образа контейнера из реестра артефактов Майкрософт, а также сопоставить порты 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, чтобы вывести все параметры просмотра журнала.

Связанный контент

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