Към съдържанието
Демо концепция

Измислена марка, проектирана и изработена от Get Ranked On Top. Не е истинска компания.

Към съдържанието
SHUNT(1)Ръководство Shuntline · rev. 3.12.0 · 2026-10-14SHUNT(1)
[00] Име — shunt · copy-on-write клонове за Postgres

Разклонявайте базата си като кода.

Всеки pull request получава собствено копие на продукцията, в което може да се пише — маскирано, изолирано и готово за под секунда. Сравнете го, слейте го по план или го изхвърлете. Скриптовете ви за seed данни могат да се пенсионират с достойнство.

curl -fsSL https://get.shuntline.example | sh
Обзор
0,8 сза клон на 1,84 TB. Медиана, не най-добрият опит.
0 Bкопирани, докато не запишете нещо.
1,9 млнклона, създадени миналия месец; 1,7 млн от тях изтрити по график.
PGPostgres 14–17. MySQL 8.4 в бета, с подобаващите предупреждения.
Фиг. 1 shunt tree — клоновете на prod-eu-1 в момента
$ shunt tree --db prod-eu-1

main                      ● 4f2a91c  1.84 TB   защитен
├─ feature/payments       ● 9be04d7  +412 MB   +3 табл ~1 кол -1 кол
│  ├─ preview/pr-482      ● 2d71aa0  +6.1 MB   +1204 -18 реда
│  └─ ci/run-88213        ○ 9be04d7  0 B       спрян
├─ fix/invoice-round      ● a0c3f19  +88 KB    ~312 реда
└─ scratch/kenji          ○ 4f2a91c  0 B       ttl 3ч 51м

6 клона · 4 активни · 506 MB записани · 11,04 TB некопирани
Фиг. 2 Разписание, петък, 16 октомвриГрафика в стил Git: feature/payments се отделя от main, preview/pr-482 се отделя от feature/payments, а feature/payments се слива обратно в main.09:0010:0011:0012:0013:0014:00mainfeature/paymentspreview/pr-4824f2a91c7c03e1dсливане+3~1-1схема+1,204-18реда
В продукция при 4100 инженерни екипа, сред коитона никого не сме плащали, за да е тук
  • Paraday
  • Quillon Health
  • Marrow & Finch
  • Obel Ledger
  • Tessary
  • Kallio Freight
[01] Терминалбез регистрация, без мрежа, без последици

Три команди. Това е продуктът.

Кликнете команда, за да я пуснете срещу въображаемо копие на продукцията. Изходът е истински в смисъл, че точно това бихте видели; фалшив е в смисъл, че всъщност не изтрихме колоната ви.

branch create
указател към страниците на родителя, нов compute, маскирано.
diff
схема и редове, спрямо всеки предшественик.
merge
план, проверка за разминаване, lock timeout и чак тогава работата.
acme-api — zsh — shunt 3.12.0готов
Last login: Fri Oct 16 09:12:44 on ttys004
~/acme-api (main) $ shunt branch create feature/payments --from main
→ намираме main @ 4f2a91c  (prod-eu-1 · postgres 16.4)
→ snapshot на 212 таблици, 1,84 TB логически
  copy-on-write: записани 0 байта. проверихме два пъти.
→ заделяме compute  shu-c-2x  (2 vCPU · 8 GB)
✓ клонът feature/payments е готов за 0,81 с

  postgres://app@feature-payments.eu-1.shuntline.example/app
  ttl 72h · заспива след 5 мин бездействие · маскиране: pii-default
~/acme-api (main) $ 

[02] Как работи3 стъпки · 0 YAML файла · 1 ред в CI

Семантиката на Git за частта от стека, която никога я е нямала.

Стъпка 01: Насочете го към Postgres

Shuntline се закача като read реплика. Никога не пише в основната ви база и не иска superuser — само REPLICATION и търпение колкото за едно кафе при първата синхронизация.

стъпка 01
$ shunt init \
    --from $PROD_URL
→ репликата е закачена (lag 120ms)
✓ следят се 212 таблици

Стъпка 02: Клон за всеки pull request

Един ред в CI дава на всеки PR собствена база за запис, с PII, маскирано по правила, и TTL, за да не плаща никой за експериментите от миналото тримесечие.

стъпка 02
$ shunt branch create \
    preview/pr-$PR --ttl 72h
→ маскираме 14 колони
✓ готово за 0,79 с

Стъпка 03: Сравни, слей, забрави

Вижте промените в схемата и по редове спрямо родителя, генерирайте план за миграция, който наистина се чете, и го слейте — или изтрийте клона и се правете, че го е нямало.

стъпка 03
$ shunt merge --plan
+ table payment_intents
- column legacy_ref
1 разрушителна. --yes за продължение
[03] Бенчмарковемедиана от 30 пускания · postgres 16 · eu-1 · септ. 2026
Създаване на клон0,8 с

p50 при база от 1,84 TB. p99 е 1,6 с, основно DNS.

Записано при създаване0 B

Copy-on-write на ниво страница. Пазите само това, което промените.

Цена на четенето+0,4мс

добавена p99 латентност на горещи страници спрямо родителя.

Спестено място38×

Медиана при клиентите спрямо пълни нощни клонинги.

Време до копие за запис на база от 500 GB

pg_dump → pg_restore3 ч 41 мин
Логическа реплика + promote1 ч 12 мин
Възстановяване от snapshot27 мин
shunt branch create0,8 с

Нашата лента е начертана с 1px, защото 0,0006% от ширината не се визуализира. Методология и сурови данни в docs/benchmarks.

Фиг. 3 Copy-on-write, начертано честноmainfeature/payments000102030405060708098 указателя, 2 страници

Клонът е списък с указатели към страниците на родителя. Запишете в страница и клонът получава собствено копие само на нея. Тук: две от десет. Плащате за оранжевите.

[04] Промениshunt changelog --follow

Пускаме във вторник и четвъртък.

Четиридесет и едно издания тази година. Семантично версиониране, писано от хора, с несъвместимите промени в червено, за да намерите бързо важните.

Цялата история, до v0.1 →
  1. v3.12.0perf

    shunt diff --data взема извадка от таблици над 100 млн реда, вместо да ги сканира. 41× по-бързо и ви казва, че е взел извадка, защото не сме чудовища.

  2. v3.11.2fix

    Имена на клонове с наклонена черта накрая вече не създават клон, наречен на практика нищо. Благодарим на четиримата, които го откриха.

  3. v3.11.0ново

    TTL вече се наследява от родителския клон. Клоновете preview/* са по подразбиране 72h, освен ако не кажете друго в shunt.toml.

  4. v3.10.0ново

    Postgres 17 е общодостъпен във всеки план, включително разширенията pgvector 0.8 и PostGIS 3.5.

  5. v3.0.0breaking

    shunt merge вече изисква --yes за разрушителни миграции в неинтерактивни shell-ове. Вашият CI ще забележи. Точно това е идеята.

[05] Клавиатураshunt ui · работи през ssh · минимум 80 колони

Мишката е по желание.

shunt ui е цял екран TUI за разглеждане, сравняване и сливане на клонове. Уважава $EDITOR, $PAGER и мускулната ви памет. Има и уеб табло. Ползваме го основно за скрийншоти.

Клавишни комбинации в shunt ui
КлавишДействиеБележки
bНов клон от избранотопита за име; допълва с Tab от git
dСравнение с родителяпърво схемата, данните с Enter
mСливане в родителявинаги първо показва плана
rВръщане към родителяотхвърля записите; пита веднъж
sСпиране / пускане на computeданните остават, таксуването спира
/Филтър на клоноветеregex, естествено
g gКъм mainза хората на vim
ctrl zОтмяна на последното сливанедо 15 минути, преди някой да забележи
?Показва тази таблицаако забравите, че съществува
[05½] Отзиви от теренанередактирани, освен ругатните

Какво казват инженерите

Изтрихме 1900 реда скриптове за seed данни още в седмицата на прехода. Никой не си ги е поискал обратно, включително човекът, който ги написа.
Ingrid Valtonen
Staff Engineer, Paraday
Всеки PR получава истинско копие на продукцията с маскирани имейли. QA спряха да пускат бъгове, които се възпроизвеждат само във вторник.
Tomás Arriaga
Ръководител „Платформа“, Quillon Health
Планът за сливане хвана NOT NULL върху таблица с 400 милиона реда в 16:55 ч. в петък. Искам да му благодаря лично.
Priya Raman
Ръководител бази данни, Obel Ledger
[06] Цениusd · месечно таксуване · отказ с една команда

Таблица, не фуния.

Всеки план включва CLI, TUI, copy-on-write съхранение и клонове за под секунда. Разликите са по-долу. Скрити редове няма.

Сравнение на плановете
ФункцияSolo0 $Team24 $ / разраб. / мес.повечето екипи започват оттукScale480 $ / мес. + ползванеEnterpriseДа поговорим
Активни клонове10Без лимитБез лимитБез лимит
Включено място10 GB250 GB2 TBПо договаряне
Допълнително място—0,12 $ / GB-мес.0,09 $ / GB-мес.По договор
Compute за клонСподелен2 vCPUДо 16 vCPUОтделен
Правила за маскиране на PII✓ включено✓ включено✓ включено✓ включено
Сравнение на данни— не е включено✓ включено✓ включено✓ включено
Планове за сливане + отмяна— не е включено✓ включено✓ включено✓ включено
SSO / SCIM— не е включено— не е включено✓ включено✓ включено
Пазене на одит лога—30 дни1 година7 години
Ваш собствен облак— не е включено— не е включено— не е включено✓ включено
ПоддръжкаФорумИмейл, 1 работен денSlack, 4 часаЛичен инженер, 1 час
 Инсталирай CLI14 дни пробно14 дни пробноРазговор
[07] Чести въпросиman shunt-faq

Въпроси, отговорени направо.

Липсва нещо? engineers@shuntline.example стига до хората, които писаха кода, а не до опашка с тикети.

Клонът истинска Postgres база ли е?

Да. Пълна Postgres инстанция със собствен connection string, роли и разширения. Вашият ORM, инструментът за миграции и psql няма да усетят разлика — в това е смисълът.

Копирате ли продукционните данни заедно с PII?

Клоновете се маскират при създаване по правила, които задавате в shunt.toml — хеш, заличаване, фалшиви данни или запазване, по колона. Правилата по подразбиране хващат имейли, телефони и всичко, наречено като тайна. Немаскираните клонове изискват изричен флаг и се записват в лога.

Мога ли да сливам данни, или само схема?

И двете. Сливането на схема дава план за миграция. Сливането на данни се включва за всяка таблица и се решава по първичен ключ, а конфликтите се изброяват, вместо да се гадаят.

Какво става, ако main се е променил, докато съм бил в клона?

shunt merge проверява за разминаване спрямо commit-а, от който е тръгнал клонът ви. Ако нещо се е променило под краката ви, пренарежда плана и ви показва разликата, преди да направи каквото и да е.

Как се таксува copy-on-write съхранението?

Плащате за страниците, които клонът е записал, а не за размера на родителя. Нов клон на база от 2 TB не струва нищо за съхранение, докато не промените нещо.

Къде работи?

В управлявани региони eu-1, eu-2, us-1 и ap-1 или в собствения ви облачен акаунт при Enterprise. Данните ви остават в избрания регион; пишем го и в договора.

[08] Документация214 страници · търсене офлайн с shunt docs
[09] Вижте също

Прочетете ръководството.

Бързият старт отнема единайсет минути, четири от които чакате първата реплика да се синхронизира. Или го пропуснете, започнете пробния период и четете документацията, когато нещо ви изненада. Повечето хора правят така.

Без карта. Без обаждане от търговци, освен ако не напишете `shunt sales --please`.

ИМЕ
    shunt-branch — създава, изброява или трие клонове

СИНТАКСИС
    shunt branch create <name> [--from ref]
        [--ttl dur] [--mask rules]

ОПИСАНИЕ
    Създава copy-on-write клон на
    ref (по подразбиране: main). Не се копират данни.
    Страниците се дублират при първи запис.

ГРЕШКИ
    Известни: няма. Подозирани: няколко.