PrijavaRezervirajte predstavitev

Poglavje 2.6

Namestitev izdaje Community v okolju Kubernetes

Oštevilčena namestitev izdaje Community z orodjem Helm, od komponente cert-manager do pripravljenosti vseh delovnih obremenitev, z razlago datoteke vrednosti ključ za ključem, zakaj ni stikala --wait, vrstnim redom izvajanja kavljev karte in potjo namestitve prek nexusctl kot alternativo.

To stran je iz angleškega izvirnika prevedla UI. Če je karkoli nejasno, je referenca angleška stran. Preberite to stran v angleščini

18 min branja

Sama namestitev je en sam ukaz helm install. Vse okoli njega je tam zato, da ta en ukaz uspe že v prvem poskusu: cert-manager pred njim, datoteka z vrednostmi, ki ste jo prebrali vrstico za vrstico, in čakanje po njem, ki točno ve, na kaj mora čakati. Pri Harrow Port Authority smo za šesttedenski pilotni projekt najprej namestili izdajo Community na gručo k3s s tremi vozlišči iz našega delovnega lista za načrtovanje. Izdaja je delovala v približno dvajsetih minutah in nihče se ni mogel prijaviti, dokler je nismo prevzeli, kot je tudi prav.

To poglavje predvideva, da ste opravili že tri stvari: izpolnili delovni list za načrtovanje (poglavje 2.3, Načrtovanje namestitve), prenesli in preverili izdajo (poglavje 2.4, Pridobivanje in preverjanje izdaje) ter zagnali predhodno preverjanje (poglavje 2.5, Predhodno preverjanje z orodjem nexusctl). Če je katera od teh točk še odprta, se vrnite. Namestitev večino napak poimensko zavrne, nekaterih pa – kot je skrbnik, čigar ključ ste že izgubili – ne more zaznati.

1. korak: potrdite svoja orodja in kontekst

  1. Preverite, ali je Helm različice 4.

    helm version

    Namestitev se zanaša na to, da Helm 4 privzeto čaka na opravila Job kavljov v paketu chart. Uporabili smo različico v4.3.1.

  2. Usmerite kubectl na gručo z vašega delovnega lista in to potrdite.

    kubectl config use-context harrow-prod
    kubectl get nodes

    Vsako vozlišče mora imeti stanje Ready. Predhodno preverjanje je to že preverilo, vendar lahko vozlišče med predhodnim preverjanjem in namestitvijo izpade, zato je to hitreje opaziti tukaj.

2. korak: najprej namestite cert-manager

Paket chart z orodjem cert-manager ustvari lastnega lokalnega overitelja potrdil (CA), vsaka storitev pa z drugimi komunicira s potrdili, ki jih ta izda: samopodpisanim izdajateljem (Issuer), desetletnim potrdilom lokalnega CA in kratkotrajnimi potrdili za storitve. Zato mora cert-manager teči pred sistemom Nexus. Izdaja potrebuje različico v1.21.3 in ne potrebuje komponente trust-manager.

  1. Namestite cert-manager iz njegovega lastnega paketa chart skupaj z njegovimi viri po meri:

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

    <cert-manager-chart> je paket chart za cert-manager v1.21.3 iz lastne izdaje projekta cert-manager. Čakanje je tukaj na mestu; gre za lastno namestitev orodja cert-manager brez kavljev, ki bi bili odvisni od česar koli drugega.

  2. Počakajte na njegov spletni kavelj (webhook), prek katerega gre vsaka zahteva za potrdilo:

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

3. korak: ustvarite imenski prostor in TLS Secret

Pri možnosti tls.mode: existing paket chart pred namestitvijo pričakuje vaše potrdilo kot Kubernetes Secret v imenskem prostoru. Varnost transportne plasti (TLS) za vse tri naslove izvira iz tega enega vira Secret, zato mora njegovo potrdilo navajati vse tri gostitelje.

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

harrow-public.crt je potrdilo skupaj z njegovo verigo, harrow-public.key pa njegov zasebni ključ. Če ste v poglavju 2.3, Načrtovanje namestitve, izbrali tls.mode: cert-manager ali none, preskočite Secret; imenski prostor lahko ustvarite že zdaj ali pa prepustite orodju Helm, da ga v 6. koraku ustvari z možnostjo --create-namespace.

4. korak: zapišite datoteko vrednosti

To je datoteka z vrednostmi organizacije Harrow za pilotni projekt. Vsak ključ v njej je ključ, ki ga shema paketa chart sprejme; shema zavrne vse druge, tako da napačno črkovan ključ povzroči neuspeh namestitve, namesto da bi bil tiho prezrt.

# 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>"

Vsak <recipient-...> je javni prejemnik age enega skrbnika, torej vrstica age1... ali age1se1..., ki vam jo je poslal. Tukaj so vsi ključi, ki smo jih nastavili, in razlogi zanje.

global.imageRegistry je register, iz katerega vaša vozlišča vlečejo slike. Paket chart nima privzete vrednosti; vsako sliko sestavi kot <this>/nexus/<service>@<digest>. Za povezano namestitev je to registry.adverant.ai. Če ste slike prekopirali v lasten register, je to tisti gostitelj.

global.domain je domena, pod katero se nahajajo vsi trije naslovi.

hosts.console, hosts.api in hosts.auth predstavljajo identiteto namestitve: tri imena, ki jih uporabljajo ljudje in programi. Vsako se mora že razreševati v sistemu domenskih imen (DNS), kar je preverilo predhodno preverjanje.

edition in enterprise.enabled se morata ujemati: community z vrednostjo false ali enterprise z vrednostjo true. Paket chart zavrne vse drugo in zavrne izdajo, za katero njegova zaklepna datoteka slik ni bila ustvarjena.

tls.mode in tls.existingSecret določata, kako javni rob pridobi svoje potrdilo. Pri možnosti cert-manager bi namesto tega nastavili tls.clusterIssuer, pri možnosti none pa nobenega.

ingress.className poimenuje razred vstopne točke (ingress class). Pustite nenastavljeno, če želite uporabiti privzeti razred gruče.

storage.className poimenuje razred shrambe (storage class) za vsak podatkovni nosilec. Pustite nenastavljeno, če želite uporabiti privzetega.

networkPolicy.ingressNamespace je imenski prostor, v katerem teče vaš krmilnik vstopne točke (ingress controller). Privzeta vrednost, kube-system, je pravilna za Traefik v okolju k3s; kljub temu smo jo nastavili, da je v datoteki izrecno navedena.

networkPolicy.externalEgressCIDRs navaja obsege naslovov v zapisu brezrazrednega meddomenskega usmerjanja (CIDR) zunaj imenskega prostora, ki jih storitve lahko dosežejo poleg sistema DNS in strežnika aplikacijskega programskega vmesnika (API) sistema Kubernetes. Naš vsebuje posamezni naslov poštnega posrednika; če je seznam prazen, zunaj imenskega prostora ni dosegljivega ničesar.

keys.installationName je trajno ime, pod katerim shramba ključev ustvari identiteto namestitve.

keys.custody.recipients navaja javne prejemnike age skrbnikov. Opravilo Job za skrbništvo šifrira vsak delež za odklepanje in obnovitveni ključ za vsakega od njih.

Ključi, ki jih boste morda potrebovali, in ključi, ki jih pustite pri miru

Ključ Kdaj ga nastaviti
networkPolicy.apiServerCIDRs Ko paket chart ne more prebrati naslovov strežnika API iz končnih točk (Endpoints) kubernetes. Navedite jih kot obsege /32
proxy.trustedCIDRs Ko podi vašega krmilnika vstopne točke niso v naslovnem obsegu podov 10.42.0.0/16 okolja k3s
ai.localProvider.baseUrl Ko organizacija upravlja lasten strežnik modelov umetne inteligence (UI), združljiv z OpenAI (poglavje 2.14, Ponudniki in modeli UI)
ai.installationHosts Ko se ta strežnik modelov nahaja na zasebnih imenih znotraj namestitve
dataTier.<store>.size Ko shramba potrebuje več od svojega privzetega nosilca
dataTier.<store>.mode external za shrambo, ki jo upravljate sami (poglavje 2.11, Različice: zunanje shrambe, TLS in vstopna točka)
components.<service>.replicas, components.<service>.resources Ko povečate zmogljivosti storitve
auth.rateLimitPerMinute Kadar obsežna avtomatizacija potrebuje več kot 5.000 zahtev na minuto na osebo
schemaWait.timeoutSeconds Ko zaradi počasnega diska prve migracije trajajo več kot 30 minut

Pustite istio.enabled na vrednosti false; Nexus ne potrebuje storitvene mreže (service mesh). Pustite telemetry.enabled na vrednosti false; shema ne sprejme nobene druge vrednosti. Pustite orchestrator.platformServiceUserId in probitas.flags tako, kot ju nastavi paket chart.

Nobena poverilnica ni nikoli vrednost v paketu chart. Ni ključa za ključ API ponudnika modelov, geslo za pošto ali žeton za vleko (pull token). Storitve ob namestitvi ustvarijo lastne interne skrivnosti in jih ob nadgradnji ohranijo, ključi modelov posamezne organizacije pa se po prvem zagonu iz konzole dodajo v njeno lastno zbirko ključev.

5. korak: zaženite predhodno preverjanje na končni datoteki

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

Zagon se mora končati z 0 failed. Poglavje 2.5, Predhodno preverjanje z orodjem nexusctl, pojasnjuje vsako vrstico. Če ste od zadnjega zagona kar koli spremenili, četudi le velikost, ga zaženite znova.

6. korak: namestite, brez --wait

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

Če v 3. koraku niste ustvarili imenskega prostora, dodajte --create-namespace. Če nameščate iz datoteke paketa chart, ki ste jo prenesli in preverili, vstavite njeno pot namesto sklica oci://.

Ne dodajajte --wait. Začetna vzpostavitev podatkovne baze paketa chart se izvede kot kavelj po namestitvi (post-install hook), potem ko viri same izdaje že obstajajo, in prav ta kavelj vsaki storitvi dodeli njeno vlogo in geslo v podatkovni bazi. Možnost --wait bi zadrževala namestitev, dokler vsak Deployment ne bi imel stanja Available, noben Deployment pa ne more postati Available, preden se ne izvede kavelj, na katerega čaka. Storitve bi čakale z zavrnjenimi prijavami v podatkovno bazo, Helm pa bi nanje čakal do časovne omejitve. Brez možnosti --wait Helm 4 še vedno po vrsti počaka na vsako opravilo Job kavlja, in prav takšno čakanje želite.

Ko se zadnji kavelj zaključi, Helm izpiše svoj povzetek:

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

STATUS: deployed pomeni, da je uspel vsak kavelj. Ne pomeni pa še, da vsaka storitev že streže zahtevam; na to počaka 7. korak.

Kaj se izvede in v kakšnem vrstnem redu

Helm izvaja kavlje glede na utež, od najmanjše naprej, in pred naslednjim počaka na zaključek prejšnjega. Vsako migracijsko opravilo Job ima nastavljeno backoffLimit: 0: neuspela migracija povzroči neuspeh namestitve in se nikoli ne ponovi brez vaše vednosti. Opravilo Job, ki uspe, se izbriše; opravilo Job, ki spodleti, ostane skupaj s svojim dnevnikom, da ga lahko preberete.

Utež Kavelj Kaj naredi
-30 Predpogoji Račun kavlja nexus-migrations, Secret samo za kavlje nexus-migrations-env z ustvarjenimi poverilnicami podatkovne baze ter račun, vloga, konfiguracija in potrdilo opravila Job za skrbništvo
-20 nexus-db-bootstrap Ustvari podatkovne baze in vloge, pri čemer nobena ni superuporabnik in nobena ne more zaobiti varnosti na ravni vrstic (RLS); doda razširitve, med njimi PostGIS in pgvector; ustvari glavno knjigo izdaje
-15 nexus-openbao-custody-init Inicializira shrambo ključev in njen odklepalnik, šifrira deleže in obnovitvene ključe za vaše skrbnike, prekliče oba korenska žetona ter ustvari identiteto namestitve pod keys.installationName
-12 nexus-graphrag-migrations Najprej postavi shemo storitve grafa, ker se shema storitve za prijavo sklicuje na objekte v njeni lasti
-10 nexus-auth-migrations Postavi shemo storitve za prijavo in njeni dve izvajalni vlogi
-5 nexus-orchestrator-migrations, nexus-gateway-migrations, nexus-probitas-migrations Lastna shema vsake storitve; probitas se izvede po storitvi auth, ker najprej preveri tabele storitve auth
0 nexus-alpha-bff-migrations Vzpostavi podatkovno bazo zaledja za čelni del (BFF) in njene vloge ter nato izvede njene migracije

Vsak migracijski kavelj se zaključi z zapisom ene vrstice v glavno knjigo izdaje, nexus_release.schema_applied: imena svoje verige in izvlečka (digest) slike, ki ga je zagnala. To vrstico zapiše šele, ko se njegov izvajalnik migracij zaključi brez napake. Začetno opravilo Job izpiše db-bootstrap: done; migracijski kavlji SQL kot svojo zadnjo vrstico izpišejo schema-ledger: recorded <chain> for this release's image. Lastni migracijski kavelj konzole, nexus-alpha-bff-migrations, zabeleži svojo vrstico na enak način in nato izpiše bff-migrate: done.

Vodoravna časovnica, ki poteka od leve proti desni, z oznako "helm install". Na zgornji sledi je po vrsti sedem polj s kavlji: "-30 prerequisites", "-20 db-bootstrap", "-15 custody init", "-12 graphrag migrations", "-10 auth migrations", "-5 orchestrator, gateway, probitas migrations", "0 BFF migrations". Vsako migracijsko polje ima majhno puščico navzdol proti valju na srednji sledi z oznako "release ledger: nexus_release.schema_applied". Na spodnji sledi je dolga vrstica, ki se začne na levi z oznako "Deployments start, wait-for-schema holds each pod"; iz nje se proti glavni knjigi dvigajo kratke navpične puščice, vrstica vsakega vira Deployment pa postane polna, ko se pojavi njegova vrstica v glavni knjigi.
Vrstni red sveže namestitve s kavlji in delovnimi obremenitvami drug ob drugem.

Kako storitve čakajo na svojo shemo

Viri Deployment se zaženejo takoj, ko jih Helm ustvari, medtem ko se kavlji še izvajajo. Storitev, ki bi se zagnala ob podatkovni bazi brez vloge, gesla ali sheme, bi se sesula in vnovič zaganjala, dokler se kavlji ne bi zaključili. Zato ima vsak Deployment, ki uporablja podatkovno bazo, začetni vsebnik (init container) wait-for-schema, ki namesto tega zadrži pod.

Glavno knjigo izdaje bere kot nexus_ledger_reader, kar je prijava, ki lahko bere samo to eno tabelo in ničesar drugega, ter čaka, dokler glavna knjiga ne prikaže njegovih verig za izvlečke slik te izdaje. Stanje preverja vsakih schemaWait.intervalSeconds (privzeto 3), izpiše svoje stanje ob spremembi in ob vsakem dvajsetem preverjanju ter odneha po schemaWait.timeoutSeconds (privzeto 1.800) z napako, ki poimenuje storitev.

Uvajanje Čaka na
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

Če želite v živo spremljati čakanje posamezne storitve, preberite dnevnik njenega začetnega vsebnika:

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

Ker je čakanje vezano na izvleček slike in ne na število datotek, podi poznejše nadgradnje čakajo na vrstice nove izdaje, pod, ki se znova zažene po spremembi samo v datoteki z vrednostmi, pa svojo vrstico najde takoj.

7. korak: počakajte na vsako delovno obremenitev

Počakajte na vire Deployment z določeno časovno omejitvijo:

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

Nato še na vire StatefulSet. Dva strežnika shrambe ključev se posodobita šele, ko izbrišete njune pode, kubectl rollout status pa to strategijo posodabljanja zavrne, zato namesto tega počakajte na število pripravljenih podov:

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

Vsak izpiše condition met. V naši gruči sta obe čakanji skupaj trajali manj kot pet minut po tem, ko je Helm zaključil delo.

Kako je videti stanje pripravljenosti

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

Deset virov Deployment in sedem virov StatefulSet, vsi pripravljeni. Ob njih boste našli tri vire CronJob, nexus-keys-rotate-epoch, nexus-keys-run-schedule in nexus-keys-export-receipts, ki skrbijo za nočno vzdrževanje storitve ključev. Ukaz kubectl -n nexus get jobs ne bi smel izpisati nobenih opravil Job kavljev: uspešna so bila izbrisana.

Preden zapustite terminal, velja narediti dve stvari. Shranite datoteko z vrednostmi (commit) tja, kjer vaša ekipa hrani konfiguracijo; vsaka nadgradnja se začne iz nje. In pustite Secret nexus-generated pri miru. Paket chart ob namestitvi enkrat ustvari interna gesla in ključe, jih tam hrani in jih ob vsaki nadgradnji znova prebere, zato bi z njegovim izbrisom storitvam onemogočili dostop do lastnih podatkov.

Stanje pripravljenosti pomeni, da platforma teče in še ni prevzeta. Odprite https://console.harrow.example in prišli boste do namestitvenega programa, ne do prijavne strani: nihče se ne more prijaviti, dokler nekdo ne prevzame namestitve. To je prvi zagon, opisan v poglavju 2.12, Prvi zagon.

Ta namestitev (Community)
Ta namestitev (Community)
Lastna stran namestitve Community, ko je ta prevzeta: nameščena različica, stanje pogona, poraba diska, varnostne kopije in obljuba glede varnostnih popravkov, pri čemer so deli izdaje Enterprise prikazani kot predogledi z navedbo, kdo jih lahko vklopi.

Če to ne uspe

Večina napak se poimenuje sama. Preberite sporočilo, preden kar koli spremenite.

Kaj vidite Vzrok Kaj storiti
INSTALLATION_NAME_MISSING ali INSTALLATION_NAME_EXAMPLE keys.installationName je prazen ali pa vsebuje vrednost iz primera Nastavite lastno trajno ime
KEYS_CUSTODIAN_MISSING ali KEYS_CUSTODIAN_EXAMPLE Ni skrbnikov ali pa je naveden tisti iz primera Nastavite lastne prejemnike svojih skrbnikov
keys.installationName ... does not match ^[a-z][a-z0-9-]{0,62}$ Velike črke, pike ali vodilna števka Uporabite male črke, števke in vezaje, pri čemer mora biti prvi znak črka
keys.custody.recipients: ... in razlog Prejemnik je napačno vnesen, je zasebni ključ ali pa je v obliki, za katero opravilo Job za skrbništvo ne more šifrirati Znova prosite skrbnika za njegovega prejemnika
hosts.console is required (the installation identity) Gostitelj ni nastavljen Nastavite vse tri gostitelje
tls.existingSecret is required when tls.mode is existing Ni poimenovanega vira Secret Nastavite ga ali spremenite tls.mode
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read Vaš račun ne more prebrati naslovov strežnika API Navedite jih kot obsege /32
global.imageRegistry is required Register ni nastavljen Nastavite ga
Helm čaka do svoje časovne omejitve; nexus-auth beleži password authentication failed Podana je bila možnost --wait Odstranite in znova namestite brez možnosti --wait
Error: ... job failed z navedbo kavlja Migracija ni uspela kubectl -n nexus logs job/<hook-name> in preberite njegove zadnje vrstice
Pod je obtičal v stanju Init Njegov wait-for-schema še vedno čaka Preberite njegov dnevnik: navaja verigo, ki mu manjka
wait-for-schema: FAILED Kavelj verige nikoli ni zapisal svoje vrstice Najprej poiščite napako tega kavlja
ImagePullBackOff Vozlišče ne more vleči iz global.imageRegistry Preverite, ali vozlišče lahko doseže register in ali ima (za izdajo Enterprise) žeton za vleko

Vsak kavelj, ki čaka na PostgreSQL, čaka omejen čas in to tudi izpiše, waiting for postgres (12/60), zato se zataknjena podatkovna baza v dnevniku kavlja pokaže v eni minuti.

Namestitev prek orodja nexusctl

nexusctl install izvede isto namestitev, pri čemer samodejno izvede vsa spremljajoča preverjanja namesto vas. Sprejme isto datoteko z vrednostmi:

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

Znova zažene predhodno preverjanje in se ustavi, če katero koli preverjanje ne uspe. Preveri podpis svežnja paketa chart glede na ključ izdaje. Nato izvede namestitev, počaka na kavlje in delovne obremenitve ter izpiše vsak korak skupaj s časom trajanja. --edition community določa izdajo tako v ukazni vrstici kot v datoteki. --ca-bundle <file> doda vaša lastna potrdila CA, enako kot pri predhodnem preverjanju. Če si želite ogledati operacije helm in kubectl, ki bi jih ukaz izvedel, ne da bi jih dejansko zagnali, dodajte --explain:

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

Ko konča, izpiše naslov za prevzem, enkratno kodo za prevzem in prstni odtis namestitve:

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>

Koda je sestavljena iz treh skupin in dovoljuje pet poskusov; prstni odtis ima osem skupin po štiri znake, brskalnik pa pred prevzemom prikaže istih osem skupin za primerjavo.

Nameščanje
Nameščanje
Namestitev, ki teče v operaterjevem terminalu. Vsak korak se izpiše s svojim časom, zagon pa se konča z enkratno kodo in prstnim odtisom namestitve; nihče se ne more prijaviti, dokler namestitev ni prevzeta v brskalniku.

Prehod na prvi zagon

Če ste namestitev izvedli z orodjem Helm, ustvarite kodo za prevzem sami in navedite osebo, ki bo prvi skrbnik:

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

Z vašim dostopom do gruče v podu nexus-keys zažene lastni ukaz storitve ključev za ustvarjanje kode za prevzem ter izpiše naslov, kodo in prstni odtis kot zgoraj. Koda velja 30 minut; za svežo kodo ukaz zaženite znova.

Od tu naprej delo prevzame brskalnik: prevzemite namestitev, ustvarite prvega skrbnika s potrdilnim ključem (passkey) in opravite šest korakov, preden se kdor koli prijavi. To je opisano v poglavju 2.12, Prvi zagon. Če boste takoj licencirali izdajo Enterprise, najprej preberite poglavje 2.7, Namestitev izdaje Enterprise in uveljavitev licence, saj je licenca eden od teh šestih korakov.