Toute installation auto-hébergée a besoin d'un jeton de licence, que ses workers s'exécutent dans des microVM AWS ou, pour une évaluation, sur le même ordinateur. Une licence couvre une installation. Vous pouvez acheter des licences vous-même sur le site web, ou Ephemeral peut accorder à votre organisation une allocation dans le cadre d'un accord distinct.
Fonctionnement des licences
- Un propriétaire ou administrateur ouvre Déploiements dans le portail client, choisit la facturation mensuelle ou annuelle, le nombre d'installations et les éventuels blocs d'exécutions supplémentaires, accepte le contrat de licence auto-hébergée et paie avec Stripe. La licence est active dès que le paiement est terminé. Les organisations disposant d'un contrat négocié reçoivent à la place une allocation d'Ephemeral et passent cette étape.
- Le propriétaire ou l'administrateur enregistre chaque installation sous Déploiements avec un nom. Ephemeral crée son ID de machine et son jeton de licence, et n'affiche le jeton qu'une fois, avec un bouton Télécharger le fichier de licence qui enregistre le jeton, l'ID de machine et l'ID de déploiement.
- L'installation est configurée avec
EPHEMERAL_LICENSE_TOKEN,EPHEMERAL_MACHINE_IDetEPHEMERAL_CUSTOMER_URL=https://ephemer.al. Elle valide le jeton auprès d'Ephemeral au démarrage et avant d'exécuter du travail. Le même ID de déploiement et le même jeton permettent de se connecter au registre d'images (voir auto-hébergement).
Enregistrer un déploiement n'est qu'une opération de licence. Cela ne crée, ne démarre ni n'arrête aucune infrastructure ; vous l'installez et la mettez à jour vous-même, comme décrit dans auto-hébergement.
Formules et contenu d'une licence
| Élément | Mensuel | Annuel |
|---|---|---|
| Forfait de base : 1 installation et 100 000 exécutions par mois | $5,000 | $50,000 |
| Chaque installation supplémentaire | $2,500 | $25,000 |
| Chaque tranche de 100 000 exécutions supplémentaires par mois | $1,000 | $10,000 |
Le forfait de base comprend une installation et 100 000 exécutions par mois. Ajoutez des installations et des blocs de 100 000 exécutions selon vos besoins : par exemple, le forfait de base avec 2 installations supplémentaires et 3 blocs supplémentaires représente 3 installations qui se partagent 400 000 exécutions par mois, pour $5,000 + 2 × $2,500 + 3 × $1,000 = $13,000 par mois ($130,000 par an).
Les exécutions sont mutualisées : les exécutions mensuelles appartiennent à votre organisation et sont partagées par toutes ses installations, quelle que soit leur répartition. Chaque installation autorise 20 exécutions simultanées, avec toutes les mises à jour et l'assistance par e-mail. Des allocations plus importantes sont disponibles dans le cadre d'un contrat distinct : contactez-nous. Les prix s'entendent hors taxes. L'abonnement se renouvelle automatiquement jusqu'à ce que vous le résiliiez.
Modification, annulation et paiements échoués
- Gérer l'abonnement, sur la page Déploiements, ouvre le portail de facturation Stripe, où les propriétaires et administrateurs mettent à jour la carte, téléchargent les factures et résilient.
- L'annulation prend effet à la fin de la période que vous avez payée. Les installations continuent de fonctionner jusque-là.
- Modifier le forfait : Modifier le forfait, sur la page Déploiements, change le nombre d'installations et de blocs d'exécutions supplémentaires. Stripe calcule la modification au prorata pour le reste de la période, et un abonnement au prix précédent par licence est converti en forfait de base avec des éléments supplémentaires.
- Retirer des installations est refusé tant que plus d'installations sont enregistrées que le nouveau nombre : désactivez-en d'abord. Retirer des blocs d'exécutions réduit immédiatement les exécutions mensuelles partagées.
- Un paiement échoué n'arrête pas vos installations immédiatement. Stripe retente le paiement, et la licence reste valide jusqu'à 7 jours après la fin de la dernière période payée. Si le paiement manque toujours, la licence expire et les installations cessent de se valider. Payer plus tard la rétablit.
- Lorsqu'une licence prend fin, le jeton et la connexion au registre cessent de fonctionner. Vos données n'ont jamais été chez Ephemeral et restent dans votre propre installation.
Vérifier votre droit d'utilisation
/v1/organizations/{id}/licenseentitlement (null lorsque votre organisation n'en a pas) et sa consommation actuelle, la subscription (statut, intervalle, quantité, paid_through) d'une licence achetée, et les informations sales que le site web utilise pour proposer un achat.max_deploymentsintegermax_concurrencyintegermax_runs_per_monthintegerpooledbooleanpooled_runs_per_monthintegerruns_used_this_monthintegerexpires_attimestampstatusstringactive ou expired.sourcestringsubscription pour une licence que vous avez achetée, operator pour une allocation accordée par Ephemeral.active_deploymentsintegeravailable_deploymentsintegerLa subscription indique aussi installations, run_blocks (les blocs d'exécutions supplémentaires) et pooled_runs_per_month.
/v1/organizations/{id}/license/plan409 si moins d'installations sont demandées que d'installations actives.installationsintegerobligatoireextra_run_blocksintegerEnregistrer une installation
/v1/organizations/{id}/deploymentsnamestringobligatoiremachine_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"
}L'enregistrement échoue avec 403 lorsque votre organisation n'a aucune licence active, et avec 409 lorsque tous les déploiements autorisés sont enregistrés.
Lister et désactiver
/v1/organizations/{id}/deploymentsid, name, machine_id, max_concurrency, max_runs_per_month, expires_at et revoked./v1/organizations/{id}/deployments/{deployment_id}Ce que l'installation applique
| Contrôle | Effet |
|---|---|
| Démarrage | Le moteur ne démarre pas sans jeton et ID de machine valides, ni si sa concurrence configurée dépasse celle de la licence. |
| Avant chaque exécution | La licence est vérifiée de nouveau, avec un résultat mis en cache pendant 30 secondes au plus. Si elle n'est plus valide, l'exécution échoue. |
| Exécutions mensuelles | Lorsque l'allocation du mois est épuisée, POST /v1/runs renvoie 402 jusqu'au mois suivant. Avec un abonnement, l'allocation est le pool partagé par toutes les installations (voir ci-dessous). |
Comment le pool est appliqué : chaque installation signale les exécutions qu'elle a lancées ce mois-ci chaque fois qu'elle valide sa licence (au plus toutes les 30 secondes tant qu'elle lance des exécutions). Ephemeral répond par une limite égale aux exécutions propres de cette installation ce mois-ci plus ce qu'il reste du pool, de sorte que l'organisation reste globalement dans son allocation. Les installations se rafraîchissent toutes les 30 secondes : le pool peut donc être dépassé brièvement, au plus des exécutions lancées par toutes les installations en environ une minute. Une installation qui exécute une version antérieure à la mutualisation ne signale rien ; elle reçoit une part égale du pool.
Les limites appliquées sont les plus basses entre les valeurs de l'enregistrement et celles du droit d'utilisation actuel : une réduction du droit d'utilisation prend donc effet sans nouvel enregistrement. Lorsqu'Ephemeral renouvelle un droit d'utilisation, les enregistrements existants reçoivent la nouvelle expiration et les nouvelles limites, et conservent leurs jetons. Révoquer le droit d'utilisation révoque tous ses enregistrements.