ВходЗапазете среща

Глава 2.7

Инсталиране на Enterprise и прилагане на лиценз

Какво се променя, когато инсталирате изданието Enterprise, как да заявите лиценз от профила си в Adverant, трите начина да го импортирате заедно с всеки код за отказ и как Harrow Port Authority прехвърли своя пилотен проект от Community към Enterprise на място, без да изгуби нищо.

Тази страница е преведена от ИИ от английския оригинал. Ако нещо е неясно, английската страница е референтна. Прочетете тази страница на английски

17 минути за четене

Една инсталация на Enterprise има две половини и те пристигат по различни пътища. Образите на Enterprise идват с чарта на Enterprise, изтеглени с токен за изтегляне. Лицензът идва като подписан файл от Вашия акаунт в Adverant и го импортирате в работещата инсталация. Нито една половина не работи без другата: образи без лиценз работят на базовото ниво Community, а лиценз без образи на Enterprise няма какво да включи.

В Harrow Port Authority го направихме в този ред, шест седмици след пилотния проект с Community в глава 2.6, Инсталиране на Community върху Kubernetes. Надграждането до чарта на Enterprise отне един прозорец за профилактика; импортирането на лиценза отне две минути. Тази глава обхваща и двете половини. Тя започва с чиста инсталация и завършва с преместване на място на съществуваща инсталация на Community.

Две успоредни ленти, вливащи се в едно поле вдясно с надпис „Инсталация на Enterprise“. Горна лента: „Акаунт в Adverant: Downloads“ води към „Чарт на Enterprise и неговият заключващ файл за образите“, след това към „helm install или helm upgrade, edition: enterprise“, със странично поле „токен за изтегляне на всеки възел“, свързано с него. Долна лента: „Акаунт в Adverant: Deployments“ води към „подписан файл с лиценз“, след това към „импортиране в работещата инсталация“. Двете ленти се срещат в дясното поле. Под него ред с надпис гласи „образи без лиценз работят на базовото ниво Community“.
Двете половини на една инсталация на Enterprise и откъде идва всяка от тях.

Какво се различава от 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.json
1.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, стъпка по стъпка, с три разлики:

  1. Поставете токена за изтегляне на всеки възел преди стъпка 6.

  2. Използвайте стойностите за Enterprise (двата ключа по-горе) в стъпка 4.

  3. В стъпка 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 при инсталирането. Затова акаунтът трябва да знае коя инсталация имате предвид, преди да може да издаде лиценз.

  1. Влезте във Вашия акаунт в Adverant на адрес https://account.adverant.ai.
  2. В инсталацията отворете This installation, след това Licence. Показва се еднократен код и отпечатъкът на инсталацията.
  3. Във Вашия акаунт отворете Claim a deployment и въведете кода. След това сравнете отпечатъка, който акаунтът е получил, с този, който инсталацията показва, група по група; всяка група трябва да съвпада.
  4. Натиснете бутона за заявяване. Инсталацията се присъединява към Deployments във Вашия акаунт със своята версия и състояние на лиценза.
  5. Adverant издава лиценза за тази инсталация. Изтеглете файла от Вашия акаунт; той е кръстен на идентификатора на лиценза си, <licence-id>.json.

Кодът за заявяване работи еднократно и за кратко време. Ако изтече, акаунтът го отказва с CLAIM_CODE_EXPIRED, а инсталацията показва нов.

Заявяване на внедряване
Заявяване на внедряване
Заявяване на внедряване в акаунта в Adverant. Първо се въвежда еднократният код, след което отпечатъкът се сравнява на групи от по четири, така че никой не може да заяви инсталация, пред която не се намира.

Съществуват още два пътя и глава 2.13, Лицензи, ги разглежда изцяло. Устройствата и периферните комплекти нямат екран за показване на код, така че те се заявяват с ключ за заявяване, отпечатан върху кутията, въведен в Enter a claim key или прочетен от файла с поръчката на производителя. Инсталация без изходяща връзка използва Offline exchange: тя създава подписан файл със заявка за лиценз, Вие го пренасяте до Вашия акаунт и връщате обратно файла с лиценза. Веднъж годишно тя създава подписан отчет за използването по същия начин. Всеки файл в обмена е подписан, така че файл, променен по пътя, бива отказан с LICENCE_REQUEST_SIGNATURE_INVALID за заявка и USAGE_FILE_SIGNATURE_INVALID за файл за използване.

Офлайн обмен
Офлайн обмен
Офлайн обменът в акаунта в Adverant. Подписаните файлове се пренасят на ръка в двете посоки, а файл, променен по пътя, бива отказан поименно.

Какво съдържа файлът с лиценза

Лицензът е 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>.json

nexusctl изпраща файла непроменен до маршрута за импортиране на инсталацията като администратор на инсталацията и докладва състоянието на лиценза или кода за отказ от таблицата по-долу.

Чрез 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. Нищо не се преинсталира и нищо не се мигрира: това е същата инсталация, със същата идентичност и същите данни, като по-голяма част от нея е включена. Името на инсталацията и пазителите остават точно каквито са били; при надграждане куката за попечителство проверява дали хранилището за ключове вече е инициализирано и не прави нищо друго.

  1. Поставете токена за изтегляне на всеки възел и рестартирайте средата за изпълнение на контейнери там.

  2. Изтеглете чарта на Enterprise от Downloads и проверете него и неговите образи, както е посочено по-горе.

  3. Променете двете стойности във Вашия съществуващ файл със стойности: edition: enterprise и enterprise.enabled: true. Не променяйте нищо друго.

  4. Изпълнете предварителната проверка с новия файл.

    nexusctl preflight --context harrow-prod --values harrow-values.yaml
  5. Надградете изданието до чарта на 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
  6. Изчакайте работните натоварвания, точно както в глава 2.6, Инсталиране на Community върху Kubernetes, стъпка 7.

    kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  7. Импортирайте лиценза по който и да е от трите начина по-горе.

  8. В конзолата отворете This installation, след това Licence, след това Move to Enterprise. Страницата прочита лиценза и показва какво ще бъде изтеглено и какво ще се промени, преди да се случи каквото и да било. Тя също така преброява хората и съдържанието на организацията и отбелязва всяко от тях като запазено. Натиснете Fetch and switch on. Всяка част се проверява спрямо ключа на изданието на Adverant, преди да бъде използвана, а групите функции се включват една по една.

Нашият прозорец беше един час; работата в рамките му отне около двадесет минути, повечето от които в изчакване на схемата, докато се изпълняваха куките. Хората от пилотния проект влязоха на следващата сутрин в същото работно пространство, като зоните за Enterprise в менюто вече не бяха сиви.

От Community към Enterprise
От Community към Enterprise
Преместване на инсталация на Community към Enterprise. Страницата потвърждава, че лицензът е истински, и изброява какво ще бъде изтеглено, преди да се изтегли каквото и да било; хората и файловете на организацията са отбелязани като запазени.

След импортирането

Страницата за лиценза под This installation изброява всяка група функции в лиценза с нейните места и срок. Тя също така показва как се доставя всяка част, например компилирана и лицензирана за група на Enterprise или с отворен код за базовото ниво Community. Групите извън лиценза остават в списъка в сиво. Администраторите могат да стеснят обхвата на дадена група вътре в организацията; никой освен Adverant не може да разшири това, което лицензът предоставя.

Състоянието на лиценза се изчислява наново от документа и датата при всяко четене, така че изтичането на срока се случва без планирана задача. Всички в инсталацията виждат едно и също известие в конзолата с наближаването на края: LICENCE_ENDS_SOON от 30 дни преди края, след това LICENCE_IN_GRACE по време на гратисния период. Членовете виждат известието и датите; само администраторите на инсталацията виждат самия лиценз. Глава 2.13, Лицензи, обхваща подновяването и стълбицата на изтичане на срока.

Лицензът и какво отключва той
Лицензът и какво отключва той
Това е страницата за лиценза на една инсталация на Enterprise. Цифрите в горната част показват местата и срока; под тях е изброена всяка група функции с начина, по който е защитена, а групите извън лиценза остават сиви.

Ако това не успее

Какво виждате Причина Какво да предприемете
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, Доставчици и модели на ИИ, показва как да ги свържете.