Licenças
Cada imagem self-hosted leva uma licença. Ela diz quais provedores a imagem pode servir, e até quando. A imagem confere a licença a cada hora, então uma licença mais nova passa a valer sem reiniciar.
Onde encontrar
Abra o backend em Self-hosted e escolha Licença.
- Referência:
LT-e um número para uma licença de teste,LP-e um número para uma paga. - Emitida e Vence, com os dias que faltam.
- Cobre: os provedores que ela permite.
- Baixar o arquivo de licença: a licença, como
license.json.
Uma licença nova é emitida quando um teste começa, quando um pedido é pago, e para cada mês que você paga no cartão. Ela cobre cada provedor que você tem do tipo. Os provedores que você seleciona em Provedores decidem só o que entra na imagem.
Como uma imagem recebe a licença
Cada backend faz isso de um de dois jeitos. Você define em Configurações, em A licença, e uma mudança vale a partir do próximo build.
- Busca a licença no nosso servidor: a imagem busca a licença num endereço nosso e confere de novo a cada hora. Uma licença nova, um provedor adicionado ou removido, e cada mês que você paga chegam sozinhos a uma imagem rodando. A imagem precisa de uma rota até o nome de host do seu registro.
- Leva a licença dentro: a imagem tem a licença com que foi criada, ou lê um arquivo que você monta. Ela não precisa de conexão com a gente. Uma licença nova quer dizer um arquivo novo ou uma imagem nova.
Uma imagem que você paga por mês sempre busca a licença. Um teste começa com a resposta que você deu ao pedir.
Buscar a licença
A aba Licença mostra o endereço de onde as imagens buscam a licença, e a chave que elas enviam. Mostrar revela a chave.
Mantenha um volume em /var/lib/mockzilla. A imagem guarda ali a licença que buscou, assim um contêiner novo inicia sem rede.
Uma imagem criada antes de ligar a busca também pode buscar. Passe o endereço e a chave para ela:
docker run \
-e MZ_LICENSE_URL=<o endereço> \
-e MZ_LICENSE_KEY=<a chave> \
-v mockzilla-license:/var/lib/mockzilla \
<image>Trocar dá ao backend uma chave nova. Uma imagem criada com a chave antiga não busca mais nada até você fazer outro build ou passar a chave nova para ela.
Quando uma licença nova é emitida
Uma licença nova funciona com uma imagem que você já roda, inclusive uma criada durante um teste. A imagem confere se a licença foi assinada pela Mockzilla, é para o tipo dela e não venceu. Ela não precisa ser a licença com que a imagem foi criada.
- Se a imagem busca a licença, não há nada a fazer. Ela pega a nova em até uma hora, sem reiniciar.
- Se a imagem leva a licença dentro, baixe o arquivo de licença novo e monte. Um arquivo montado substitui o que está na imagem, então você mantém a imagem que roda.
- Ou faça um build novo. Ele leva a licença atual. Isso conta como um dos seus builds.
Para montar o arquivo:
docker run -v "$PWD/license.json:/etc/mockzilla/license.json:ro" <image>Para montar em outro caminho, por exemplo a partir de um Secret do Kubernetes, defina MZ_LICENSE_FILE com esse caminho.
Uma imagem serve só os provedores do build dela, e desses só os que a licença cobre. Quando uma licença nova adiciona um provedor, faça um build novo para servir esse provedor.
Quando uma licença vence
Quando todas as licenças de uma imagem vencem, um contêiner rodando responde cada requisição com um erro, e um contêiner novo não inicia. A imagem não pode mais ser baixada, e depois é apagada do seu registro. O backend continua, e um build novo traz a imagem de volta quando você tiver uma licença de novo.