Публикация API с помощью GitHub Actions

Завершено

Вы добавили API в свое веб-приложение, и они оба выполняются локально. Теперь вам нужно опубликовать свой API и приложение в службе статических веб-приложений Azure.

Когда вы создали экземпляр службы статических веб-приложений Azure и поручили ему наблюдать за ветвью main, для вас было создано действие GitHub. Действие GitHub прослушивает ветку main вашего репозитория для коммитов и запросов на вытягивание. Когда действие GitHub обнаруживает эти изменения, оно выполняет сборку и публикацию вашего приложения.

При создании ресурса Статические веб-приложения Azure вы указали расположение папки для вашего проекта API, приняв значение Api по умолчанию. Статические веб-приложения Azure создали и развернули приложение функций Azure в этой папке. Однако приложение не работало, так как API HTTP GET еще не создан.

Запустить действие GitHub

Действие GitHub будет готово к сборке и публикации вашего веб-приложения и API, как только обнаружит изменения в ветви main. Вы можете либо напрямую выполнить фиксацию изменений, либо создать пулл-реквест в ветвь main. Оба этих изменения активируют действие GitHub. При обнаружении изменений в главной ветви он активирует действие GitHub для публикации приложения на том же URL-адресе веб-сайта.

Среды предпросмотра с предварительными URL-адресами

Иногда перед публикацией на активный веб-сайт вы хотите видеть изменения на тестовом сайте. Статические веб-приложения Azure позволяют просматривать ваши изменения в тестовых средах, каждая из которых имеет собственный URL-адрес для предварительного просмотра. Вы можете создать предварительную рабочую среду, создав pull request в ветвь, которую отслеживает GitHub Action. Ваш динамический веб-сайт не затрагивается. Вместо этого в собственной предварительной среде создается новая версия приложения. Если вернуться и проверить запрос на вытягивание на GitHub, обратите внимание, что ссылка на предварительную версию размещена на вкладке "Беседа".

В следующей таблице показано, как Статические веб-приложения Azure публикует ваше приложение на разных URL-адресах. Приложение публикуется по одному URL-адресу, а пулл-реквест в ту же ветвь публикуется по другому URL-адресу. Эти автоматически созданные URL-адреса предоставляются в Статических веб-приложениях Azure для производственного приложения и pull-запросов. При необходимости можно назначить рабочему приложению личный домен.

Оригинал Описание URL-адрес
Основная ветвь main Пример URL-адреса веб-сайта в реальном времени https://purple-rain-062d03304.azurestaticapps.net/
Запрос на вытягивание #5 Пример URL-адреса предварительной версии https://purple-rain-062d03304-5.<location>.azurestaticapps.net/

Сейчас вы работаете в ветви api. Запрос на вытягивание из ветви API в главную ветвь. При создании запроса на вытягивание в основной ветви действие GitHub публикует приложение в предварительной среде.

После того как завершится создание и развертывание приложения, бот GitHub добавит комментарий к pull request. Этот комментарий содержит ссылку на URL-адрес предварительной среды. Вы можете выбрать эту ссылку, чтобы просмотреть промежуточные изменения.

Затем вы создадите pull-запрос и посетите черновую версию вашего приложения.