Despliegue portable

Instala un contrato portable

PBOC v1alpha1 es el límite público entre el build de una aplicación y un host de despliegue. La versión 0.4.0-beta.1 publica pliego-pboc, pliego-cloudflare y la ruta de admisión nativa como un solo grafo preview; fija cada crate pliego-* en esa versión exacta.

[dependencies]
pliego-pboc = "=0.4.0-beta.1"
pliego-runtime = "=0.4.0-beta.1"
# Only for a Cloudflare Worker target
pliego-cloudflare = "=0.4.0-beta.1"

Verifica antes del upload

La validación comprueba estructura canónica, cada ruta de artefacto, longitud, SHA-256, el set exacto de archivos, referencias de rutas y funciones, política de cache, cierre de features, provenance y el límite que mantiene valores secretos fuera de la salida.

pliego pboc validate target/app/pliego.pboc.json --root target/app
pliego pboc admit target/app/pliego.pboc.json --root target/app --host native
pliego pboc admit target/app/pliego.pboc.json --root target/app --host cloudflare

Ejecuta el mismo build en dos hosts

Native Linux / OCI

Ejecutable musl estático, identidades de ruta y runtime verificadas, imagen de referencia nonroot, filesystem de solo lectura e ingress explícito del operador

Cloudflare Workers

Adapter Rust workers-rs, registro exacto de funciones, handles de secretos mapeados después de la admisión, streaming nativo de Worker y binding de Assets

Shared semantics

Un router, SHA PBOC, identidad de release, corpus de estados/body/headers HTTP, política de cache y diagnósticos limitados

IDs de cuenta del proveedor, credenciales, dominios, política de tráfico, TLS, billing, destinos de observabilidad e infraestructura persistente siguen como configuración del operador fuera del bundle portable.

Demuestra la dirección rolling y rollback

pliego pboc compatibility active/pliego.pboc.json candidate/pliego.pboc.json --direction rolling
pliego pboc compatibility candidate/pliego.pboc.json active/pliego.pboc.json --direction rollback

La coexistencia rolling exige la misma aplicación, epoch de compatibilidad y schema de estado, una secuencia mayor y un vínculo exacto al release anterior. Rollback exige además una secuencia menor y que el release activo haya declarado rollbackSafe.

Reproduce la conformidad de proveedores

npm ci
npm ci --prefix examples/provider-tck
npm run check:provider-tck

El gate Linux compila dos releases, registra cuatro admisiones de host, comprueba casos negativos de capabilities y estado, escanea todos los bytes del bundle con un sentinel secreto, reproduce version skew y rollback y compara siete casos HTTP entre native, OCI y Cloudflare.

Conoce lo que aún no es portable

Los hosts mantenidos del preview son native Linux/OCI y Cloudflare Workers. Bases de datos, queues, schedules, object storage, durable objects, billing del proveedor, migración automática de estado y paridad de boundaries asíncronos no forman parte de PBOC v1alpha1.