Versión 1.0.0-alpha.1 más reciente
Capítulo 2.7
Instalación de Enterprise y aplicación de una licencia
Qué cambia al instalar la edición Enterprise, cómo solicitar una licencia desde su cuenta de Adverant, las tres formas de importarla con todos los códigos de rechazo, y cómo Harrow Port Authority pasó su piloto de Community a Enterprise in situ sin perder nada.
Esta página fue traducida por IA a partir del original en inglés. Si algo no está claro, la página en inglés es la referencia. Leer esta página en inglés

Una instalación Enterprise consta de dos mitades que llegan por caminos distintos. Las imágenes Enterprise vienen con el chart Enterprise, descargadas mediante un token de descarga. La licencia llega como un archivo firmado desde su cuenta de Adverant y usted la importa en la instalación en ejecución. Ninguna mitad funciona sin la otra: las imágenes sin licencia se ejecutan al nivel base de Community y una licencia sin imágenes Enterprise no tiene nada que activar.
En Harrow Port Authority lo hicimos en ese orden, seis semanas después de la prueba piloto de Community del capítulo 2.6, Instalación de Community en Kubernetes. La actualización al chart Enterprise llevó una ventana de mantenimiento; la importación de la licencia tomó dos minutos. Este capítulo abarca ambas mitades. Comienza con una instalación desde cero y termina con una instalación Community existente que se actualiza en el mismo lugar.
Qué difiere de Community
Dos valores y el chart que los lee.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueTodo lo demás en el archivo de valores permanece exactamente como estaba, sobre todo el nombre de la instalación y los custodios. Las dos claves deben coincidir, y el chart rechaza edition: enterprise con enterprise.enabled: false, o viceversa.
La edición también debe coincidir con el bloqueo de imágenes del chart. Cada paquete de chart lleva el bloqueo para una edición, y el bloqueo Enterprise enumera las imágenes Community más las compilaciones Enterprise. Si apunta un archivo de valores Enterprise al chart Community, el renderizado se detiene con files/images.lock.json is the community lock; this install is edition enterprise. Por tanto, la instalación Enterprise necesita el chart Enterprise.
El chart y el paquete Enterprise se encuentran en la página Downloads de su cuenta de Adverant, que corresponde a su licencia. El archivo del chart tiene el mismo nombre que el de Community, nexus-1.0.0-alpha.1.tgz, así que mantenga ambos en carpetas separadas. Verifíquelo exactamente como se describe en el capítulo 2.4, Obtención y verificación de una versión, contra la clave de versión cuya huella digital comprobó:
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
A continuación, ejecute el bucle de firmas del capítulo 2.4, Obtención y verificación de una versión, sobre enterprise/nexus/files/images.lock.json. Esto abarca tanto las imágenes Enterprise como las compartidas.
El token de descarga
Las imágenes Community son públicas. Las imágenes Enterprise necesitan un token de descarga de la página Pull tokens and install commands de su cuenta, configurado para el entorno de ejecución de contenedores de sus nodos, tal como se muestra en el capítulo 2.4, Obtención y verificación de una versión, paso 3. En k3s, eso corresponde a una entrada configs para registry.adverant.ai en /etc/rancher/k3s/registries.yaml en cada nodo.
Cree un token por clúster y asígnele una fecha de vencimiento que vaya a notar. Cuando un token caduca, los pods en ejecución continúan funcionando, pero un pod reprogramado en un nodo que aún no tiene la imagen no podrá descargarla. Nosotros pusimos la fecha de vencimiento del token en el mismo calendario que la del certificado.
Una instalación nueva de Enterprise
Si va a instalar Enterprise desde el principio, siga el capítulo 2.6, Instalación de Community en Kubernetes, paso a paso, con tres diferencias:
Coloque el token de descarga en cada nodo antes del paso 6.
Utilice los valores Enterprise (las dos claves anteriores) en el paso 4.
En el paso 6, instale desde el archivo del chart Enterprise que descargó:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Todo lo que sigue al comando de instalación es igual que en el capítulo 2.6, Instalación de Community en Kubernetes, así como la regla sobre --wait: no lo utilice. Si instala con nexusctl en su lugar, añada --edition enterprise al comando:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseCuando todas las cargas de trabajo estén listas, realice la primera ejecución descrita en el capítulo 2.12, La primera ejecución. La licencia es uno de los seis elementos que la consola enumera antes de que alguien inicie sesión. Hasta que se importe, la instalación se ejecuta al nivel base de Community y cada área Enterprise se muestra atenuada en gris con un candado.
Solicitar la licencia
Una licencia de Adverant se emite para la identidad de una única instalación, la que el almacén de claves generó bajo keys.installationName durante la instalación. Por lo tanto, la cuenta necesita saber a qué instalación se refiere antes de poder emitir una.
- Inicie sesión en su cuenta de Adverant en
https://account.adverant.ai. - En la instalación, abra Esta instalación y, a continuación, Licencia. Muestra un código de un solo uso y la huella digital de la instalación.
- En su cuenta, abra Reclamar un despliegue e introduzca el código. Luego compare la huella digital que recibió la cuenta con la que muestra la instalación, grupo por grupo; todos los grupos deben coincidir.
- Pulse el botón de reclamar. La instalación se incorpora a la sección Despliegues de su cuenta, con su versión y estado de licencia.
- Adverant emite la licencia para esa instalación. Descargue el archivo desde su cuenta; lleva el nombre de su identificador de licencia,
<licence-id>.json.
Un código de reclamación funciona una sola vez y durante un breve periodo. Si caduca, la cuenta lo rechaza con CLAIM_CODE_EXPIRED y la instalación muestra uno nuevo.
Existen otras dos vías, y el capítulo 2.13, Licencias, abarca ambas en detalle. Los dispositivos y kits de borde (edge kits) no tienen pantalla para mostrar un código, por lo que se reclaman con una clave de reclamación impresa en la caja, que se escribe en Introducir una clave de reclamación o se lee del archivo de pedido del fabricante. Una instalación sin salida a la red utiliza el Intercambio sin conexión: genera un archivo firmado de solicitud de licencia, usted lo lleva a su cuenta y trae de vuelta el archivo de licencia. Una vez al año genera una declaración de uso firmada de la misma manera. Cada archivo en el intercambio está firmado, por lo que un archivo modificado en el trayecto es rechazado, con LICENCE_REQUEST_SIGNATURE_INVALID para una solicitud y USAGE_FILE_SIGNATURE_INVALID para un archivo de uso.
Qué contiene el archivo de licencia
La licencia es un documento JSON con el formato nexus-licence/v1, firmado dos veces por Adverant con dos claves independientes. No necesita leerlo, pero es útil saber qué contiene cuando alguien pregunta qué se ha adquirido.
| Campo | Qué indica |
|---|---|
licence_id |
El identificador propio de la licencia, un UUID (identificador único universal) en minúsculas |
type |
alpha, evaluation o commercial |
licensee |
El nombre de la organización y el identificador de cliente de Adverant |
scope |
La instalación a la que está destinada y cualquier organización nombrada en una concesión |
edition |
enterprise |
grants |
Los grupos de funcionalidades que desbloquea, cada uno para toda la instalación o para organizaciones específicas |
add_ons y domain_packs |
Capacidades con licencia por separado; el paquete de Logística y sector marítimo es una de ellas |
metric |
Cómo se contabiliza la licencia, named-seat, per-core o per-environment, y la cantidad |
term |
starts_on, ends_on, y los días de aviso y de gracia |
matrix |
La versión de la matriz de ediciones para la que fue redactada |
signatures |
Las dos firmas de Adverant |
Una licencia de evaluación dura como máximo 30 días, para un máximo de cinco personas asignadas, sin periodo de gracia. Una licencia comercial avisa 30 días antes de finalizar y luego otorga 30 días de gracia de forma predeterminada. Lo que sucede en cada peldaño de esa escalera se explica en el capítulo 2.13, Licencias.
Las firmas cubren el documento tal como Adverant lo creó. Envíelo exactamente como lo recibió; no lo abra en un editor que pueda reformatearlo.
Importar la licencia
Solo un administrador de la instalación puede importar una licencia: un propietario o administrador de toda la organización propietaria de la instalación, habiendo iniciado sesión en ella. Un administrador completo de la plataforma también puede importar una. La licencia nunca es un valor del chart ni un archivo montado en un pod. Va al servicio de inicio de sesión, nexus-auth, que la comprueba sin conexión contra las raíces de confianza integradas en su propia imagen y la registra en una sola transacción. Puede importarla de tres maneras, y todas terminan en el mismo lugar.
En la consola
Durante la primera ejecución, abra Seis cosas antes de que alguien inicie sesión y luego Licencia. La página Importar la licencia recibe el archivo: arrástrelo a la página o selecciónelo. La página lo comprueba sin conexión en la propia instalación y, a continuación, enumera los grupos de funcionalidades que habilita, indicando cómo está protegido cada uno y hasta cuándo. Los grupos que la licencia no incluye siguen apareciendo en la lista, atenuados en gris.
Más adelante, la misma importación se realiza mediante el botón Importar una nueva licencia en la página de licencia de la instalación. Cuando una licencia ha caducado, la página de licencia restringida ofrece la opción Importar una licencia renovada.
Con nexusctl
nexusctl licence import <licence-id>.jsonnexusctl envía el archivo, sin cambios, a la ruta de importación de la instalación como administrador de la instalación, e informa del estado de la licencia o del código de rechazo de la siguiente tabla.
A través de la API
La ruta de importación forma parte de la interfaz de programación de aplicaciones (API) del servicio de inicio de sesión, en su dirección hosts.auth. El cuerpo es el documento de licencia, byte por 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> es el token de acceso de un administrador de la instalación que ha iniciado sesión. Utilice --data-binary, nunca -d, ya que este último elimina los saltos de línea y modifica los bytes enviados. La ruta no acepta cadenas de consulta ni nada en el cuerpo salvo el documento; un cuerpo que intente nombrar a una organización o a una persona en su nivel superior es rechazado antes de que se lea nada.
Una importación correcta responde 201 Created. Recortado, el cuerpo se ve así:
{
"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 cuenta las organizaciones en la instalación que ahora poseen la licencia. tenants_without_organisation cuenta las organizaciones que la licencia menciona pero que esta instalación no alberga.
Cuando se rechaza la importación
Una importación rechazada no cambia nada: no se escribe ninguna fila y la licencia vigente, si la hay, permanece como estaba. El registro de auditoría de la instalación registra cada intento, incluidos los rechazados.
| Código | Estado | Qué significa | Qué hacer |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Falta una de las dos firmas de Adverant o no se puede verificar; el archivo se modificó después de ser firmado | Solicite de nuevo el archivo a Adverant; no lo edite |
LICENCE_FORMAT_INVALID |
422 | El archivo no es una licencia que esta versión pueda leer | Envíe el archivo exactamente como se lo entregó Adverant |
LICENCE_ROOT_UNKNOWN |
422 | Está firmado con una clave en la que esta instalación no confía | Solicite una licencia firmada para las raíces de confianza de esta versión, o actualice |
LICENCE_MATRIX_MISMATCH |
422 | Está redactada para una matriz de ediciones que esta versión no lee, o concede un grupo que esta versión desconoce | Actualice o solicite una licencia redactada para esta versión |
LICENCE_OTHER_INSTALLATION |
409 | Fue emitida para otra instalación | Solicite una licencia emitida para la identidad de esta instalación |
TRANSITION_NOT_PERMITTED |
409 | Ya se importó una licencia con este identificador; cada una se importa una sola vez | Solicite a Adverant una nueva licencia si las condiciones deben cambiar |
LICENCE_REVOKED |
403 | Adverant ha retirado esta licencia | Solicite una nueva a Adverant |
LICENCE_LOCKED |
403 | El periodo de validez de la licencia no ha comenzado; se aplica el nivel base de Community hasta entonces | Impórtela de nuevo en su primer día de vigencia o después |
RECORD_NOT_FOUND |
404 | La instalación aún no ha sido declarada, por lo que no tiene identidad con la que comprobar | Complete el paso del primer administrador (capítulo 2.12, La primera ejecución) y luego importe |
VALIDATION_FAILED |
400 | El cuerpo era ilegible o superaba 1 MiB, o se envió una cadena de consulta | Envíe el archivo como el cuerpo completo, sin consulta |
Puede devolverse un código más en una importación exitosa, como aviso más que como rechazo: LICENCE_CLOCK_BEHIND_FLOOR significa que el reloj de la instalación marca una hora anterior a la última hora que ya ha registrado, por lo que la licencia se lee con esa hora posterior. Atrasar el reloj nunca reactiva una licencia caducada. Solo un token de restablecimiento de hora que Adverant firme para la instalación rebaja esa marca temporal.
Pasar de Community a Enterprise in situ
Esto es lo que hicimos en Harrow. No se reinstala ni se migra nada: es la misma instalación, con la misma identidad y los mismos datos, pero con más elementos activados. El nombre de la instalación y los custodios permanecen exactamente como estaban; en una actualización, el hook de custodia comprueba que el almacén de claves ya esté inicializado y no hace nada más.
Coloque el token de descarga en cada nodo y reinicie allí el entorno de ejecución de contenedores.
Descargue el chart Enterprise desde Downloads y verifíquelo junto con sus imágenes como se indicó anteriormente.
Cambie los dos valores en su archivo de valores existente:
edition: enterpriseyenterprise.enabled: true. No cambie nada más.Ejecute la comprobación previa (preflight) con el nuevo archivo.
nexusctl preflight --context harrow-prod --values harrow-values.yamlActualice el despliegue al chart Enterprise, de nuevo sin
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mEn una actualización, los hooks se ejecutan antes de que se desplieguen los nuevos pods, y cada migración aplica únicamente los archivos que no haya aplicado antes. Los secretos generados se vuelven a leer de la instalación y se conservan. Helm finaliza con:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Espere a las cargas de trabajo, exactamente como en el capítulo 2.6, Instalación de Community en Kubernetes, paso 7.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sImporte la licencia por cualquiera de las tres vías anteriores.
En la consola, abra Esta instalación, luego Licencia y después Pasar a Enterprise. La página lee la licencia y muestra qué se descargará y qué cambiará antes de que ocurra nada. También contabiliza las personas y el contenido de la organización y marca cada elemento como conservado. Pulse Descargar y activar. Cada parte se comprueba contra la clave de versión de Adverant antes de utilizarse, y los grupos de funcionalidades se activan uno por uno.
Nuestra ventana era de una hora; el trabajo dentro de ella llevó unos veinte minutos, la mayor parte esperando al esquema mientras se ejecutaban los hooks. Los participantes de la prueba piloto iniciaron sesión a la mañana siguiente en el mismo espacio de trabajo, con las áreas Enterprise del menú ya sin atenuar.
Después de la importación
La página de licencia bajo Esta instalación enumera cada grupo de funcionalidades de la licencia con sus puestos y periodo de validez. También indica cómo se entrega cada parte, por ejemplo, compilada y con licencia para un grupo Enterprise, o de código abierto para el nivel base de Community. Los grupos fuera de la licencia siguen apareciendo en la lista, atenuados en gris. Los administradores pueden restringir el alcance de un grupo dentro de la organización; nadie salvo Adverant puede ampliar lo que concede una licencia.
El estado de la licencia se vuelve a calcular a partir del documento y la fecha en cada lectura, por lo que el vencimiento se produce sin una tarea programada. Todos en la instalación ven el mismo aviso en la consola a medida que se acerca el final: LICENCE_ENDS_SOON desde 30 días antes del vencimiento, y luego LICENCE_IN_GRACE durante el periodo de gracia. Los miembros ven el aviso y las fechas; solo los administradores de la instalación ven la licencia en sí. El capítulo 2.13, Licencias, abarca la renovación y la escalera de vencimiento.
Si esto falla
| Lo que ve | Causa | Qué hacer |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Solo se cambió una de las dos claves | Cambie ambas |
files/images.lock.json is the community lock; this install is edition enterprise |
Se utilizó el chart Community | Utilice el chart Enterprise de Downloads |
image ... is a enterprise image; a community install takes only community images |
Un nombre de imagen Enterprise llegó a un renderizado de Community | Compruebe edition y la carpeta del chart |
ImagePullBackOff en una imagen Enterprise después de la actualización |
Un nodo no tiene token de descarga o su token ya no es válido | Compruebe registries.yaml en ese nodo o cree un nuevo token |
| Un código de rechazo de licencia | Consulte la tabla de rechazos anterior | Siga las indicaciones de su fila; no se ha modificado nada |
Cuando la página de licencia muestra Enterprise y los grupos que esperaba, la instalación ya tiene licencia. La siguiente parada es la primera ejecución en el capítulo 2.12, La primera ejecución, si aún no ha reclamado la instalación. Si ya lo ha hecho, el asistente aún necesita las claves de los modelos de inteligencia artificial (IA) propios de la organización antes de poder responder a nadie. El capítulo 2.14, Proveedores y modelos de IA, muestra cómo conectarlos.




