Просмотр пул-реквестов в предварительной среде эксплуатации

В этой статье показано, как использовать предварительные среды для просмотра изменений в приложениях, развернутых с помощью статических веб-приложений Azure. Предварительная среда — это полностью функциональная версия приложения, которая включает изменения, недоступные в рабочей среде.

Замечание

Среды запросов на вытягивание автоматически не поддерживаются для Azure DevOps, но вы можете использовать именованные среды для их ручной настройки.

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

В предварительной среде можно выполнить следующие задачи:

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

Необходимые условия

Внесение изменения

Внесите изменения в репозиторий непосредственно на GitHub, как показано на следующих шагах.

  1. Перейдите в репозиторий проекта на GitHub и выберите "Ветвь".

    Создание ветви с помощью интерфейса GitHub

  2. Введите имя ветви и выберите "Создать ветвь".

  3. Перейдите в папку приложения и измените текстовое содержимое, например название или абзац. Нажмите кнопку "Изменить", чтобы внести изменения в файл.

    Кнопка

  4. После завершения нажмите кнопку "Зафиксировать изменения ".

    Снимок экрана: кнопка

Создание pull request

Создайте pull request для публикации вашего обновления.

  1. Откройте вкладку Pull request проекта на GitHub.

    Снимок экрана, показывающий вкладку pull request в репозитории GitHub.

  2. Выберите "Сравнить" и "Запрос на вытягивание".

  3. При необходимости введите сведения об изменениях и выберите Создать запрос на слияние.

    Снимок экрана, показывающий создание pull request в GitHub.

При необходимости назначьте рецензентов и добавьте комментарии для обсуждения изменений.

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

Вы можете внести несколько изменений и отправить новые фиксации в ветвь. Пулл-реквест автоматически обновляется, чтобы отразить все изменения.

Проверить изменения

Рабочий процесс развертывания GitHub Actions запускает и развертывает изменения в запросе на вытягивание в предварительную рабочую среду.

После завершения процесса сборки и развертывания вашего приложения бот GitHub добавляет комментарий к пулл-реквесту, содержащий URL-адрес среды предварительного развертывания.

  1. Выберите тестовый URL, чтобы просмотреть подготовленные изменения.

    Скриншот комментария к pull request с предпродакшн URL.

    URL-адрес состоит из следующего: https://<SUBDOMAIN-PULL_REQUEST_ID>.<AZURE_REGION>.azurestaticapps.net Для данного запроса на вытягивание URL-адрес остается неизменным, даже если вы отправляете новые обновления. Одна и та же предварительная среда повторно используется на протяжении всего времени жизни пулл-реквеста.

Чтобы автоматизировать процесс проверки с помощью сквозного тестирования, действие GitHub для развертывания статических веб-приложений Azure имеет static_web_app_url выходную переменную. Вы можете ссылаться на этот URL-адрес в остальной части рабочего процесса, чтобы выполнить тесты в предварительной среде.

Публикация изменений

Слияние запроса на вытягивание для публикации в рабочей среде.

  1. Выберите Объединить pull-запрос.

    Снимок экрана: кнопка

    Изменения копируются в отслеживаемую ветвь (рабочая ветвь). Затем процесс развертывания запускается в отслеживаемой ветви, и изменения становятся активными после пересборки вашего приложения.

  2. Откройте рабочий URL-адрес, чтобы загрузить динамическую версию веб-сайта и проверить.

Ограничения

  • Любой пользователь может получить доступ к промежуточным версиям приложения через свой URL-адрес, даже если репозиторий GitHub является частным.

    Предупреждение

    Будьте осторожны с чувствительным контентом, так как любой может получить доступ к предпроизводственной среде.

  • Количество предварительных сред, доступных для каждого приложения, развернутого с помощью статических веб-приложений, зависит от плана размещения. Например, с уровнем "Бесплатный" можно иметь три предварительных производственных среды наряду с рабочей средой.

  • Предварительно созданные среды не распределены по географическому распределению.

  • Только развертывания GitHub Actions поддерживают предпроизводственные среды.

Дальнейшие действия