Versão 1.0.0-alpha.1mais recente
Capítulo 2.7
Instalar a edição Enterprise e aplicar uma licença
O que muda quando instala a edição Enterprise, como solicitar uma licença a partir da sua conta Adverant, as três formas de a importar com todos os códigos de recusa e como a Harrow Port Authority mudou o seu piloto Community para Enterprise no local sem perder nada.
Esta página foi traduzida por IA a partir do original em inglês. Em caso de dúvida, a página em inglês serve de referência. Ler esta página em inglês

Uma instalação Enterprise tem duas metades, que chegam por caminhos diferentes. As imagens Enterprise vêm com o chart Enterprise, obtidas através de um token de pull. A licença chega sob a forma de um ficheiro assinado a partir da sua conta Adverant, que importa para a instalação em execução. Nenhuma das metades funciona sem a outra: imagens sem licença são executadas no patamar base da edição Community, e uma licença sem imagens Enterprise não tem nada para ativar.
Na Harrow Port Authority fizemo-lo por essa ordem, seis semanas após o projeto-piloto Community do capítulo 2.6, Instalar a edição Community no Kubernetes. A atualização para o chart Enterprise demorou uma janela de manutenção; a importação da licença demorou dois minutos. Este capítulo aborda ambas as metades. Começa com uma instalação de raiz e termina com a transição no local de uma instalação Community existente.
O que difere da edição Community
Dois valores e o chart que os lê.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueTudo o resto no ficheiro de valores permanece exatamente como estava, sobretudo o nome da instalação e os custodiantes. As duas chaves têm de coincidir, e o chart recusa edition: enterprise com enterprise.enabled: false, ou o inverso.
A edição também tem de coincidir com o bloqueio de imagens do chart. Cada pacote de chart transporta o bloqueio para uma edição, e o bloqueio Enterprise lista as imagens Community mais as compilações Enterprise. Se apontar um ficheiro de valores Enterprise para o chart Community, a renderização para com files/images.lock.json is the community lock; this install is edition enterprise. Por conseguinte, a instalação Enterprise precisa do chart Enterprise.
O chart e o pacote Enterprise encontram-se na página Transferências da sua conta Adverant, que acompanha a sua licença. O ficheiro do chart tem o mesmo nome que o da edição Community, nexus-1.0.0-alpha.1.tgz, pelo que deve manter os dois em pastas separadas. Verifique-o exatamente como descreve o capítulo 2.4, Obter e verificar um lançamento, comparando-o com a chave de lançamento cuja impressão digital verificou:
nexusctl verify enterprise/nexus-1.0.0-alpha.1.tgz
tar -xzf enterprise/nexus-1.0.0-alpha.1.tgz -C enterprise
jq -r '.version, .edition' enterprise/nexus/files/images.lock.json1.0.0-alpha.1
enterprise
Em seguida, execute o ciclo de verificação de assinaturas do capítulo 2.4, Obter e verificar um lançamento, sobre enterprise/nexus/files/images.lock.json. Este abrange tanto as imagens Enterprise como as partilhadas.
O token de transferência
As imagens Community são públicas. As imagens Enterprise precisam de um token de pull obtido na página Tokens de pull e comandos de instalação da sua conta, configurado para o runtime de contentores dos seus nós, conforme mostra o capítulo 2.4, Obter e verificar um lançamento, passo 3. No k3s, trata-se de uma entrada configs para registry.adverant.ai em /etc/rancher/k3s/registries.yaml em cada nó.
Crie um token por cluster e atribua-lhe uma data de validade que não lhe passe despercebida. Quando um token expira, os pods em execução continuam a funcionar, mas um pod reagendado para um nó que ainda não tenha a imagem não a conseguirá obter. Colocámos a data de validade do token no mesmo calendário que a do certificado.
Uma instalação Enterprise de raiz
Se estiver a instalar a edição Enterprise desde o início, siga o capítulo 2.6, Instalar a edição Community no Kubernetes, passo a passo, com três diferenças:
Coloque o token de pull em cada nó antes do passo 6.
Utilize os valores Enterprise (as duas chaves acima) no passo 4.
No passo 6, instale a partir do ficheiro do chart Enterprise que transferiu:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Tudo o que se segue ao comando de instalação é igual ao descrito no capítulo 2.6, Instalar a edição Community no Kubernetes, tal como a regra sobre --wait: não o utilize. Se, em vez disso, instalar com nexusctl, adicione --edition enterprise ao comando:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseQuando todas as cargas de trabalho estiverem prontas, siga a primeira execução no capítulo 2.12, A primeira execução. A licença é um dos seis elementos que a consola lista antes de alguém iniciar sessão. Até ser importada, a instalação funciona no patamar base da edição Community e todas as áreas Enterprise aparecem a cinzento com um cadeado.
Solicitar a licença
Uma licença da Adverant é emitida para a identidade de uma única instalação, aquela que o armazenamento de chaves cunhou em keys.installationName no momento da instalação. Por conseguinte, a conta precisa de saber a que instalação se refere antes de poder emitir uma.
- Inicie sessão na sua conta Adverant em
https://account.adverant.ai. - Na instalação, abra Esta instalação e, em seguida, Licença. É apresentado um código de utilização única e a impressão digital da instalação.
- Na sua conta, abra Associar uma implementação e introduza o código. Em seguida, compare a impressão digital que a conta recebeu com a que a instalação apresenta, grupo a grupo; todos os grupos têm de coincidir.
- Prima o botão de associação. A instalação junta-se às Implementações da sua conta, com a respetiva versão e o estado da licença.
- A Adverant emite a licença para essa instalação. Transfira o ficheiro a partir da sua conta; tem o nome do identificador da licença,
<licence-id>.json.
Um código de associação funciona apenas uma vez e durante um curto período. Se expirar, a conta recusa-o com CLAIM_CODE_EXPIRED e a instalação apresenta um novo.
Existem outras duas vias, e o capítulo 2.13, Licenças, aborda ambas na íntegra. Os appliances e os kits de periferia não têm ecrã para apresentar um código, pelo que são associados através de uma chave de associação impressa na caixa, introduzida em Introduzir uma chave de associação ou lida a partir do ficheiro de encomenda do fabricante. Uma instalação sem ligação ao exterior utiliza a Troca offline: cria um ficheiro de pedido de licença assinado, que o utilizador transporta para a sua conta, trazendo de volta o ficheiro de licença. Uma vez por ano, cria uma declaração de utilização assinada da mesma forma. Todos os ficheiros na troca são assinados, pelo que um ficheiro alterado pelo caminho é recusado, com LICENCE_REQUEST_SIGNATURE_INVALID para um pedido e USAGE_FILE_SIGNATURE_INVALID para um ficheiro de utilização.
O que contém o ficheiro de licença
A licença é um documento JSON no formato nexus-licence/v1, assinado duas vezes pela Adverant com duas chaves independentes. Não precisa de o ler, mas é útil saber o que contém quando alguém pergunta o que foi adquirido.
| Campo | O que indica |
|---|---|
licence_id |
O próprio identificador da licença, um UUID (identificador universalmente único) em minúsculas |
type |
alpha, evaluation ou commercial |
licensee |
O nome da organização e o identificador de cliente Adverant |
scope |
A instalação a que se destina e quaisquer organizações nomeadas numa concessão |
edition |
enterprise |
grants |
Os grupos de funcionalidades que desbloqueia, cada um para toda a instalação ou para organizações nomeadas |
add_ons e domain_packs |
Capacidades licenciadas separadamente; o pacote de Logística e marítimo é uma delas |
metric |
Como é contabilizada a licença, named-seat, per-core ou per-environment, e a quantidade |
term |
starts_on, ends_on e os dias de aviso prévio e de tolerância |
matrix |
A versão da matriz de edições com base na qual foi redigida |
signatures |
As duas assinaturas da Adverant |
Uma licença de avaliação dura no máximo 30 dias, para um máximo de cinco pessoas nomeadas, sem período de tolerância. Uma licença comercial emite avisos 30 dias antes de terminar e concede, por predefinição, 30 dias de tolerância. O que acontece em cada degrau dessa evolução encontra-se no capítulo 2.13, Licenças.
As assinaturas abrangem o documento tal como a Adverant o criou. Envie-o exatamente como o recebeu; não o abra num editor que o possa reformatar.
Importar a licença
Apenas um administrador da instalação pode importar uma licença: um proprietário ou administrador de toda a organização proprietária da instalação, com sessão iniciada na mesma. Um administrador global da plataforma também pode importar uma. A licença nunca é um valor do chart nem um ficheiro montado num pod. Dá entrada no serviço de início de sessão, nexus-auth, que a verifica offline com base nas raízes de confiança integradas na sua própria imagem e a regista numa única transação. Pode importá-la de três formas, e todas terminam no mesmo sítio.
Na consola
Durante a primeira execução, abra Seis coisas antes de alguém iniciar sessão e, em seguida, Licença. A página Importar a licença recebe o ficheiro: largue-o na página ou selecione-o. A página verifica-o offline na própria instalação e, em seguida, lista os grupos de funcionalidades que abre, indicando como cada um é protegido e até quando. Os grupos que a licença não inclui permanecem listados, a cinzento.
Mais tarde, a mesma importação é feita através do botão Importar uma nova licença na página de licença da instalação. Quando uma licença expira, a página de licença restrita apresenta a opção Importar uma licença renovada.
Com o nexusctl
nexusctl licence import <licence-id>.jsonnexusctl envia o ficheiro, inalterado, para a rota de importação da instalação como administrador da instalação, e comunica o estado da licença ou o código de recusa da tabela abaixo.
Através da API
A rota de importação faz parte da interface de programação de aplicações (API) do serviço de início de sessão, no seu endereço hosts.auth. O corpo é o documento da licença, byte a byte:
curl -sS -X POST https://auth.harrow.example/api/v1/installation/licence \
-H "authorization: Bearer <admin-token>" \
-H "content-type: application/json" \
--data-binary @<licence-id>.json<admin-token> é o token de acesso de um administrador da instalação com sessão iniciada. Utilize --data-binary, nunca -d, pois este último remove as quebras de linha e altera os bytes enviados. A rota não aceita parâmetros de consulta nem nada no corpo além do documento; um corpo que tente nomear uma organização ou uma pessoa no nível superior é recusado antes que qualquer conteúdo seja lido.
Uma importação bem-sucedida responde 201 Created. De forma abreviada, o corpo tem o seguinte aspeto:
{
"licence": {
"licence_id": "<licence-id>",
"state": "licensed",
"edition": "enterprise",
"licensee": {"name": "Harrow Port Authority", "customer_id": "<customer-id>"},
"term": {"starts_on": "2026-12-01", "ends_on": "2027-11-30", "warn_days": 30, "grace_days": 30},
"groups": ["enterprise-base", "..."]
},
"organizations": 1,
"tenants_without_organisation": 0
}
organizations contabiliza as organizações na instalação que detêm agora a licença. tenants_without_organisation contabiliza as organizações nomeadas pela licença que esta instalação não detém.
Quando a importação é recusada
Uma importação recusada não altera nada: nenhuma linha é gravada e a licença em vigor, se existir, permanece como estava. O registo de auditoria da instalação guarda todas as tentativas, incluindo as recusadas.
| Código | Estado | O que significa | O que fazer |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Falta uma das duas assinaturas da Adverant ou a verificação falha; o ficheiro foi alterado após a assinatura | Peça novamente o ficheiro à Adverant; não o edite |
LICENCE_FORMAT_INVALID |
422 | O ficheiro não é uma licença que este lançamento consiga ler | Envie o ficheiro exatamente como a Adverant o forneceu |
LICENCE_ROOT_UNKNOWN |
422 | Está assinado com uma chave na qual esta instalação não confia | Peça uma licença assinada para as raízes de confiança deste lançamento ou atualize a instalação |
LICENCE_MATRIX_MISMATCH |
422 | Foi redigida com base numa matriz de edições que este lançamento não lê, ou concede um grupo que este lançamento não conhece | Atualize a instalação ou peça uma licença redigida para este lançamento |
LICENCE_OTHER_INSTALLATION |
409 | Foi emitida para outra instalação | Peça uma licença emitida para a identidade desta instalação |
TRANSITION_NOT_PERMITTED |
409 | Já foi importada uma licença com este identificador; cada licença é importada apenas uma vez | Peça uma nova licença à Adverant se os termos tiverem de mudar |
LICENCE_REVOKED |
403 | A Adverant revogou esta licença | Peça uma nova licença à Adverant |
LICENCE_LOCKED |
403 | A vigência da licença ainda não começou; aplica-se o patamar base da edição Community até essa data | Volte a importá-la no primeiro dia de vigência ou após essa data |
RECORD_NOT_FOUND |
404 | A instalação ainda não foi declarada, pelo que não tem identidade para verificação | Conclua o passo do primeiro administrador (capítulo 2.12, A primeira execução) e, em seguida, importe-a |
VALIDATION_FAILED |
400 | O corpo estava ilegível ou excedia 1 MiB, ou foram enviados parâmetros de consulta | Envie o ficheiro como a totalidade do corpo, sem parâmetros de consulta |
Pode surgir mais um código numa importação bem-sucedida, sob a forma de aviso e não de recusa: LICENCE_CLOCK_BEHIND_FLOOR significa que o relógio da instalação marca uma hora anterior à última hora que já registou, pelo que a licença é lida com essa hora posterior. Atrasar o relógio nunca reativa uma licença expirada. Apenas um token de reposição de hora assinado pela Adverant para a instalação faz baixar esse limite temporal.
Mudar de Community para Enterprise no local
Foi isto que fizemos em Harrow. Nada é reinstalado e nada é migrado: trata-se da mesma instalação, com a mesma identidade e os mesmos dados, mas com mais capacidades ativadas. O nome da instalação e os custodiantes permanecem exatamente como estavam; numa atualização, o hook de custódia verifica que o armazenamento de chaves já está inicializado e não faz mais nada.
Coloque o token de pull em cada nó e reinicie o respetivo runtime de contentores.
Obtenha o chart Enterprise em Transferências e verifique tanto o chart como as respetivas imagens, conforme descrito acima.
Altere os dois valores no seu ficheiro de valores existente:
edition: enterpriseeenterprise.enabled: true. Não altere mais nada.Execute a verificação prévia com o novo ficheiro.
nexusctl preflight --context harrow-prod --values harrow-values.yamlAtualize o lançamento para o chart Enterprise, novamente sem
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mNuma atualização, os hooks são executados antes da implementação dos novos pods, e cada migração aplica apenas os ficheiros que ainda não tinha aplicado. Os segredos gerados são lidos a partir da instalação e mantidos. O Helm termina com:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Aguarde pelas cargas de trabalho, exatamente como no capítulo 2.6, Instalar a edição Community no Kubernetes, passo 7.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sImporte a licença por qualquer uma das três formas descritas acima.
Na consola, abra Esta instalação, depois Licença e, em seguida, Mudar para Enterprise. A página lê a licença e mostra o que será obtido e o que mudará antes que algo aconteça. Também contabiliza as pessoas e os conteúdos da organização e marca cada um como mantido. Prima Obter e ativar. Cada parte é verificada com base na chave de lançamento da Adverant antes de ser utilizada, e os grupos de funcionalidades são ativados um a um.
A nossa janela era de uma hora; o trabalho dentro dela demorou cerca de vinte minutos, na sua maioria a aguardar pelo esquema enquanto os hooks eram executados. Na manhã seguinte, o pessoal do projeto-piloto iniciou sessão no mesmo espaço de trabalho, onde as áreas Enterprise do menu já não apareciam a cinzento.
Após a importação
A página da licença em Esta instalação lista todos os grupos de funcionalidades incluídos na licença, com os respetivos lugares e período de vigência. Também indica como cada parte é disponibilizada, por exemplo, compilada e licenciada para um grupo Enterprise, ou de código aberto para o patamar base da edição Community. Os grupos fora da licença permanecem listados, a cinzento. Os administradores podem restringir o alcance de um grupo dentro da organização; ninguém além da Adverant pode alargar o que uma licença concede.
O estado da licença é recalculado a partir do documento e da data em cada leitura, pelo que a expiração ocorre sem necessidade de uma tarefa agendada. Todas as pessoas na instalação veem o mesmo aviso na consola à medida que o fim se aproxima: LICENCE_ENDS_SOON a partir de 30 dias antes do término e, depois, LICENCE_IN_GRACE durante o período de tolerância. Os membros veem o aviso e as datas; apenas os administradores da instalação veem a própria licença. O capítulo 2.13, Licenças, aborda a renovação e as fases de expiração.
Se isto falhar
| O que vê | Causa | O que fazer |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Apenas uma das duas chaves foi alterada | Altere ambas |
files/images.lock.json is the community lock; this install is edition enterprise |
Foi utilizado o chart Community | Utilize o chart Enterprise disponível em Transferências |
image ... is a enterprise image; a community install takes only community images |
Um nome de imagem Enterprise chegou a uma renderização Community | Verifique edition e a pasta do chart |
ImagePullBackOff numa imagem Enterprise após a atualização |
Um nó não tem token de pull, ou o respetivo token já não é válido | Verifique registries.yaml nesse nó ou crie um novo token |
| Um código de recusa de licença | Consulte a tabela de recusas acima | Siga a linha correspondente; nada foi alterado |
Quando a página de licença apresentar Enterprise e os grupos esperados, a instalação está licenciada. A paragem seguinte é a primeira execução no capítulo 2.12, A primeira execução, se ainda não tiver associado a instalação. Se já o tiver feito, o assistente ainda precisa das chaves de modelos de inteligência artificial (IA) da própria organização antes de poder responder a alguém. O capítulo 2.14, Fornecedores e modelos de IA, mostra como ligá-las.




