Проверка запросов на вытягивание в подготовительных средах
В этой статье показано, как использовать предварительные среды для просмотра изменений в приложениях, развернутых с помощью Статические веб-приложения Azure. Предварительная среда — это полностью функциональная версия приложения, которая включает изменения, недоступные в рабочей среде.
Примечание.
Среды запросов на вытягивание не поддерживаются автоматически для Azure DevOps, но для настройки их вручную можно использовать именованные среды .
Статические веб-приложения Azure создает рабочий процесс YAML в репозитории. При создании запроса на вытягивание в ветви, в которой выполняется просмотр рабочего процесса, создается предварительная среда. Предварительная рабочая среда этапов приложения, поэтому перед отправкой изменений в рабочую среду можно просмотреть изменения. Жизненный цикл предварительной рабочей среды привязан к запросу на вытягивание. После закрытия запроса на вытягивание предварительная среда автоматически удаляется.
В предварительной среде можно выполнить следующие задачи:
- Просмотр визуальных изменений между рабочей и промежуточной, например обновлениями содержимого и макета
- Демонстрация изменений в команде
- Сравнение различных версий приложения
- Проверка изменений с помощью тестов принятия
- Выполнение проверка sanity перед развертыванием в рабочей среде
Необходимые компоненты
- Существующий репозиторий GitHub, настроенный с Статические веб-приложения Azure. Если у вас их нет, см. статью Краткое руководство. Создание первого статического веб-приложения.
Внесение изменения
Внесите изменения в репозиторий непосредственно на GitHub, как показано на следующих шагах.
Перейдите в репозиторий проекта на GitHub и выберите "Ветвь".
Введите имя ветви и выберите "Создать ветвь".
Перейдите в папку приложения и измените текстовое содержимое, например название или абзац. Нажмите кнопку "Изменить", чтобы внести изменения в файл.
После завершения нажмите кнопку " Зафиксировать изменения ".
Создание запроса на вытягивание
Создайте запрос на вытягивание для публикации обновления.
Откройте вкладку "Запрос на вытягивание " проекта на GitHub.
Выберите "Сравнить" и "Запрос на вытягивание".
При необходимости введите сведения об изменениях и нажмите кнопку "Создать запрос на вытягивание".
При необходимости назначьте рецензентов и добавьте комментарии для обсуждения изменений.
Одновременно несколько предварительных сред могут существовать одновременно при использовании Статические веб-приложения Azure. Каждый раз, когда вы создаете запрос на вытягивание в наблюдаемой ветви, поэтапной версии с изменениями развертывается в отдельной предварительной среде.
Вы можете внести несколько изменений и отправить новые фиксации в ветвь. Запрос на вытягивание автоматически обновляется для отражения всех изменений.
Проверить изменения
Рабочий процесс развертывания GitHub Actions запускает и развертывает запрос на вытягивание в предварительной рабочей среде.
После завершения создания и развертывания приложения бот GitHub добавляет комментарий к запросу на вытягивание, содержащий URL-адрес предварительной среды.
Выберите URL-адрес предварительной среды, чтобы просмотреть промежуточные изменения.
URL-адрес состоит из следующего:
https://<SUBDOMAIN-PULL_REQUEST_ID>.<AZURE_REGION>.azurestaticapps.netДля данного запроса на вытягивание URL-адрес остается неизменным, даже если вы отправляете новые обновления. Та же предварительная среда также повторно используется для выполнения запроса на вытягивание.
Чтобы автоматизировать процесс проверки с помощью сквозного тестирования, действие GitHub для развертывания Статические веб-приложения Azure имеет static_web_app_url выходную переменную.
Вы можете ссылаться на этот URL-адрес в остальной части рабочего процесса, чтобы выполнить тесты в предварительной среде.
Публикация изменений
Слияние запроса на вытягивание для публикации в рабочей среде.
Выберите Объединить запросы на вытягивание.
Изменения копируются в отслеживаемую ветвь (рабочая ветвь). Затем рабочий процесс развертывания запускается в отслеживаемой ветви и изменения идут в режиме реального времени после перестроения приложения.
Откройте рабочий URL-адрес, чтобы загрузить динамическую версию веб-сайта и проверить.
Ограничения
Любой пользователь может получить доступ к промежуточным версиям приложения через свой URL-адрес, даже если репозиторий GitHub является частным.
Предупреждение
Будьте осторожны с конфиденциальным содержимым, так как любой пользователь может получить доступ к предварительно рабочей среде.
Количество предварительных сред, доступных для каждого приложения, развернутого с помощью Статические веб-приложения, зависит от плана размещения. Например, с уровнем "Бесплатный" можно использовать три предварительных среды, а также рабочую среду.
Предварительно созданные среды не распределены по географическому распределению.
Подготовительные среды поддерживаются только в развертываниях GitHub Actions.