セルフホストのインストールには、ワーカーを AWS の microVM で実行する場合も、評価のために同じコンピューターで実行する場合も、ライセンストークンが必要です。1 つのライセンスで 1 つのインストールをカバーします。ライセンスはウェブサイトからご自身で購入できます。別途の契約に基づいて、Ephemeral が組織に利用枠を付与することもできます。
ライセンスの仕組み
- オーナーまたは管理者が、カスタマーポータルのデプロイメントで、月払いまたは年払い、インストールの数、追加する実行枠を選び、セルフホストライセンス契約に同意して、Stripe で支払います。支払いが完了すると、ライセンスはすぐに有効になります。個別に契約を結んでいる組織には、代わりに Ephemeral から利用枠が付与されるため、この手順は不要です。
- オーナーまたは管理者が、デプロイメントで、名前を指定して各インストールを登録します。マシン ID とライセンストークンは Ephemeral が作成し、トークンは 1 度だけ表示されます。ライセンスファイルをダウンロードボタンで、トークン、マシン ID、デプロイメント ID を保存できます。
- インストールには、
EPHEMERAL_LICENSE_TOKEN、EPHEMERAL_MACHINE_ID、EPHEMERAL_CUSTOMER_URL=https://ephemer.alを設定します。インストールは、起動時と処理を実行する前に、Ephemeral に対してトークンを検証します。同じデプロイメント ID とトークンで、イメージレジストリにサインインできます (セルフホストを参照)。
デプロイメントの登録は、ライセンスに関する操作のみです。インフラの作成、起動、停止は行いません。インフラのインストールと更新は、セルフホストの説明に従って、ご自身で行ってください。
プランとライセンスに含まれるもの
| 内訳 | 月払い | 年払い |
|---|---|---|
| 基本プラン: インストール 1 つと月 100,000 件の実行 | $5,000 | $50,000 |
| 追加のインストール 1 つにつき | $2,500 | $25,000 |
| 月 100,000 件の実行の追加 1 枠につき | $1,000 | $10,000 |
基本プランには、インストール 1 つと月 100,000 件の実行が含まれます。必要に応じて、インストールと 100,000 件ごとの実行枠を追加できます。たとえば、基本プランに追加インストール 2 つと追加の実行枠 3 枠を加えると、3 つのインストールで月 400,000 件の実行を共有し、$5,000 + 2 × $2,500 + 3 × $1,000 = 月 $13,000 (年払いなら $130,000) です。
実行数はプールされます。月間の実行数は組織のもので、すべてのインストールで共有され、インストール間の配分は問いません。どのインストールでも同時に 20 件の実行が可能で、すべてのアップデートとメールサポートが含まれます。より大きな利用枠は、別途の契約で提供しています。お問い合わせください。料金には税金が含まれません。サブスクリプションは、解約するまで自動的に更新されます。
変更、解約、支払いの失敗
- デプロイメントページのサブスクリプションを管理から Stripe の請求ポータルを開くと、オーナーと管理者がカードの更新、請求書のダウンロード、解約を行えます。
- 解約は、支払い済みの期間の終了時に有効になります。それまでインストールは動作し続けます。
- プランの変更: デプロイメントページのプランを変更で、インストールの数と追加の実行枠を変更できます。変更は Stripe が期間の残りについて日割りで計算します。以前のライセンス単位の料金のサブスクリプションは、基本プランと追加項目に変換されます。
- インストールの削減は、新しい数より多くのインストールが登録されている間は拒否されます。先にいくつか無効化してください。実行枠を減らすと、共有の月間実行数がただちに減ります。
- 支払いの失敗では、インストールはすぐには停止しません。Stripe が支払いを再試行し、最後に支払い済みの期間の終了から 7 日間は、ライセンスは有効なままです。それでも支払いが確認できない場合は、ライセンスが期限切れになり、インストールの検証は通らなくなります。後から支払うと、元に戻ります。
- ライセンスが終了すると、トークンとレジストリへのサインインは使えなくなります。お客様のデータは Ephemeral に置かれることはなく、ご自身のインストールに残ります。
利用権を確認する
/v1/organizations/{id}/licenseentitlement (組織にない場合は null) とその現在の使用状況、購入したライセンスの subscription (ステータス、期間、数量、paid_through)、ウェブサイトが購入を案内するために使う sales 情報を返します。max_deploymentsintegermax_concurrencyintegermax_runs_per_monthintegerpooledbooleanpooled_runs_per_monthintegerruns_used_this_monthintegerexpires_attimestampstatusstringactive または expired。sourcestringsubscription は購入したライセンス、operator は Ephemeral が付与した利用枠。active_deploymentsintegeravailable_deploymentsintegersubscription には、installations、run_blocks (追加の実行枠の数)、pooled_runs_per_month も含まれます。
/v1/organizations/{id}/license/plan409 を返します。installationsinteger必須extra_run_blocksintegerインストールを登録する
/v1/organizations/{id}/deploymentsnamestring必須machine_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"
}組織に有効なライセンスがない場合、登録は 403 で失敗します。許可されたデプロイメントがすべて登録済みの場合は 409 で失敗します。
一覧と無効化
/v1/organizations/{id}/deploymentsid、name、machine_id、max_concurrency、max_runs_per_month、expires_at、revoked とともに一覧します。/v1/organizations/{id}/deployments/{deployment_id}インストールが適用する制限
| チェック | 効果 |
|---|---|
| 起動時 | 有効なトークンとマシン ID がない場合や、設定された同時実行数がライセンスの上限を超えている場合、エンジンは起動しません。 |
| 各実行の前 | ライセンスが再び確認されます。キャッシュされた結果が最大 30 秒間使われます。ライセンスが無効になっている場合、実行は失敗します。 |
| 月間の実行数 | その月の上限を使い切ると、翌月まで POST /v1/runs は 402 を返します。サブスクリプションの場合、上限はすべてのインストールで共有されるプールです (下記)。 |
プールの適用方法: 各インストールは、ライセンスを検証するたびに (実行を開始している間は最大 30 秒ごとに)、今月に開始した実行の数を報告します。Ephemeral は、そのインストール自身の今月の実行数にプールの残りを加えた値を上限として返すため、組織全体では利用枠の範囲内に収まります。インストールは 30 秒ごとに更新するため、プールを一時的に超えることがあります。超過するのは、すべてのインストールで約 1 分間に開始された実行の数までです。プール導入前のリリースを使っているインストールは報告を行わず、プールの均等割りを受け取ります。
適用される上限は、登録時の値と現在の利用権の値のうち、低いほうです。そのため、利用権が引き下げられた場合は、再登録しなくても反映されます。Ephemeral が利用権を更新すると、既存の登録には新しい有効期限と上限が適用され、トークンはそのまま使えます。利用権を取り消すと、そのすべての登録も失効します。