Ir al contenido

Primeros pasos

Elige la superficie que prefieras; todas llaman a las mismas rutas.

Superficie Ideal para Empezar
Studio Ver qué es un proyecto y recorrer el ciclo de vida con clics Quickstart: Studio
hcloud (CLI) Scripts, terminal, CI Quickstart: hcloud
curl Entender el contrato HTTP Quickstart: curl
@hyphae/cloud (JavaScript) Aplicaciones Quickstart: JavaScript
  1. Un proyecto es un motor. Crear un proyecto reserva un nombre y un puerto de loopback; nada corre hasta que lo despiertas. Dormirlo detiene el proceso y conserva el directorio de datos. → Un Native por proyecto, Ciclo de vida
  2. Dos credenciales. Tu sesión (hyc0_…, 24 h, del login) administra proyectos. Una clave de proyecto (hyp1_…) es lo que usa una aplicación en el data plane. Las claves se muestran una vez y se comprueban en cada petición. → Credenciales
  3. El data plane es la propia API de Native. /v2/* se reenvía tal cual a tu motor; el Cloud no lo reescribe. El Studio decodifica un solo tipo de respuesta (capabilities) y muestra los nombres de campo del motor sin cambios. → Campos de Native
  4. Los snapshots son copias Native, tomadas sobre un proyecto dormido; restore reemplaza el directorio. → Snapshots y restore
  5. Storage, realtime y funciones son servicios del Cloud junto al motor: un catálogo de blobs, un fanout de eventos en proceso y procesos con límite de tiempo que ejecutan tu código. Cada uno tiene límites y no-afirmaciones claras. → Storage, Realtime, Funciones y secretos
  • Origen público: https://infra-hyphae.run (API y el Studio en /studio/). Estos docs se publican en https://hyphae.dev/cloud/docs/.
  • Plano de control: /v0/* — cuentas, proyectos, claves, snapshots, catálogo de storage, realtime, funciones.
  • Data plane: /v2/* — tu motor, a través del proxy del Cloud, con una clave de proyecto.
  • Salud: /healthz, /readyz (sin credenciales).

La lista completa de rutas se genera del contrato: referencia HTTP (en inglés).