Saltar al contenido
Demo conceptual

Una marca ficticia, diseñada y desarrollada por Get Ranked On Top. No es una empresa real.

Ir al contenido
SHUNT(1)Manual de Shuntline · rev. 3.12.0 · 2026-10-14SHUNT(1)
[00] Nombre — shunt · ramas copy-on-write para Postgres

Ramifica tu base de datos como tu código.

Cada pull request recibe su propia copia de producción con escritura: enmascarada, aislada y lista en menos de un segundo. Compárala, fusiónala con un plan o tírala. Tus scripts de seed pueden jubilarse con dignidad.

curl -fsSL https://get.shuntline.example | sh
Sinopsis
0,8 spara ramificar 1,84 TB. Mediana, no la mejor tirada.
0 Bcopiados hasta que escribes algo.
1,9 Mramas creadas el mes pasado; 1,7 M de ellas borradas según lo previsto.
PGPostgres 14–17. MySQL 8.4 en beta, con las advertencias de rigor.
Fig. 1 shunt tree — las ramas de prod-eu-1, ahora mismo
$ shunt tree --db prod-eu-1

main                      ● 4f2a91c  1.84 TB   protegida
├─ feature/payments       ● 9be04d7  +412 MB   +3 tbl ~1 col -1 col
│  ├─ preview/pr-482      ● 2d71aa0  +6.1 MB   +1204 -18 filas
│  └─ ci/run-88213        ○ 9be04d7  0 B       suspendida
├─ fix/invoice-round      ● a0c3f19  +88 KB    ~312 filas
└─ scratch/kenji          ○ 4f2a91c  0 B       ttl 3h 51m

6 ramas · 4 activas · 506 MB escritos · 11,04 TB sin copiar
Fig. 2 Horario, viernes 16 de octubreGráfico estilo Git: feature/payments sale de main, preview/pr-482 sale de feature/payments, y feature/payments se fusiona de vuelta en main.09:0010:0011:0012:0013:0014:00mainfeature/paymentspreview/pr-4824f2a91c7c03e1dfusión+3~1-1esquema+1,204-18filas
En producción en 4100 equipos de ingeniería, entre ellosa ninguno le pagamos por estar aquí
  • Paraday
  • Quillon Health
  • Marrow & Finch
  • Obel Ledger
  • Tessary
  • Kallio Freight
[01] Terminalsin registro, sin red, sin consecuencias

Tres comandos. Ese es el producto.

Haz clic en un comando para ejecutarlo contra una copia ficticia de producción. La salida es real en el sentido de que es exactamente lo que verías; es falsa en el sentido de que no hemos borrado tu columna de verdad.

branch create
puntero a las páginas del padre, cómputo nuevo, enmascarado.
diff
esquema y filas, contra cualquier ancestro.
merge
un plan, una comprobación de deriva, un lock timeout y luego el trabajo.
acme-api — zsh — shunt 3.12.0libre
Last login: Fri Oct 16 09:12:44 on ttys004
~/acme-api (main) $ shunt branch create feature/payments --from main
→ resolviendo main @ 4f2a91c  (prod-eu-1 · postgres 16.4)
→ snapshot de 212 tablas, 1,84 TB lógicos
  copy-on-write: 0 bytes escritos. lo comprobamos dos veces.
→ aprovisionando cómputo  shu-c-2x  (2 vCPU · 8 GB)
✓ rama feature/payments lista en 0,81 s

  postgres://app@feature-payments.eu-1.shuntline.example/app
  ttl 72h · se suspende tras 5 min inactiva · enmascarado: pii-default
~/acme-api (main) $ 

[02] Cómo funciona3 pasos · 0 archivos YAML · 1 línea de CI

Semántica de Git para la parte de tu stack que nunca la tuvo.

Paso 01: Apúntalo a Postgres

Shuntline se conecta como réplica de lectura. Nunca escribe en tu primaria y no necesita superuser: solo REPLICATION y la paciencia que dura un café para la primera sincronización.

paso 01
$ shunt init \
    --from $PROD_URL
→ réplica conectada (lag 120ms)
✓ 212 tablas en seguimiento

Paso 02: Una rama por pull request

Una línea en CI da a cada PR su propia base de datos con escritura, con la PII enmascarada por reglas y un TTL para que nadie pague por los experimentos del trimestre pasado.

paso 02
$ shunt branch create \
    preview/pr-$PR --ttl 72h
→ enmascarando 14 columnas
✓ lista en 0,79 s

Paso 03: Compara, fusiona, olvida

Mira los cambios de esquema y de filas frente al padre, genera un plan de migración que de verdad se puede leer y fusiónalo, o borra la rama y haz como si nunca hubiera existido.

paso 03
$ shunt merge --plan
+ table payment_intents
- column legacy_ref
1 destructivo. --yes para seguir
[03] Benchmarksmediana de 30 ejecuciones · postgres 16 · eu-1 · sept. 2026
Crear rama0,8 s

p50 en una base de 1,84 TB. El p99 es 1,6 s, casi todo DNS.

Escrito al crear0 B

Copy-on-write a nivel de página. Guardas lo que cambias.

Coste de lectura+0,4ms

latencia p99 añadida en páginas calientes frente al padre.

Espacio ahorrado38×

Mediana entre clientes frente a clones nocturnos completos.

Tiempo hasta una copia con escritura de una base de 500 GB

pg_dump → pg_restore3 h 41 min
Réplica lógica + promote1 h 12 min
Restaurar snapshot de volumen27 min
shunt branch create0,8 s

Nuestra barra mide 1px porque el 0,0006 % del ancho no se veía. Metodología y datos en bruto en docs/benchmarks.

Fig. 3 Copy-on-write, dibujado con honestidadmainfeature/payments000102030405060708098 punteros, 2 páginas

Una rama es una lista de punteros a las páginas de su padre. Escribe en una página y la rama obtiene su propia copia de esa página, solo de esa. Aquí: dos de diez. Pagas por las naranjas.

[04] Cambiosshunt changelog --follow

Publicamos los martes y los jueves.

Cuarenta y una versiones este año. Versionado semántico, escrito por personas, con los cambios incompatibles en rojo para que encuentres rápido los que importan.

Historial completo, hasta la v0.1 →
  1. v3.12.0perf

    shunt diff --data muestrea las tablas de más de 100 M de filas en lugar de recorrerlas enteras. 41× más rápido, y te avisa de que ha muestreado, porque no somos monstruos.

  2. v3.11.2fix

    Los nombres de rama con barra final ya no crean una rama llamada, a efectos prácticos, nada. Gracias a los cuatro que lo encontrasteis.

  3. v3.11.0nuevo

    Los TTL ahora se heredan de la rama padre. Las ramas preview/* duran 72h por defecto, salvo que digas otra cosa en shunt.toml.

  4. v3.10.0nuevo

    Postgres 17 ya está disponible en todos los planes, con las extensiones pgvector 0.8 y PostGIS 3.5.

  5. v3.0.0rompe

    shunt merge ahora exige --yes para migraciones destructivas en shells no interactivas. Tu CI lo notará. De eso se trata.

[05] Tecladoshunt ui · funciona por ssh · mínimo 80 columnas

El ratón es opcional.

shunt ui es una TUI a pantalla completa para explorar, comparar y fusionar ramas. Respeta $EDITOR, $PAGER y tu memoria muscular. También hay un dashboard web. Lo usamos sobre todo para capturas.

Atajos de teclado en shunt ui
TeclaAcciónNotas
bNueva rama desde la selecciónpide un nombre; autocompleta con Tab desde git
dComparar con el padreprimero el esquema, los datos con Enter
mFusionar en el padresiempre enseña el plan primero
rRestablecer al padredescarta escrituras; pregunta una vez
sSuspender / reanudar cómputoel almacenamiento se queda, la factura se para
/Filtrar ramasregex, faltaría más
g gSaltar a mainpara la gente de vim
ctrl zDeshacer la última fusiónen 15 minutos, antes de que nadie se entere
?Mostrar esta tablapor si olvidas que existe
[05½] Desde el terrenosin editar, salvo los tacos

Lo que dicen los ingenieros

Borramos 1900 líneas de scripts de seed la misma semana del cambio. Nadie las ha pedido de vuelta, ni siquiera quien las escribió.
Ingrid Valtonen
Staff Engineer, Paraday
Cada PR recibe una copia real de producción con los emails enmascarados. QA dejó de abrir bugs que solo se reproducen los martes.
Tomás Arriaga
Responsable de Plataforma, Quillon Health
El plan de fusión cazó un NOT NULL en una tabla de 400 millones de filas a las 16:55 de un viernes. Me gustaría darle las gracias en persona.
Priya Raman
Responsable de Bases de Datos, Obel Ledger
[06] Preciosusd · facturación mensual · cancela con un comando

Una tabla, no un embudo.

Todos los planes incluyen la CLI, la TUI, almacenamiento copy-on-write y ramas en menos de un segundo. Las diferencias están abajo. No hay filas ocultas.

Comparativa de planes
FunciónSolo0 $Team24 $ / dev / mescasi todos los equipos empiezan aquíScale480 $ / mes + usoEnterpriseHablemos
Ramas activas10IlimitadasIlimitadasIlimitadas
Almacenamiento incluido10 GB250 GB2 TBA medida
Almacenamiento extra—0,12 $ / GB-mes0,09 $ / GB-mesComprometido
Cómputo por ramaCompartido2 vCPUHasta 16 vCPUDedicado
Reglas de enmascarado de PII✓ incluido✓ incluido✓ incluido✓ incluido
Diff de datos— no incluido✓ incluido✓ incluido✓ incluido
Planes de fusión + deshacer— no incluido✓ incluido✓ incluido✓ incluido
SSO / SCIM— no incluido— no incluido✓ incluido✓ incluido
Retención del log de auditoría—30 días1 año7 años
Tu propia nube— no incluido— no incluido— no incluido✓ incluido
SoporteForoEmail, 1 día laborableSlack, 4 horasIngeniero asignado, 1 hora
 Instala la CLIPrueba 14 díasPrueba 14 díasAgenda una llamada
[07] Preguntas frecuentesman shunt-faq

Preguntas, respuestas claras.

¿Falta algo? engineers@shuntline.example llega a quienes escribieron el código, no a una cola de tickets.

¿Una rama es una base de datos Postgres de verdad?

Sí. Es una instancia completa de Postgres con su propia cadena de conexión, roles y extensiones. Tu ORM, tu herramienta de migraciones y psql no notarán la diferencia, y de eso se trata.

¿Copiáis los datos de producción, PII incluida?

Las ramas se enmascaran al crearse con las reglas que defines en shunt.toml: hash, ocultar, falsear o conservar, por columna. Las reglas por defecto pillan emails, teléfonos y cualquier cosa con nombre de secreto. Las ramas sin enmascarar exigen un flag explícito y quedan registradas.

¿Puedo fusionar datos o solo el esquema?

Las dos cosas. Fusionar el esquema genera un plan de migración. Fusionar datos se activa por tabla y se resuelve por clave primaria; los conflictos se listan en vez de adivinarse.

¿Qué pasa si main ha cambiado mientras yo trabajaba en la rama?

shunt merge busca deriva frente al commit del que partió tu rama. Si algo ha cambiado por debajo, rehace el plan y te enseña la diferencia antes de tocar nada.

¿Cómo se factura el almacenamiento copy-on-write?

Pagas por las páginas que ha escrito la rama, no por el tamaño de su padre. Una rama recién creada de una base de 2 TB no cuesta nada de almacenamiento hasta que cambias algo.

¿Dónde se ejecuta?

En regiones gestionadas eu-1, eu-2, us-1 y ap-1, o dentro de tu propia cuenta en la nube con Enterprise. Tus datos se quedan en la región que elijas; también lo ponemos en el contrato.

[08] Documentación214 páginas · búsqueda sin conexión con shunt docs
[09] Véase también

Lee el manual.

La guía rápida lleva once minutos, cuatro de ellos esperando a que se sincronice tu primera réplica. O sáltatela, empieza una prueba y lee la documentación cuando algo te sorprenda. Es lo que hace casi todo el mundo.

Sin tarjeta. Sin llamadas comerciales, salvo que escribas `shunt sales --please`.

NOMBRE
    shunt-branch — crea, lista o borra ramas

SINOPSIS
    shunt branch create <name> [--from ref]
        [--ttl dur] [--mask rules]

DESCRIPCIÓN
    Crea una rama copy-on-write de
    ref (por defecto: main). No se copian datos.
    Las páginas se duplican en la primera escritura.

ERRORES
    Ninguno conocido. Varios sospechosos.