Kirjaudu sisäänVaraa esittely

Luku 2.6

Community-version asentaminen Kubernetesiin

Community-version vaiheittainen asennus Helmillä aina cert-managerista siihen, kunnes jokainen työkuorma on valmis. Sisältää values-tiedoston selityksen avain avaimelta, miksi --wait-valitsinta ei käytetä, järjestyksen jossa kaavion koukut (hooks) ajetaan sekä vaihtoehtoisen nexusctl install -asennustavan.

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

Itse asennus on yksi helm install-komento. Kaikki sen ympärillä on olemassa siksi, että tämä yksi komento toimii ensimmäisellä yrittämällä: cert-manager ennen sitä, rivi riviltä luettu values-tiedosto ja lopuksi odotusvaihe, joka tietää, mitä sen pitää odottaa. Harrow Port Authoritylla asensimme ensin Community-version kuuden viikon pilottia varten kolmen solmun k3s-klusteriin, jonka määrittelimme suunnittelulomakkeellamme. Julkaisu oli käynnissä noin kahdessakymmenessä minuutissa, eikä kukaan voinut kirjautua sisään ennen kuin olimme lunastaneet sen käyttöömme – juuri niin kuin pitääkin.

Tässä luvussa oletetaan, että olet jo tehnyt kolme asiaa: käynyt läpi suunnittelulomakkeen (luku 2.3, Asennuksen suunnittelu), noutanut ja tarkistanut julkaisun (luku 2.4, Julkaisun noutaminen ja vahvistaminen) sekä ajanut esitarkistuksen (luku 2.5, Esitarkistus nexusctl-työkalulla). Jos jokin näistä on vielä kesken, palaa takaisin. Asennus hylkää useimmat virheet nimeltä mainiten, mutta muutamia asioita, kuten avainhenkilöä, jonka avaimen olet jo kadottanut, se ei voi havaita.

Vaihe 1: varmistakaa työkalut ja konteksti

  1. Tarkista, että Helm on versiota 4.

    helm version

    Asennus luottaa siihen, että Helm 4 odottaa oletusarvoisesti kaavion hook-tyyppisiä Job-ajoja. Käytimme versiota v4.3.1.

  2. Osoita kubectl suunnittelulomakkeesi klusteriin ja varmista yhteys.

    kubectl config use-context harrow-prod
    kubectl get nodes

    Jokaisen solmun tilana tulisi näkyä Ready. Esitarkistus tarkisti tämän jo, mutta solmu voi pudota pois esitarkistuksen ja asennuksen välillä, ja asia on nopeampi nähdä tässä.

Vaihe 2: asentakaa cert-manager ensin

Kaavio luo oman paikallisen varmentajansa (CA) cert-managerin avulla, ja jokainen palvelu keskustelee toisten kanssa sen myöntämillä varmenteilla: käytössä on itse allekirjoitettu Issuer, kymmenen vuoden paikallinen CA-varmenne ja lyhytikäiset varmenteet palveluille. Tämän vuoksi cert-managerin on oltava käynnissä ennen Nexusta. Julkaisu vaatii version v1.21.3, eikä se tarvitse trust-manageria.

  1. Asenna cert-manager sen omasta kaaviosta mukautettuine resursseineen:

    helm install cert-manager <cert-manager-chart> -n cert-manager --create-namespace \
      --set crds.enabled=true --wait --timeout 10m

    <cert-manager-chart> on cert-managerin v1.21.3-kaavio cert-manager-projektin omasta julkaisusta. Odotuskomento on tässä paikallaan; kyseessä on cert-managerin oma asennus, jossa ei ole muista resursseista riippuvia hook-toimintoja.

  2. Odota sen webhookia, jonka kautta jokainen varmennepyyntö kulkee:

    kubectl -n cert-manager rollout status deploy/cert-manager-webhook --timeout=300s
    deployment "cert-manager-webhook" successfully rolled out

Vaihe 3: luokaa nimiavaruus ja TLS Secret

Kun käytössä on tls.mode: existing, kaavio odottaa, että varmenteesi on Kubernetesin Secret-resurssina nimiavaruudessa ennen asennusta. Kaikkien kolmen osoitteen TLS-salaus (Transport Layer Security) tulee tästä yhdestä Secret-resurssista, joten sen varmenteen on nimettävä kaikki kolme verkko-osoitetta.

kubectl create namespace nexus
kubectl -n nexus create secret tls harrow-public-tls \
  --cert=harrow-public.crt --key=harrow-public.key

harrow-public.crt on varmenne ketjuineen ja harrow-public.key on sen yksityinen avain. Jos valitsit vaihtoehdon tls.mode: cert-manager tai none kohdassa luku 2.3, Asennuksen suunnittelu, ohita Secret-resurssin luonti; voit silti luoda nimiavaruuden nyt tai antaa Helmin tehdä sen valitsimella --create-namespace vaiheessa 6.

Vaihe 4: kirjoittakaa values-tiedosto

Tämä on Harrow'n pilottia varten luotu values-tiedosto. Jokainen siinä oleva avain on kaavion skeeman hyväksymä; skeema hylkää kaikki muut, joten väärin kirjoitettu avain keskeyttää asennuksen sen sijaan, että se ohitettaisiin hiljaisesti.

# harrow-values.yaml (Helm values, Community)
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
ingress:
  className: traefik
storage:
  className: local-path
networkPolicy:
  ingressNamespace: kube-system
  externalEgressCIDRs: ["10.20.9.25/32"]
keys:
  installationName: harrow-port-authority
  custody:
    recipients:
      - "<recipient-aoife>"
      - "<recipient-tomas>"
      - "<recipient-safe-laptop>"

Jokainen <recipient-...> on yhden avainhenkilön julkinen age-vastaanottajatieto, eli age1...- tai age1se1...-rivi, jonka hän lähetti sinulle. Tässä ovat kaikki asettamamme avaimet ja syyt niiden käyttöön.

global.imageRegistry on rekisteri, josta solmusi noutavat levykuvat. Kaaviolla ei ole oletusarvoa; se muodostaa jokaisen levykuvan muodossa <this>/nexus/<service>@<digest>. Verkkoyhteydellisessä asennuksessa arvo on registry.adverant.ai. Jos kopioit levykuvat omaan rekisteriisi, arvo on kyseisen rekisterin osoite.

global.domain on verkkotunnus, jonka alle kolme osoitetta sijoittuvat.

hosts.console, hosts.api ja hosts.auth muodostavat asennuksen identiteetin: ne kolme nimeä, joita ihmiset ja ohjelmat käyttävät. Jokaisen niistä on jo ratkettava nimipalvelussa (DNS), minkä esitarkistus varmisti.

Arvojen edition ja enterprise.enabled on täsmättävä keskenään: community ja false tai enterprise ja true. Kaavio hylkää kaikki muut yhdistelmät, ja se hylkää version, jolle sen levykuvalukitusta ei ole tehty.

tls.mode ja tls.existingSecret valitsevat, miten julkinen reunaverkko saa varmenteensa. Arvon cert-manager kanssa asettaisit sen sijaan avaimen tls.clusterIssuer, ja arvon none kanssa et kumpaakaan.

ingress.className nimeää ingress-luokan. Jätä se tyhjäksi, jos haluat käyttää klusterin oletusluokkaa.

storage.className nimeää tallennusluokan jokaiselle tietaltiolle. Jätä se tyhjäksi käyttääksesi oletusta.

networkPolicy.ingressNamespace on nimiavaruus, jossa ingress-ohjaimesi ajetaan. Oletusarvo, kube-system, on oikea k3s:n Traefikille; asetimme sen silti, jotta se käy tiedostosta selvästi ilmi.

networkPolicy.externalEgressCIDRs luettelee nimiavaruuden ulkopuoliset osoitealueet CIDR-muodossa (Classless Inter-Domain Routing), joihin palvelut saavat ottaa yhteyttä DNS:n ja Kubernetesin ohjelmointirajapintapalvelimen (API) lisäksi. Meidän listamme sisältää sähköpostivälittäjän yksittäisen osoitteen; jos lista on tyhjä, mihinkään nimiavaruuden ulkopuolelle ei saa yhteyttä.

keys.installationName on pysyvä nimi, jonka alle avainsäilö luo asennuksen identiteetin.

keys.custody.recipients luettelee avainhenkilöiden julkiset age-vastaanottajatiedot. Avaintenhallinnan Job-ajo salaa jokaisen avausosuuden ja palautusavaimen kullekin heistä.

Avaimet, joita saatat tarvita, ja avaimet, joihin ei pidä koskea

Avain Milloin asetetaan
networkPolicy.apiServerCIDRs Kun kaavio ei pysty lukemaan API-palvelimen osoitteita kubernetes-päätepisteistä (Endpoints). Anna ne /32-osoitealueina
proxy.trustedCIDRs Kun ingress-ohjaimesi podit eivät ole k3s:n verkossa 10.42.0.0/16
ai.localProvider.baseUrl Kun organisaatio ajaa omaa OpenAI-yhteensopivaa tekoälymallipalvelintaan (luku 2.14, Tekoälypalveluntarjoajat ja -mallit)
ai.installationHosts Kun kyseinen mallipalvelin käyttää yksityisiä nimiä asennuksen sisällä
dataTier.<store>.size Kun tietovarasto tarvitsee oletuslevytilaansa suuremman taltion
dataTier.<store>.mode external tietovarastolle, jota ylläpidät itse (luku 2.11, Muunnelmat: ulkoiset tietovarastot, TLS ja ingress)
components.<service>.replicas, components.<service>.resources Kun kasvatat palvelun mitoitusta
auth.rateLimitPerMinute Kun raskas automaatio vaatii yli 5 000 pyyntöä minuutissa henkilöä kohden
schemaWait.timeoutSeconds Kun hidas levy saa ensimmäiset migraatiot kestämään yli 30 minuuttia

Jätä istio.enabled arvoon false; Nexus ei tarvitse palveluverkkoa (service mesh). Jätä telemetry.enabled arvoon false; skeema ei hyväksy muuta arvoa. Jätä orchestrator.platformServiceUserId ja probitas.flags kaavion asettamiin arvoihin.

Mikään tunnistetieto ei ole koskaan kaavion arvo. Mallipalveluntarjoajan API-avaimelle, sähköpostin salasanalle tai noutopoleteille ei ole omaa avainta. Palvelut luovat omat sisäiset salaisuutensa asennuksen yhteydessä ja säilyttävät ne päivityksissä, ja kunkin organisaation malliavaimet lisätään sen omaan avainvarantoon konsolin kautta ensimmäisen käyttökerran jälkeen.

Vaihe 5: ajakaa esitarkistus lopullista tiedostoa vasten

nexusctl preflight --context harrow-prod --values harrow-values.yaml

Ajon on päätyttävä tulokseen 0 failed. Luku 2.5, Esitarkistus nexusctl-työkalulla, selittää jokaisen rivin. Jos muutit jotain edellisen ajon jälkeen, edes kokomääritystä, aja se uudelleen.

Vaihe 6: asentakaa ilman --wait-valitsinta

helm install nexus oci://registry.adverant.ai/nexus/charts/nexus --version 1.0.0-alpha.1 \
  --namespace nexus -f harrow-values.yaml --timeout 45m

Jos et luonut nimiavaruutta vaiheessa 3, lisää valitsin --create-namespace. Jos asennat lataamastasi ja tarkistamastasi kaaviotiedostosta, laita sen polku viittauksen oci:// tilalle.

Älä lisää valitsinta --wait. Kaavion tietokannan alustus ajetaan post-install-tyyppisenä hook-toimintona sen jälkeen, kun julkaisun omat resurssit ovat olemassa, ja juuri tämä hook antaa kullekin palvelulle sen tietokantaroolin ja salasanan. --wait pidättelisi asennusta, kunnes jokainen Deployment on tilassa Available, eikä mikään Deployment voi tulla tilaan Available ennen kuin sen odottama hook on ajettu. Palvelut jäävät odottamaan hyläten tietokantakirjautumisensa, ja Helm odottaa niitä aikakatkaisuun asti. Ilman valitsinta --wait Helm 4 odottaa silti jokaista hook-tyyppistä Job-ajoa järjestyksessä, ja juuri sitä odotusta haluat.

Kun viimeinen hook on valmis, Helm tulostaa yhteenvedon:

NAME: nexus
NAMESPACE: nexus
STATUS: deployed
REVISION: 1

STATUS: deployed tarkoittaa, että jokainen hook onnistui. Se ei vielä tarkoita, että jokainen palvelu on valmiina palvelemaan; vaihe 7 odottaa sitä.

Mitä ajetaan ja missä järjestyksessä

Helm ajaa hook-toiminnot painoarvon (weight) mukaan, pienin ensin, ja odottaa kunkin valmistumista ennen seuraavaa. Jokaisella migraation Job-ajolla on asetus backoffLimit: 0: epäonnistunut migraatio keskeyttää asennuksen, eikä sitä koskaan yritetä uudelleen selkäsi takana. Onnistunut Job poistetaan; epäonnistunut Job jää lokeineen paikalleen luettavaksesi.

Painoarvo Koukku Mitä se tekee
-30 Esivaatimukset Hook-tili nexus-migrations, vain hookien käyttämä Secret nexus-migrations-env, joka sisältää luodut tietokantatunnukset, sekä avaintenhallinnan Job-ajon tili, rooli, määritykset ja varmenne
-20 nexus-db-bootstrap Luo tietokannat ja roolit, joista mikään ei ole pääkäyttäjä (superuser) eikä mikään voi ohittaa rivitason tietoturvaa (RLS); lisää laajennukset, muun muassa PostGIS ja pgvector; luo julkaisukirjanpidon (release ledger)
-15 nexus-openbao-custody-init Alustaa avainsäilön ja sen avaajan (unsealer), salaa osuudet ja palautusavaimet avainhenkilöillesi, peruuttaa molemmat pääkäyttäjän valtuusavaimet (root tokens) ja luo asennuksen identiteetin nimen keys.installationName alle
-12 nexus-graphrag-migrations Asettaa graafipalvelun skeeman ensin, koska kirjautumispalvelun skeema viittaa sen omistamiin objekteihin
-10 nexus-auth-migrations Asettaa kirjautumispalvelun skeeman ja sen kaksi ajonaikaista roolia
-5 nexus-orchestrator-migrations, nexus-gateway-migrations, nexus-probitas-migrations Kunkin palvelun oma skeema; probitas ajetaan auth-palvelun jälkeen, koska se tarkistaa ensin auth-palvelun taulut
0 nexus-alpha-bff-migrations Valmistelee BFF-tietokannan (backend for frontend) ja sen roolit, ja vie sitten sen migraatiot

Jokainen migraatio-hook päättyy kirjoittamalla yhden rivin julkaisukirjanpitoon, tauluun nexus_release.schema_applied: oman ketjunsa nimen ja sen ajaneen levykuvan tiivisteen (digest). Se kirjoittaa kyseisen rivin vasta, kun sen migraatioajuri on suorittanut ajon loppuun ilman virheitä. Alustuksen Job-ajo tulostaa db-bootstrap: done; SQL-migraatioiden hookit tulostavat viimeisenä rivinään schema-ledger: recorded <chain> for this release's image. Konsolin oma migraatio-hook, nexus-alpha-bff-migrations, kirjaa rivinsä samalla tavalla ja tulostaa sitten bff-migrate: done.

Vaakasuuntainen aikajana vasemmalta oikealle, otsikoitu "helm install". Ylemmällä radalla on seitsemän hook-laatikkoa järjestyksessä: "-30 prerequisites", "-20 db-bootstrap", "-15 custody init", "-12 graphrag migrations", "-10 auth migrations", "-5 orchestrator, gateway, probitas migrations", "0 BFF migrations". Jokaisesta migraatiolaatikosta lähtee pieni nuoli alaspäin keskimmäisellä radalla olevaan sylinteriin, jonka otsikko on "release ledger: nexus_release.schema_applied". Alemmalla radalla on vasemmalta alkava pitkä palkki, jonka otsikko on "Deployments start, wait-for-schema holds each pod"; siitä nousee lyhyitä pystysuoria nuolia julkaisukirjanpitoon, ja jokaisen Deploymentin palkki muuttuu yhtenäiseksi, kun sen oma kirjanpitorivi ilmestyy.
Uuden asennuksen järjestys, jossa hookit ja työkuormat näkyvät rinnakkain.

Miten palvelut odottavat skeemaansa

Deployment-resurssit käynnistyvät heti, kun Helm luo ne, samalla kun hookit ovat vielä ajossa. Palvelu, joka käynnistyisi vasten tietokantaa, jolla ei ole roolia, salasanaa tai skeemaa, kaatuisi ja käynnistyisi uudelleen, kunnes hookit valmistuvat. Siksi jokainen tietokantaa käyttävä Deployment sisältää alustuskontin (init container), wait-for-schema, joka sen sijaan pidättelee podia.

Se lukee julkaisukirjanpitoa tunnuksella nexus_ledger_reader, joka voi lukea vain kyseistä taulua eikä mitään muuta, ja odottaa, kunnes kirjanpito näyttää sen ketjut tämän julkaisun levykuvatiivisteille. Se tekee kyselyn schemaWait.intervalSeconds sekunnin välein (oletuksena 3), tulostaa tilansa sen muuttuessa sekä joka kahdennellakymmenennellä kyselyllä, ja luovuttaa schemaWait.timeoutSeconds sekunnin jälkeen (oletuksena 1 800) antaen virheen, joka nimeää kyseisen palvelun.

Käyttöönotto Mitä odottaa
nexus-auth nexus-auth-migrations
nexus-orchestrator, nexus-workflows nexus-orchestrator-migrations
nexus-gateway nexus-gateway-migrations
nexus-graphrag nexus-graphrag-migrations
nexus-probitas nexus-probitas-migrations
nexus-skills-engine nexus-db-bootstrap
nexus-alpha-bff nexus-alpha-bff-migrations

Voit seurata yksittäisen palvelun odotusta reaaliajassa lukemalla sen alustuskontin lokia:

kubectl -n nexus logs deploy/nexus-auth -c wait-for-schema
wait-for-schema: nexus-auth waits for nexus_release.schema_applied (read as nexus_ledger_reader) to show: nexus-auth-migrations; gives up after 1800s
wait-for-schema: ready after 212s: the release ledger shows nexus-auth-migrations

Koska odotus perustuu levykuvan tiivisteeseen eikä tiedostojen lukumäärään, myöhemmän päivityksen podit odottavat uuden julkaisun rivejä, ja pelkän values-muutoksen jälkeen uudelleenkäynnistyvä pod löytää rivinsä välittömästi.

Vaihe 7: odottakaa jokaista työkuormaa

Odota Deployment-resursseja aikarajalla:

kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900s
deployment.apps/nexus-alpha condition met
deployment.apps/nexus-alpha-bff condition met
deployment.apps/nexus-auth condition met
deployment.apps/nexus-gateway condition met
deployment.apps/nexus-graphrag condition met
deployment.apps/nexus-keys condition met
deployment.apps/nexus-orchestrator condition met
deployment.apps/nexus-probitas condition met
deployment.apps/nexus-skills-engine condition met
deployment.apps/nexus-workflows condition met

Seuraavaksi StatefulSet-resurssit. Kaksi avainsäilöpalvelinta päivittyvät vain, kun poistat niiden podit, ja kubectl rollout status hylkää kyseisen päivitysstrategian, joten odota sen sijaan valmiiden podien lukumäärää:

for s in $(kubectl -n nexus get statefulset -o name); do
  kubectl -n nexus wait "$s" --for=jsonpath='{.status.readyReplicas}'=1 --timeout=900s
done

Jokainen tulostaa condition met. Meidän klusterissamme molemmat odotukset yhteensä veivät alle viisi minuuttia sen jälkeen, kun Helm oli palauttanut ohjauksen.

Miltä valmis tila näyttää

kubectl -n nexus get deploy,statefulset
NAME                                  READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/nexus-alpha           1/1     1            1           14m
deployment.apps/nexus-alpha-bff       1/1     1            1           14m
deployment.apps/nexus-auth            1/1     1            1           14m
deployment.apps/nexus-gateway         1/1     1            1           14m
deployment.apps/nexus-graphrag        1/1     1            1           14m
deployment.apps/nexus-keys            1/1     1            1           14m
deployment.apps/nexus-orchestrator    1/1     1            1           14m
deployment.apps/nexus-probitas        1/1     1            1           14m
deployment.apps/nexus-skills-engine   1/1     1            1           14m
deployment.apps/nexus-workflows       1/1     1            1           14m

NAME                                READY   AGE
statefulset.apps/nexus-neo4j        1/1     14m
statefulset.apps/nexus-postgres     1/1     14m
statefulset.apps/nexus-qdrant       1/1     14m
statefulset.apps/nexus-seaweedfs    1/1     14m
statefulset.apps/nexus-valkey       1/1     14m
statefulset.apps/openbao            1/1     14m
statefulset.apps/openbao-unsealer   1/1     14m

Kymmenen Deployment-resurssia ja seitsemän StatefulSet-resurssia, jokainen valmiina. Niiden rinnalta löydät kolme CronJob-resurssia, nexus-keys-rotate-epoch, nexus-keys-run-schedule ja nexus-keys-export-receipts, jotka huolehtivat avainpalvelun öisestä ylläpidosta. Komennon kubectl -n nexus get jobs ei pitäisi näyttää yhtäkään hook-tyyppistä Job-ajoa: onnistuneet ajot poistettiin.

Ennen kuin poistut päätteeltä, kannattaa tehdä kaksi asiaa. Tallenna values-tiedosto versionhallintaan, jossa tiimisi säilyttää määrityksiä; jokainen päivitys lähtee liikkeelle siitä. Jätä myös Secret nexus-generated rauhaan. Kaavio luo sisäiset salasanat ja avaimet kerran asennuksen yhteydessä, säilyttää ne siellä ja lukee ne sieltä jokaisen päivityksen yhteydessä, joten sen poistaminen estäisi palveluita pääsemästä käsiksi omiin tietoihinsa.

Valmis tarkoittaa, että alusta on käynnissä ja lunastamaton. Avaa https://console.harrow.example, niin päädyt asennusohjelmaan kirjautumissivun sijaan: kukaan ei voi kirjautua sisään ennen kuin joku lunastaa asennuksen. Se tapahtuu ensimmäisellä käyttökerralla, jota käsitellään kohdassa luku 2.12, Ensimmäinen käyttökerta.

Tämä asennus (Community)
Tämä asennus (Community)
Community-asennuksen oma sivu lunastamisen jälkeen: ajossa oleva versio, moottorin tila, levyn käyttö, varmuuskopiot ja tietoturvakorjausten lupaus sekä Enterprise-osat näytettyinä esittelyinä, joissa kerrotaan, kuka voi kytkeä ne päälle.

Jos tämä epäonnistuu

Useimmat virheet kertovat itse syynsä. Lue viesti ennen kuin muutat mitään.

Mitä näette Syy Mitä tehdä
INSTALLATION_NAME_MISSING tai INSTALLATION_NAME_EXAMPLE keys.installationName on tyhjä tai esimerkin arvo Aseta oma pysyvä nimesi
KEYS_CUSTODIAN_MISSING tai KEYS_CUSTODIAN_EXAMPLE Ei avainhenkilöitä tai käytössä on esimerkin arvo Aseta avainhenkilöidesi omat vastaanottajatiedot
keys.installationName ... does not match ^[a-z][a-z0-9-]{0,62}$ Isoja kirjaimia, pisteitä tai aloitusnumero Käytä pieniä kirjaimia, numeroita ja yhdysmerkkejä, aloittaen kirjaimella
keys.custody.recipients: ... ja syy Vastaanottajatieto on kirjoitettu väärin, se on yksityinen avain tai muotoa, jolle avaintenhallinnan Job ei pysty salaamaan Pyydä avainhenkilöltä hänen vastaanottajatietonsa uudelleen
hosts.console is required (the installation identity) Verkko-osoite on asettamatta Aseta kaikki kolme verkko-osoitetta
tls.existingSecret is required when tls.mode is existing Secret-resurssia ei ole nimetty Aseta se tai muuta arvoa tls.mode
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read Tilisi ei pysty lukemaan API-palvelimen osoitteita Anna ne /32-osoitealueina
global.imageRegistry is required Rekisteri on asettamatta Aseta se
Helm odottaa aikakatkaisuun asti; nexus-auth kirjaa lokiin password authentication failed Annettiin valitsin --wait Poista asennus ja asenna uudelleen ilman valitsinta --wait
Error: ... job failed, joka nimeää hookin Migraatio epäonnistui kubectl -n nexus logs job/<hook-name> ja lue sen viimeiset rivit
Pod on jumissa tilassa Init Sen wait-for-schema odottaa edelleen Lue sen loki: se nimeää puuttuvan ketjun
wait-for-schema: FAILED Ketjun hook ei koskaan kirjoittanut riviään Etsi ensin kyseisen hookin virhe
ImagePullBackOff Solmu ei pysty noutamaan kohteesta global.imageRegistry Tarkista, että solmu saa yhteyden rekisteriin ja että sillä on Enterprise-versiota varten noutopoletin tiedot

Jokainen PostgreSQL-tietokantaa odottava hook odottaa rajatun ajan ja ilmoittaa siitä, waiting for postgres (12/60), joten jumiutunut tietokanta näkyy hookin lokissa minuutin sisällä.

Asennus nexusctl-komennolla

nexusctl install tekee saman asennuksen ja ajaa sitä ympäröivät tarkistukset puolestasi. Se käyttää samaa values-tiedostoa:

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

Se ajaa esitarkistuksen uudelleen ja pysähtyy, jos jokin tarkistus ei enää mene läpi. Se vahvistaa kaaviopaketin allekirjoituksen julkaisuavainta vasten. Sen jälkeen se asentaa, odottaa hookit ja työkuormat läpi ja tulostaa jokaisen vaiheen sekä siihen kuluneen ajan. --edition community määrittää version komentorivillä tiedoston lisäksi. --ca-bundle <file> lisää omat CA-varmenteesi, samoin kuin esitarkistuksessa. Jos haluat nähdä helm- ja kubectl-toimenpiteet, jotka se ajaisi, suorittamatta niitä, lisää --explain:

nexusctl install --context harrow-prod --values harrow-values.yaml --explain

Kun se on valmis, se tulostaa lunastusosoitteen, kertakäyttöisen lunastuskoodin ja asennuksen sormenjäljen:

Installed in <time>. 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:
         <eight groups of four>

Koodissa on kolme ryhmää ja se sallii viisi yritystä; sormenjälki koostuu kahdeksasta neljän merkin ryhmästä, ja selain näyttää samat kahdeksan ryhmää, jotta voit verrata niitä ennen lunastusta.

Asennetaan
Asennetaan
Asennus käynnissä ylläpitäjän päätteessä. Jokainen vaihe tulostuu kestonsa kanssa, ja ajo päättyy kertakäyttöiseen koodiin ja asennuksen sormenjälkeen; kukaan ei voi kirjautua sisään ennen kuin asennus on lunastettu selaimessa.

Siirtyminen ensimmäiseen käyttökertaan

Jos asensit Helmillä, luo lunastuskoodi itse ja nimeä henkilö, josta tulee ensimmäinen pääkäyttäjä:

nexusctl claim-code --administrator aoife.brennan@harrow.example

Se ajaa avainpalvelun oman lunastuskoodikomennon nexus-keys-podissa käyttäen klusterioikeuksiasi ja tulostaa osoitteen, koodin ja sormenjäljen kuten yllä. Koodi on voimassa 30 minuuttia; aja komento uudelleen saadaksesi uuden koodin.

Tästä eteenpäin siirrytään selaimeen: lunasta asennus, luo ensimmäinen pääkäyttäjä avainkoodilla (passkey) ja käy läpi kuusi vaihetta ennen kuin kukaan kirjautuu sisään. Tätä käsitellään kohdassa luku 2.12, Ensimmäinen käyttökerta. Jos lisensoit Enterprise-version heti, lue ensin luku 2.7, Enterprise-version asentaminen ja lisenssin käyttöönotto, sillä lisenssi on yksi näistä kuudesta asiasta.