Toda instalação auto-hospedada precisa de um token de licença, seja com workers em microVMs da AWS ou, para avaliação, no mesmo computador. Uma licença cobre uma instalação. Você pode comprar licenças por conta própria no site, ou o Ephemeral pode conceder à sua organização uma cota por meio de um acordo separado.
Como funciona o licenciamento
- Um proprietário ou administrador abre Implantações no portal do cliente, escolhe o faturamento mensal ou anual, o número de instalações e os blocos de execuções adicionais, aceita o Contrato de Licença Auto-hospedada e paga com o Stripe. A licença fica ativa assim que o pagamento é concluído. Organizações com um contrato negociado recebem, em vez disso, uma cota da Ephemeral e pulam esta etapa.
- O proprietário ou administrador registra cada instalação em Implantações, com um nome. O Ephemeral cria o ID de máquina e o token de licença e exibe o token uma única vez, com um botão Baixar arquivo da licença que salva o token, o ID de máquina e o ID da implantação.
- A instalação é configurada com
EPHEMERAL_LICENSE_TOKEN,EPHEMERAL_MACHINE_IDeEPHEMERAL_CUSTOMER_URL=https://ephemer.al. Ela valida o token com o Ephemeral na inicialização e antes de executar trabalho. O mesmo ID de implantação e o mesmo token fazem login no registro de imagens (veja auto-hospedagem).
Registrar uma implantação é apenas uma operação de licença. Não cria, inicia nem para nenhuma infraestrutura; você mesmo a instala e a atualiza, como descrito na auto-hospedagem.
Planos e o que uma licença inclui
| Componente | Mensal | Anual |
|---|---|---|
| Plano base: 1 instalação e 100.000 execuções por mês | $5,000 | $50,000 |
| Cada instalação adicional | $2,500 | $25,000 |
| Cada 100.000 execuções adicionais por mês | $1,000 | $10,000 |
O plano base inclui uma instalação e 100.000 execuções por mês. Adicione instalações e blocos de 100.000 execuções conforme precisar: por exemplo, o plano base com 2 instalações adicionais e 3 blocos adicionais são 3 instalações que compartilham 400.000 execuções por mês, por $5,000 + 2 × $2,500 + 3 × $1,000 = $13,000 por mês ($130,000 por ano).
As execuções são agrupadas: as execuções mensais pertencem à sua organização e são compartilhadas por todas as suas instalações, não importa como se distribuam entre elas. Cada instalação permite 20 execuções simultâneas, com todas as atualizações e suporte por e-mail. Cotas maiores estão disponíveis em contrato separado: fale conosco. Os preços não incluem impostos. A assinatura renova automaticamente até que você a cancele.
Alterações, cancelamento e pagamentos com falha
- Gerenciar assinatura, na página Implantações, abre o portal de faturamento do Stripe, onde proprietários e administradores atualizam o cartão, baixam faturas e cancelam.
- O cancelamento vale ao fim do período que você pagou. As instalações continuam funcionando até lá.
- Alterar o plano: Alterar plano, na página Implantações, muda o número de instalações e de blocos de execuções adicionais. O Stripe calcula a alteração proporcionalmente pelo restante do período, e uma assinatura no preço anterior por licença é convertida para o plano base com itens adicionais.
- Remover instalações é recusado enquanto houver mais instalações registradas do que o novo número: desative algumas antes. Remover blocos de execuções reduz imediatamente as execuções mensais compartilhadas.
- Um pagamento com falha não interrompe suas instalações de imediato. O Stripe tenta o pagamento de novo, e a licença continua válida até 7 dias após o fim do último período pago. Se o pagamento ainda não tiver sido feito, a licença expira e as instalações deixam de validar. Pagar depois a restaura.
- Quando uma licença termina, o token e o login no registro deixam de funcionar. Seus dados nunca estiveram com o Ephemeral e permanecem na sua própria instalação.
Verifique o seu direito de uso
/v1/organizations/{id}/licenseentitlement (null quando a sua organização não tem nenhum) e o seu consumo atual, a subscription (status, intervalo, quantidade, paid_through) de uma licença comprada e as informações de sales que o site usa para oferecer uma compra.max_deploymentsintegermax_concurrencyintegermax_runs_per_monthintegerpooledbooleanpooled_runs_per_monthintegerruns_used_this_monthintegerexpires_attimestampstatusstringactive ou expired.sourcestringsubscription para uma licença que você comprou, operator para uma cota concedida pelo Ephemeral.active_deploymentsintegeravailable_deploymentsintegerA subscription também informa installations, run_blocks (os blocos de execuções adicionais) e pooled_runs_per_month.
/v1/organizations/{id}/license/plan409 quando são pedidas menos instalações do que as ativas.installationsintegerobrigatórioextra_run_blocksintegerRegistrar uma instalação
/v1/organizations/{id}/deploymentsnamestringobrigatóriomachine_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"
}O registro falha com 403 quando a sua organização não tem uma licença ativa e com 409 quando todas as implantações permitidas já estão registradas.
Listar e desativar
/v1/organizations/{id}/deploymentsid, name, machine_id, max_concurrency, max_runs_per_month, expires_at e revoked./v1/organizations/{id}/deployments/{deployment_id}O que a instalação impõe
| Verificação | Efeito |
|---|---|
| Inicialização | O mecanismo não inicia sem um token e um ID de máquina válidos, ou se a concorrência configurada exceder a licença. |
| Antes de cada execução | A licença é verificada de novo, usando um resultado em cache por até 30 segundos. Se ela deixou de ser válida, a execução falha. |
| Execuções mensais | Quando a cota do mês se esgota, POST /v1/runs retorna 402 até o mês seguinte. Em uma assinatura, a cota é o conjunto compartilhado por todas as instalações (veja abaixo). |
Como o conjunto é aplicado: cada instalação informa as execuções que iniciou neste mês sempre que valida a licença (no máximo a cada 30 segundos enquanto inicia execuções). A Ephemeral responde com um limite igual às execuções da própria instalação neste mês mais o que resta do conjunto, de modo que a organização como um todo permaneça dentro da cota. As instalações atualizam a cada 30 segundos, então o conjunto pode ser excedido por pouco tempo, no máximo pelas execuções iniciadas por todas as instalações em cerca de um minuto. Uma instalação com uma versão anterior ao agrupamento não informa nada e recebe uma parte igual do conjunto.
Os limites que valem são o menor entre os valores do registro e os do direito de uso atual, então um direito de uso reduzido passa a valer sem registrar de novo. Quando o Ephemeral renova um direito de uso, os registros existentes recebem a nova validade e os novos limites e mantêm seus tokens. Revogar o direito de uso revoga todos os seus registros.