В Aurabase мы наложили на себя жесткое ограничение на этапе проектирования: поверхность SDK и соглашения RLS должны были быть совместимыми с и Supabase. Те же createClient(), те же .from().select().eq(), те же политики SQL Postgres. Идея: хочешь уйти — уходи — мы делаем это тривиально. Вот полная книга.
Что движется, что остается
Прежде чем начать, составьте список того, что изменится, а что останется. Спойлер: большинство осталось.
| Postgres Схема | ТАКОЙ ЖЕ | pg_dump → pg_restore. Расширения, триггеры, функции, индексы — всё подходит. |
|---|---|---|
| RLS Политики | ТАКОЙ ЖЕ | Тот же синтаксис. auth.uid(), auth.role(), auth.jwt() работают как есть. |
| JavaScript SDK | 95% ИДЕНТИЧНОСТЬ | Замените @supabase/supabase-js на @aurabase/aurabase-js. Тот же цепной API. |
| Потоки аутентификации | ТАКОЙ ЖЕ | SignUp, SignInWithPassword, SignInWithOAuth, mfa — те же имена, те же подписи. |
| API хранилища | ТАКОЙ ЖЕ | aura.storage.from(bucket).upload(...) · совместимые S3 · передаваемые политики RLS. |
| В реальном времени | ТАКОЙ ЖЕ | Channel().on("postgres_changes", ...) без изменений. Присутствие + трансляция то же самое. |
| Edge Functions | ТАКОЙ ЖЕ | Deno.serve() вставлен в редактор Studio как есть. В CLI будут развертываться функции, предназначенные для отдельного пути (Rust скомпилирован в WASM). |
| Панель управления | ДРУГОЙ | Студия Aurabase · мы поможем вам сориентироваться. |
Создайте целевой проект Aurabase.
Создайте новый проект Aurabase с помощью официального интерфейса командной строки, затем свяжите эту папку с проектом, чтобы следующие команды применялись к нему автоматически.
# учетная запись Aurabase + CLI
npm i -g @aurabase/cli
aura login
# Создайте проект (движок Postgres)
aura projects create my-app --engine postgres
# Свяжите эту папку с созданным проектом
aura link --project-id <uuid-du-projet>
# Получить ключи API связанного проекта
aura projects api-keys
Дамп Supabase, восстановление Aurabase
Стандартный pg_dump / pg_restore: Aurabase предоставляет прямую строку подключения Postgres для каждого проекта (Студия → Настройки → Соединение), нет необходимости в промежуточном преобразовании.
# Получите строку подключения Supabase со своей панели управления.
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"
# Дамп общедоступной схемы (без системных схем Supabase)
pg_dump "$SUPABASE_DB_URL" \
--schema=public \
--no-owner --no-acl \
--format=custom \
-f supabase-dump.pgdump
# Получить строку подключения Aurabase (Студия → Настройки → Соединение).
# Параметр ?search_path= ОБЯЗАТЕЛЬНЫЙ: он направляет к схеме вашего проекта.
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"
# Восстановить стандартным pg_restore
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump
# Восстановить типы TypeScript
aura db generate > src/aurabase.types.ts
Миграция пользователей
Следует исправить по сравнению с тем, что мы говорили здесь ранее: Aurabase хеширует пароли с Argon2id, но Supabase (GoTrue) по умолчанию хеширует свои собственные с bcrypt — эти два формата не являются взаимозаменяемыми. Поэтому вашим пользователям придется один раз сбросить свой пароль, как и в большинстве случаев миграции.
Aurabase в настоящее время не предлагает инструмент массового импорта из Supabase. Два варианта: позволить вашим пользователям перерегистрироваться (signUp с тем же адресом электронной почты) или заново создать их по одному на стороне администратора с помощью aura auth users create --email <email> перед запуском сброса пароля.
Активные сессии на стороне Supabase не портируются (технически невозможно — каждая платформа подписывает свои JWT своим ключом). Пользователям необходимо будет снова войти в систему с новым паролем.
Адаптируйте клиентский код
Поиска/замены достаточно в 95% случаев.
// ДО (Supabase)
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(url, key)
// ПОСЛЕ (Aurabase)
import { createClient } from '@aurabase/aurabase-js'
export const aura = createClient(url, key)
// Остальная часть кода не меняется:
await aura.from('posts').select('*').eq('author_id', userId)
Развертывание Edge Functions
Aurabase предлагает два пути для Edge Functions: редактор кода Studio (среда выполнения Deno, такая же, как Supabase — вставьте свою функцию как есть) и aura functions deployCLI, который предназначен для отдельного пути для функций, написанных на Rust и скомпилированных в WASM. Чтобы перенести существующий код Deno без переписывания, используйте Studio.
// Работает так же, вставлено в редактор Studio как есть.
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(JSON.stringify({ hello: name }))
})
Переключение DNS и запуск производства
Две возможные стратегии. Первое рекомендуется в 99% случаев.
- Прямое переключение — измените
NEXT_PUBLIC_AURABASE_URLиNEXT_PUBLIC_AURABASE_ANON_KEYв переменных окружения, повторно разверните. Пользователи переподключаются, все работает. Рекомендуется для большинства проектов. - Временная двойная запись — записывайте Supabase + Aurabase одновременно в течение 48 часов, проверьте согласованность критических таблиц вручную (подсчет строк, контрольные суммы), затем выключите Supabase. Предпочтительно для критически важных приложений.
Мы здесь, если что-то застрянет
Для крупных проектов или со строгими ограничениями соответствия наша команда может помочь вам с миграцией. Свяжитесь с нами для получения предложения, адаптированного к вашему проекту.