Проекты для предварительного просмотра и временных экспериментов

Это две взаимосвязанные концепции, призванные отделить экспериментальную работу от важных задач.

Временные проекты#

Временный проект — это обычный проект, который вы планируете удалить позже. Используйте его, чтобы опробовать Coroid на незнакомой кодовой базе, протестировать изменение политики перед широким применением или изучить подход, к которому вы не привязаны окончательно.

Главное преимущество — изоляция. Эксперименты во временном проекте не загрязняют историю задач, метрики или контекст проекта, на котором зависит ваша команда.

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

Среды предпросмотра#

Предпросмотр — это ваша изменённая программа, уже запущенная, созданная на основе ветки, сформированной задачей.

Это важно, потому что некоторые аспекты нельзя определить по разнице в коде. Правильно ли отображается страница, работает ли весь процесс от начала до конца, выглядит ли изменение корректно — для этого нужно, чтобы программа действительно работала.

Среды предпросмотра — это то, браузерные тесты запускаются против них, и то, что открывают рецензенты, когда скриншот не даёт однозначного ответа.

Просмотреть изменения задачи#

В Factory откройте задачу, ожидающую рецензирования. В разделе Что изменилось, нажмите Предпросмотр окно запустит ветку задачи одним кликом.

• Запуск: устанавливаются зависимости ветки и запускается приложение. Первый запуск может занять несколько минут.
• Готово: запущенное приложение отображается в окне. Открыть откроет его в новой вкладке, а в окне будет указано оставшееся время работы предпросмотра.
• Остановить прекратит его раньше времени. Предпросмотр, работающий в Coroid, останавливается автоматически через час.

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

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

Где запускается предпросмотр#

Вы не выбираете место запуска предпросмотра:

• Coroid sandbox: стандартный вариант. Coroid собирает ветку задачи в изолированном контейнере, куда не попадают ваши секретные данные. Для этого не нужны ни pull request, ни push, поэтому он работает даже с репозиториями, хранящимися внутри Coroid.
• Vercel: если проект подключен к Vercel для прямого деплоя (настройки проекта → Интеграции → Рецензирование доказательств), Vercel собирает ветку и размещает её по адресу предпросмотра Vercel. Применяются собственные механизмы защиты деплоя Vercel, поэтому предпросмотр открывается в новой вкладке, а не в окне.

Репозиторий в режиме локального доступа никогда не покидает Coroid и всегда использует для предпросмотра Coroid sandbox.

Адрес предпросмотра длинный и сложный для угадывания, но любой, кто его получит, сможет открыть предпросмотр во время его работы. Относитесь к нему как к любой ссылке на невыпущенную версию продукта.

Как среды предпросмотра интегрируются в pull request#

Ссылка на предпросмотр задачи в pull request Coroid выглядит так: Просмотреть это изменение в Coroid откроет страницу рецензирования задачи и запустит предпросмотр. Для перехода по ссылке требуется вход в Coroid; сам адрес предпросмотра не публикуется в pull request.

Если у вас уже есть средства для развертывания предпросмотров — будь то приложение Git от провайдера хостинга или система непрерывной интеграции — Coroid также прикрепляет их в качестве доказательств рецензирования, поэтому ссылка отображается рядом с изменением, а не там, где её нужно искать.

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

Когда использовать то или иное#

• Опробование Coroid или подхода, который вы можете отбросить → временный проект
• Проверка корректности конкретного изменения → среда предпросмотра

Они совместимы: во временном проекте могут быть среды предпросмотра, как и в любом другом.

Связанные материалы#

• Создать и настроить проект
• Доказательства рецензирования
• Поставщики доказательств рецензирования