Wersja 1.0.0-alpha.1najnowsza
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

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
- Proszę pobrać plik
nexusctlodpowiedni dla Państwa architektury z adresuhttps://downloads.adverant.ai/nexus/1.0.0-alpha.1/, wraz z kluczem publicznym wydania. Klucz należy zapisać jakorelease.pub. Rozdział 2.4, Pobieranie i weryfikacja wydania, wyjaśnia, jak sprawdzić odcisk palca klucza z tym opublikowanym przez firmę Adverant. - Proszę zweryfikować plik binarny oraz wydanie za pomocą klucza:
nexusctl version --json
nexusctl verifyPolecenie 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.keyPlik 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
- 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- 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
- Instalacja. Flaga
--editionmusi być zgodna z wartościąeditionw pliku wartości.
sudo nexusctl install --single-node --values harrow-pilot-values.yaml --edition community- 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.
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.keyPlik 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.kubeconfigKażda flaga ma swoje uzasadnienie.
--agents 0tworzy 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-k3s1przypina wersję k3s, na której testowane jest każde wydanie. Bez tej flagi otrzymują Państwo wersję domyślną dla k3d.--disable=traefik@server:0pomija 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 300skoń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 10mSystem Nexus nie potrzebuje niczego więcej od narzędzia cert-manager, a w szczególności nie wymaga komponentu trust-manager.
Instalacja systemu Nexus
- Proszę napisać plik wartości dla laptopa. Połączenie TLS kończy się na Państwa własnym froncie, więc
tls.modema 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>"- 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- 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
donePę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.
Wystawienie certyfikatu dla nazwy konsoli
- 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=120sNarzędzie cert-manager podpisuje go wewnątrz klastra. Nigdy nie odczytują Państwo klucza prywatnego urzędu CA.
- 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- 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 | base64Należ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
- 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- Proszę uruchomić nasłuchiwanie HTTPS na adresie
127.0.0.1:28443, które przekierowuje ruch do127.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 nimca.crtjako łańcuch certyfikatów, z kluczemtls.key; - zachowuje nagłówek
Hostjakoconsole.harrow.example; - ustawia
X-Forwarded-Proto: https; - przepuszcza żądania przełączenia na protokół WebSocket (upgrades), ponieważ konsola z nich korzysta.
- serwuje plik
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-evalUsunię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,statefulsetPlik 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.
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.
