Zaloguj sięUmów spotkanie

Rozdział 2.7

Instalacja edycji Enterprise i stosowanie licencji

Co się zmienia po zainstalowaniu edycji Enterprise, jak wystąpić o licencję z konta Adverant, trzy sposoby jej importu wraz ze wszystkimi kodami odmowy oraz jak organizacja Harrow Port Authority przeniosła swój pilotaż w edycji Community do Enterprise w miejscu, bez utraty danych.

Ta strona została przetłumaczona przez AI z angielskiego oryginału. W razie jakichkolwiek niejasności wersją wiążącą jest strona w języku angielskim. Przeczytaj tę stronę po angielsku

Czas czytania: 17 min

Instalacja Enterprise składa się z dwóch połówek, które docierają różnymi drogami. Obrazy Enterprise są dostarczane z pakietem chart Enterprise, pobieranym za pomocą tokenu pobierania (pull token). Licencja ma postać podpisanego pliku z konta Adverant i należy ją zaimportować do działającej instalacji. Żadna połówka nie działa bez drugiej: obrazy bez licencji działają na poziomie podstawowym Community, a licencja bez obrazów Enterprise nie ma czego włączyć.

W Harrow Port Authority zrobiliśmy to w tej właśnie kolejności, sześć tygodni po pilotażu wersji Community opisanym w rozdziale 2.6, Instalacja wersji Community w środowisku Kubernetes. Aktualizacja do pakietu chart Enterprise zajęła jedno okno serwisowe; import licencji zajął dwie minuty. Niniejszy rozdział omawia obie połówki. Zaczyna się od czystej instalacji, a kończy na aktualizacji istniejącej instalacji Community w miejscu.

Dwa równoległe tory prowadzące do jednego pola po prawej stronie z etykietą „Instalacja Enterprise”. Górny tor: „Konto Adverant: Downloads” prowadzi do „Pakiet chart Enterprise i jego blokada obrazów”, a następnie do „helm install lub helm upgrade, edition: enterprise”, z dołączonym bocznym polem „token pobierania na każdym węźle”. Dolny tor: „Konto Adverant: Deployments” prowadzi do „podpisany plik licencji”, a następnie do „import do działającej instalacji”. Oba tory spotykają się w polu po prawej stronie. Pod nim znajduje się podpis: „obrazy bez licencji działają na poziomie podstawowym Community”.
Dwie połówki instalacji Enterprise i skąd każda z nich pochodzi.

Różnice względem edycji Community

Dwie wartości oraz pakiet chart, który je odczytuje.

# harrow-values.yaml (Helm values, Enterprise: only these two keys change)
edition: enterprise
enterprise:
  enabled: true

Wszystko inne w pliku wartości pozostaje dokładnie takie samo, a przede wszystkim nazwa instalacji oraz depozytariusze. Oba klucze muszą być zgodne – pakiet chart odrzuci edition: enterprise z enterprise.enabled: false lub odwrotnie.

Edycja musi być również zgodna z blokadą obrazów pakietu chart. Każda paczka chart zawiera blokadę dla jednej edycji, a blokada Enterprise obejmuje obrazy Community oraz kompilacje Enterprise. Jeśli wskażą Państwo plik wartości Enterprise dla pakietu chart Community, renderowanie zatrzyma się z błędem files/images.lock.json is the community lock; this install is edition enterprise. Zatem instalacja Enterprise wymaga pakietu chart Enterprise.

Pakiet chart oraz paczka Enterprise znajdują się na stronie Downloads na Państwa koncie Adverant, zgodnie z posiadaną licencją. Plik pakietu chart ma taką samą nazwę jak w wersji Community, nexus-1.0.0-alpha.1.tgz, należy więc przechowywać je w osobnych folderach. Proszę go zweryfikować dokładnie tak, jak opisano w rozdziale 2.4, Pobieranie i weryfikacja wydania, względem klucza wydania, którego odcisk palca został sprawdzony:

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

Następnie proszę uruchomić pętlę weryfikacji podpisów z rozdziału 2.4, Pobieranie i weryfikacja wydania, dla pliku enterprise/nexus/files/images.lock.json. Obejmuje on zarówno obrazy Enterprise, jak i te współdzielone.

Token pobierania (pull token)

Obrazy Community są publiczne. Obrazy Enterprise wymagają tokenu pobierania ze strony Pull tokens and install commands na Państwa koncie, skonfigurowanego dla środowiska uruchomieniowego kontenerów na węzłach, jak pokazano w rozdziale 2.4, Pobieranie i weryfikacja wydania, w kroku 3. W przypadku k3s jest to wpis configs dla registry.adverant.ai w pliku /etc/rancher/k3s/registries.yaml na każdym węźle.

Proszę utworzyć jeden token na klaster i nadać mu datę ważności, którą łatwo zauważyć. Gdy token wygaśnie, działające pody będą kontynuować pracę, ale pod przeniesiony na węzeł, który nie ma jeszcze obrazu, nie będzie mógł go pobrać. My wpisaliśmy datę wygaśnięcia tokenu do tego samego kalendarza, w którym śledzimy certyfikaty.

Nowa instalacja edycji Enterprise

Jeśli instalują Państwo edycję Enterprise od podstaw, proszę postępować krok po kroku zgodnie z rozdziałem 2.6, Instalacja wersji Community w środowisku Kubernetes, z trzema różnicami:

  1. Przed krokiem 6 proszę umieścić token pobierania na każdym węźle.

  2. W kroku 4 proszę użyć wartości Enterprise (dwóch powyższych kluczy).

  3. W kroku 6 proszę przeprowadzić instalację z pobranego pliku pakietu chart Enterprise:

    helm install nexus enterprise/nexus-1.0.0-alpha.1.tgz \
      --namespace nexus -f harrow-values.yaml --timeout 45m

Wszystko po poleceniu instalacji wygląda tak samo jak w rozdziale 2.6, Instalacja wersji Community w środowisku Kubernetes, włącznie z zasadą dotyczącą --wait: proszę tego nie używać. Jeśli zamiast tego instalują Państwo za pomocą nexusctl, proszę dodać do polecenia --edition enterprise:

nexusctl install --context harrow-prod --values harrow-values.yaml --edition enterprise

Gdy wszystkie obciążenia będą gotowe, proszę przejść przez pierwsze uruchomienie opisane w rozdziale 2.12, Pierwsze uruchomienie. Licencja to jedna z sześciu rzeczy, które konsola wyświetla, zanim ktokolwiek się zaloguje. Dopóki nie zostanie zaimportowana, instalacja działa na poziomie podstawowym Community, a każdy obszar Enterprise jest wyszarzony i oznaczony kłódką.

Występowanie o licencję

Licencja od Adverant jest wystawiana dla tożsamości jednej instalacji – tej, którą magazyn kluczy wygenerował pod keys.installationName podczas instalacji. Konto musi więc wiedzieć, o którą instalację chodzi, zanim będzie mogło wystawić licencję.

  1. Proszę zalogować się na swoje konto Adverant pod adresem https://account.adverant.ai.
  2. W instalacji proszę otworzyć This installation, a następnie Licence. Wyświetli się jednorazowy kod oraz odcisk palca instalacji.
  3. Na swoim koncie proszę otworzyć Claim a deployment i wprowadzić kod. Następnie proszę porównać odcisk palca otrzymany przez konto z tym, który pokazuje instalacja, grupa po grupie; każda grupa musi się zgadzać.
  4. Proszę nacisnąć przycisk przypisania. Instalacja dołączy do sekcji Deployments na Państwa koncie, wraz z informacją o wersji i stanie licencji.
  5. Adverant wystawia licencję dla tej instalacji. Proszę pobrać plik ze swojego konta; jego nazwa pochodzi od identyfikatora licencji, <licence-id>.json.

Kod przypisania działa jednorazowo i przez krótki czas. Jeśli wygaśnie, konto odrzuci go z błędem CLAIM_CODE_EXPIRED, a instalacja wyświetli nowy kod.

Przypisz wdrożenie
Przypisz wdrożenie
Przypisywanie wdrożenia na koncie Adverant. Najpierw wprowadzany jest kod jednorazowy, a następnie porównywany jest odcisk palca w grupach po cztery znaki, dzięki czemu nikt nie może przypisać instalacji, przed którą bezpośrednio się nie znajduje.

Istnieją dwie inne drogi, a rozdział 2.13, Licencje, szczegółowo omawia obie. Urządzenia zintegrowane (appliances) i zestawy brzegowe (edge kits) nie mają ekranu do wyświetlenia kodu, dlatego przypisuje się je za pomocą klucza przypisania wydrukowanego na pudełku, wpisywanego na stronie Enter a claim key lub odczytywanego z pliku zamówienia od producenta. Instalacja bez połączenia ze światem zewnętrznym korzysta z wymiany offline (Offline exchange): tworzy podpisany plik żądania licencji, który przenoszą Państwo na swoje konto, a z powrotem przenoszą Państwo plik licencji. Raz w roku w ten sam sposób instalacja tworzy podpisane zestawienie wykorzystania. Każdy plik w tej wymianie jest podpisany, więc plik zmodyfikowany po drodze zostaje odrzucony z kodem LICENCE_REQUEST_SIGNATURE_INVALID w przypadku żądania oraz USAGE_FILE_SIGNATURE_INVALID w przypadku pliku wykorzystania.

Wymiana offline
Wymiana offline
Wymiana offline na koncie Adverant. Podpisane pliki są przenoszone ręcznie w obu kierunkach, a plik zmodyfikowany po drodze zostaje odrzucony ze wskazaniem nazwy błędu.

Co zawiera plik licencji

Licencja to dokument JSON w formacie nexus-licence/v1, podpisany dwukrotnie przez Adverant dwoma niezależnymi kluczami. Nie muszą go Państwo czytać, ale warto wiedzieć, co się w nim znajduje, gdy ktoś zapyta, co zostało kupione.

Pole Co określa
licence_id Własny identyfikator licencji, zapisany małymi literami identyfikator UUID (uniwersalnie unikalny identyfikator)
type alpha, evaluation lub commercial
licensee Nazwę organizacji oraz identyfikator klienta Adverant
scope Instalację, dla której została wystawiona, oraz wszelkie organizacje wskazane w nadaniu uprawnień
edition enterprise
grants Odblokowywane grupy funkcji, każda dla całej instalacji lub dla wskazanych organizacji
add_ons oraz domain_packs Możliwości licencjonowane osobno; jedną z nich jest pakiet Logistics and maritime
metric Sposób rozliczania licencji – named-seat, per-core lub per-environment – oraz liczbę
term starts_on, ends_on oraz liczbę dni ostrzeżenia i okresu karencji
matrix Wersję macierzy edycji, względem której została wystawiona
signatures Dwa podpisy firmy Adverant

Licencja ewaluacyjna trwa maksymalnie 30 dni, obejmuje najwyżej pięć nazwanych osób i nie ma okresu karencji. Licencja komercyjna wyświetla ostrzeżenie na 30 dni przed końcem, a następnie domyślnie daje 30 dni okresu karencji. To, co dzieje się na każdym stopniu tej drabiny, opisano w rozdziale 2.13, Licencje.

Podpisy obejmują dokument w takiej postaci, w jakiej utworzył go Adverant. Proszę przesłać go dokładnie tak, jak został otrzymany; proszę nie otwierać go w edytorze, który mógłby sformatować zawartość.

Importowanie licencji

Tylko administrator instalacji może zaimportować licencję: właściciel lub administrator całej organizacji będącej właścicielem instalacji, po zalogowaniu się do niej. Może to również zrobić pełny administrator platformy. Licencja nigdy nie jest wartością pakietu chart ani plikiem montowanym do poda. Trafia ona do usługi logowania, nexus-auth, która weryfikuje ją w trybie offline względem głównych certyfikatów zaufania wbudowanych w jej własny obraz i zapisuje ją w jednej transakcji. Można ją zaimportować na trzy sposoby, a wszystkie prowadzą do tego samego miejsca.

W konsoli

Podczas pierwszego uruchomienia proszę otworzyć Six things before anyone signs in, a następnie Licence. Strona Import the licence przyjmuje plik: można go upuścić na stronę lub wybrać z dysku. Strona weryfikuje go offline w samej instalacji, a następnie wyświetla listę otwieranych grup funkcji wraz z informacją, jak każda z nich jest chroniona i do kiedy obowiązuje. Grupy nieobjęte licencją pozostają na liście jako wyszarzone.

Później ten sam import jest dostępny pod przyciskiem Import a new licence na stronie licencji danej instalacji. Gdy licencja wygaśnie, strona ograniczonej licencji oferuje przycisk Import a renewed licence.

Zaimportuj licencję
Zaimportuj licencję
Importowanie licencji w konsoli. Plik jest weryfikowany w samej instalacji; strona wymienia odblokowywane elementy według grup funkcji, a plik, który nie przejdzie weryfikacji podpisu, jest traktowany jako nieobecny z odpowiednim kodem błędu.

Za pomocą nexusctl

nexusctl licence import <licence-id>.json

Polecenie nexusctl wysyła niezmieniony plik do ścieżki importu instalacji jako administrator instalacji i zwraca stan licencji lub kod odrzucenia z poniższej tabeli.

Przez API

Ścieżka importu jest częścią interfejsu programowania aplikacji (API) usługi logowania pod Państwa adresem hosts.auth. Treść żądania to dokument licencji, bajt po bajcie:

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> to token dostępu zalogowanego administratora instalacji. Proszę użyć --data-binary, nigdy -d, ponieważ ten drugi usuwa znaki końca linii, zmieniając wysyłane bajty. Ścieżka nie przyjmuje żadnych parametrów zapytania (query string), a w treści nie może być niczego poza dokumentem; treść, która na najwyższym poziomie próbuje wskazać organizację lub osobę, zostaje odrzucona przed jakimkolwiek odczytem.

Prawidłowy import zwraca odpowiedź 201 Created. Po skróceniu treść wygląda następująco:

{
  "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 zlicza organizacje w instalacji, które mają teraz przypisaną licencję. tenants_without_organisation zlicza organizacje wymienione w licencji, których ta instalacja nie obejmuje.

Gdy import zostanie odrzucony

Odrzucony import niczego nie zmienia: żaden wiersz nie zostaje zapisany, a obowiązująca licencja, jeśli istnieje, pozostaje bez zmian. Dziennik audytu instalacji rejestruje każdą próbę, w tym również te odrzucone.

Kod Status Co to oznacza Co należy zrobić
LICENCE_SIGNATURE_INVALID 422 Brakuje jednego z dwóch podpisów Adverant lub nie przechodzi on weryfikacji; plik został zmodyfikowany po podpisaniu Proszę poprosić Adverant o ponowne przesłanie pliku; proszę go nie edytować
LICENCE_FORMAT_INVALID 422 Plik nie jest licencją, którą to wydanie potrafi odczytać Proszę przesłać plik dokładnie w takiej postaci, w jakiej przekazał go Adverant
LICENCE_ROOT_UNKNOWN 422 Plik jest podpisany kluczem, któremu ta instalacja nie ufa Proszę poprosić o licencję podpisaną dla głównych certyfikatów zaufania tego wydania lub przeprowadzić aktualizację
LICENCE_MATRIX_MISMATCH 422 Licencja została wystawiona względem macierzy edycji, której to wydanie nie odczytuje, lub nadaje uprawnienia do grupy nieznanej temu wydaniu Proszę przeprowadzić aktualizację lub poprosić o licencję wystawioną dla tego wydania
LICENCE_OTHER_INSTALLATION 409 Licencja została wystawiona dla innej instalacji Proszę poprosić o licencję wystawioną dla tożsamości tej instalacji
TRANSITION_NOT_PERMITTED 409 Licencja o tym identyfikatorze została już zaimportowana; każdą importuje się tylko raz Jeśli warunki muszą ulec zmianie, proszę poprosić Adverant o nową licencję
LICENCE_REVOKED 403 Adverant wycofał tę licencję Proszę poprosić Adverant o nową licencję
LICENCE_LOCKED 403 Okres obowiązywania licencji jeszcze się nie rozpoczął; do tego czasu obowiązuje poziom podstawowy Community Proszę zaimportować ją ponownie w pierwszym dniu obowiązywania lub później
RECORD_NOT_FOUND 404 Instalacja nie została jeszcze zadeklarowana, nie ma więc tożsamości, względem której można dokonać sprawdzenia Proszę ukończyć krok pierwszego administratora (rozdział 2.12, Pierwsze uruchomienie), a następnie zaimportować licencję
VALIDATION_FAILED 400 Treść żądania była nieczytelna, przekraczała 1 MiB lub przesłano parametry zapytania Proszę przesłać plik jako całą treść żądania, bez parametrów zapytania

Przy udanym imporcie może pojawić się jeszcze jeden kod, jako powiadomienie, a nie odrzucenie: LICENCE_CLOCK_BEHIND_FLOOR oznacza, że zegar instalacji wskazuje czas wcześniejszy niż najpóźniejszy czas, jaki już odnotowała, więc licencja jest odczytywana względem tego późniejszego czasu. Cofnięcie zegara nigdy nie przywraca wygasłej licencji. Tylko token resetowania czasu podpisany przez Adverant dla danej instalacji może obniżyć ten próg czasowy.

Przenoszenie edycji Community do Enterprise w miejscu

Tak właśnie postąpiliśmy w Harrow. Nic nie jest instalowane od nowa i nic nie jest migrowane: to ta sama instalacja, z tą samą tożsamością i tymi samymi danymi, ale z większą liczbą włączonych funkcji. Nazwa instalacji oraz depozytariusze pozostają dokładnie tacy sami; podczas aktualizacji hak depozytu (custody hook) sprawdza jedynie, czy magazyn kluczy jest już zainicjowany, i nie robi nic więcej.

  1. Proszę umieścić token pobierania na każdym węźle i zrestartować tam środowisko uruchomieniowe kontenerów.

  2. Proszę pobrać pakiet chart Enterprise z sekcji Downloads oraz zweryfikować go wraz z obrazami, jak opisano powyżej.

  3. Proszę zmienić dwie wartości w istniejącym pliku wartości: edition: enterprise oraz enterprise.enabled: true. Proszę nie zmieniać niczego innego.

  4. Proszę uruchomić sprawdzenie wstępne (preflight) z nowym plikiem.

    nexusctl preflight --context harrow-prod --values harrow-values.yaml
  5. Proszę zaktualizować wydanie do pakietu chart Enterprise, ponownie bez użycia --wait.

    helm upgrade nexus enterprise/nexus-1.0.0-alpha.1.tgz \
      --namespace nexus -f harrow-values.yaml --timeout 45m

    Podczas aktualizacji haki (hooks) uruchamiają się przed wdrożeniem nowych podów, a każda migracja stosuje tylko te pliki, których wcześniej nie zastosowała. Wygenerowane sekrety są odczytywane z instalacji i zachowywane. Helm kończy działanie komunikatem:

    NAME: nexus
    NAMESPACE: nexus
    STATUS: deployed
    REVISION: 2
  6. Proszę zaczekać na obciążenia, dokładnie tak jak w rozdziale 2.6, Instalacja wersji Community w środowisku Kubernetes, w kroku 7.

    kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
  7. Proszę zaimportować licencję jednym z trzech opisanych wyżej sposobów.

  8. W konsoli proszę otworzyć This installation, następnie Licence, a potem Move to Enterprise. Strona odczytuje licencję i pokazuje, co zostanie pobrane i co się zmieni, zanim cokolwiek nastąpi. Zlicza również osoby i treści w organizacji, oznaczając je jako zachowane. Proszę nacisnąć Fetch and switch on. Każda część przed użyciem jest weryfikowana względem klucza wydania Adverant, a grupy funkcji włączają się jedna po drugiej.

Nasze okno serwisowe wynosiło godzinę; sama praca zajęła około dwudziestu minut, z czego większość stanowiło oczekiwanie na schemat podczas działania haków. Uczestnicy pilotażu zalogowali się następnego ranka do tej samej przestrzeni roboczej, w której obszary menu Enterprise nie były już wyszarzone.

Z Community do Enterprise
Z Community do Enterprise
Przenoszenie instalacji Community do wersji Enterprise. Strona potwierdza autentyczność licencji i wyświetla listę elementów do pobrania, zanim cokolwiek zostanie pobrane; osoby i pliki organizacji są oznaczone jako zachowane.

Po imporcie

Strona licencji w sekcji This installation wyświetla każdą grupę funkcji zawartą w licencji wraz z liczbą stanowisk i okresem obowiązywania. Informuje również, w jaki sposób każda część jest dostarczana, na przykład jako skompilowana i licencjonowana w przypadku grupy Enterprise lub jako open source w przypadku poziomu podstawowego Community. Grupy spoza licencji pozostają na liście jako wyszarzone. Administratorzy mogą zawęzić zasięg grupy wewnątrz organizacji; nikt poza firmą Adverant nie może rozszerzyć uprawnień wynikających z licencji.

Stan licencji jest obliczany na nowo na podstawie dokumentu i daty przy każdym odczycie, dzięki czemu wygaśnięcie następuje bez użycia zaplanowanego zadania. W miarę zbliżania się końca okresu wszyscy użytkownicy instalacji widzą w konsoli to samo powiadomienie: LICENCE_ENDS_SOON na 30 dni przed końcem, a następnie LICENCE_IN_GRACE podczas okresu karencji. Członkowie widzą powiadomienie i daty; samą licencję widzą tylko administratorzy instalacji. Rozdział 2.13, Licencje, omawia odnawianie oraz drabinę wygasania.

Licencja i to, co odblokowuje
Licencja i to, co odblokowuje
To jest strona licencji instalacji Enterprise. Liczby na górze przedstawiają stanowiska i okres obowiązywania; poniżej wymieniono każdą grupę funkcji wraz ze sposobem jej ochrony, a grupy spoza licencji pozostają wyszarzone.

W razie niepowodzenia

Co Państwo widzą Przyczyna Co należy zrobić
edition=enterprise but enterprise.enabled=false: they must agree Zmieniono tylko jeden z dwóch kluczy Proszę zmienić oba
files/images.lock.json is the community lock; this install is edition enterprise Użyto pakietu chart Community Proszę użyć pakietu chart Enterprise z sekcji Downloads
image ... is a enterprise image; a community install takes only community images Nazwa obrazu Enterprise trafiła do renderowania Community Proszę sprawdzić edition oraz folder pakietu chart
ImagePullBackOff na obrazie Enterprise po aktualizacji Węzeł nie ma tokenu pobierania lub jego token stracił ważność Proszę sprawdzić registries.yaml na tym węźle lub utworzyć nowy token
Kod odrzucenia licencji Proszę sprawdzić powyższą tabelę odrzuceń Proszę postępować zgodnie z odpowiednim wierszem; nic nie zostało zmienione

Gdy strona licencji pokazuje wersję Enterprise oraz oczekiwane grupy, instalacja jest objęta licencją. Następnym przystankiem jest pierwsze uruchomienie w rozdziale 2.12, Pierwsze uruchomienie, jeśli nie przypisali Państwo jeszcze instalacji. Jeśli zostało to już zrobione, asystent nadal potrzebuje własnych kluczy modeli sztucznej inteligencji (AI) organizacji, zanim będzie mógł komukolwiek odpowiedzieć. Rozdział 2.14, Dostawcy i modele AI, pokazuje, jak je podłączyć.