Vercel блокирует продакшен-деплой Microfrontends без конфигурации: что нужно знать

Vercel ввёл новую автоматическую проверку, которая блокирует продакшен-деплой для приложений Microfrontends, если в сборке отсутствует файл microfrontends.json. Это изменение направлено на предотвращение случайных поломок роутинга и повышение надёжности развёртывания. Теперь разработчикам, использую

Как работает новая проверка Microfrontends Config Present

Проверка Microfrontends Config Present встроена в процесс деплоя Vercel и активируется автоматически для проектов, зарегистрированных в Vercel Microfrontends. Если приложение назначено дефолтным в группе Microfrontends, то при отсутствии файла microfrontends.json в выходных артефактах сборки деплой блокируется до продакшена. Это означает, что сборка не будет развёрнута на продакшен-окружении, пока конфигурация не появится. Проверка не требует ручного включения — она действует по умолчанию для всех подходящих проектов.

Почему Vercel ввёл эту блокировку?

Ранее разработчики могли случайно продвинуть деплой из ветки, в которой отсутствовала конфигурация Microfrontends. Это приводило к поломке продакшен-роутинга, так как система не знала, как маршрутизировать запросы между микросервисами. Новая проверка предотвращает такие инциденты, автоматически останавливая деплой до того, как проблема попадёт на продакшен. Она дополняет существующие проверки, такие как линтинг и проверка типов, делая процесс развёртывания более надёжным.

Какие проекты попадают под проверку?

Проверка срабатывает для проектов, которые зарегистрированы в Vercel Microfrontends и назначены дефолтным приложением в группе. Если ваше приложение не является дефолтным, проверка может не применяться — точное поведение для не-дефолтных приложений пока не уточнено. Разработчикам, управляющим несколькими приложениями в группе, стоит обратить особое внимание на эту проверку, особенно если они вручную продвигают деплои из разных веток.

Что произойдёт, если microfrontends.json отсутствует?

Если файл microfrontends.json не найден в артефактах сборки, деплой блокируется и не доходит до продакшена. Это может случиться, например, при ручном продвижении деплоя из старой ветки, где конфигурация Microfrontends ещё не была добавлена. При следующем деплое с корректным файлом проверка проходит успешно, и развёртывание выполняется как обычно. Настроить поведение проверки можно в разделе Build and Deployment Settings вашего проекта на Vercel.

Как подготовиться к новому правилу?

Чтобы избежать блокировок, убедитесь, что файл microfrontends.json присутствует во всех ветках, из которых вы планируете делать продакшен-деплой. Добавьте его в корень проекта или укажите путь к нему в настройках сборки. Если вы используете несколько окружений, проверьте, что конфигурация актуальна для каждого из них. Рекомендуется также настроить CI/CD так, чтобы перед деплоем автоматически проверялось наличие файла.

Можно ли отключить проверку?

На данный момент неясно, можно ли полностью отключить проверку, не меняя настроек сборки. В разделе Build and Deployment Settings можно настроить поведение, но возможность полного отключения пока не подтверждена. Возможно, в будущем Vercel добавит такую опцию, но сейчас лучше всего обеспечить наличие конфигурации в каждой сборке.

Кого затронет это изменение?

Изменение затронет всех разработчиков, использующих Vercel Microfrontends, особенно тех, кто управляет несколькими приложениями в группе и вручную продвигает деплои. Если вы автоматизируете деплой через CI/CD, проверьте, что ваши пайплайны учитывают новое правило. Для небольших проектов с одним приложением влияние может быть минимальным, но всё равно стоит проверить наличие microfrontends.json.

Что пока остаётся неизвестным?

Vercel не уточнил, как проверка ведёт себя для не-дефолтных приложений в группе. Также неясно, есть ли возможность полностью отключить проверку без изменения настроек сборки. Разработчикам стоит следить за обновлениями документации Vercel, чтобы быть в курсе изменений. Если вы столкнулись с блокировкой, проверьте наличие файла microfrontends.json и настройки проекта.

Заключение

Новая проверка Microfrontends Config Present — это полезное улучшение, которое повышает надёжность деплоя и предотвращает случайные поломки. Чтобы избежать проблем, убедитесь, что ваш проект содержит правильную конфигурацию Microfrontends в каждой ветке, предназначенной для продакшена. Следите за обновлениями Vercel, так как в будущем могут появиться дополнительные настройки для управления проверкой.