Версия 1.0.0-alpha.1последно
Глава 2.7
Инсталиране на Enterprise и прилагане на лиценз
Какво се променя, когато инсталирате изданието Enterprise, как да заявите лиценз от профила си в Adverant, трите начина да го импортирате заедно с всеки код за отказ и как Harrow Port Authority прехвърли своя пилотен проект от Community към Enterprise на място, без да изгуби нищо.
Тази страница е преведена от ИИ от английския оригинал. Ако нещо е неясно, английската страница е референтна. Прочетете тази страница на английски

Една инсталация на Enterprise има две половини и те пристигат по различни пътища. Образите на Enterprise идват с чарта на Enterprise, изтеглени с токен за изтегляне. Лицензът идва като подписан файл от Вашия акаунт в Adverant и го импортирате в работещата инсталация. Нито една половина не работи без другата: образи без лиценз работят на базовото ниво Community, а лиценз без образи на Enterprise няма какво да включи.
В Harrow Port Authority го направихме в този ред, шест седмици след пилотния проект с Community в глава 2.6, Инсталиране на Community върху Kubernetes. Надграждането до чарта на Enterprise отне един прозорец за профилактика; импортирането на лиценза отне две минути. Тази глава обхваща и двете половини. Тя започва с чиста инсталация и завършва с преместване на място на съществуваща инсталация на Community.
Какво се различава от Community
Две стойности и чартът, който ги чете.
# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
enabled: trueВсичко останало във файла със стойности остава точно както е било, най-вече името на инсталацията и пазителите. Двата ключа трябва да съвпадат и чартът отказва edition: enterprise с enterprise.enabled: false или обратното.
Изданието трябва да съвпада и със заключващия файл за образите на чарта. Всеки пакет на чарта носи заключващия файл за едно издание, а заключващият файл на Enterprise изброява образите на Community плюс компилациите на Enterprise. Насочете файл със стойности на Enterprise към чарта на Community и рендирането спира с files/images.lock.json is the community lock; this install is edition enterprise. Така че инсталацията на Enterprise се нуждае от чарта на Enterprise.
Чартът и пакетът на Enterprise са на страницата Downloads във Вашия акаунт в Adverant, която следва Вашия лиценз. Файлът на чарта има същото име като този на Community, nexus-1.0.0-alpha.1.tgz, затова дръжте двата в отделни папки. Проверете го точно както е описано в глава 2.4, Получаване и проверка на издание, спрямо ключа на изданието, чийто отпечатък сте проверили:
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
След това изпълнете цикъла за проверка на подписите от глава 2.4, Получаване и проверка на издание, върху enterprise/nexus/files/images.lock.json. Той обхваща както образите на Enterprise, така и споделените.
Токенът за изтегляне
Образите на Community са публични. Образите на Enterprise се нуждаят от токен за изтегляне от страницата Pull tokens and install commands на Вашия акаунт, конфигуриран за средата за изпълнение на контейнери на Вашите възли, както е показано в глава 2.4, Получаване и проверка на издание, стъпка 3. При k3s това е запис configs за registry.adverant.ai в /etc/rancher/k3s/registries.yaml на всеки възел.
Създайте по един токен на клъстер и му задайте крайна дата, която ще забележите. Когато токенът изтече, работещите подове продължават, но под, пренасрочен към възел, който все още няма образа, не може да го изтегли. Ние поставихме крайната дата на токена в същия календар като тази на сертификата.
Чиста инсталация на Enterprise
Ако инсталирате Enterprise от самото начало, следвайте глава 2.6, Инсталиране на Community върху Kubernetes, стъпка по стъпка, с три разлики:
Поставете токена за изтегляне на всеки възел преди стъпка 6.
Използвайте стойностите за Enterprise (двата ключа по-горе) в стъпка 4.
В стъпка 6 инсталирайте от файла на чарта на Enterprise, който сте изтеглили:
helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45m
Всичко след командата за инсталиране е същото като в глава 2.6, Инсталиране на Community върху Kubernetes, както и правилото относно --wait: не го използвайте. Ако вместо това инсталирате с nexusctl, добавете --edition enterprise към командата:
nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterpriseКогато всички работни натоварвания са готови, преминете през първото стартиране в глава 2.12, Първото стартиране. Лицензът е едно от шестте неща, които конзолата изброява, преди някой да влезе. Докато не бъде импортиран, инсталацията работи на базовото ниво Community и всяка зона на Enterprise е показана в сиво с катинар.
Заявяване на лиценза
Лиценз от Adverant се издава за идентичността на една инсталация – тази, която хранилището за ключове е създало под keys.installationName при инсталирането. Затова акаунтът трябва да знае коя инсталация имате предвид, преди да може да издаде лиценз.
- Влезте във Вашия акаунт в Adverant на адрес
https://account.adverant.ai. - В инсталацията отворете This installation, след това Licence. Показва се еднократен код и отпечатъкът на инсталацията.
- Във Вашия акаунт отворете Claim a deployment и въведете кода. След това сравнете отпечатъка, който акаунтът е получил, с този, който инсталацията показва, група по група; всяка група трябва да съвпада.
- Натиснете бутона за заявяване. Инсталацията се присъединява към Deployments във Вашия акаунт със своята версия и състояние на лиценза.
- Adverant издава лиценза за тази инсталация. Изтеглете файла от Вашия акаунт; той е кръстен на идентификатора на лиценза си,
<licence-id>.json.
Кодът за заявяване работи еднократно и за кратко време. Ако изтече, акаунтът го отказва с CLAIM_CODE_EXPIRED, а инсталацията показва нов.
Съществуват още два пътя и глава 2.13, Лицензи, ги разглежда изцяло. Устройствата и периферните комплекти нямат екран за показване на код, така че те се заявяват с ключ за заявяване, отпечатан върху кутията, въведен в Enter a claim key или прочетен от файла с поръчката на производителя. Инсталация без изходяща връзка използва Offline exchange: тя създава подписан файл със заявка за лиценз, Вие го пренасяте до Вашия акаунт и връщате обратно файла с лиценза. Веднъж годишно тя създава подписан отчет за използването по същия начин. Всеки файл в обмена е подписан, така че файл, променен по пътя, бива отказан с LICENCE_REQUEST_SIGNATURE_INVALID за заявка и USAGE_FILE_SIGNATURE_INVALID за файл за използване.
Какво съдържа файлът с лиценза
Лицензът е JSON документ във формат nexus-licence/v1, подписан два пъти от Adverant с два независими ключа. Не е необходимо да го четете, но е полезно да знаете какво има в него, когато някой попита какво сте закупили.
| Поле | Какво гласи |
|---|---|
licence_id |
Собственият идентификатор на лиценза, UUID (универсално уникален идентификатор) с малки букви |
type |
alpha, evaluation или commercial |
licensee |
Името на организацията и клиентският идентификатор в Adverant |
scope |
Инсталацията, за която е предназначен, и всички организации, посочени в дадено право |
edition |
enterprise |
grants |
Групите функции, които отключва – всяка за цялата инсталация или за посочени организации |
add_ons и domain_packs |
Възможности, лицензирани отделно; пакетът за логистика и морско дело е една от тях |
metric |
Как се отчита лицензът – named-seat, per-core или per-environment – и количеството |
term |
starts_on, ends_on и дните за предупреждение и гратисен период |
matrix |
Версията на матрицата на изданията, спрямо която е съставен |
signatures |
Двата подписа на Adverant |
Лицензът за оценка продължава най-много 30 дни, за най-много пет посочени лица, без гратисен период. Търговският лиценз предупреждава 30 дни преди да изтече и след това дава 30 дни гратисен период по подразбиране. Какво се случва на всяка стъпка от тази стълбица е описано в глава 2.13, Лицензи.
Подписите покриват документа така, както Adverant го е създал. Изпратете го точно както сте го получили; не го отваряйте в редактор, който може да го преформатира.
Импортиране на лиценза
Само администратор на инсталацията може да импортира лиценз: собственик или администратор на цялата организация, която притежава инсталацията, докато е влязъл в нея. Пълен администратор на платформата също може да импортира такъв. Лицензът никога не е стойност в чарта или файл, монтиран в под. Той отива в услугата за влизане, nexus-auth, която го проверява офлайн спрямо корените на доверие, вградени в собствения ѝ образ, и го записва в една транзакция. Можете да го импортирате по три начина и всички те водят до едно и също място.
В конзолата
По време на първото стартиране отворете Six things before anyone signs in, след това Licence. Страницата Import the licence приема файла: пуснете го на страницата или го изберете. Страницата го проверява офлайн на самата инсталация, след което изброява групите функции, които той отваря, заедно с това как е защитена всяка от тях и до кога. Групите, които лицензът не включва, остават в списъка в сиво.
По-късно същото импортиране става чрез бутона Import a new licence на страницата за лиценза на инсталацията. Когато лицензът е изтекъл, ограничената страница за лиценза предлага Import a renewed licence.
С nexusctl
nexusctl licence import <licence-id>.jsonnexusctl изпраща файла непроменен до маршрута за импортиране на инсталацията като администратор на инсталацията и докладва състоянието на лиценза или кода за отказ от таблицата по-долу.
Чрез API
Маршрутът за импортиране е част от приложния програмен интерфейс (API) на услугата за влизане на Вашия адрес hosts.auth. Тялото на заявката е документът на лиценза, байт по байт:
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> е токенът за достъп на влязъл администратор на инсталацията. Използвайте --data-binary, никога -d, който премахва знаците за нов ред и така променя байтовете, които изпращате. Маршрутът не приема низ на заявката и нищо друго в тялото освен документа; тяло, което се опитва да посочи организация или лице на най-горното си ниво, бива отказано, преди да бъде прочетено каквото и да било.
Успешното импортиране отговаря с 201 Created. Съкратено, тялото изглежда така:
{
"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 преброява организациите в инсталацията, които вече притежават лиценза. tenants_without_organisation преброява организациите, посочени в лиценза, които тази инсталация не съдържа.
Когато импортирането бъде отказано
Отказаното импортиране не променя нищо: не се записва ред и действащият лиценз, ако има такъв, остава какъвто е бил. Одитният дневник на инсталацията записва всеки опит, включително отказаните.
| Код | Състояние | Какво означава | Какво да предприемете |
|---|---|---|---|
LICENCE_SIGNATURE_INVALID |
422 | Един от двата подписа на Adverant липсва или не преминава проверката; файлът е бил променен след подписването | Поискайте отново файла от Adverant; не го редактирайте |
LICENCE_FORMAT_INVALID |
422 | Файлът не е лиценз, който това издание може да прочете | Изпратете файла точно както Adverant го е предоставил |
LICENCE_ROOT_UNKNOWN |
422 | Подписан е с ключ, на който тази инсталация не се доверява | Поискайте лиценз, подписан за корените на доверие на това издание, или надградете |
LICENCE_MATRIX_MISMATCH |
422 | Съставен е спрямо матрица на изданията, която това издание не чете, или предоставя група, която това издание не познава | Надградете или поискайте лиценз, съставен спрямо това издание |
LICENCE_OTHER_INSTALLATION |
409 | Издаден е за друга инсталация | Поискайте лиценз, издаден за идентичността на тази инсталация |
TRANSITION_NOT_PERMITTED |
409 | Лиценз с този идентификатор вече е бил импортиран; всеки се импортира по веднъж | Поискайте от Adverant нов лиценз, ако условията трябва да се променят |
LICENCE_REVOKED |
403 | Adverant е оттеглил този лиценз | Поискайте нов от Adverant |
LICENCE_LOCKED |
403 | Срокът на лиценза не е започнал; дотогава се прилага базовото ниво Community | Импортирайте го отново на или след първия му ден |
RECORD_NOT_FOUND |
404 | Инсталацията все още не е декларирана, така че няма идентичност, спрямо която да се извърши проверка | Завършете стъпката за първия администратор (глава 2.12, Първото стартиране), след което импортирайте |
VALIDATION_FAILED |
400 | Тялото е било нечетливо или над 1 MiB, или е бил изпратен низ на заявката | Изпратете файла като цялото тяло на заявката, без низ за заявка (query string) |
Още един код може да се върне при успешно импортиране като известие, а не като отказ: LICENCE_CLOCK_BEHIND_FLOOR означава, че часовникът на инсталацията показва по-ранно време от последното време, което вече е видяла, така че лицензът се разчита към това по-късно време. Връщането на часовника назад никога не съживява изтекъл лиценз. Само токен за нулиране на времето, който Adverant подписва за инсталацията, понижава долната граница.
Преминаване от Community към Enterprise на място
Това е, което направихме в Harrow. Нищо не се преинсталира и нищо не се мигрира: това е същата инсталация, със същата идентичност и същите данни, като по-голяма част от нея е включена. Името на инсталацията и пазителите остават точно каквито са били; при надграждане куката за попечителство проверява дали хранилището за ключове вече е инициализирано и не прави нищо друго.
Поставете токена за изтегляне на всеки възел и рестартирайте средата за изпълнение на контейнери там.
Изтеглете чарта на Enterprise от Downloads и проверете него и неговите образи, както е посочено по-горе.
Променете двете стойности във Вашия съществуващ файл със стойности:
edition: enterpriseиenterprise.enabled: true. Не променяйте нищо друго.Изпълнете предварителната проверка с новия файл.
nexusctl preflight --context harrow-prod --values harrow-values.yamlНадградете изданието до чарта на Enterprise, отново без
--wait.helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \ --namespace nexus -f harrow-values.yaml --timeout 45mПри надграждане куките се изпълняват преди стартирането на новите подове и всяка миграция прилага само файловете, които не е прилагала преди. Генерираните тайни се прочитат обратно от инсталацията и се запазват. Helm завършва с:
NAME: nexus NAMESPACE: nexus STATUS: deployed REVISION: 2Изчакайте работните натоварвания, точно както в глава 2.6, Инсталиране на Community върху Kubernetes, стъпка 7.
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sИмпортирайте лиценза по който и да е от трите начина по-горе.
В конзолата отворете This installation, след това Licence, след това Move to Enterprise. Страницата прочита лиценза и показва какво ще бъде изтеглено и какво ще се промени, преди да се случи каквото и да било. Тя също така преброява хората и съдържанието на организацията и отбелязва всяко от тях като запазено. Натиснете Fetch and switch on. Всяка част се проверява спрямо ключа на изданието на Adverant, преди да бъде използвана, а групите функции се включват една по една.
Нашият прозорец беше един час; работата в рамките му отне около двадесет минути, повечето от които в изчакване на схемата, докато се изпълняваха куките. Хората от пилотния проект влязоха на следващата сутрин в същото работно пространство, като зоните за Enterprise в менюто вече не бяха сиви.
След импортирането
Страницата за лиценза под This installation изброява всяка група функции в лиценза с нейните места и срок. Тя също така показва как се доставя всяка част, например компилирана и лицензирана за група на Enterprise или с отворен код за базовото ниво Community. Групите извън лиценза остават в списъка в сиво. Администраторите могат да стеснят обхвата на дадена група вътре в организацията; никой освен Adverant не може да разшири това, което лицензът предоставя.
Състоянието на лиценза се изчислява наново от документа и датата при всяко четене, така че изтичането на срока се случва без планирана задача. Всички в инсталацията виждат едно и също известие в конзолата с наближаването на края: LICENCE_ENDS_SOON от 30 дни преди края, след това LICENCE_IN_GRACE по време на гратисния период. Членовете виждат известието и датите; само администраторите на инсталацията виждат самия лиценз. Глава 2.13, Лицензи, обхваща подновяването и стълбицата на изтичане на срока.
Ако това не успее
| Какво виждате | Причина | Какво да предприемете |
|---|---|---|
edition=enterprise but enterprise.enabled=false: they must agree |
Променен е само един от двата ключа | Променете и двата |
files/images.lock.json is the community lock; this install is edition enterprise |
Използван е чартът на Community | Използвайте чарта на Enterprise от Downloads |
image ... is a enterprise image; a community install takes only community images |
Име на образ на Enterprise е достигнало до рендиране на Community | Проверете edition и папката на чарта |
ImagePullBackOff върху образ на Enterprise след надграждането |
Възел няма токен за изтегляне или неговият токен вече не е валиден | Проверете registries.yaml на този възел или създайте нов токен |
| Код за отказ на лиценз | Вижте таблицата с откази по-горе | Следвайте съответния ред; нищо не е било променено |
Когато страницата за лиценза покаже Enterprise и групите, които сте очаквали, инсталацията е лицензирана. Следващата спирка е първото стартиране в глава 2.12, Първото стартиране, ако все още не сте заявили инсталацията. Ако сте го направили, асистентът все още се нуждае от собствените ключове за модели с изкуствен интелект (ИИ) на организацията, преди да може да отговаря на когото и да било. Глава 2.14, Доставчици и модели на ИИ, показва как да ги свържете.




