Vercel удалит поддержку now.json к марту 2026: инструкция по миграции

Vercel, одна из самых популярных платформ для развертывания фронтенд-проектов, официально объявила о прекращении поддержки устаревшего конфигурационного файла now.json. Начиная с 31 марта 2026 года этот формат перестанет работать, и все проекты, использующие его, должны быть мигрированы на современные альтернативы — vercel.json или vercel.ts. Решение затронет тысячи разработчиков, которые все еще используют старый файл конфигурации, особенно в проектах, созданных до 2020 года. В этой статье мы разберем причины отказа, сроки, пошаговую инструкцию по миграции и ответим на частые вопросы, чтобы вы могли подготовиться заранее и избежать простоев.

Почему Vercel отказывается от now.json и какие сроки

Компания Vercel объявила, что 31 марта 2026 года поддержка файла now.json будет полностью удалена. Это означает, что любые проекты, которые по-прежнему используют этот формат, перестанут корректно деплоиться на платформе. Решение объясняется необходимостью унифицировать конфигурацию и перейти на более гибкие и современные форматы, такие как vercel.json и vercel.ts. Vercel рекомендует разработчикам начать миграцию заранее, чтобы избежать простоев. Отказ от now.json — часть более широкой стратегии по упрощению платформы и переходу к TypeScript-конфигурациям, которые обеспечивают лучшую типизацию и возможность программируемой настройки.

Как мигрировать с now.json на vercel.json: пошаговая инструкция

Процесс миграции крайне прост: достаточно переименовать файл now.json в vercel.json. Никаких других изменений в содержимом файла не требуется, так как оба формата имеют одинаковую структуру. Для продвинутых случаев Vercel рекомендует использовать vercel.ts — конфигурацию на TypeScript, которая позволяет использовать переменные окружения, импорты и логику. Например, можно динамически генерировать настройки в зависимости от среды. Vercel предоставляет документацию с примерами и руководствами по миграции. Чтобы убедиться, что все работает корректно, после переименования выполните тестовый деплой и проверьте логи.

Какие изменения произойдут в работе после миграции

Файл now.json и vercel.json семантически идентичны: они поддерживают одни и те же поля, такие как builds, routes, rewrites, redirects, headers и env. Единственное отличие — имя файла. Vercel гарантирует, что после переименования поведение проекта не изменится. Для тех, кто использует программируемую конфигурацию, vercel.ts открывает доступ к TypeScript, что позволяет добавлять условия, циклы и импортировать данные из других модулей. Это особенно полезно для больших проектов с разными конфигурациями для staging и production. Важно отметить, что Vercel не планирует автоматическую миграцию, поэтому ответственность ложится на разработчиков.

Кого затронет это изменение и как подготовиться

Изменение коснется всех разработчиков, у которых в корне проекта есть файл now.json. Это могут быть как личные проекты, так и коммерческие приложения, особенно те, что были созданы до 2020 года. Для большинства пользователей миграция займет несколько минут. Однако в больших организациях с сотнями проектов потребуется координация. СНГ-разработчикам стоит обратить внимание на проекты, развернутые через Vercel для клиентов, чтобы избежать проблем с деплоем после дедлайна. Рекомендуется провести аудит всех проектов, найти файлы now.json и запланировать их обновление в ближайшее время.

Что делать, если проект использует now.json: практические советы

Если вы обнаружили, что ваш проект все еще использует now.json, не паникуйте. Просто переименуйте файл в vercel.json и убедитесь, что конфигурация корректна. Для сложных проектов рассмотрите возможность перехода на vercel.ts, чтобы получить преимущества TypeScript. Также проверьте документацию Vercel на предмет устаревших полей, которые могли быть изменены. Если у вас есть сомнения, создайте тестовую ветку и выполните пробный деплой. Помните, что после 31 марта 2026 года Vercel начнет отклонять деплои с now.json, поэтому лучше не откладывать миграцию на последний момент.

Какие альтернативы now.json существуют и их преимущества

Основная альтернатива — vercel.json, который полностью совместим с now.json. Для тех, кто хочет больше гибкости, Vercel предлагает vercel.ts. Этот формат позволяет использовать TypeScript, что дает возможность писать конфигурацию с логикой, импортировать модули и использовать переменные окружения. Например, вы можете создать функцию, которая возвращает разные настройки для продакшена и стейджинга. Это делает конфигурацию более читаемой и поддерживаемой. Vercel рекомендует vercel.ts для новых проектов и постепенный переход для существующих.

Часто задаваемые вопросы о миграции с now.json на vercel.json

Многие разработчики задаются вопросом: нужно ли менять что-то еще, кроме имени файла? Ответ — нет, если вы используете стандартные поля. Однако если в вашем now.json были кастомные настройки, проверьте, не устарели ли они. Другой частый вопрос: что произойдет, если не мигрировать до дедлайна? Деплои будут отклоняться, и проект перестанет обновляться. Vercel рекомендует начать миграцию как можно раньше, чтобы избежать авралов. Также спрашивают, затронет ли это изменение CI/CD пайплайны. Да, если в пайплайне используется now.json, его нужно обновить.

Итог: что нужно сделать разработчикам до марта 2026

Vercel окончательно отказывается от now.json, устанавливая дедлайн на 31 марта 2026 года. Миграция тривиальна — достаточно переименовать файл. Однако игнорирование этого объявления может привести к остановке деплоя. Разработчикам стоит уже сейчас проверить свои проекты и обновить конфигурацию, чтобы обеспечить бесперебойную работу. В будущем Vercel, вероятно, полностью перейдет на TypeScript-конфигурации, так как vercel.ts уже рекомендуется для новых проектов. Следите за обновлениями документации, чтобы быть в курсе дальнейших изменений.