Поддержка API в Статические веб-приложения Azure с помощью приложений контейнеров Azure
Приложения контейнеров Azure — это управляемая платформа для размещения бессерверных контейнеров и микрослужб.
При связывании приложения-контейнера со статическим веб-приложением все запросы к статическому веб-приложению с маршрутом, начинающимся с /api того же маршрута в приложении-контейнере.
По умолчанию, когда приложение-контейнер связано со статическим веб-приложением, приложение контейнера принимает только запросы, которые используются через связанное статическое веб-приложение. Приложение-контейнер может быть связано с одним статическим веб-приложением одновременно.
Параметры API для Статические веб-приложения включают следующие службы Azure:
Дополнительные сведения см. в обзоре API.
Примечание.
Для интеграции с приложениями контейнеров Azure требуется план Статические веб-приложения standard.
Интеграция серверной части не поддерживается в средах запросов на вытягивание Статические веб-приложения.
Необходимые компоненты
Чтобы связать приложение-контейнер со статическим веб-приложением, необходимо иметь существующий ресурс контейнерных приложений и статическое веб-приложение.
| Ресурс | Description |
|---|---|
| Приложения контейнеров Azure | Если у вас еще нет приложения, выполните действия, описанные в руководстве по развертыванию первого приложения контейнера. |
| Существующее статическое веб-приложение | Если у вас еще нет одного, выполните действия, описанные в руководстве по началу работы , чтобы создать статическое веб-приложение No Framework . |
Пример
Рассмотрим существующий экземпляр приложения контейнера Azure, предоставляющий конечную точку с помощью следующего расположения.
https://my-container-app.red-river-123.eastus2.azurecontainerapps.io/api/getProducts
После установки связи вы можете получить доступ к той же конечной точке по пути api из статического веб-приложения, как показано в этом примере URL-адреса.
https://red-sea-123.azurestaticapps.net/api/getProducts
Оба URL-адреса указывают на одну конечную точку API. Конечная точка в приложении-контейнере должна иметь /api префикс, так как Статические веб-приложения соответствует запросам, сделанным /api и прокси-серверам, весь путь к связанному ресурсу.
Связывание приложения-контейнера
Чтобы связать приложение-контейнер в качестве серверной части API для статического веб-приложения, выполните следующие действия.
В портал Azure перейдите в статическое веб-приложение.
Выберите API в меню навигации.
Найдите среду, с которой нужно связать экземпляр Управление API. Выберите Ссылка.
В типе ресурса серверной части выберите "Приложение контейнера".
В подписке выберите подписку, содержащую приложение контейнера, которое вы хотите связать.
В имени ресурса выберите приложение-контейнер.
Выберите Ссылка.
По завершении процесса связывания запросы на маршруты, начинающиеся с /api прокси,, отправляются в связанное приложение контейнера.
Управление доступом к приложению-контейнеру
Приложение-контейнер настроено с именем Azure Static Web Apps (Linked) поставщика удостоверений, который разрешает только трафик, который используется через статическое веб-приложение. Чтобы сделать приложение контейнера доступным для других приложений, обновите его конфигурацию проверки подлинности, чтобы добавить другого поставщика удостоверений или изменить параметры безопасности, чтобы разрешить доступ без проверки подлинности.
Отмена связывания приложения-контейнера
Чтобы отменить связь с приложением-контейнером из статического веб-приложения, выполните следующие действия.
В портал Azure перейдите в статическое веб-приложение.
Выберите API в меню навигации.
Найдите среду, которую требуется отменить связь, и выберите имя приложения контейнера.
Выберите "Отменить связь".
После завершения процесса отмены связи запросы на маршруты, начинающиеся с /api , больше не используются в приложении-контейнере.
Примечание.
Чтобы предотвратить случайное предоставление приложения-контейнера анонимному трафику, поставщик удостоверений, созданный процессом связывания, не удаляется автоматически. Вы можете удалить поставщика удостоверений с именем Статические веб-приложения Azure (связанная) из параметров проверки подлинности приложения контейнера.
Удаление проверки подлинности из ресурса "Приложения контейнеров"
Чтобы разрешить ресурсу Контейнеров Apps получать анонимный трафик, выполните следующие действия, чтобы удалить поставщика удостоверений:
В портал Azure перейдите к ресурсу "Приложения контейнеров".
Выберите проверку подлинности в меню навигации .
В списке поставщиков удостоверений удалите поставщик удостоверений, связанный с ресурсом Статические веб-приложения.
Выберите " Удалить проверку подлинности", чтобы удалить проверку подлинности и разрешить анонимный трафик к ресурсу "Приложения контейнеров".
Ресурс "Приложения контейнеров" теперь может получать анонимный трафик.