Zaloguj sięUmów spotkanie

Rozdział 2.8

Instalacje na pojedynczej maszynie

Zainstaluj system Nexus na jednym serwerze z systemem Linux za pomocą nexusctl lub przetestuj go na laptopie z k3d i połącz się z konsolą przez HTTPS, aby działało logowanie oraz klucze dostępu (passkeys).

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: 18 min

Zanim Harrow Port Authority wdrożył system Nexus na swoim klastrze produkcyjnym, Tomás Reilly potrzebował dwóch mniejszych instalacji. Jedną z nich był pilotaż na zapasowym serwerze z systemem Linux w budynku operacyjnym, przeznaczony dla dwunastu osób, które miały wypróbować go jako pierwsze. Druga działała na jego własnym laptopie, aby mógł bezpiecznie eksperymentować i psuć konfigurację, nie zwracając niczyjej uwagi. Niniejszy rozdział omawia oba te scenariusze. Wykorzystują one ten sam pakiet chart, te same obrazy i ten sam proces pierwszego uruchomienia co pełna instalacja na platformie Kubernetes, dzięki czemu wiedza zdobyta na jednej maszynie przydaje się w dalszej pracy.

Ścieżka serwerowa to jedno polecenie: nexusctl install --single-node buduje klaster k3s na maszynie, instaluje cert-manager, a następnie instaluje system Nexus. Ścieżka na laptopie wymaga więcej samodzielnej pracy. Samodzielnie budują Państwo klaster k3d, instalują cert-manager oraz pakiet chart za pomocą narzędzia Helm, a następnie wykonują jedno dodatkowe zadanie, które stanowi pułapkę dla niemal każdego: umieszczają Państwo konsolę za protokołem HTTPS na własnej maszynie, ponieważ zwykłe przekierowanie portów (port-forward) nigdy nie pozwoli nikomu się zalogować.

Wymagany rozmiar maszyny

Przy domyślnych ustawieniach pakietu chart system Nexus wymaga w żądaniach (requests) około 2.05 rdzenia CPU (central processing unit) oraz 6.7 GiB pamięci, a jego wolumeny sumują się do 142 GiB. Na tę sumę składają się: PostgreSQL – 50, Valkey – 5, Neo4j – 20, Qdrant – 10, magazyn obiektów – 50, dwa magazyny OpenBao – 1 i 5 oraz wolumen pokwitowań (receipts) – 1. Żądania określają zasoby rezerwowane przez planistę (scheduler), natomiast rzeczywiste zużycie wzrasta, gdy użytkownicy rozpoczynają pracę.

Maszyna CPU Pamięć (RAM, random-access memory) Dysk
Zalecany pojedynczy węzeł 8 vCPU 32 GiB 250 GB SSD (solid-state drive)
Minimum do celów ewaluacji 4 vCPU 16 GiB 200 GB

Laptop spełniający minimum ewaluacyjne uruchomi system Nexus, jednak liczy się własny limit pamięci usługi Docker, a nie pamięć samego laptopa. Przed rozpoczęciem należy przydzielić usłudze Docker co najmniej 16 GiB.

Obie ścieżki wymagają platformy Kubernetes w wersji 1.33 lub nowszej. Ścieżka dla pojedynczego węzła dostarcza własną dystrybucję: k3s v1.33.6+k3s1, na której testowane jest każde wydanie.

Część pierwsza: jeden serwer z systemem Linux i nexusctl

Serwer pilotażowy Tomása to 8-rdzeniowa maszyna z 32 GiB pamięci i dyskiem 500 GB SSD, działająca pod kontrolą aktualnego systemu Linux, na którym nie ma nic innego. Instalacja wymaga uprawnień użytkownika root, ponieważ instaluje k3s jako usługę systemową.

Pobranie i weryfikacja narzędzia nexusctl

  1. Proszę pobrać plik nexusctl odpowiedni dla Państwa architektury z adresu https://downloads.adverant.ai/nexus/1.0.0-alpha.1/, wraz z kluczem publicznym wydania. Klucz należy zapisać jako release.pub. Rozdział 2.4, Pobieranie i weryfikacja wydania, wyjaśnia, jak sprawdzić odcisk palca klucza z tym opublikowanym przez firmę Adverant.
  2. Proszę zweryfikować plik binarny oraz wydanie za pomocą klucza:
nexusctl version --json
nexusctl verify

Polecenie nexusctl verify sprawdza pobrany plik względem klucza wydania Adverant i odrzuca wszystko, czego nie może zweryfikować. Jeśli weryfikacja się nie powiedzie, należy przerwać proces i pobrać pliki ponownie. Nigdy nie należy uruchamiać instalacji z pliku, który nie przeszedł weryfikacji.

Utworzenie klucza depozytariusza

Magazyn kluczy instalacji pieczętuje swoje klucze odzyskiwania dla jednego lub większej liczby depozytariuszy (custodians). Depozytariusz to osoba, która przechowuje w trybie offline plik tożsamości age, a pakiet chart odmawia instalacji bez co najmniej jednego takiego pliku. Na własnej maszynie depozytariusza należy wykonać:

age-keygen -o custodian.key

Plik zaczyna się od wiersza # public key: age1.... Ta publiczna połowa to część, która trafia do pliku wartości (values file). Sam plik tożsamości nigdy nie opuszcza maszyny depozytariusza. Na komputerze Mac z układem Secure Enclave polecenie age-plugin-se keygen --access-control=any-biometry -o custodian.key tworzy klucz wymagający użycia funkcji Touch ID, a jego publiczna połowa zaczyna się od age1se1.

Przygotowanie pliku wartości

# harrow-pilot-values.yaml (Helm values)
global:
  imageRegistry: registry.adverant.ai
  domain: harrow.example
hosts:
  console: console.harrow.example
  api: api.harrow.example
  auth: auth.harrow.example
edition: community
enterprise:
  enabled: false
tls:
  mode: existing
  existingSecret: harrow-public-tls
keys:
  installationName: harrow-pilot
  custody:
    recipients:
      - "<custodian-age-recipient>"

<custodian-age-recipient> to wiersz age1... z pliku custodian.key. Należy dodać jeden wpis na liście dla każdego depozytariusza.

Wartość keys.installationName jest stała. Pierwsze uruchomienie magazynu kluczy tworzy tożsamość instalacji pod tą nazwą i nic nie może jej później zmienić. Musi ona pasować do wyrażenia ^[a-z][a-z0-9-]{0,62}$: małe litery, zaczynające się od litery, maksymalnie 63 znaki. Proszę nie kopiować wartości nexus-example ani przykładowego odbiorcy z przykładowych plików samego pakietu chart. Pakiet chart odrzuca obie te wartości z nazwy, a kontrola wstępna (preflight) jako pierwsza zgłasza te same kody błędów.

Trzy nazwy hostów stanowią tożsamość instalacji. Każda usługa odmawia uruchomienia bez nich, a każde logowanie, plik cookie i klucz dostępu (passkey) są powiązane z hosts.console. Proszę wybrać nazwy, których nadal będą Państwo chcieli używać za pięć lat.

Skierowanie trzech nazw na serwer

Użytkownicy łączą się z konsolą, interfejsem API (application programming interface) oraz usługą logowania za pośrednictwem wbudowanego w k3s kontrolera ingress, Traefik, na portach 80 i 443 serwera. Należy dodać trzy rekordy DNS (Domain Name System) dla console.harrow.example, api.harrow.example oraz auth.harrow.example, z których każdy wskazuje adres serwera. Kontrola wstępna sprawdza każdą nazwę i informuje, dla której z nich brakuje rekordu.

Polityka sieciowa pakietu chart pozwala tylko jednej przestrzeni nazw (namespace) łączyć się z trzema usługami publicznymi. Jej domyślna wartość, kube-system, to miejsce, w którym k3s uruchamia usługę Traefik, dlatego na pojedynczym węźle należy pozostawić networkPolicy.ingressNamespace bez zmian.

Uruchomienie kontroli wstępnej, a następnie instalacji

  1. Proszę uruchomić kontrolę wstępną z flagą pojedynczego węzła. Odczytuje ona parametry maszyny oraz Państwa plik wartości i niczego nie zmienia.
sudo nexusctl preflight --single-node --values harrow-pilot-values.yaml
  1. Proszę przeczytać wiersz podsumowania na końcu. Ostrzeżenie nigdy nie blokuje instalacji, ale błąd już tak, a każdy wiersz z błędem zawiera linię fix.
 ────────────────────────────────────────────────────────────
 9 passed · 1 warning · 0 failed   You can install. Warnings do not block; fix them when you can.
 Report saved to preflight-2026-11-12-0902.txt · nothing was changed
  1. Instalacja. Flaga --edition musi być zgodna z wartością edition w pliku wartości.
sudo nexusctl install --single-node --values harrow-pilot-values.yaml --edition community
  1. Proszę obserwować przebieg procesu. Uruchamia on ponownie kontrolę wstępną, instaluje k3s v1.33.6+k3s1, instaluje cert-manager v1.21.3, instaluje system Nexus i czeka, aż każda usługa odpowie na test kondycji (health check). Na serwerze Tomása zajęło to niespełna dziesięć minut.
 done   Preflight again        9 passed · 1 warning
 done   k3s v1.33.6+k3s1       node Ready
 done   cert-manager v1.21.3   ready
 done   Database and search    ready
 done   Engines                started
 done   Console                https://console.harrow.example
 Installed. Nobody can sign in yet.
 Open https://console.harrow.example/claim
 Code <code>  works once, for 30 minutes
 Fingerprint of this installation, to compare in the browser:
 3F9A C21B 77E0 5D4C 9B12 A6F3 0E88 41D7

Proszę zachować ten odcisk palca na ekranie. Porównają go Państwo w przeglądarce podczas przejmowania instalacji za pomocą kodu. Jeśli kod wygaśnie przed jego użyciem, polecenie nexusctl claim-code --administrator <email> wygeneruje nowy. Dalsze kroki opisuje Rozdział 2.12, Pierwsze uruchomienie.

Instalacja edycji Community
Instalacja edycji Community
Instalacja edycji Community na jednym serwerze obejmuje pobranie, weryfikację, kontrolę wstępną i instalację, a następnie konfigurację pierwszego administratora. Krok związany z licencją nie występuje.

Wdrożenie certyfikatu

Przy użyciu tls.mode: existing trzy trasy ingress obsługują certyfikat znajdujący się w obiekcie Secret o nazwie określonej przez tls.existingSecret. Musi on obejmować wszystkie trzy hosty. Kontrola wstępna odczytuje ten obiekt Secret, gdy on istnieje, i ostrzega, jeśli ważność certyfikatu kończy się w ciągu 30 dni. Gdy obiektu Secret jeszcze tam nie ma, odpowiedni wiersz informuje o konieczności jego utworzenia – jest to ostrzeżenie, a nie błąd.

Na pojedynczym węźle klaster nie istnieje, dopóki proces instalacji go nie utworzy, dlatego obiekt Secret należy utworzyć bezpośrednio po instalacji. Najpierw proszę zapisać plik kubeconfig klastra (wyjaśnia to ostatnia sekcja niniejszego rozdziału), a następnie utworzyć za jego pomocą obiekt Secret:

sudo nexusctl kubeconfig > harrow-pilot.kubeconfig
chmod 600 harrow-pilot.kubeconfig
export KUBECONFIG=$PWD/harrow-pilot.kubeconfig
kubectl -n nexus create secret tls harrow-public-tls --cert=harrow-public.crt --key=harrow-public.key

Plik harrow-public.crt zawiera certyfikat, po którym następują ewentualne certyfikaty pośrednie, natomiast harrow-public.key zawiera jego klucz prywatny. Jeśli Państwa certyfikaty pochodzą z prywatnego urzędu certyfikacji, CA (certificate authority), polecenia nexusctl preflight oraz nexusctl install przyjmują flagę --ca-bundle <file>, aby mogły sprawdzić łańcuch certyfikatów. Inne sposoby obsługi protokołu TLS (Transport Layer Security) opisano w rozdziale 2.11, Warianty: zewnętrzne magazyny, TLS i ingress.

W razie niepowodzenia

Co Państwo widzą Co to oznacza Co należy zrobić
PREFLIGHT_FAILED (409) Kontrola wstępna wykryła błąd, w związku z czym instalacja się nie rozpoczęła. Nic nie zostało zainstalowane. Proszę naprawić każdy wiersz z błędem, korzystając z jego linii fix, i ponownie uruchomić instalację.
INSTALLATION_NAME_MISSING Wartość keys.installationName jest pusta. Proszę ustawić własną, stałą nazwę instalacji.
INSTALLATION_NAME_EXAMPLE Nazwa pochodzi z przykładowych wartości pakietu chart. Proszę wybrać własną nazwę.
KEYS_CUSTODIAN_MISSING Wartość keys.custody.recipients jest pusta. Proszę dodać publicznego odbiorcę age1... każdego depozytariusza.
KEYS_CUSTODIAN_EXAMPLE Odbiorcą jest przykładowy depozytariusz z pakietu chart, którego tożsamości nikt nie posiada. Proszę zastąpić go odbiorcami Państwa depozytariuszy.

Polecenie nexusctl kończy działanie z kodem 0, gdy proces może być kontynuowany, 1, gdy test go zablokował, oraz 2, gdy w ogóle nie mogło zostać uruchomione (nieczytelny plik wartości, błędna flaga). Skrypt może rozgałęziać swoje działanie na podstawie tych trzech wartości.

Część druga: wersja testowa na laptopie z k3d

Narzędzie k3d uruchamia k3s wewnątrz kontenerów Docker, dzięki czemu cały klaster działa na laptopie i znika za pomocą jednego polecenia. Narzędzia wydawnicze, które testują każde wydanie systemu Nexus, budują swoje klastry dokładnie w ten sposób, a skopiowanie ich ustawień pozwala uniknąć ponownego odkrywania problemów, które zostały już rozwiązane.

Potrzebują Państwo usługi Docker, narzędzia k3d 5.8.3, kubectl, Helm v4 oraz przeglądarki Chrome. Tomás użył swojego komputera Mac.

Utworzenie klastra

k3d cluster create harrow-eval --agents 0 --wait --timeout 300s \
  --image rancher/k3s:v1.33.6-k3s1 \
  --k3s-arg "--disable=traefik@server:0"
k3d kubeconfig get harrow-eval > harrow-eval.kubeconfig
chmod 600 harrow-eval.kubeconfig
export KUBECONFIG=$PWD/harrow-eval.kubeconfig

Każda flaga ma swoje uzasadnienie.

  • --agents 0 tworzy jeden węzeł serwerowy i żadnych węzłów roboczych (workers). Nexus działa bezproblemowo na jednym węźle, a drugi tylko zużywa pamięć.
  • --image rancher/k3s:v1.33.6-k3s1 przypina wersję k3s, na której testowane jest każde wydanie. Bez tej flagi otrzymują Państwo wersję domyślną dla k3d.
  • --disable=traefik@server:0 pomija instalację usługi Traefik. Laptop nie ma publicznego adresu do obsługi ruchu, a z konsolą łączą się Państwo za pośrednictwem własnego frontu HTTPS (opisanego poniżej).
  • --wait --timeout 300s kończy działanie tylko wtedy, gdy klaster odpowie, lub zwraca błąd po upływie pięciu minut.

Jeśli utrzymują Państwo serwer lustrzany (mirror) rejestru wydań na swoim laptopie, proszę dodać --registry-config <registries.yaml>, aby kierować pobieranie obrazów do serwera lustrzanego, oraz --k3s-arg "--disable-default-registry-endpoint@server:0", aby nic nie przełączało się awaryjnie na rejestr nadrzędny. Narzędzia wydawnicze działają w ten sposób, pobierając każdy obraz wyłącznie przez serwer lustrzany.

Instalacja narzędzia cert-manager

Pakiet chart tworzy własny lokalny urząd certyfikacji (CA), nexus-local-ca, jako wystawcę (issuer) w narzędziu cert-manager, z którego każda usługa pobiera swój certyfikat. Bez zasobów cert-manager w klastrze polecenie helm install odrzuca pakiet chart w ciągu kilku sekund. Proszę najpierw zainstalować cert-manager v1.21.3 z pakietu chart publikowanego przez projekt cert-manager:

helm install cert-manager cert-manager-v1.21.3.tgz -n cert-manager \
  --create-namespace --set crds.enabled=true --wait --timeout 10m

System Nexus nie potrzebuje niczego więcej od narzędzia cert-manager, a w szczególności nie wymaga komponentu trust-manager.

Instalacja systemu Nexus

  1. Proszę napisać plik wartości dla laptopa. Połączenie TLS kończy się na Państwa własnym froncie, więc tls.mode ma wartość none.
# harrow-eval-values.yaml (Helm values)
global:
  imageRegistry: registry.adverant.ai
  domain: harrow.example
hosts:
  console: console.harrow.example
  api: api.harrow.example
  auth: auth.harrow.example
edition: community
tls:
  mode: none
keys:
  installationName: harrow-eval
  custody:
    recipients:
      - "<custodian-age-recipient>"
  1. Proszę zainstalować pakiet chart z rejestru i pominąć flagę --wait (poniższe ostrzeżenie wyjaśnia dlaczego).
helm install nexus oci://registry.adverant.ai/nexus/charts/nexus --version 1.0.0-alpha.1 \
  -n nexus --create-namespace -f harrow-eval-values.yaml --timeout 45m
  1. Następnie należy samodzielnie zaczekać na uruchomienie obciążeń (workloads):
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
for s in $(kubectl -n nexus get sts -o name); do
  want=$(kubectl -n nexus get "$s" -o jsonpath='{.spec.replicas}')
  kubectl -n nexus wait "$s" --for=jsonpath='{.status.readyReplicas}'="$want" --timeout=900s
done

Pętla dla obiektów StatefulSet jest tam obecna, ponieważ niektóre z nich aktualizują po jednym podzie naraz na żądanie, a kubectl rollout status odrzuca takie obiekty. Oczekiwanie na readyReplicas działa dla każdej strategii aktualizacji.

Gdy oba polecenia zakończą działanie, każdy obiekt Deployment ma status Available, a każdy obiekt StatefulSet ma gotowe pody. Nikt nie może się jeszcze zalogować. Jest to prawidłowe zachowanie: instalacja nie została jeszcze przejęta.

Dlaczego przekierowanie portów (port-forward) nigdy nie pozwoli na zalogowanie

Oczywistym kolejnym krokiem wydaje się kubectl port-forward svc/nexus-alpha 3000:3000 i otwarcie przeglądarki pod adresem http://127.0.0.1:3000. Strony konsoli ładują się, więc wygląda na to, że wszystko działa. Tak jednak nie jest i żadne ustawienie tego nie zmieni. Na przeszkodzie stoją trzy rzeczy, każda z nich celowo.

Co blokuje działanie Dlaczego
Źródło (origin) Mechanizm logowania konsoli odrzuca żądanie, którego źródłem (origin) nie jest https://<hosts.console>, w tym przypadku https://console.harrow.example. Strona serwowana z adresu http://127.0.0.1:3000 ma nieprawidłowe źródło, więc proces logowania nigdy się nie rozpoczyna.
Plik cookie Sesja to plik cookie __Host- oznaczony jako Secure. Przeglądarki przechowują taki plik cookie wyłącznie przez połączenie HTTPS, bez atrybutu domeny, dokładnie dla tego hosta, który go ustawił. Przy zwykłym połączeniu HTTP przeglądarka go odrzuca.
Klucz dostępu (passkey) Pierwszy administrator loguje się za pomocą klucza dostępu, a klucz dostępu wymaga bezpiecznego kontekstu z ważnym certyfikatem. Przeglądarka Chrome odmawia utworzenia klucza dostępu za ostrzeżeniem o certyfikacie, nawet jeśli zostało ono zaakceptowane przez użytkownika.

Przeglądarka musi zatem komunikować się z adresem https://console.harrow.example, używając certyfikatu, któremu ufa, a nazwa ta musi prowadzić do Państwa laptopa.

Łączenie się z konsolą przez HTTPS na laptopie

Poniższa metoda wykorzystuje własny urząd certyfikacji (CA) pakietu chart do wystawienia certyfikatu, przekierowanie portów (port-forward) w celu dotarcia do konsoli oraz osobny profil przeglądarki Chrome, który ufa temu jednemu urzędowi CA i mapuje nazwę konsoli na Państwa laptop. Państwa systemowy magazyn zaufanych certyfikatów oraz plik /etc/hosts pozostają bez zmian.

Diagram przedstawia po lewej stronie przeglądarkę Chrome z etykietą „osobny profil: ufa wyłącznie nexus-local-ca; console.harrow.example:443 zmapowane na 127.0.0.1:28443”. Strzałka z etykietą „HTTPS” prowadzi do pola „front HTTPS na 127.0.0.1:28443 (certyfikat z nexus-local-ca)”. Strzałka z etykietą „HTTP, zachowany nagłówek Host, X-Forwarded-Proto https” prowadzi do pola „kubectl port-forward 127.0.0.1:3000”, a ostatnia strzałka wchodzi do pola klastra k3d, wskazując „Service nexus-alpha, port http (3000)”. Linia kropkowana biegnąca od komponentu cert-manager wewnątrz klastra do pola frontu nosi etykietę „wystawia certyfikat”.
Sposób, w jaki przeglądarka na laptopie łączy się z konsolą w klastrze k3d przez protokół HTTPS.

Wystawienie certyfikatu dla nazwy konsoli

  1. Proszę zażądać od narzędzia cert-manager certyfikatu dla hosta konsoli, podpisanego przez wystawcę pakietu chart:
# console-front-certificate.yaml (a cert-manager Certificate)
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
  name: nexus-console-front
  namespace: nexus
spec:
  secretName: nexus-console-front-tls
  dnsNames: [console.harrow.example]
  duration: 24h
  usages: [server auth, digital signature, key encipherment]
  privateKey: { algorithm: ECDSA, size: 256, rotationPolicy: Always }
  issuerRef: { name: nexus-local-ca, kind: Issuer, group: cert-manager.io }
kubectl apply -f console-front-certificate.yaml
kubectl -n nexus wait --for=condition=Ready certificate/nexus-console-front --timeout=120s

Narzędzie cert-manager podpisuje go wewnątrz klastra. Nigdy nie odczytują Państwo klucza prywatnego urzędu CA.

  1. Proszę skopiować certyfikat, jego klucz oraz certyfikat CA z obiektu Secret:
kubectl -n nexus get secret nexus-console-front-tls -o jsonpath='{.data.tls\.crt}' | base64 -d > tls.crt
kubectl -n nexus get secret nexus-console-front-tls -o jsonpath='{.data.tls\.key}' | base64 -d > tls.key
kubectl -n nexus get secret nexus-console-front-tls -o jsonpath='{.data.ca\.crt}' | base64 -d > ca.crt
chmod 600 tls.key
  1. Proszę obliczyć skrót (pin) urzędu CA. Przeglądarka Chrome identyfikuje zaufany klucz za pomocą zakodowanego w base64 skrótu SHA-256 jego klucza publicznego:
openssl x509 -in ca.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | base64

Należy przypiąć klucz urzędu CA, a nie klucz samego certyfikatu. Certyfikat jest ważny przez jeden dzień i otrzymuje nowy klucz za każdym razem, gdy cert-manager go odnawia, podczas gdy urząd CA pozostaje ten sam.

Umieszczenie frontu HTTPS przed przekierowaniem portów

  1. Proszę przekierować usługę (Service) konsoli. Jej port to ten o nazwie http, czyli 3000 w tym wydaniu:
kubectl -n nexus port-forward svc/nexus-alpha 3000:3000
  1. Proszę uruchomić nasłuchiwanie HTTPS na adresie 127.0.0.1:28443, które przekierowuje ruch do 127.0.0.1:3000. Sprawdzi się dowolny serwer reverse proxy, któremu już Państwo ufają, o ile realizuje on cztery zadania:
    • serwuje plik tls.crt, a po nim ca.crt jako łańcuch certyfikatów, z kluczem tls.key;
    • zachowuje nagłówek Host jako console.harrow.example;
    • ustawia X-Forwarded-Proto: https;
    • przepuszcza żądania przełączenia na protokół WebSocket (upgrades), ponieważ konsola z nich korzysta.

Przekierowanie portów do obiektu Service wiąże się z jednym konkretnym podem wybranym w momencie uruchomienia. Po aktualizacji lub ponownym uruchomieniu, które zastępuje pod konsoli, przekierowanie pozostaje aktywne, ale trafia w próżnię, a przeglądarka wyświetla błąd złej bramy (bad gateway). Przekierowanie portów należy zrestartować za każdym razem, gdy zmienia się pod konsoli.

Otwarcie przeglądarki Chrome z przypiętym kluczem i mapowaniem nazwy

Na komputerze Mac:

open -na "Google Chrome" --args --user-data-dir="$HOME/.nexus-eval-chrome" \
  "--host-resolver-rules=MAP console.harrow.example:443 127.0.0.1:28443" \
  "--ignore-certificate-errors-spki-list=<ca-pin>" \
  https://console.harrow.example/install

<ca-pin> to wynik działania wiersza z poleceniem openssl. W systemie Linux należy uruchomić przeglądarkę Chrome z tymi samymi trzema flagami.

Te trzy flagi współpracują ze sobą. Flaga --host-resolver-rules wysyła ruch dla console.harrow.example na porcie 443 do Państwa frontu, wyłącznie wewnątrz tego profilu. Flaga --ignore-certificate-errors-spki-list ufa certyfikatom wystawionym przez ten jeden klucz CA, a przeglądarka Chrome honoruje ją tylko w połączeniu z --user-data-dir. Osobny profil izoluje ten wyjątek od Państwa codziennego przeglądania internetu. Nie jest to ogólny przełącznik „ignoruj błędy certyfikatów”: wszystko, co nie zostało podpisane przez urząd CA klastra, nadal zakończy się błędem.

Po otwarciu tego profilu adres https://console.harrow.example/install prowadzi do strony przejęcia instalacji i możliwe jest utworzenie klucza dostępu. Dalsze kroki opisuje Rozdział 2.12, Pierwsze uruchomienie.

Ponowne uruchomienie laptopa

Magazyn kluczy składa się z dwóch części: samego magazynu kluczy oraz małego komponentu odpieczętowania (unsealer), który przechowuje jego klucz odblokowujący. Po każdym ponownym uruchomieniu węzła (restart usługi Docker, restart laptopa, polecenia k3d cluster stop i start) komponent odpieczętowania uruchamia się w stanie zapieczętowanym. Magazyn kluczy odpieczętowywuje się za jego pośrednictwem, więc dopóki depozytariusz nie odopieczętuje komponentu odpieczętowania za pomocą własnej tożsamości age, nic, co wymaga klucza, nie będzie działać. Jest to celowa właściwość projektu, która działa identycznie na klastrze produkcyjnym. Rozdział 2.15, Dzień drugi: eksploatacja systemu Nexus, pokazuje proces odpieczętowania.

Po zakończeniu ewaluacji:

k3d cluster delete harrow-eval

Usunięcie klastra powoduje usunięcie instalacji oraz wszystkiego, co się w niej znajduje.

nexusctl kubeconfig

Klaster zbudowany przez polecenie nexusctl install --single-node należy do nexusctl. Aby połączyć się z nim za pomocą kubectl, helm lub dowolnego innego narzędzia, należy pobrać jego plik kubeconfig:

sudo nexusctl kubeconfig > harrow-pilot.kubeconfig
chmod 600 harrow-pilot.kubeconfig
export KUBECONFIG=$PWD/harrow-pilot.kubeconfig
kubectl -n nexus get deploy,statefulset

Plik ten zapewnia pełny dostęp administracyjny do klastra. Należy przechowywać go z uprawnieniami w trybie 600, na maszynach osób zarządzających instalacją i nigdzie indziej. Każde kolejne polecenie w Części 2, które przyjmuje flagę --context lub odczytuje zmienną KUBECONFIG, działa na pojedynczym węźle za pośrednictwem tego pliku. To samo dotyczy aktualizacji: polecenia nexusctl upgrade plan --bundle <file> oraz nexusctl upgrade apply --bundle <file> na pojedynczym węźle aktualizują również klaster k3s należący do nexusctl.

Diagram przedstawia stos czterech warstw na polu z etykietą „jeden serwer z systemem Linux”. Od dołu: „k3s v1.33.6+k3s1 (Traefik w przestrzeni kube-system, porty 80 i 443)”, następnie „cert-manager v1.21.3 oraz lokalny urząd CA pakietu chart nexus-local-ca”, wyżej „warstwa danych Nexus: PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS, OpenBao”, a na górze „usługi Nexus: konsola, logowanie, brama i pozostałe”. Po prawej stronie trzy strzałki z najwyższej warstwy wychodzą z pola i są oznaczone etykietami console.harrow.example, api.harrow.example oraz auth.harrow.example. Po lewej stronie ikona terminala z etykietą „nexusctl kubeconfig” wskazuje na warstwę k3s.
Elementy, które polecenie nexusctl install --single-node instaluje na jednym serwerze z systemem Linux.

Co przenosi się do klastra

Wszystko, co wykonali Państwo na jednej maszynie, ma swój odpowiednik w klastrze. Plik wartości to ten sam plik, różniący się jedynie rejestrem, trybem TLS lub klasą pamięci masowej (storage class), jak pokazano w rozdziale 2.11, Warianty: zewnętrzne magazyny, TLS i ingress. Pierwsze uruchomienie przebiega identycznie. Tym, czego nie można przenieść, jest sama instalacja: nazwa instalacji jest ustalana na stałe i instalacji nie da się przenieść z laptopa na serwer. Kiedy Tomás przeszedł ze swojego laptopa na serwer pilotażowy, zaczął od nowa z nową nazwą, harrow-pilot, a środowisko harrow-eval zachował do eksperymentów.