Развертывание локального шлюза Azure Управление API для Служба Azure Kubernetes

  • Статья

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

В этой статье описаны действия по развертыванию в Службе Azure Kubernetes компонента локального шлюза службы "Управление API" Azure. Сведения о развертывании локального шлюза в кластере Kubernetes см. в статье по развертыванию с помощью YAML-файла развертывания или Helm.

Внимание

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

Примечание.

Также можно развернуть локальный шлюз в кластере Kubernetes с поддержкой Azure Arc в качестве расширения кластера.

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

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

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

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

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

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

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

  6. Выберите ссылку на файл <gateway-name>.yml рядом с элементом Deployment (Развертывание), чтобы скачать файл.

  7. При необходимости измените в YML-файле config.service.endpoint, сопоставления портов и имя контейнера.

  8. В зависимости от ситуации может потребоваться изменить тип службы.

    • Значение по умолчанию LoadBalancer указывает на внешний балансировщик нагрузки.
    • Вы можете использовать внутренний балансировщик нагрузки, чтобы доступ к локальному шлюзу могли получить только внутренние пользователи.
    • В примере ниже используется NodePort.

  9. Щелкните значок копирования в правой части текстового поля Deploy (Развернуть), чтобы сохранить команду kubectl в буфер обмена.

  10. Вставьте команду в окно терминала (или командной строки). Команда предполагает, что скачанный файл среды находится в текущем каталоге.

    kubectl apply -f <gateway-name>.yaml

  11. Выполните команду . Команда указывает кластеру AKS сделать следующее:

    • запустить контейнер с использованием образа локального шлюза, скачанного из Microsoft Container Registry;
    • настроить контейнер для доступа к портам HTTP (8080) и HTTPS (443).

  12. Выполните команду ниже, чтобы проверить, работает ли pod шлюза. Используемое вами имя модуля pod будет другим.

    kubectl get pods
NAME                                   READY     STATUS    RESTARTS   AGE
contoso-apim-gateway-59f5fb94c-s9stz   1/1       Running   0          1m

  13. Выполните команду ниже, чтобы проверить, работает ли служба шлюза. Используемые вами имя службы и IP-адреса будут другими.

    kubectl get services
NAME             TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)                      AGE
contosogateway   NodePort    10.110.230.87   <none>        80:32504/TCP,443:30043/TCP   1m

  14. Вернитесь на портал Azure и убедитесь, что развернутый узел шлюза сообщает о работоспособном состоянии.

Совет

Используйте команду kubectl logs <gateway-pod-name> для просмотра моментального снимка журнала локального шлюза.

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