3 мин на чтение

Supabase CLI 2.122.0: версии локального стека теперь можно закрепить

В Supabase CLI 2.122.0 появился lock-файл для версий сервисов экспериментального стека. Обновление также исправляет передачу TLS-настроек и делает диагностику команд понятнее.

Supabase выпустила CLI 2.122.0 23 октября. В центре обновления — воспроизводимость локального окружения и исправления повседневных команд. Новый файл supabase/supabase.lock закрепляет версии сервисов в экспериментальном режиме stack. Релиз также устраняет ситуации, когда настройки TLS не доходили до подключения к базе или до утилиты выгрузки данных.

Один проект, одинаковые версии сервисов

Локальная среда Supabase состоит из нескольких частей: базы Postgres, авторизации, хранилища и других сервисов. Обновление самого CLI и обновление этого набора — связанные, но разные изменения. Если участники команды запускают разные версии компонентов, одинаковый код приложения может вести себя неодинаково.

Lock-файл делает состав окружения явным. В stack-режиме можно выбрать опубликованные версии сервисов, согласовать их с привязанным облачным проектом после supabase link и воспроизвести набор по файлу, сохранённому в репозитории. Это особенно полезно при разборе ошибки: обсуждать можно конкретную конфигурацию, а не просто «последний локальный Supabase».

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

Stack пока остаётся экспериментальным

Новый механизм относится к supabase stack. Этот режим включается отдельно через experimental.stack; его команды и вывод пока могут меняться между выпусками. Локальные проекты, созданные в нём, хранят данные отдельно от окружений, запущенных стандартным supabase start.

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

Локальный Studio даёт доступ к проекту и его сервисам. Фиксация версий помогает воспроизводить окружение, в котором работает приложение.

TLS-настройки доходят до нужной команды

Исправления подключения затрагивают конкретный случай: db push --linked при прямом соединении раньше пропускал переменные PGSSLMODE и PGSSLROOTCERT. Теперь настройки режима проверки, корневого и клиентского сертификатов считываются из окружения и на этом маршруте. Отсутствующий файл сертификата должен приводить к понятной ошибке, а не незаметно игнорироваться.

Отдельная правка передаёт разрешённые TLS-настройки в pg_dump при удалённой выгрузке и начальном получении схемы через db pull. Ранее такой запуск мог не выполнять ожидаемую проверку сертификата или получать отказ от сервера, требующего клиентский сертификат. При контейнерном запуске нужные файлы сертификатов подключаются только для чтения.

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

Меньше догадок в ежедневной работе

Справка команд теперь показывает раздел PERMISSIONS с необходимыми разрешениями токена. Это помогает точнее настроить автоматизацию. Ошибки конфигурации стали указывать проблемную строку, а не ограничиваться общим названием ошибки парсинга.

В выпуск также вошли исправления запуска и остановки с Podman и передачи многострочных динамических импортов при развёртывании функций. Для командных сценариев есть ещё одна существенная деталь: CLI предупреждает о предстоящей смене цели по умолчанию на локальную. Это предупреждение о будущем изменении, а не сообщение о том, что переход уже произошёл.

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

АвторAnthony Fubon

Anthony Fubon — российский музыкант, DJ, музыкальный продюсер, организатор мероприятий и специалист по цифровым продуктам. В музыке он использовал несколько имён, в частности Fubon, TheFubon и yagelProject. Его собственная биография описывает путь от рок-музыки и российской psytrance-сцены к электронной музыке разных направлений и созданию собственной цифровой экосистемы.