Toda instalación autoalojada necesita un token de licencia, tanto si sus workers se ejecutan en microVM de AWS como, para evaluación, en el mismo equipo. Una licencia cubre una instalación. Puedes comprar licencias tú mismo en el sitio web, o Ephemeral puede conceder a tu organización una asignación mediante un acuerdo aparte.
Cómo funcionan las licencias
- Un propietario o administrador abre Despliegues en el portal del cliente, elige la facturación mensual o anual, el número de instalaciones y los bloques de ejecuciones adicionales, acepta el Acuerdo de licencia autoalojada y paga con Stripe. La licencia queda activa en cuanto se completa el pago. Las organizaciones con un acuerdo negociado reciben en su lugar una asignación de Ephemeral y se saltan este paso.
- El propietario o administrador registra cada instalación en Despliegues con un nombre. Ephemeral crea su ID de máquina y su token de licencia, y muestra el token una sola vez, con un botón Descargar archivo de licencia que guarda el token, el ID de máquina y el ID del despliegue.
- La instalación se configura con
EPHEMERAL_LICENSE_TOKEN,EPHEMERAL_MACHINE_IDyEPHEMERAL_CUSTOMER_URL=https://ephemer.al. Valida el token con Ephemeral al arrancar y antes de ejecutar trabajo. El mismo ID de despliegue y token sirven para iniciar sesión en el registro de imágenes (consulta autoalojamiento).
Registrar un despliegue es solo una operación de licencia. No crea, inicia ni detiene ninguna infraestructura; la instalas y actualizas tú, como se describe en autoalojamiento.
Planes y qué incluye una licencia
| Componente | Mensual | Anual |
|---|---|---|
| Plan base: 1 instalación y 100.000 ejecuciones al mes | $5,000 | $50,000 |
| Cada instalación adicional | $2,500 | $25,000 |
| Cada 100.000 ejecuciones adicionales al mes | $1,000 | $10,000 |
El plan base incluye una instalación y 100.000 ejecuciones al mes. Añade instalaciones y bloques de 100.000 ejecuciones según los necesites: por ejemplo, el plan base con 2 instalaciones adicionales y 3 bloques adicionales son 3 instalaciones que comparten 400.000 ejecuciones al mes, por $5,000 + 2 × $2,500 + 3 × $1,000 = $13,000 al mes ($130,000 al año).
Las ejecuciones se agrupan: las ejecuciones mensuales pertenecen a tu organización y las comparten todas sus instalaciones, sin importar cómo se reparten entre ellas. Cada instalación permite 20 ejecuciones simultáneas, con todas las actualizaciones y soporte por correo. Hay asignaciones mayores con un acuerdo aparte: contáctanos. Los precios no incluyen impuestos. La suscripción se renueva automáticamente hasta que la canceles.
Cambios, cancelación y pagos fallidos
- Gestionar suscripción en la página Despliegues abre el portal de facturación de Stripe, donde los propietarios y administradores actualizan la tarjeta, descargan facturas y cancelan.
- Cancelar surte efecto al final del periodo que pagaste. Las instalaciones siguen funcionando hasta entonces.
- Cambiar el plan: Cambiar plan en la página Despliegues cambia el número de instalaciones y de bloques de ejecuciones adicionales. Stripe prorratea el cambio por el resto del periodo, y una suscripción con el precio anterior por licencia se convierte al plan base con elementos adicionales.
- Quitar instalaciones se rechaza mientras haya más instalaciones registradas que el nuevo número: desactiva algunas antes. Quitar bloques de ejecuciones reduce de inmediato las ejecuciones mensuales compartidas.
- Un pago fallido no detiene tus instalaciones de inmediato. Stripe reintenta el pago y la licencia sigue siendo válida hasta 7 días después del fin del último periodo pagado. Si el pago sigue sin llegar, la licencia caduca y las instalaciones dejan de validarse. Pagar más tarde la restablece.
- Cuando una licencia termina, el token y el inicio de sesión en el registro dejan de funcionar. Tus datos nunca estuvieron en Ephemeral y permanecen en tu propia instalación.
Comprobar tu derecho de uso
/v1/organizations/{id}/licenseentitlement (null cuando tu organización no tiene ninguno) y su uso actual, la subscription (estado, intervalo, cantidad, paid_through) de una licencia comprada, y la información sales que el sitio web usa para ofrecer una compra.max_deploymentsintegermax_concurrencyintegermax_runs_per_monthintegerpooledbooleanpooled_runs_per_monthintegerruns_used_this_monthintegerexpires_attimestampstatusstringactive o expired.sourcestringsubscription para una licencia que compraste, operator para una asignación concedida por Ephemeral.active_deploymentsintegeravailable_deploymentsintegerLa subscription también informa de installations, run_blocks (los bloques de ejecuciones adicionales) y pooled_runs_per_month.
/v1/organizations/{id}/license/plan409 si se piden menos instalaciones de las que hay activas.installationsintegerobligatorioextra_run_blocksintegerRegistrar una instalación
/v1/organizations/{id}/deploymentsnamestringobligatoriomachine_idstring{
"id": "dep_2c8f0e6a4b1d9375c0e8a2f4b6d1c3e5",
"name": "production-eu",
"machine_id": "mch_3f9a0c1e7b2d4a6c8e10",
"token": "lic_…",
"max_concurrency": 4,
"max_runs_per_month": 20000,
"expires_at": "2027-09-30T00:00:00Z"
}El registro falla con 403 cuando tu organización no tiene una licencia activa y con 409 cuando ya están registrados todos los despliegues permitidos.
Listar y desactivar
/v1/organizations/{id}/deploymentsid, name, machine_id, max_concurrency, max_runs_per_month, expires_at y revoked./v1/organizations/{id}/deployments/{deployment_id}Qué aplica la instalación
| Comprobación | Efecto |
|---|---|
| Arranque | El motor no arranca sin un token y un ID de máquina válidos, o si su concurrencia configurada supera la de la licencia. |
| Antes de cada ejecución | La licencia se vuelve a comprobar, usando un resultado en caché durante hasta 30 segundos. Si ya no es válida, la ejecución falla. |
| Ejecuciones mensuales | Cuando se agota la asignación del mes, POST /v1/runs devuelve 402 hasta el mes siguiente. Con una suscripción, la asignación es el conjunto compartido por todas las instalaciones (véase abajo). |
Cómo se aplica el conjunto: cada instalación informa de las ejecuciones que inició este mes cada vez que valida su licencia (como máximo cada 30 segundos mientras inicia ejecuciones). Ephemeral responde con un límite igual a las ejecuciones propias de esa instalación este mes más lo que queda del conjunto, de modo que la organización en su conjunto se mantiene dentro de su asignación. Las instalaciones se actualizan cada 30 segundos, así que el conjunto puede superarse brevemente, como máximo por las ejecuciones iniciadas entre todas las instalaciones en aproximadamente un minuto. Una instalación con una versión anterior a esta agrupación no informa y recibe una parte igual del conjunto.
Los límites que se aplican son el menor de los valores del registro y del derecho de uso actual, así que un derecho de uso reducido surte efecto sin volver a registrar. Cuando Ephemeral renueva un derecho de uso, los registros existentes reciben la nueva caducidad y los nuevos límites y conservan sus tokens. Revocar el derecho de uso revoca todos sus registros.