PrisijungtiUžsisakyti pristatymą

2.6 skyrius

Community diegimas Kubernetes aplinkoje

Sunumeruotas Community leidimo diegimas naudojant Helm – nuo cert-manager iki kiekvieno darbo krūvio parengties, raktas po rakto paaiškinant reikšmių failą, kodėl nenaudojamas --wait, kokia tvarka vykdomi paketo kabliai (hooks) bei alternatyvus diegimo kelias su nexusctl.

Šį puslapį iš originalo anglų kalba išvertė DI. Jei kas nors neaišku, remkitės puslapiu anglų kalba. Skaityti šį puslapį anglų kalba

18 min. skaitymo

Pats diegimas yra viena helm install komanda. Viskas aplink ją skirta tam, kad ši viena komanda suveiktų iš pirmo karto: „cert-manager“ prieš ją, reikšmių failas, kurį perskaitėte eilutė po eilutės, ir laukimas po to, žinantis, ko laukti. „Harrow Port Authority“ iš pradžių įdiegėme „Community“ leidimą šešių savaičių bandomajam projektui trijų mazgų „k3s“ klasteryje iš mūsų planavimo darbalapio. Leidimas pradėjo veikti maždaug per dvidešimt minučių, ir niekas negalėjo prisijungti, kol jo nepatvirtinome kaip savo, kaip ir turi būti.

Šiame skyriuje daroma prielaida, kad jau atlikote tris dalykus: užpildėte planavimo darbalapį (2.3 skyrius, Diegimo planavimas), atsisiuntėte ir patikrinote leidimą (2.4 skyrius, Leidimo gavimas ir patikrinimas) bei atlikote išankstinę patikrą (2.5 skyrius, Išankstinė patikra su „nexusctl“). Jei kuris nors iš šių punktų dar nebaigtas, grįžkite atgal. Diegimo procesas atmeta daugumą klaidų pagal pavadinimą, tačiau kai kurių, pavyzdžiui, saugotojo, kurio raktą jau praradote, jis matyti negali.

1 žingsnis: patvirtinkite savo įrankius ir kontekstą

  1. Patikrinkite, ar „Helm“ yra 4 versijos.

    helm version

    Diegimas remiasi tuo, kad „Helm 4“ pagal numatytuosius nustatymus laukia paketo kablių (angl. hook) „Job“ užduočių. Mes naudojome v4.3.1.

  2. Nukreipkite kubectl į klasterį, nurodytą jūsų darbalapyje, ir patvirtinkite tai.

    kubectl config use-context harrow-prod
    kubectl get nodes

    Kiekvienas mazgas turėtų rodyti Ready. Išankstinė patikra tai jau patikrino, tačiau mazgas gali atsijungti tarp išankstinės patikros ir diegimo, o čia tai pamatyti greičiau.

2 žingsnis: pirmiausia įdiekite cert-manager

Paketas sukuria savo vietinę sertifikatų instituciją (CA) su „cert-manager“, ir kiekviena tarnyba bendrauja su kitomis naudodama jos išduotus sertifikatus: savarankiškai pasirašytą „Issuer“, dešimties metų vietinį CA sertifikatą ir trumpalaikius sertifikatus tarnyboms. Todėl „cert-manager“ turi veikti prieš „Nexus“. Leidimui reikalinga v1.21.3 versija, ir jam nereikia „trust-manager“.

  1. Įdiekite „cert-manager“ iš jo paties paketo su jo pasirinktiniais ištekliais:

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

    <cert-manager-chart> yra „cert-manager“ v1.21.3 paketas iš paties „cert-manager“ projekto leidimo. Laukti čia yra tinkama – tai paties „cert-manager“ diegimas be jokių kablių, priklausančių nuo ko nors kito.

  2. Palaukite jo „webhook“ komponento, per kurį pereina kiekviena sertifikato užklausa:

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

3 žingsnis: sukurkite vardų sritį ir TLS Secret

Naudojant tls.mode: existing, paketas tikisi, kad jūsų sertifikatas prieš diegimą jau bus vardų srityje kaip „Kubernetes Secret“ objektas. Transporto lygmens saugumas (TLS) visiems trims adresams gaunamas iš šio vieno „Secret“ objekto, todėl jo sertifikate turi būti nurodyti visi trys mazgai (angl. hosts).

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

harrow-public.crt yra sertifikatas su jo grandine, o harrow-public.key – jo privatusis raktas. Jei 2.3 skyriuje, Diegimo planavimas, pasirinkote tls.mode: cert-manager arba none, praleiskite „Secret“ kūrimą; vardų sritį vis tiek galite sukurti dabar arba leisti tai padaryti „Helm“ su --create-namespace 6 veiksme.

4 žingsnis: parašykite reikšmių failą

Tai yra „Harrow“ reikšmių failas bandomajam projektui. Kiekvienas jame esantis raktas yra raktas, kurį priima paketo schema; schema atmeta bet kurį kitą, todėl klaidingai parašytas raktas nutraukia diegimą, o ne yra tyliai ignoruojamas.

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

Kiekvienas <recipient-...> yra vieno saugotojo viešasis age gavėjas – age1... arba age1se1... eilutė, kurią jie jums atsiuntė. Štai visi mūsų nustatyti raktai ir priežastys, kodėl juos nustatėme.

global.imageRegistry yra registras, iš kurio jūsų mazgai atsisiunčia atvaizdus. Paketas neturi numatytosios reikšmės; jis suformuoja kiekvieną atvaizdą kaip <this>/nexus/<service>@<digest>. Prijungto diegimo atveju tai yra registry.adverant.ai. Jei nukopijavote atvaizdus į savo registrą, tai yra to registro mazgas.

global.domain yra domenas, kuriam priklauso šie trys adresai.

hosts.console, hosts.api ir hosts.auth yra diegimo tapatybė: trys vardai, kuriuos naudoja žmonės ir programos. Kiekvienas iš jų jau turi būti išsprendžiamas domenų vardų sistemoje (DNS), ką jau patikrino išankstinė patikra.

edition ir enterprise.enabled turi sutapti: community su false arba enterprise su true. Paketas atmeta bet ką kita, taip pat atmeta leidimą, kuriam nebuvo sukurtas jo atvaizdų užrakto failas.

tls.mode ir tls.existingSecret parenka, kaip viešasis kraštas (angl. public edge) gauna savo sertifikatą. Naudodami cert-manager, vietoj to nustatytumėte tls.clusterIssuer, o naudodami none – nė vieno iš jų.

ingress.className nurodo įėjimo (angl. ingress) klasę. Palikite ją nenustatytą, kad būtų naudojama numatytoji klasterio klasė.

storage.className nurodo saugyklos klasę kiekvienam duomenų tomui. Palikite ją nenustatytą, kad būtų naudojama numatytoji.

networkPolicy.ingressNamespace yra vardų sritis, kurioje veikia jūsų įėjimo valdiklis (angl. ingress controller). Numatytoji reikšmė kube-system tinka „k3s“ naudojamam „Traefik“; mes vis tiek ją nustatėme, kad faile tai būtų aiškiai nurodyta.

networkPolicy.externalEgressCIDRs išvardija adresų rėžius bekupinio tarpsritinio maršrutizavimo (CIDR) žymėjimu už vardų srities ribų, kuriuos tarnybos gali pasiekti, be DNS ir „Kubernetes“ programų sąsajos (API) serverio. Mūsiškiame yra vienas pašto perdavimo serverio (angl. mail relay) adresas; jei sąrašas tuščias, niekas už vardų srities ribų nėra pasiekiama.

keys.installationName yra nuolatinis pavadinimas, kuriuo raktų saugykla suformuoja diegimo tapatybę.

keys.custody.recipients išvardija saugotojų viešuosius age gavėjus. Saugotojų „Job“ užduotis užšifruoja kiekvieną atrakinimo dalį (angl. unseal share) ir atkūrimo raktą kiekvienam iš jų.

Raktai, kurių jums gali prireikti, ir raktai, kurių nereikėtų liesti

Raktas Kada jį nustatyti
networkPolicy.apiServerCIDRs Kai paketas negali nuskaityti API serverio adresų iš kubernetes „Endpoints“ objektų. Pateikite juos kaip /32 rėžius
proxy.trustedCIDRs Kai jūsų įėjimo valdiklio pod'ai nėra „k3s“ 10.42.0.0/16 tinkle
ai.localProvider.baseUrl Kai organizacija naudoja savo su „OpenAI“ suderinamą dirbtinio intelekto (DI) modelių serverį (2.14 skyrius, DI teikėjai ir modeliai)
ai.installationHosts Kai tas modelių serveris naudoja privačius vardus diegimo viduje
dataTier.<store>.size Kai saugyklai reikia didesnio nei numatytasis tomo
dataTier.<store>.mode external saugyklai, kurią administruojate patys (2.11 skyrius, Variacijos: išorinės saugyklos, TLS ir įėjimas)
components.<service>.replicas, components.<service>.resources Kai padidinate tarnybos išteklius
auth.rateLimitPerMinute Kai intensyviam automatizavimui reikia daugiau nei 5 000 užklausų per minutę vienam asmeniui
schemaWait.timeoutSeconds Kai dėl lėto disko pirmosios migracijos trunka ilgiau nei 30 minučių

Palikite istio.enabled su reikšme false; „Nexus“ nereikia tarnybų tinklo (angl. service mesh). Palikite telemetry.enabled su reikšme false; schema nepriima jokios kitos reikšmės. Palikite orchestrator.platformServiceUserId ir probitas.flags tokius, kokius juos nustato paketas.

Jokie prisijungimo duomenys niekada nebūna paketo reikšmėmis. Nėra rakto modelio teikėjo API raktui, pašto slaptažodžiui ar atsisiuntimo prieigos raktui (angl. pull token). Tarnybos diegimo metu sugeneruoja savo vidines paslaptis ir išlaiko jas atnaujinimo metu, o kiekvienos organizacijos modelių raktai po pirmojo paleidimo iš konsolės patenka į jos pačios raktų telkinį.

5 žingsnis: paleiskite išankstinę patikrą su galutiniu failu

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

Paleidimas turi baigtis 0 failed. 2.5 skyrius, Išankstinė patikra su „nexusctl“, paaiškina kiekvieną eilutę. Jei nuo paskutinio paleidimo ką nors pakeitėte, net ir dydį, paleiskite ją dar kartą.

6 žingsnis: įdiekite be --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

Jei nesukūrėte vardų srities 3 veiksme, pridėkite --create-namespace. Jei diegiate iš paketo failo, kurį atsisiuntėte ir patikrinote, įrašykite jo kelią vietoj oci:// nuorodos.

Nepridėkite --wait. Paketo duomenų bazės pradinis paruošimas (angl. bootstrap) vykdomas kaip podiegiminis kablys (angl. post-install hook), kai jau egzistuoja paties leidimo ištekliai, ir būtent šis kablys suteikia kiekvienai tarnybai jos duomenų bazės vaidmenį ir slaptažodį. --wait sulaikytų diegimą, kol kiekvienas „Deployment“ taps „Available“, o joks „Deployment“ negali tapti „Available“, kol nebus įvykdytas kablys, kurio jis laukia. Tarnybos laukia, nes jų prisijungimai prie duomenų bazės atmetami, o „Helm“ laukia jų, kol baigiasi skirtasis laikas. Be --wait, „Helm 4“ vis tiek iš eilės laukia kiekvienos kablio „Job“ užduoties, ir būtent tokio laukimo jums reikia.

Kai baigiamas paskutinis kablys, „Helm“ išspausdina savo suvestinę:

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

STATUS: deployed reiškia, kad visi kabliai buvo sėkmingai įvykdyti. Tai dar nereiškia, kad kiekviena tarnyba jau aptarnauja užklausas; to laukiama 7 veiksme.

Kas vykdoma ir kokia tvarka

„Helm“ vykdo kablius pagal svorį, pradedant nuo mažiausio, ir laukia kiekvieno iš jų prieš paleisdamas kitą. Kiekviena migracijos „Job“ užduotis turi backoffLimit: 0: nepavykusi migracija nutraukia diegimą ir niekada nėra bandoma iš naujo jums nežinant. Sėkmingai įvykdyta „Job“ užduotis ištrinama; nepavykusi „Job“ užduotis lieka kartu su savo žurnalu, kad galėtumėte jį perskaityti.

Svoris Kablys Ką daro
-30 Būtinosios sąlygos Kablio paskyra nexus-migrations, tik kabliui skirtas „Secret“ nexus-migrations-env su sugeneruotais duomenų bazės prisijungimo duomenimis bei saugotojų „Job“ užduoties paskyra, vaidmuo, konfigūracija ir sertifikatas
-20 nexus-db-bootstrap Sukuria duomenų bazes ir vaidmenis, iš kurių nė vienas nėra supervartotojas ir nė vienas negali apeiti eilučių lygmens saugumo (RLS); prideda plėtinius, tarp jų „PostGIS“ ir „pgvector“; sukuria leidimų registrą (angl. release ledger)
-15 nexus-openbao-custody-init Inicijuoja raktų saugyklą ir jos atrakinimo priemonę (angl. unsealer), užšifruoja dalis ir atkūrimo raktus jūsų saugotojams, atšaukia abu šakninius prieigos raktus (angl. root tokens) ir suformuoja diegimo tapatybę po keys.installationName
-12 nexus-graphrag-migrations Pirmiausia sukuria grafų tarnybos schemą, nes prisijungimo tarnybos schema remiasi jai priklausančiais objektais
-10 nexus-auth-migrations Sukuria prisijungimo tarnybos schemą ir du jos vykdymo laiko vaidmenis
-5 nexus-orchestrator-migrations, nexus-gateway-migrations, nexus-probitas-migrations Kiekvienos tarnybos savoji schema; „probitas“ vykdomas po „auth“, nes pirmiausia patikrina „auth“ lenteles
0 nexus-alpha-bff-migrations Paruošia „backend for frontend“ (BFF) duomenų bazę ir jos vaidmenis, tada pritaiko jos migracijas

Kiekvienas migracijos kablys baigiamas įrašant vieną eilutę į leidimų registrą nexus_release.schema_applied: savo grandinės pavadinimą ir jį vykdžiusio atvaizdo santrauką (angl. digest). Šią eilutę jis įrašo tik tada, kai jo migracijos vykdyklė baigia darbą be klaidų. Pradinio paruošimo „Job“ užduotis išspausdina db-bootstrap: done; SQL migracijos kabliai kaip paskutinę eilutę išspausdina schema-ledger: recorded <chain> for this release's image. Pačios konsolės migracijos kablys nexus-alpha-bff-migrations tokiu pat būdu įrašo savo eilutę ir tada išspausdina bff-migrate: done.

Horizontali laiko juosta, einanti iš kairės į dešinę, pažymėta „helm install“. Viršutinėje juostoje iš eilės išdėstyti septyni „hook“ langeliai: „-30 prerequisites“, „-20 db-bootstrap“, „-15 custody init“, „-12 graphrag migrations“, „-10 auth migrations“, „-5 orchestrator, gateway, probitas migrations“, „0 BFF migrations“. Kiekvienas migracijos langelis turi mažą rodyklę, nukreiptą žemyn į cilindrą vidurinėje juostoje, pažymėtą „release ledger: nexus_release.schema_applied“. Apatinėje juostoje yra ilga juosta, prasidedanti kairėje ir pažymėta „Deployments start, wait-for-schema holds each pod“; iš jos į registrą kyla trumpos vertikalios rodyklės, o kiekvieno „Deployment“ objekto juosta tampa ištisine, kai pasirodo jo paties registro eilutė.
Švaraus diegimo eiga, greta pateikiant kablius ir darbo krūvius (angl. workloads).

Kaip paslaugos laukia savo schemos

„Deployment“ objektai pradeda veikti iškart, kai tik Helm juos sukuria, kol „hook“ scenarijai dar vykdomi. Paslauga, kuri būtų paleista duomenų bazėje be vaidmens, slaptažodžio ar schemos, nulūžtų ir būtų paleidžiama iš naujo tol, kol „hook“ scenarijai baigtų darbą. Todėl kiekvienas „Deployment“ objektas, naudojantis duomenų bazę, turi inicijavimo konteinerį wait-for-schema, kuris sulaiko „pod“ objekto paleidimą.

Jis skaito leidimo registrą kaip nexus_ledger_reader – prisijungimo vardą, galintį skaityti tik tą vieną lentelę ir nieko daugiau, – ir laukia, kol registre pasirodys šio leidimo atvaizdų santraukų (angl. *image digests*) grandinės. Jis atlieka apklausą kas schemaWait.intervalSeconds (pagal numatytuosius nustatymus – 3), išveda savo būseną, kai ji pasikeičia, ir per kiekvieną dvidešimtą apklausą, o po schemaWait.timeoutSeconds (pagal numatytuosius nustatymus – 1 800) nutraukia bandymus, pateikdamas klaidos pranešimą, kuriame nurodomas paslaugos pavadinimas.

Diegimas Ko laukia
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

Norėdami stebėti vienos paslaugos laukimą realiuoju laiku, skaitykite jos inicijavimo konteinerio žurnalą:

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

Kadangi laukimas susietas su atvaizdo santrauka, o ne su failų skaičiumi, vėlesnio atnaujinimo „pod“ objektai laukia naujojo leidimo eilučių, o „pod“ objektas, kuris paleidžiamas iš naujo pakeitus tik reikšmes, savo eilutę randa iš karto.

7 žingsnis: palaukite kiekvieno darbo krūvio

Palaukite „Deployment“ objektų, nurodydami laiko ribą:

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

Tada – „StatefulSet“ objektai. Du raktų saugyklos serveriai atsinaujina tik tada, kai ištrinate jų „pod“ objektus, o kubectl rollout status atmeta šią atnaujinimo strategiją, todėl vietoj to laukite parengtų objektų skaičiaus:

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

Kiekvienas išveda condition met. Mūsų klasteryje abu laukimai kartu truko mažiau nei penkias minutes po to, kai Helm baigė darbą.

Kaip atrodo parengtis

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

Dešimt „Deployment“ ir septyni „StatefulSet“ objektai – kiekvienas iš jų parengtas. Šalia jų rasite tris „CronJob“ užduotis – nexus-keys-rotate-epoch, nexus-keys-run-schedule ir nexus-keys-export-receipts, kurios atlieka raktų paslaugos naktinę priežiūrą. kubectl -n nexus get jobs neturėtų rodyti jokių „hook“ tipo „Job“ užduočių: sėkmingai įvykdytos užduotys buvo ištrintos.

Prieš išjungiant terminalą, verta atlikti du dalykus. Įkelkite (angl. *commit*) reikšmių failą ten, kur jūsų komanda saugo konfigūraciją – nuo jo prasideda kiekvienas atnaujinimas. Ir nelieskite „Secret“ objekto nexus-generated. Šablonų paketas (angl. *chart*) sugeneruoja vidinius slaptažodžius ir raktus vieną kartą diegimo metu, saugo juos ten ir nuskaito kiekvieno atnaujinimo metu, todėl jį ištrynus paslaugos nebegalėtų pasiekti savo duomenų.

Būsena „Ready“ (parengta) reiškia, kad platforma veikia ir dar nėra priskirta. Atidarykite https://console.harrow.example ir pateksite į diegimo vedlį, o ne į prisijungimo puslapį: niekas negali prisijungti, kol kas nors nepriskirs diegimo sau. Tai yra pirmasis paleidimas, aprašytas 2.12 skyriuje „Pirmasis paleidimas“.

Šis diegimas (Community)
Šis diegimas (Community)
„Community“ leidimo diegimo puslapis po to, kai jis priskiriamas: veikianti versija, variklio būklė, disko naudojimas, atsarginės kopijos ir saugumo pataisų įsipareigojimas, o „Enterprise“ dalys rodomos kaip anonsai, kuriuose nurodyta, kas gali jas įjungti.

Jei tai nepavyksta

Dauguma klaidų pačios save įvardija. Prieš ką nors keisdami, perskaitykite pranešimą.

Ką matote Priežastis Ką daryti
INSTALLATION_NAME_MISSING arba INSTALLATION_NAME_EXAMPLE keys.installationName yra tuščias arba paliktas pavyzdinis Nustatykite savo nuolatinį pavadinimą
KEYS_CUSTODIAN_MISSING arba KEYS_CUSTODIAN_EXAMPLE Nėra saugotojų arba paliktas pavyzdinis Nustatykite savo saugotojų gavėjų raktus (angl. *recipients*)
keys.installationName ... does not match ^[a-z][a-z0-9-]{0,62}$ Didžiosios raidės, taškai arba skaitmuo priekyje Naudokite mažąsias raides, skaitmenis ir brūkšnelius, pradėdami raide
keys.custody.recipients: ... ir priežastis Gavėjo raktas įvestas su klaida, yra privatusis raktas arba yra tokio formato, kuriam saugojimo „Job“ užduotis negali atlikti šifravimo Dar kartą paprašykite saugotojo jo gavėjo rakto
hosts.console is required (the installation identity) Nenustatytas mazgas (angl. *host*) Nustatykite visus tris mazgus
tls.existingSecret is required when tls.mode is existing Nurodytas neegzistuojantis „Secret“ objektas Nustatykite jį arba pakeiskite tls.mode
networkPolicy.apiServerCIDRs is empty and the kubernetes Endpoints could not be read Jūsų paskyra negali nuskaityti API serverio adresų Nurodykite juos kaip /32 rėžius
global.imageRegistry is required Nenustatytas registras Nustatykite jį
Helm laukia, kol baigiasi skirtasis laikas; nexus-auth į žurnalą įrašo password authentication failed Buvo nurodytas --wait Pašalinkite ir įdiekite iš naujo be --wait
Error: ... job failed, nurodantis „hook“ scenarijų Nepavyko atlikti migracijos kubectl -n nexus logs job/<hook-name> ir perskaitykite paskutines jo eilutes
„Pod“ objektas įstrigo būsenoje Init Jo wait-for-schema vis dar laukia Perskaitykite jo žurnalą: jame nurodoma trūkstama grandinė
wait-for-schema: FAILED Grandinės „hook“ scenarijus taip ir neįrašė savo eilutės Pirmiausia raskite to „hook“ scenarijaus klaidą
ImagePullBackOff Mazgas (angl. *node*) negali atsiųsti atvaizdo iš global.imageRegistry Patikrinkite, ar mazgas gali pasiekti registrą ir, „Enterprise“ atveju, ar turi atsiuntimo prieigos raktą (angl. *pull token*)

Kiekvienas „hook“ scenarijus, laukiantis PostgreSQL, laukia ribotą laiką ir apie tai praneša (waiting for postgres (12/60)), todėl įstrigusi duomenų bazė „hook“ scenarijaus žurnale tampa matoma per minutę.

Diegimo per nexusctl kelias

nexusctl install atlieka tą patį diegimą, tik už jus paleidžia ir su juo susijusias patikras. Jis priima tą patį reikšmių failą:

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

Jis dar kartą paleidžia išankstinę patikrą (angl. *preflight*) ir sustoja, jei kuri nors patikra tampa nesėkminga. Jis patikrina šablonų paketo parašą pagal leidimo raktą. Tada jis įdiegia, išlaukia, kol bus įvykdyti „hook“ scenarijai bei darbiniai krūviai (angl. *workloads*), ir išveda kiekvieną žingsnį bei jo trukmę. --edition community nurodo leidimą komandinėje eilutėje, taip pat kaip ir faile. --ca-bundle <file> prideda jūsų pačių CA sertifikatus, taip pat kaip ir išankstinės patikros metu. Norėdami pamatyti helm ir kubectl operacijas, kurias jis vykdytų, bet jų nepaleisti, pridėkite --explain:

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

Baigęs darbą, jis išveda priskyrimo adresą, vienkartinį priskyrimo kodą ir diegimo kontrolinę žymę (angl. *fingerprint*):

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>

Kodas sudarytas iš trijų grupių ir leidžia penkis bandymus; kontrolinė žymė sudaryta iš aštuonių keturių simbolių grupių, o naršyklė rodo tas pačias aštuonias grupes, kad galėtumėte jas palyginti prieš priskirdami diegimą.

Diegiama
Diegiama
Diegimas, vykstantis operatoriaus terminale. Kiekvienas žingsnis išvedamas su jo trukme, o vykdymas baigiamas vienkartiniu kodu ir diegimo kontroline žyme; niekas negali prisijungti, kol diegimas nepriskiriamas naršyklėje.

Perdavimas pirmajam paleidimui

Jei diegėte naudodami Helm, sugeneruokite priskyrimo kodą patys, nurodydami asmenį, kuris bus pirmasis administratorius:

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

Jis paleidžia raktų paslaugos priskyrimo kodo komandą nexus-keys „pod“ objekte, naudodamas jūsų klasterio prieigą, ir išveda adresą, kodą bei kontrolinę žymę, kaip nurodyta pirmiau. Kodas galioja 30 minučių; paleiskite komandą dar kartą, kad gautumėte naują.

Nuo šiol darbą perima naršyklė: priskirkite diegimą, sukurkite pirmąjį administratorių su įgaliojimo raktu (angl. *passkey*) ir atlikite šešis veiksmus, kol dar niekas neprisijungė. Tai aprašyta 2.12 skyriuje „Pirmasis paleidimas“. Jei iš karto licencijuosite „Enterprise“, pirmiausia perskaitykite 2.7 skyrių „Enterprise diegimas ir licencijos pritaikymas“, nes licencija yra vienas iš tų šešių dalykų.