Kirjaudu sisäänVaraa esittely

Luku 2.8

Yhden koneen asennukset

Asenna Nexus yhdelle Linux-palvelimelle nexusctl-työkalulla tai arvioi sitä kannettavalla tietokoneella k3d:n avulla, ja yhdistä konsoliin HTTPS-yhteydellä, jotta kirjautuminen ja avainkoodit toimivat.

Tämä sivu on käännetty tekoälyllä englanninkielisestä alkuperäistekstistä. Jos jokin kohta on epäselvä, englanninkielinen sivu on ensisijainen lähde. Lue tämä sivu englanniksi

18 minuutin lukuaika

Ennen kuin Harrow Port Authority otti Nexuksen käyttöön tuotantoklusterissaan, Tomás Reilly halusi kaksi pienempää asennusta. Toinen oli pilottikokeilu ylimääräisellä Linux-palvelimella toimistorakennuksessa niille kahdelletoista henkilölle, jotka kokeilisivat sitä ensin. Toinen toimi hänen omalla kannettavallaan, jotta hän voisi rikkoa asioita kenenkään huomaamatta. Tämä luku käsittelee molempia. Ne käyttävät samaa kaaviota (chart), samoja levykuvia ja samaa ensikäynnistystä kuin täysi Kubernetes-asennus, joten yhdellä koneella opittu pätee myös muualla.

Palvelinpolku on yksi komento: nexusctl install --single-node rakentaa koneelle k3s-klusterin, asentaa cert-managerin ja asentaa sen jälkeen Nexuksen. Kannettavan polku vaatii enemmän käsityötä. Rakennat itse k3d-klusterin, asennat cert-managerin ja kaavion Helmillä ja teet sitten yhden lisätyön, johon lähes jokainen kompastuu: asetat konsolin HTTPS:n taakse omalla koneellasi, koska pelkkä portin uudelleenohjaus (port-forward) ei koskaan pysty kirjaamaan ketään sisään.

Kuinka suuri koneen on oltava

Nexus pyytää kaavion oletusarvoilla varauksina noin 2.05 CPU-ydintä (central processing unit, suoritin) ja 6.7 GiB muistia, ja sen tallennustilat ovat yhteensä 142 GiB. Tämä kokonaismäärä koostuu seuraavista: PostgreSQL 50, Valkey 5, Neo4j 20, Qdrant 10, objektitallennustila 50, kaksi OpenBao-tallennustilaa 1 ja 5 sekä kuittien tallennustila 1. Pyynnöt ovat se määrä, jonka ajastin varaa, ja todellinen käyttö on suurempaa, kun ihmiset työskentelevät.

Kone CPU Muisti (RAM, random-access memory, keskusmuisti) Levy
Suositeltu yksittäinen solmu 8 vCPU 32 GiB 250 GB SSD (solid-state drive, puolijohdelevy)
Vähimmäisvaatimus arviointiin 4 vCPU 16 GiB 200 GB

Kannettava, joka täyttää arvioinnin vähimmäisvaatimukset, pystyy suorittamaan Nexuksen, mutta ratkaisevaa on Dockerin oma muistiraja, ei kannettavan. Anna Dockerille vähintään 16 GiB ennen kuin aloitat.

Molemmat polut vaativat Kubernetes 1.33:n tai uudemman. Yhden solmun polku tuo mukanaan omansa: k3s v1.33.6+k3s1, joka on se jakelu, jolla jokainen julkaisu testataan.

Osa 1: yksi Linux-palvelin ja nexusctl

Tomásin pilottipalvelin on 8-ytiminen kone, jossa on 32 GiB muistia ja 500 GB SSD, ja siinä on ajantasainen Linux, johon ei ole asennettu mitään muuta. Asennus vaatii root-oikeudet, koska se asentaa k3s:n järjestelmäpalveluna.

Hanki nexusctl ja tarkista se

  1. Lataa arkkitehtuurillesi sopiva nexusctl osoitteesta https://downloads.adverant.ai/nexus/1.0.0-alpha.1/ yhdessä julkaisun julkisen avaimen kanssa. Tallenna avain nimellä release.pub. Luku 2.4, Julkaisun hankkiminen ja vahvistaminen, selittää, kuinka avaimen sormenjälki tarkistetaan Adverantin julkaisemaa sormenjälkeä vasten.
  2. Tarkista binääritiedosto ja julkaisu avaimella:
nexusctl version --json
nexusctl verify

nexusctl verify tarkistaa latauksen Adverantin julkaisuavainta vasten ja hylkää kaiken, mitä se ei pysty vahvistamaan. Jos se epäonnistuu, lopeta ja lataa uudelleen. Älä koskaan suorita asennusta tiedostosta, jonka vahvistaminen epäonnistui.

Luo avaintenhaltijan avain

Asennuksen avainsäilö sinetöi palautusavaimensa yhdelle tai useammalle avaintenhaltijalle (custodian). Avaintenhaltija on henkilö, joka säilyttää age-identiteettitiedostoa offline-tilassa, ja kaavio kieltäytyy asentumasta ilman vähintään yhtä haltijaa. Avaintenhaltijan omalla koneella:

age-keygen -o custodian.key

Tiedosto alkaa rivillä # public key: age1.... Tämä julkinen puolisko on se, mikä laitetaan arvotiedostoon (values file). Itse identiteettitiedosto ei koskaan poistu avaintenhaltijan koneelta. Macissa, jossa on Secure Enclave, age-plugin-se keygen --access-control=any-biometry -o custodian.key luo avaimen, jonka käyttäminen vaatii Touch ID:tä, ja sen julkinen puolisko alkaa merkkijonolla age1se1.

Kirjoita arvotiedosto

# 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> on age1...-rivi tiedostosta custodian.key. Lisää listaan yksi merkintä kutakin avaintenhaltijaa kohden.

keys.installationName on pysyvä. Avainsäilön ensimmäinen käynnistys luo asennuksen identiteetin tällä nimellä, eikä mikään muuta sen nimeä sen jälkeen. Sen on vastattava lauseketta ^[a-z][a-z0-9-]{0,62}$: pienet kirjaimet, alkaa kirjaimella, enintään 63 merkkiä. Älä kopioi arvoa nexus-example tai esimerkkivastaanottajaa kaavion omista esimerkkitiedostoista. Kaavio hylkää molemmat nimen perusteella, ja esitarkistus (preflight) ilmoittaa samat koodit jo etukäteen.

Nämä kolme verkko-osoitetta muodostavat asennuksen identiteetin. Jokainen palvelu kieltäytyy käynnistymästä ilman niitä, ja jokainen sisäänkirjautuminen, eväste ja pääsyavain (passkey) on sidottu arvoon hosts.console. Valitse nimet, joita haluat käyttää vielä viidenkin vuoden kuluttua.

Ohjaa kolme nimeä palvelimelle

Käyttäjät tavoittavat konsolin, API:n (application programming interface, ohjelmointirajapinta) ja sisäänkirjautumispalvelun k3s:n sisäänrakennetun ingress-ohjaimen, Traefikin, kautta palvelimen porteissa 80 ja 443. Lisää kolme DNS-tietuetta (Domain Name System, nimipalvelujärjestelmä) osoitteille console.harrow.example, api.harrow.example ja auth.harrow.example, joista jokainen osoittaa palvelimen osoitteeseen. Esitarkistus tarkistaa jokaisen nimen ja kertoo, miltä puuttuu tietue.

Kaavion verkkokäytäntö sallii vain yhden nimiavaruuden tavoittaa nämä kolme julkista palvelua. Sen oletusarvo, kube-system, on se, missä k3s suorittaa Traefikia, joten yksittäisessä solmussa jätät asetuksen networkPolicy.ingressNamespace ennalleen.

Suorita esitarkistus ja asenna sitten

  1. Suorita esitarkistus yhden solmun valitsimella. Se lukee koneen ja arvotiedostosi eikä muuta mitään.
sudo nexusctl preflight --single-node --values harrow-pilot-values.yaml
  1. Lue lopussa oleva yhteenvetorivi. Varoitus ei koskaan estä asennusta, mutta virhe estää, ja jokaisella epäonnistuneella rivillä on fix-rivi.
 ────────────────────────────────────────────────────────────
 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. Asenna. Valitsimen --edition on täsmättävä arvotiedoston kohdan edition kanssa.
sudo nexusctl install --single-node --values harrow-pilot-values.yaml --edition community
  1. Seuraa sen etenemistä. Se suorittaa esitarkistuksen uudelleen, asentaa k3s v1.33.6+k3s1:n, asentaa cert-manager v1.21.3:n, asentaa Nexuksen ja odottaa, että jokainen palvelu vastaa terveystarkistukseensa. Tomásin palvelimella se kesti hieman alle kymmenen minuuttia.
 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

Pidä tuo sormenjälki näkyvillä näytöllä. Vertaat sitä selaimessa, kun lunastat asennuksen koodilla. Jos koodi vanhenee ennen kuin ehdit käyttää sitä, nexusctl claim-code --administrator <email> luo uuden. Luku 2.12, Ensikäynnistys, jatkaa tästä.

Asenna Community-versio
Asenna Community-versio
Community-asennus yhdelle palvelimelle sisältää latauksen, tarkistuksen, esitarkistuksen ja asennuksen sekä sen jälkeen ensimmäisen pääkäyttäjän luonnin. Lisenssivaihetta ei ole.

Aseta varmenne paikalleen

Arvolla tls.mode: existing kolme ingress-reittiä jakavat varmenteen, joka on kohdan tls.existingSecret nimeämässä Secret-objektissa. Sen on katettava kaikki kolme verkko-osoitetta. Esitarkistus lukee kyseisen Secret-objektin, kun se on olemassa, ja varoittaa, jos varmenne vanhenee 30 päivän kuluessa. Kun Secret-objektia ei vielä ole, rivi kehottaa sinua luomaan sen, ja kyseessä on varoitus, ei virhe.

Yksittäisessä solmussa klusteria ei ole olemassa ennen kuin asennus on luonut sen, joten luo Secret-objekti heti asennuksen jälkeen. Kirjoita ensin ulos klusterin kubeconfig (tämän luvun viimeinen osio selittää sen) ja luo sitten Secret-objekti sen avulla:

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 sisältää varmenteen sekä mahdolliset välivarmenteet ja harrow-public.key sen yksityisen avaimen. Jos varmenteesi tulevat yksityiseltä CA:lta (certificate authority, varmentaja), nexusctl preflight ja nexusctl install ottavat valitsimen --ca-bundle <file>, jotta ne voivat tarkistaa ketjun. Muut tavat käsitellä TLS:ää (Transport Layer Security) ovat luvussa 2.11, Variaatiot: ulkoiset tallennustilat, TLS ja ingress.

Jos tämä epäonnistuu

Mitä näette Mitä se tarkoittaa Mitä tehdä
PREFLIGHT_FAILED (409) Esitarkistus löysi virheen, joten asennus ei käynnistynyt. Mitään ei asennettu. Korjaa jokainen epäonnistunut rivi sen fix-rivin avulla ja suorita asennus uudelleen.
INSTALLATION_NAME_MISSING keys.installationName on tyhjä. Aseta asennuksen oma pysyvä nimi.
INSTALLATION_NAME_EXAMPLE Nimi on peräisin kaavion esimerkkiarvoista. Valitse oma nimesi.
KEYS_CUSTODIAN_MISSING keys.custody.recipients on tyhjä. Lisää jokaisen avaintenhaltijan julkinen age1...-vastaanottaja.
KEYS_CUSTODIAN_EXAMPLE Vastaanottaja on kaavion esimerkkiavaintenhaltija, jonka identiteettiä ei ole kenelläkään. Korvaa se omien avaintenhaltijoidesi vastaanottajilla.

nexusctl poistuu paluuarvolla 0, kun se voi jatkaa, arvolla 1, kun tarkistus esti sen, ja arvolla 2, kun sitä ei voitu suorittaa lainkaan (lukukelvoton arvotiedosto, väärä valitsin). Komentosarja voi haarautua näiden kolmen perusteella.

Osa 2: arviointi kannettavalla tietokoneella ja k3d

k3d suorittaa k3s:ää Docker-säiliöiden sisällä, joten kokonainen klusteri elää kannettavalla ja katoaa yhdellä komennolla. Julkaisutyökalut, jotka testaavat jokaisen Nexus-julkaisun, rakentavat klusterinsa täsmälleen tällä tavalla, ja niiden asetusten kopioiminen säästää sinut löytämästä uudelleen niitä ongelmia, jotka ne ovat jo kohdanneet.

Tarvitset Dockerin, k3d 5.8.3:n, kubectl-työkalun, Helm v4:n ja Chromen. Tomás käytti Maciaan.

Luo klusteri

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

Jokaisella valitsimella on syynsä.

  • --agents 0 antaa yhden palvelinsolmun eikä yhtään työsolmua. Nexus toimii mainiosti yhdessä solmussa, ja toinen vain kuluttaa muistia.
  • --image rancher/k3s:v1.33.6-k3s1 lukitsee k3s-version, jolla jokainen julkaisu testataan. Ilman sitä saat sen, mitä k3d oletuksena käyttää.
  • --disable=traefik@server:0 jättää Traefikin pois. Kannettavalla ei ole julkista osoitetta palveltavaksi, ja tavoitat konsolin sen sijaan oman HTTPS-edustapalvelimesi kautta (alla).
  • --wait --timeout 300s palaa vasta, kun klusteri vastaa, tai epäonnistuu viiden minuutin kuluttua.

Jos peilaat julkaisurekisterin kannettavallesi, lisää --registry-config <registries.yaml> ohjataksesi levykuvien noudot peilipalvelimelle ja --k3s-arg "--disable-default-registry-endpoint@server:0", jotta mikään ei palaudu hakemaan ylävirran rekisteristä. Julkaisutyökalut toimivat tällä tavalla, jolloin jokainen levykuva tulee vain peilipalvelimen kautta.

Asenna cert-manager

Kaavio tekee oman paikallisen CA:nsa, nexus-local-ca, cert-manager-myöntäjänä, ja jokainen palvelu saa varmenteensa siltä. Ilman cert-managerin resursseja klusterissa helm install hylkää kaavion muutamassa sekunnissa. Asenna ensin cert-manager v1.21.3 cert-manager-projektin julkaisemasta kaaviosta:

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

Nexus ei tarvitse cert-managerilta mitään muuta, eikä varsinkaan trust-manageria.

Asenna Nexus

  1. Kirjoita arvotiedosto kannettavaa varten. TLS päättyy omaan edustapalvelimeesi, joten tls.mode on 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. Asenna kaavio rekisteristä ja jätä --wait pois (alla oleva varoitus kertoo miksi).
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. Odota sitten työkuormia itse:
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-silmukka on mukana siksi, että jotkin niistä päivittävät yhden podin kerrallaan pyynnöstä, ja kubectl rollout status hylkää ne. Kohdan readyReplicas odottaminen toimii jokaisella päivitysstrategialla.

Kun molemmat komennot palaavat, jokainen Deployment on tilassa Available ja jokaisen StatefulSetin podit ovat valmiina. Kukaan ei voi vielä kirjautua sisään. Tämä kuuluu asiaan: asennusta ei ole vielä lunastettu.

Miksi portinohjauksella (port-forward) ei voi koskaan kirjautua sisään

Ilmeinen seuraava siirto on kubectl port-forward svc/nexus-alpha 3000:3000 ja selain osoitteeseen http://127.0.0.1:3000. Konsolin sivut latautuvat, joten se näyttää toimivan. Se ei kuitenkaan toimi, eikä mikään asetus saa sitä toimimaan. Tiellä on kolme asiaa, jokainen tarkoituksella.

Mikä sen estää Miksi
Alkuperä (origin) Konsolin sisäänkirjautuminen hylkää pyynnön, jonka alkuperä ei ole https://<hosts.console>, tässä https://console.harrow.example. Osoitteesta http://127.0.0.1:3000 jaetulla sivulla on väärä alkuperä, joten sisäänkirjautuminen ei koskaan käynnisty.
Eväste Istunto on __Host--eväste, joka on merkitty määritteellä Secure. Selaimet tallentavat tällaisen evästeen vain HTTPS:n yli, ilman domain-attribuuttia, täsmälleen sille verkko-osoitteelle, joka sen asetti. Tavallisen HTTP:n yli selain heittää sen pois.
Pääsyavain (passkey) Ensimmäinen pääkäyttäjä kirjautuu sisään pääsyavaimella, ja pääsyavain vaatii suojatun kontekstin sekä kelvollisen varmenteen. Chrome kieltäytyy luomasta pääsyavainta varmennevaroituksen takana, vaikka olisitkin ohittanut sen napsauttamalla.

Selaimen on siis keskusteltava osoitteen https://console.harrow.example kanssa varmenteella, johon se luottaa, ja kyseisen nimen on johdettava kannettavallesi.

Yhdistäminen konsoliin HTTPS-yhteydellä kannettavalla tietokoneellasi

Alla oleva menetelmä käyttää kaavion omaa CA:ta varmenteen myöntämiseen, portin uudelleenohjausta konsolin tavoittamiseen ja erillistä Chrome-profiilia, joka luottaa tuohon yhteen CA:han ja yhdistää konsolin nimen kannettavaasi. Järjestelmäsi luottamussäilö ja /etc/hosts pysyvät ennallaan.

Kaaviossa vasemmalla on Chrome, jossa on teksti "erillinen profiili: luottaa vain nexus-local-ca:han; console.harrow.example:443 yhdistetty osoitteeseen 127.0.0.1:28443". Nuoli, jossa on teksti "HTTPS", menee laatikkoon "HTTPS-edustapalvelin osoitteessa 127.0.0.1:28443 (varmenne nexus-local-ca:lta)". Nuoli, jossa on teksti "HTTP, Host säilytetty, X-Forwarded-Proto https", menee laatikkoon "kubectl port-forward 127.0.0.1:3000", ja viimeinen nuoli menee k3d-klusterilaatikon sisään kohtaan "Service nexus-alpha, portti http (3000)". Katkoviiva klusterin sisällä olevasta cert-managerista edustapalvelinlaatikkoon on nimetty "myöntää varmenteen".
Kuinka kannettavan selain tavoittaa k3d-klusterissa olevan konsolin HTTPS:n yli.

Myönnä varmenne konsolin nimelle

  1. Pyydä cert-managerilta varmennetta konsolin verkko-osoitteelle, kaavion myöntäjän allekirjoittamana:
# 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 allekirjoittaa sen klusterin sisällä. Et koskaan lue CA:n yksityistä avainta.

  1. Kopioi varmenne, sen avain ja CA-varmenne ulos Secret-objektista:
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. Selvitä CA:n kiinnitystunniste (pin). Chrome tunnistaa luotetun avaimen sen julkisen avaimen base64-muotoisesta SHA-256-tiivisteestä:
openssl x509 -in ca.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl dgst -sha256 -binary | base64

Kiinnitä CA:n avain, älä varmenteen. Varmenne on voimassa päivän ja saa uuden avaimen joka kerta, kun cert-manager uusii sen, kun taas CA pysyy samana.

Aseta HTTPS-edustapalvelin portin uudelleenohjauksen eteen

  1. Ohjaa konsolin Service-objektin portti eteenpäin. Sen portti on nimeltään http, joka on tässä julkaisussa 3000:
kubectl -n nexus port-forward svc/nexus-alpha 3000:3000
  1. Suorita HTTPS-kuuntelija osoitteessa 127.0.0.1:28443, joka ohjaa liikenteen edelleen osoitteeseen 127.0.0.1:3000. Mikä tahansa käänteinen välityspalvelin (reverse proxy), johon jo luotat, käy, kunhan se tekee neljä asiaa:
    • jakaa ketjuna tiedoston tls.crt ja sen perään tiedoston ca.crt, avaimella tls.key;
    • säilyttää Host-otsakkeen arvona console.harrow.example;
    • asettaa otsakkeen X-Forwarded-Proto: https;
    • päästää WebSocket-päivitykset läpi, koska konsoli käyttää niitä.

Portin uudelleenohjaus Service-objektiin sitoo sen yhden podin, jonka se valitsi käynnistyessään. Kun päivitys tai uudelleenkäynnistys korvaa konsolipodin, uudelleenohjaus pysyy päällä mutta ei ohjaa mihinkään, ja selain näyttää bad gateway -virheen. Käynnistä portin uudelleenohjaus uudelleen aina, kun konsolipodi vaihtuu.

Avaa Chrome kiinnitystunnisteen ja nimikartoituksen kanssa

Macissa:

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> on openssl-rivin tuloste. Linuxissa käynnistä Chrome samoilla kolmella valitsimella.

Nämä kolme valitsinta toimivat yhdessä. --host-resolver-rules lähettää osoitteen console.harrow.example portissa 443 edustapalvelimellesi, vain tämän profiilin sisällä. --ignore-certificate-errors-spki-list luottaa tuon yhden CA-avaimen myöntämiin varmenteisiin, ja Chrome noudattaa sitä vain valitsimen --user-data-dir kanssa. Erillinen profiili pitää poikkeuksen erillään päivittäisestä selailustasi. Se ei ole yleinen "ohita varmennevirheet" -kytkin: kaikki, mitä ei ole allekirjoitettu klusterin CA:lla, epäonnistuu edelleen.

Kun kyseinen profiili on avoinna, https://console.harrow.example/install johtaa lunastussivulle, ja pääsyavain voidaan luoda. Luku 2.12, Ensikäynnistys, jatkaa tästä.

Kun kannettava käynnistyy uudelleen

Avainsäilössä on kaksi osaa: itse avainsäilö ja pieni sinetinavaaja (unsealer), joka pitää hallussaan sen avausavainta. Minkä tahansa solmun uudelleenkäynnistyksen jälkeen (Dockerin uudelleenkäynnistys, kannettavan uudelleenkäynnistys, k3d cluster stop ja start) sinetinavaaja käynnistyy sinetöitynä. Avainsäilö avaa oman sinettinsä sen kautta, joten ennen kuin avaintenhaltija avaa sinetinavaajan omalla age-identiteetillään, mikään avainta tarvitseva ei toimi. Tämä on suunnitteluominaisuus, ja se toimii samoin tuotantoklusterissa. Luku 2.15, Toinen päivä: Nexuksen ylläpito, näyttää sinetin avaamisen.

Kun olet saanut arvioinnin päätökseen:

k3d cluster delete harrow-eval

Klusterin poistaminen poistaa asennuksen ja kaiken sen sisällön.

nexusctl kubeconfig

Klusteri, jonka nexusctl install --single-node rakensi, kuuluu käyttäjälle nexusctl. Jotta voit tavoittaa sen komennolla kubectl, helm tai millä tahansa muulla työkalulla, pyydä sen kubeconfig:

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

Tiedosto myöntää täydet pääkäyttäjän oikeudet klusteriin. Pidä se tilassa 600 niiden henkilöiden koneilla, jotka ylläpitävät asennusta, äläkä missään muualla. Jokainen osan 2 myöhempi komento, joka ottaa valitsimen --context tai lukee muuttujan KUBECONFIG, toimii yksittäistä solmua vasten tämän tiedoston kautta. Sama pätee päivitykseen: nexusctl upgrade plan --bundle <file> ja nexusctl upgrade apply --bundle <file> yksittäisessä solmussa päivittävät myös k3s-klusterin, jonka nexusctl omistaa.

Kaavio on neljän kerroksen pino laatikossa, joka on nimetty "yksi Linux-palvelin". Alhaalta lukien: "k3s v1.33.6+k3s1 (Traefik kube-system-nimiavaruudessa, portit 80 ja 443)", sitten "cert-manager v1.21.3 ja kaavion paikallinen CA nexus-local-ca", sitten "Nexuksen tietokerros: PostgreSQL, Valkey, Neo4j, Qdrant, SeaweedFS, OpenBao", sitten "Nexus-palvelut: konsoli, sisäänkirjautuminen, yhdyskäytävä ja muut". Oikealla kolme nuolta ylimmästä kerroksesta lähtee laatikosta nimillä console.harrow.example, api.harrow.example ja auth.harrow.example. Vasemmalla päätekuvake, jossa on teksti "nexusctl kubeconfig", osoittaa k3s-kerrokseen.
Mitä nexusctl install --single-node asettaa yhdelle Linux-palvelimelle.

Mikä siirtyy klusteriin

Kaikella, mitä teit yhdellä koneella, on vastineensa klusterissa. Arvotiedosto on sama tiedosto eri rekisterillä, TLS-tilalla tai tallennusluokalla, kuten luku 2.11, Variaatiot: ulkoiset tallennustilat, TLS ja ingress, osoittaa. Ensikäynnistys on identtinen. Se, mikä ei siirry, on itse asennus: asennuksen nimi on kiinnitetty pysyvästi, eikä asennusta voi siirtää kannettavalta palvelimelle. Kun Tomás siirtyi kannettavaltaan pilottipalvelimelle, hän aloitti alusta uudella nimellä, harrow-pilot, ja piti nimen harrow-eval kokeiluja varten.