PieteiktiesPieteikt konsultāciju

2.8. nodaļa

Instalēšana vienā iekārtā

Instalējiet Nexus vienā Linux serverī ar nexusctl vai novērtējiet to klēpjdatorā ar k3d, un piekļūstiet konsolei, izmantojot HTTPS, lai darbotos pierakstīšanās un piekļuves atslēgas.

Šo lapu no oriģināla angļu valodā ir tulkojis MI. Neskaidrību gadījumā par pamatu jāņem lapa angļu valodā. Lasīt šo lapu angļu valodā

18 minūšu lasīšana

Pirms Harrow Port Authority izvietoja Nexus savā produkcijas klasterī, Tomás Reilly vēlējās divas mazākas instalācijas. Viena bija pilotprojekts uz rezerves Linux servera operāciju ēkā divpadsmit cilvēkiem, kuri to izmēģinātu pirmie. Otra darbojās viņa paša klēpjdatorā, lai viņš varētu eksperimentēt un kļūdīties neviena nepamanīts. Šajā nodaļā ir apskatīti abi varianti. Tie izmanto to pašu chart pakotni, tos pašus attēlus un to pašu pirmo palaišanu kā pilna Kubernetes instalācija, tāpēc vienā iekārtā apgūtais ir tieši pielietojams arī tālāk.

Servera variants ir viena komanda: nexusctl install --single-node izveido k3s klasteri iekārtā, instalē cert-manager un pēc tam instalē Nexus. Klēpjdatora variants prasa vairāk praktisku darbību. Jūs pats izveidojat k3d klasteri, ar Helm instalējat cert-manager un chart pakotni, un pēc tam veicat vienu papildu uzdevumu, kurā gandrīz visi paklūp: savā iekārtā novietojat konsoli aiz HTTPS, jo ar vienkāršu port-forward neviens nekad nevarēs pierakstīties.

Nepieciešamā iekārtas jauda

Ar chart pakotnes noklusējuma iestatījumiem Nexus pieprasījumos (requests) prasa aptuveni 2.05 CPU (centrālā procesora) kodolus un 6.7 GiB atmiņas, un tā sējumu kopējais apjoms ir 142 GiB. Šo kopsummu veido PostgreSQL 50, Valkey 5, Neo4j 20, Qdrant 10, objektu krātuve 50, abas OpenBao krātuves 1 un 5, kā arī kvīšu (receipts) sējums 1. Pieprasījumi ir tas apjoms, ko plānotājs rezervē, un faktiskais patēriņš ir lielāks, kad cilvēki sāk strādāt.

Iekārta CPU Atmiņa (RAM, brīvpiekļuves atmiņa) Disks
Ieteicamais vienam mezglam 8 vCPU 32 GiB 250 GB SSD (pusvadītāju disks)
Minimums novērtēšanai 4 vCPU 16 GiB 200 GB

Klēpjdators, kas atbilst novērtēšanas minimumam, spēs darbināt Nexus, taču izšķirošais ir paša Docker atmiņas limits, nevis klēpjdatora atmiņa. Pirms sākat, piešķiriet Docker vismaz 16 GiB.

Abiem variantiem ir nepieciešams Kubernetes 1.33 vai jaunāka versija. Viena mezgla variants nodrošina savu: k3s v1.33.6+k3s1 — distributīvu, uz kura tiek testēts katrs laidiens.

Pirmā daļa: viens Linux serveris ar nexusctl

Tomás pilotprojekta serveris ir 8 kodolu iekārta ar 32 GiB atmiņu un 500 GB SSD, kurā darbojas aktuāla Linux versija un nekas cits. Instalācijai ir nepieciešamas root tiesības, jo tā instalē k3s kā sistēmas pakalpojumu.

Iegūstiet nexusctl un pārbaudiet to

  1. Lejupielādējiet savai arhitektūrai atbilstošo nexusctl no https://downloads.adverant.ai/nexus/1.0.0-alpha.1/ kopā ar laidiena publisko atslēgu. Saglabājiet atslēgu kā release.pub. 2.4. nodaļā „Laidiena iegūšana un pārbaude” ir paskaidrots, kā salīdzināt atslēgas nospiedumu ar Adverant publicēto.
  2. Pārbaudiet bināro failu un laidienu ar atslēgu:
nexusctl version --json
nexusctl verify

nexusctl verify pārbauda lejupielādi pret Adverant laidiena atslēgu un noraida visu, ko nevar verificēt. Ja pārbaude neizdodas, apturiet procesu un lejupielādējiet vēlreiz. Nekad neveiciet instalēšanu no faila, kas nav verificēts.

Izveidojiet glabātāja atslēgu

Instalācijas atslēgu krātuve aizplombē savas atkopšanas atslēgas vienam vai vairākiem glabātājiem (custodians). Glabātājs ir persona, kas bezsaistē glabā age identitātes failu, un chart pakotne atsakās instalēties bez vismaz viena šāda glabātāja. Glabātāja paša iekārtā:

age-keygen -o custodian.key

Fails sākas ar rindiņu # public key: age1.... Šī publiskā puse ir tā, kas jāiekļauj vērtību (values) failā. Pats identitātes fails nekad nepamet glabātāja iekārtu. Mac datorā ar Secure Enclave komanda age-plugin-se keygen --access-control=any-biometry -o custodian.key izveido atslēgu, kuras lietošanai nepieciešams Touch ID, un tās publiskā puse sākas ar age1se1.

Uzrakstiet vērtību failu

# 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> ir age1... rindiņa no custodian.key. Pievienojiet vienu saraksta ierakstu katram glabātājam.

keys.installationName ir nemainīgs. Pirmajā atslēgu krātuves palaišanas reizē ar šo nosaukumu tiek izveidota instalācijas identitāte, un vēlāk nekas to vairs nevar pārdēvēt. Tam jāatbilst ^[a-z][a-z0-9-]{0,62}$: mazie burti, jāsākas ar burtu, ne vairāk kā 63 rakstzīmes. Nekopējiet nexus-example vai parauga saņēmēju no pašas chart pakotnes parauga failiem. Chart pakotne noraida abus pēc nosaukuma, un pirmsinstalācijas pārbaude (preflight) vispirms ziņo par tiem pašiem kodiem.

Šie trīs resursdatori (hosts) ir instalācijas identitāte. Bez tiem katrs pakalpojums atsakās startēt, un katra pierakstīšanās, sīkdatne un piekļuves atslēga (passkey) ir piesaistīta hosts.console. Izvēlieties nosaukumus, kurus vēlēsieties izmantot arī pēc pieciem gadiem.

Novirziet trīs nosaukumus uz serveri

Lietotāji sasniedz konsoli, API (lietojumprogrammu saskarni) un pierakstīšanās pakalpojumu caur k3s iebūvēto ingress kontrolieri Traefik servera 80. un 443. portā. Pievienojiet trīs DNS (domēna nosaukumu sistēmas) ierakstus — console.harrow.example, api.harrow.example un auth.harrow.example, no kuriem katrs norāda uz servera adresi. Pirmsinstalācijas pārbaude pārbauda katru nosaukumu un pasaka, kuram nav ieraksta.

Chart pakotnes tīkla politika ļauj sasniegt trīs publiskos pakalpojumus tikai vienai nosaukumvietai (namespace). Tās noklusējuma vērtība kube-system ir vieta, kur k3s darbina Traefik, tāpēc uz viena mezgla networkPolicy.ingressNamespace nav jāmaina.

Veiciet pirmsinstalācijas pārbaudi, tad instalējiet

  1. Palaidiet pirmsinstalācijas pārbaudi ar viena mezgla karodziņu. Tā nolasa iekārtas un jūsu vērtību faila datus un neko nemaina.
sudo nexusctl preflight --single-node --values harrow-pilot-values.yaml
  1. Izlasiet kopsavilkuma rindiņu beigās. Brīdinājums nekad nebloķē instalēšanu, bet kļūme to dara, un katrā nesekmīgajā rindā ir fix rindiņa.
 ────────────────────────────────────────────────────────────
 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. Instalējiet. Karodziņam --edition ir jāsakrīt ar edition vērtību failā.
sudo nexusctl install --single-node --values harrow-pilot-values.yaml --edition community
  1. Vērojiet izpildi. Tā vēlreiz palaiž pirmsinstalācijas pārbaudi, instalē k3s v1.33.6+k3s1, instalē cert-manager v1.21.3, instalē Nexus un gaida, līdz katrs pakalpojums atbild uz savu darbspējas pārbaudi. Tomás serverī tas aizņēma nedaudz mazāk par desmit minūtēm.
 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

Atstājiet šo nospiedumu redzamu ekrānā. Jūs to salīdzināsiet pārlūkprogrammā, kad ar kodu pieprasīsiet instalāciju. Ja koda derīguma termiņš beidzas pirms tā izmantošanas, nexusctl claim-code --administrator <email> izveido jaunu. Tālākās darbības ir aprakstītas 2.12. nodaļā „Pirmā palaišana”.

Instalējiet Community izdevumu
Instalējiet Community izdevumu
Community instalācija vienā serverī ietver lejupielādi, pārbaudi, pirmsinstalācijas pārbaudi un instalēšanu, kam seko pirmā administratora izveide. Licences posma nav.

Ievietojiet sertifikātu

Izmantojot tls.mode: existing, trīs ingress maršruti izsniedz sertifikātu no Secret objekta, ko norāda tls.existingSecret. Tam ir jāaptver visi trīs resursdatori. Pirmsinstalācijas pārbaude nolasa šo Secret objektu, ja tas pastāv, un brīdina, ja sertifikāta derīguma termiņš beidzas 30 dienu laikā. Ja Secret objekta vēl nav, attiecīgā rinda liek to izveidot, un tas ir brīdinājums, nevis kļūme.

Uz viena mezgla klasteris nepastāv, kamēr instalācija to nav izveidojusi, tāpēc izveidojiet Secret objektu uzreiz pēc instalēšanas. Vispirms izvadiet klastera kubeconfig (tas ir paskaidrots šīs nodaļas pēdējā sadaļā) un pēc tam ar to izveidojiet Secret objektu:

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

harrow-public.crt satur sertifikātu, kam seko visi starpposma sertifikāti, bet harrow-public.key — tā privāto atslēgu. Ja jūsu sertifikāti nāk no privātas CA (sertifikācijas iestādes), nexusctl preflight un nexusctl install pieņem --ca-bundle <file>, lai tie varētu pārbaudīt ķēdi. Citi TLS (transporta slāņa drošības) apstrādes veidi ir aprakstīti 2.11. nodaļā „Variācijas: ārējās krātuves, TLS un ingress”.

Ja tas neizdodas

Ko jūs redzat Ko tas nozīmē Kā rīkoties
PREFLIGHT_FAILED (409) Pirmsinstalācijas pārbaude konstatēja kļūmi, tāpēc instalēšana nesākās. Nekas netika instalēts. Novērsiet katru nesekmīgo rindu, izmantojot tās fix rindiņu, un palaidiet instalēšanu vēlreiz.
INSTALLATION_NAME_MISSING keys.installationName ir tukšs. Iestatiet pašas instalācijas pastāvīgo nosaukumu.
INSTALLATION_NAME_EXAMPLE Šis nosaukums ir ņemts no chart pakotnes parauga vērtībām. Izvēlieties savu nosaukumu.
KEYS_CUSTODIAN_MISSING keys.custody.recipients ir tukšs. Pievienojiet katra glabātāja publisko age1... saņēmēju.
KEYS_CUSTODIAN_EXAMPLE Saņēmējs ir chart pakotnes parauga glabātājs, kura identitāte nevienam nepieder. Aizstājiet to ar savu glabātāju saņēmējiem.

nexusctl beidz darbu ar kodu 0, kad var turpināt, ar 1, kad pārbaude to bloķēja, un ar 2, kad to vispār nevarēja palaist (nenolasāms vērtību fails, nepareizs karodziņš). Skripts var sazaroties atkarībā no šīm trim vērtībām.

Otrā daļa: novērtēšana klēpjdatorā ar k3d

k3d darbina k3s Docker konteineros, tādējādi viss klasteris atrodas klēpjdatorā un pazūd ar vienu komandu. Laidienu rīki, kas testē katru Nexus laidienu, veido savus klasterus tieši šādā veidā, un to iestatījumu kopēšana pasargā jūs no problēmām, ar kurām tie jau ir saskārušies.

Jums ir nepieciešams Docker, k3d 5.8.3, kubectl, Helm v4 un Chrome. Tomás izmantoja savu Mac.

Izveidojiet klasteri

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

Katram karodziņam ir savs iemesls.

  • --agents 0 izveido vienu servera mezglu un nevienu darba mezglu (worker). Nexus lieliski darbojas vienā mezglā, un otrs tikai patērē atmiņu.
  • --image rancher/k3s:v1.33.6-k3s1 piesaista k3s versiju, uz kuras tiek testēts katrs laidiens. Bez tā jūs iegūstat k3d noklusējuma versiju.
  • --disable=traefik@server:0 izlaiž Traefik. Klēpjdatoram nav publiskas adreses, ko apkalpot, un jūs sasniedzat konsoli caur savu HTTPS priekšgalu (skatīt zemāk).
  • --wait --timeout 300s atgriež rezultātu tikai tad, kad klasteris atbild, vai arī cieš neveiksmi pēc piecām minūtēm.

Ja savā klēpjdatorā spoguļojat laidienu reģistru, pievienojiet --registry-config <registries.yaml>, lai novirzītu attēlu izgūšanu uz spoguli, un --k3s-arg "--disable-default-registry-endpoint@server:0", lai nekas neatgrieztos pie augšupējā (upstream) reģistra. Laidienu rīki darbojas šādā veidā, katram attēlam nākot tikai caur spoguli.

Instalējiet cert-manager

Chart pakotne izveido savu lokālo CA nexus-local-ca kā cert-manager izdevēju (issuer), un katrs pakalpojums saņem savu sertifikātu no tā. Ja klasterī nav cert-manager resursu, helm install dažās sekundēs noraida chart pakotni. Vispirms instalējiet cert-manager v1.21.3 no chart pakotnes, ko publicē cert-manager projekts:

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

Nexus no cert-manager nekas cits nav nepieciešams, un jo īpaši nav nepieciešams trust-manager.

Instalējiet Nexus

  1. Uzrakstiet vērtību failu klēpjdatoram. TLS beidzas pie jūsu paša priekšgala, tāpēc tls.mode ir 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. Instalējiet chart pakotni no reģistra un izlaidiet --wait (brīdinājumā zemāk ir paskaidrots, kāpēc).
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. Pēc tam pats sagaidiet darba slodžu gatavību:
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

StatefulSet cikls ir nepieciešams tāpēc, ka daži no tiem pēc pieprasījuma atjaunina pa vienam podam, un kubectl rollout status tādus noraida. Gaidīšana uz readyReplicas darbojas ar katru atjaunināšanas stratēģiju.

Kad abas komandas ir izpildītas, katrs Deployment ir statusā Available un katram StatefulSet podi ir gatavi. Neviens vēl nevar pierakstīties. Tā tam ir jābūt: instalācija vēl nav pieprasīta (unclaimed).

Kāpēc ar portu pāradresāciju nevar pierakstīties

Acīmredzamais nākamais solis būtu kubectl port-forward svc/nexus-alpha 3000:3000 un pārlūkprogramma adresē http://127.0.0.1:3000. Konsoles lapas ielādējas, tāpēc izskatās, ka tas darbojas. Tā nav, un neviens iestatījums neliks tam darboties. Tam ceļā stāv trīs lietas, katra ar nolūku.

Kas to aptur Kāpēc
Izcelsme (origin) Konsoles pierakstīšanās noraida pieprasījumu, kura izcelsme nav https://<hosts.console>, šajā gadījumā https://console.harrow.example. Lapai, kas tiek apkalpota no http://127.0.0.1:3000, ir nepareiza izcelsme, tāpēc pierakstīšanās nekad nesākas.
Sīkdatne Sesija ir __Host- sīkdatne ar atzīmi Secure. Pārlūkprogrammas šādu sīkdatni saglabā tikai caur HTTPS, bez domēna atribūta, precīzi tam resursdatoram, kas to iestatīja. Izmantojot parastu HTTP, pārlūkprogramma to atmet.
Piekļuves atslēga (passkey) Pirmais administrators pierakstās ar piekļuves atslēgu, un piekļuves atslēgai ir nepieciešams drošs konteksts ar derīgu sertifikātu. Chrome atsakās izveidot piekļuves atslēgu aiz sertifikāta brīdinājuma, pat ja esat tam noklikšķinājis cauri.

Tādēļ pārlūkprogrammai ir jāsazinās ar https://console.harrow.example, izmantojot sertifikātu, kuram tā uzticas, un šim nosaukumam ir jāved uz jūsu klēpjdatoru.

Piekļuve konsolei klēpjdatorā, izmantojot HTTPS

Tālāk aprakstītā metode izmanto pašas chart pakotnes CA sertifikāta izdošanai, port-forward konsoles sasniegšanai un atsevišķu Chrome profilu, kas uzticas šai vienai CA un kartē konsoles nosaukumu uz jūsu klēpjdatoru. Jūsu sistēmas uzticamības krātuve un /etc/hosts paliek nemainīgi.

Diagrammā kreisajā pusē ir attēlots Chrome ar uzrakstu „separate profile: trusts nexus-local-ca only; console.harrow.example:443 mapped to 127.0.0.1:28443”. Bultiņa ar uzrakstu „HTTPS” ved uz bloku „HTTPS front on 127.0.0.1:28443 (certificate from nexus-local-ca)”. Bultiņa ar uzrakstu „HTTP, Host kept, X-Forwarded-Proto https” ved uz „kubectl port-forward 127.0.0.1:3000”, un pēdējā bultiņa ved k3d klastera blokā uz „Service nexus-alpha, port http (3000)”. Punktēta līnija no cert-manager klastera iekšienē uz priekšgala bloku ir apzīmēta ar „issues the certificate”.
Kā pārlūkprogramma klēpjdatorā caur HTTPS sasniedz konsoli k3d klasterī.

Izsniedziet sertifikātu konsoles nosaukumam

  1. Pieprasiet cert-manager sertifikātu konsoles resursdatoram, ko parakstījis chart pakotnes izdevējs:
# 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

cert-manager to paraksta klastera iekšienē. Jūs nekad nenolasāt CA privāto atslēgu.

  1. Nokopējiet sertifikātu, tā atslēgu un CA sertifikātu no Secret objekta:
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. Aprēķiniet CA piespraudi (pin). Chrome identificē uzticamu atslēgu pēc tās publiskās atslēgas base64 SHA-256 vērtības:
openssl x509 -in ca.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | base64

Piespraudiet CA atslēgu, nevis sertifikāta atslēgu. Sertifikāts ir derīgs vienu dienu un saņem jaunu atslēgu katru reizi, kad cert-manager to atjauno, savukārt CA paliek nemainīga.

Novietojiet HTTPS priekšgalu port-forward priekšā

  1. Pāradresējiet konsoles Service objektu. Tā ports ir nosaukts http, kas šajā laidienā ir 3000:
kubectl -n nexus port-forward svc/nexus-alpha 3000:3000
  1. Palaidiet HTTPS klausītāju adresē 127.0.0.1:28443, kas pāradresē uz 127.0.0.1:3000. Derēs jebkurš reversais starpniekserveris (reverse proxy), kuram jau uzticaties, ja vien tas veic četras lietas:
    • apkalpo tls.crt, kam kā ķēde seko ca.crt, izmantojot tls.key;
    • saglabā Host galveni kā console.harrow.example;
    • iestata X-Forwarded-Proto: https;
    • laiž cauri WebSocket jaunināšanas pieprasījumus (upgrades), jo konsole tos izmanto.

Port-forward uz Service objektu piesaistās tam vienam podam, kuru tas izvēlējās darbības sākumā. Pēc tam, kad jaunināšana vai restartēšana nomaina konsoles podu, pāradresācija paliek aktīva, bet nepāradresē nekur, un pārlūkprogramma rāda kļūdu „bad gateway”. Restartējiet port-forward ikreiz, kad mainās konsoles pods.

Atveriet Chrome ar piespraudi un nosaukuma kartējumu

Mac datorā:

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> ir openssl rindiņas izvade. Linux sistēmā palaidiet Chrome ar tiem pašiem trim karodziņiem.

Šie trīs karodziņi darbojas kopā. --host-resolver-rules novirza console.harrow.example 443. portā uz jūsu priekšgalu tikai šī profila ietvaros. --ignore-certificate-errors-spki-list uzticas sertifikātiem, ko izdevusi šī viena CA atslēga, un Chrome to ņem vērā tikai kopā ar --user-data-dir. Atsevišķais profils nošķir šo izņēmumu no jūsu ikdienas pārlūkošanas. Tas nav vispārējs slēdzis „ignorēt sertifikātu kļūdas”: viss, ko nav parakstījusi klastera CA, joprojām tiek noraidīts.

Kad šis profils ir atvērts, https://console.harrow.example/install aizved uz pieprasīšanas lapu, un var izveidot piekļuves atslēgu. Tālākās darbības ir aprakstītas 2.12. nodaļā „Pirmā palaišana”.

Kad klēpjdators tiek restartēts

Atslēgu krātuvei ir divas daļas: pati atslēgu krātuve un neliels atplombētājs (unsealer), kas glabā tās atbloķēšanas atslēgu. Pēc jebkuras mezgla restartēšanas (Docker restartēšanas, klēpjdatora pārstartēšanas, k3d cluster stop un start) atplombētājs startē aizplombētā stāvoklī. Atslēgu krātuve atplombē sevi caur to, tāpēc, kamēr glabātājs neatplombē atplombētāju ar savu age identitāti, nekas, kam nepieciešama atslēga, nedarbojas. Tā ir arhitektūras īpašība, un produkcijas klasterī tas notiek tāpat. 2.15. nodaļā „Otrā diena: Nexus ekspluatācija” ir parādīts atplombēšanas process.

Kad esat pabeidzis novērtēšanu:

k3d cluster delete harrow-eval

Dzēšot klasteri, tiek izdzēsta instalācija un viss, kas tajā atrodas.

nexusctl kubeconfig

Klasteris, ko izveidoja nexusctl install --single-node, pieder nexusctl. Lai to sasniegtu ar kubectl, helm vai jebkuru citu rīku, pieprasiet tā kubeconfig:

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

Šis fails piešķir pilnu administratīvo piekļuvi klasterim. Glabājiet to ar piekļuves režīmu 600 to cilvēku iekārtās, kuri uztur instalāciju, un nekur citur. Katra turpmākā komanda 2. daļā, kas izmanto --context vai nolasa KUBECONFIG, darbojas ar vienu mezglu caur šo failu. Tas pats attiecas uz jaunināšanu: nexusctl upgrade plan --bundle <file> un nexusctl upgrade apply --bundle <file> uz viena mezgla jaunina arī k3s klasteri, kas pieder nexusctl.

Diagramma ir četru slāņu steks uz bloka ar uzrakstu „one Linux server”. No apakšas: „k3s v1.33.6+k3s1 (Traefik in kube-system, ports 80 and 443)”, tad „cert-manager v1.21.3 and the chart's local CA nexus-local-ca”, tad „Nexus data tier: PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS, OpenBao”, tad „Nexus services: console, sign-in, gateway, and the rest”. Pa labi trīs bultiņas no augšējā slāņa iziet no bloka ar uzrakstiem console.harrow.example, api.harrow.example un auth.harrow.example. Kreisajā pusē termināļa ikona ar uzrakstu „nexusctl kubeconfig” norāda uz k3s slāni.
Ko nexusctl install --single-node izvieto vienā Linux serverī.

Kas tiek pārnests uz klasteri

Visam, ko darījāt vienā iekārtā, ir ekvivalents klasterī. Vērtību fails ir tas pats fails ar citu reģistru, TLS režīmu vai krātuves klasi (storage class), kā parādīts 2.11. nodaļā „Variācijas: ārējās krātuves, TLS un ingress”. Pirmā palaišana ir identiska. Tas, ko nevar pārnest, ir pati instalācija: instalācijas nosaukums ir fiksēts uz visiem laikiem, un instalāciju nevar pārcelt no klēpjdatora uz serveri. Kad Tomás pārgāja no sava klēpjdatora uz pilotprojekta serveri, viņš sāka no jauna ar jaunu nosaukumu harrow-pilot, bet harrow-eval paturēja eksperimentiem.