Verzija 1.0.0-alpha.1najnovije
Poglavlje 2.15
Drugi dan: upravljanje sustavom Nexus
Rutinski posao vođenja instalacije nakon prvog tjedna. Počinje otpečaćivanjem spremišta ključeva nakon ponovnog pokretanja, a završava deinstalacijom.
Ovu je stranicu s engleskog izvornika preveo AI. Ako je išta nejasno, mjerodavna je stranica na engleskom jeziku. Pročitajte ovu stranicu na engleskom jeziku

Kada je prvi put nestalo struje u serverskoj sobi u Harrow Port Authorityju, sve se vratilo u rad osim dijelova kojima su trebali ključevi. Podovi su bili u stanju Running i konzola se učitala. Nitko nije mogao otvoriti datoteku. Tomás Reilly je čitao o tome, pa mu je ipak trebalo dvadeset minuta da se sjeti zašto. Poslužitelj za otpečaćivanje pohrane ključeva pokreće se zapečaćen nakon svakog ponovnog pokretanja svojeg čvora i samo ga skrbnik ključeva može otvoriti.
Ovo poglavlje prati rutinu operatera nakon prvog tjedna, od pohrane ključeva i njezinih skrbnika do deinstalacije. Svaka naredba nexusctl ovdje prihvaća --explain, što ispisuje operacije kubectl i helm koje bi izvršila, a da ih stvarno ne izvrši. Upotrijebite to prvi put kada pokrećete bilo što na produkcijskom klasteru.
Čuvanje spremišta ključeva
Instalacija ima dva OpenBao poslužitelja u svojem imenskom prostoru. Pohrana ključeva, openbao, čuva svaki ključ koji Nexus koristi. Poslužitelj za otpečaćivanje, openbao-unsealer, drugi je, mali OpenBao čiji je jedini zadatak otpečatiti pohranu ključeva. Pohrana ključeva sama se otpečaćuje pomoću tranzitnog ključa poslužitelja za otpečaćivanje; poslužitelj za otpečaćivanje zapečaćen je Shamirovom shemom, u obliku 5 udjela od kojih bilo koja 3 služe za otpečaćivanje.
Pri prvoj instalaciji skrbnički Job inicijalizira oba poslužitelja unutar klastera. On u vlastitoj memoriji šifrira udjele poslužitelja za otpečaćivanje i ključeve za oporavak pohrane ključeva za svakog skrbnika navedenog u keys.custody.recipients, te pohranjuje samo šifrirani tekst (Secrete openbao-unseal-shares-encrypted i openbao-recovery-keys-encrypted). U istom Jobu opoziva oba korijenska tokena. Paket svakog skrbnika sadrži dovoljno udjela za samostalno otpečaćivanje, tako da vam je nakon ponovnog pokretanja potreban samo jedan skrbnik.
Nakon ponovnog pokretanja čvora
Nakon svakog ponovnog pokretanja čvora na kojem se izvodi poslužitelj za otpečaćivanje (nestanak struje, ponovno pokretanje stroja, ponovno pokretanje izvršnog okruženja spremnika) poslužitelj za otpečaćivanje pokreće se zapečaćen. Dok ga skrbnik ne otpečati, pohrana ključeva također ostaje zapečaćena i ništa što zahtijeva ključ ne radi. Konzola i dalje odgovara i ljudi se i dalje mogu prijaviti, ali svaka radnja koja treba ključ iz pohrane ključeva čeka: otvaranje šifriranog sadržaja, preuzimanje vlasništva, provjera kompiliranog dijela.
Upitajte sam OpenBao, unutar svakog poda. Ovo je poslužitelj za otpečaćivanje:
kubectl -n nexus exec openbao-unsealer-0 -c openbao -- \
bao status -format=json -address=https://127.0.0.1:8200 \
-ca-cert=/openbao/tls/ca.crt -tls-server-name=openbao-unsealer
echo "exit $?"Pokrenite istu naredbu na openbao-0 s -tls-server-name=openbao za pohranu ključeva. bao status izlazi s kodom 0 kada je poslužitelj otpečaćen, 2 kada je zapečaćen i 1 kada nije mogao odgovoriti. Izlazni kod 1 ne znači ništa jer pod možda još nije podignut. Pričekajte minutu i ponovite upit. Ako je poslužitelj za otpečaćivanje otpečaćen, a pohrana ključeva još uvijek zapečaćena, pohrana ključeva se sama otpečaćuje i ne morate ništa poduzimati.
Otpečaćivanje
Chart isporučuje unseal.sh, u svojoj mapi files/custody/, bajt po bajt identičan u svakom izdanju. Skrbnik ga pokreće na vlastitom računalu. Skripta čita šifrirani Secret, jednokratno ga dešifrira pomoću identiteta skrbnika (Secure Enclave identitet jednom traži Touch ID), šalje udjele poslužitelju za otpečaćivanje i potvrđuje da je otpečaćen. Nijedan udio nikada se ne zapisuje u datoteku niti stavlja u naredbeni redak.
Harrow ga pokreće u izravnom načinu rada, kroz port-forward:
kubectl -n nexus get secret openbao-unsealer-tls -o jsonpath='{.data.ca\.crt}' | base64 -d > unsealer-ca.crt
kubectl -n nexus port-forward pod/openbao-unsealer-0 28200:8200 &
AGE_IDENTITY=<path-to-your-custodian-identity> \
OPENBAO_NS=nexus \
UNSEAL_ADDR=https://127.0.0.1:28200 \
UNSEAL_CACERT=unsealer-ca.crt \
UNSEAL_RESOLVE=openbao-unsealer.<namespace>.svc \
UNSEAL_SECRET_JSON_CMD='kubectl -n nexus get secret openbao-unseal-shares-encrypted -o json' \
bash unseal.sh<path-to-your-custodian-identity> je datoteka age identiteta skrbnika, privatna polovica jednog od primatelja u keys.custody.recipients. UNSEAL_RESOLVE je naziv koji nosi certifikat poslužitelja za otpečaćivanje (<namespace> je imenski prostor u kojem je Nexus instaliran, zadano nexus), tako da se TLS provjerava u odnosu na vlastiti CA poslužitelja za otpečaćivanje iako veza ide na 127.0.0.1. Skripta nikada ne isključuje provjeru certifikata.
| Izlazni kod | Posljednji redak | Značenje |
|---|---|---|
| 0 | UNSEALED nexus/openbao-unsealer-0 |
Otpečaćeno. Ako je već bilo otpečaćeno, ništa nije poslano |
| 1 | STILL-SEALED … |
Još uvijek zapečaćeno ili poziv za otpečaćivanje nije uspio |
| 2 | UNSEAL-REFUSED … |
Nedostaje preduvjet naveden u poruci |
| 3 | UNSEAL-REFUSED … |
Ovaj identitet ne može dešifrirati udjele, stoga nije skrbnik ove instalacije. Ništa nije poslano |
Unutar jedne minute pohrana ključeva slijedi sama od sebe. Provjerite pomoću kubectl -n nexus get deploy,statefulset je li sve ponovno spremno.
Skrbici se biraju prije instalacije i svaki izrađuje vlastiti ključ na vlastitom računalu. Chart vidi samo javnu polovicu:
age-keygen -o custodian.key
age-plugin-se keygen --access-control=any-biometry -o custodian.keyPrva naredba stvara obični age identitet; njegov primatelj je redak # public key: age1... u datoteci. Druga stvara identitet pohranjen u Secure Enclaveu na Macu, s primateljem koji počinje s age1se1. Bilo koji od tih primatelja ide u keys.custody.recipients. Datoteka identiteta ostaje kod svojeg skrbnika, izvan mreže.
Sigurnosno kopiranje i vraćanje
Sigurnosno kopiranje i vraćanje prikazuje svaku pohranu s njezinom posljednjom sigurnosnom kopijom i vremenom kada je vraćanje te kopije posljednji put stvarno testirano. Sigurnosna kopija dokazana je tek kada se vrati, pa stranica prati oboje. Sigurnosno se kopira šest pohrana. Glavna baza podataka sadrži ljude i postavke, poslove i dnevnik revizije. Uz nju se nalaze graf znanja i indeks pretraživanja, a zatim pohrana datoteka i pohrana memorije. Ključevi su šesti, zapečaćeni i odvojeni od podataka. Sigurnosne kopije idu na vašu vlastitu pohranu, šifrirane vašim vlastitim ključevima, i Adverant ih ne može pročitati. Kada vraćanje neke pohrane nije testirano u roku koji nalaže vaše pravilo, stranica prikazuje oznaku RESTORE_TEST_OVERDUE s gumbom Test it now. Testno vraćanje izvodi se u zasebnom prostoru i nitko ga ne primjećuje.
Iste dvije radnje dostupne su iz naredbenog retka:
nexusctl backup now
nexusctl backup verifybackup now izrađuje sigurnosnu kopiju svih pohrana odjednom. backup verify provjerava najnoviju sigurnosnu kopiju. Pokrenite oboje prije svake promjene zbog koje ste zabrinuti.
Za vraćanje navedite sigurnosnu kopiju:
nexusctl restore --from <backup-id><backup-id> dolazi s popisa na stranici Sigurnosno kopiranje i vraćanje. Vraćanje mora odobriti druga osoba, a dok se izvodi, traka napretka prikazuje ga s vremenom početka i osobom koja ga je odobrila. Svima je tijekom vraćanja omogućen samo način za čitanje, što se razlikuje od zabrane pristupa: ljudi se mogu prijaviti i čitati. Poslovi se ne pokreću (rasporedi čekaju i nadoknađuju zaostatke), a pretraživanje se vraća kada se vrati indeks pretraživanja. Sve što je zapisano nakon izrade sigurnosne kopije gubi se, pa izvješće o vraćanju to navodi prema vlasnicima kako bi mogli ponoviti unos.
Uz sigurnosne kopije sačuvajte još jednu stvar: Secret nexus-generated u imenskom prostoru nexus. Chart pri prvoj instalaciji stvara generirane lozinke i ključeve za šifriranje instalacije te ih pri svakoj nadogradnji ponovno čita iz tog Secreta. Podaci zapečaćeni pod EXTERNAL_KEY_ENCRYPTION_KEY otvaraju se samo tim ključem. Pohranite kopiju tog Secreta gdje god čuvate najosjetljivije materijale koje imate, jer svatko tko ga posjeduje, posjeduje i te ključeve.
Nadogradnje
Tomás nadograđuje u dva koraka. Prvo pita što će se promijeniti:
nexusctl upgrade plan --bundle nexus-alpha-1.0.0-alpha.2-enterprise.tarPlan navodi što se mijenja u izdanju, svaku promjenu u strukturi baze podataka i može li se ona poništiti. Zatim ga primjenjuje:
nexusctl upgrade apply --bundle nexus-alpha-1.0.0-alpha.2-enterprise.tarPrimjena prvo izrađuje sigurnosnu kopiju i pokreće predprovjeru. Zatim premješta pogone u valovima, pri čemu svaki val čeka dok prethodni ne bude u ispravnom stanju 10 minuta. Stranica Nadogradnja prikazuje svaki val dok traje te stanje ispravnosti instalacije u međuvremenu. Također navodi do kada put za povratak ostaje otvoren; nakon tog datuma za povratak je potrebno vraćanje iz sigurnosne kopije. Ako neki korak ne uspije, Nexus vraća svaki pogon na prethodno izdanje i provjerava ih. Obavijest UPGRADE_ROLLED_BACK tada navodi korak koji nije uspio i potvrđuje da podaci nisu promijenjeni. Popravak je naveden prije gumba Try again, a paket za podršku udaljen je jedan klik.
Za instalaciju bez vanjske veze paket stiže na mediju. Uvoz s medija provjerava potpis izdanja u odnosu na Adverantov ključ izdanja instaliran na sustavu i provjerava idu li verzije samo naprijed. Datoteke koje je potpisao netko drugi odbijaju se uz MEDIA_SIGNATURE_INVALID: ništa se ne učitava, a trenutno pokrenuto izdanje nastavlja s radom.
Što se događa u pozadini
nexusctl upgrade apply pokreće helm upgrade nad chartom. Ako sami nadograđujete pomoću Helma, vrijede ista pravila:
helm upgrade nexus oci://registry.adverant.ai/nexus/charts/nexus --version <version> -n nexus -f harrow-values.yaml
kubectl -n nexus wait --for=condition=Available deploy --all --timeout=900sShema se ažurira prije pokretanja novih podova. Migracije charta su pre-upgrade hookovi koji se izvode redom: prvo bootstrap baze podataka, zatim migracije svake usluge, a potom migracije pozadinskog sustava za sučelje (BFF) konzole. Skrbnički Job također se pokreće, a na instalaciji koja je već inicijalizirana to samo potvrđuje i ništa ne mijenja. Svaki hook Job ima backoff limit postavljen na 0, tako da migracija koja ne uspije zaustavlja nadogradnju i nikada se tiho ne pokušava ponovno: pročitajte njezin dnevnik pomoću kubectl -n nexus logs job/<hook-job> prije ponovnog pokušaja.
Pod svake usluge čeka u init spremniku, wait-for-schema, dok glavna knjiga izdanja ne pokaže da su njezine migracije primijenjene za sliku novog izdanja. Nakon povratka na staro stanje ili nadogradnje koja je promijenila samo vrijednosti, ponovno pokrenuti pod pronalazi svoj redak i odmah se pokreće.
Prije nadogradnje
Tri točke iz napomena o izdanju vrijedne su planiranja:
- Nadograđujte u mirnom razdoblju. Pri prvoj nadogradnji instalacije napravljene iz ranijeg charta, bootstrap posao oduzima stara zadana prava nad tablicama, a svaka usluga vraća svoja vlastita prava kroz vlastitu migraciju. Dok se ta migracija ne izvrši, usluga ne može koristiti svoje tablice. Prekid traje nekoliko sekundi. Ako su sekunde važne, prvo skalirajte usluge na nulu, a zatim ih ponovno skalirajte naviše nakon što poslovi migracije završe.
- Dodijelite organizaciju svakom ključu aplikacijskog programskog sučelja (API). Ključ bez organizacije odbija se uz
403 TOKEN_ORG_MISSINGod strane svake usluge koja provjerava ključeve kroz nexus-auth, uključujući nexus-graphrag. Prije nadogradnje dodijelite svakom takvom ključu organizaciju ili izdajte novi ključ. Stari bcrypt ključevi nastavljaju raditi do datuma svojeg trajnog opoziva. - Nakon toga ispraznite predmemorirane API ključeve. Unosi ključeva u predmemoriji u trajanju do sat vremena nose pogrešan naziv aplikacije dok to ne učinite. Pokrenite ovo nad predmemorijom usluge nexus-auth, odnosno Valkeyjem instalacije (
nexus-valkey, lozinka u Secretunexus-generatedpodVALKEY_PASSWORD):
pw=$(kubectl -n nexus get secret nexus-generated -o jsonpath='{.data.VALKEY_PASSWORD}' | base64 -d)
kubectl -n nexus exec nexus-valkey-0 -- sh -c \
'valkey-cli -a "$1" --scan --pattern "apikey:prefix:*" | xargs -r valkey-cli -a "$1" del' _ "$pw"To vrijedi za zadanu pohranu unutar klastera. Uz dataTier.valkey.mode: external takav pod ne postoji: pokrenite isto skeniranje i brisanje na vlastitom Valkey poslužitelju, s lozinkom iz Secreta navedenog u dataTier.valkey.external.existingSecret.
Povrat na prethodno stanje
Unutar vremenskog okvira koji prikazuje stranica Nadogradnja, opcija Go back vraća svaki pogon na prethodno izdanje. Nakon isteka tog okvira, povratak na staro stanje znači vraćanje sigurnosne kopije koju je nadogradnja napravila na početku.
Dvije se vrijednosti nikada ne smiju mijenjati tijekom nadogradnje ili povratka na staro stanje.
keys.installationName je trajan. Prvi bootstrap pohrane ključeva pod njim stvara identitet instalacije, a taj je identitet ono što glasi na vašoj licenci. Koristite potpuno istu vrijednost u svakoj datoteci vrijednosti koju ikada primijenite na ovu instalaciju.
Secret nexus-generated mora ostati kakav jest. Pri svakoj nadogradnji chart iz njega čita EXTERNAL_KEY_ENCRYPTION_KEY i provjerava njegov oblik. Vrijednost koja nije ni base64 zapis od 32 bajta ni sirovi 32-bajtni ključ starije instalacije zaustavlja generiranje uz EXTERNAL_KEY_ENCRYPTION_KEY_INVALID, a chart nikada ne ispisuje samu vrijednost. To znači da je netko uredio ili zamijenio Secret. Vratite ključ kojim su zapečaćeni podaci ove instalacije, kao base64 zapis njegovih 32 bajta (printf %s "$OLD" | base64), i ponovno pokrenite nadogradnju. Novi nasumični ključ učinio bi nečitljivim sve što je zapečaćeno starim ključem.
Skaliranje
Svaka komponenta ima prekidač i veličinu u datoteci vrijednosti. Obavezne komponente ne mogu se isključiti: chart ih pokreće bez obzira na to što kaže njihov prekidač. Ostalima se može dodijeliti više replika i više resursa.
# harrow-values.yaml (Helm values): scaling
components:
gateway:
replicas: 2
resources: { requests: { cpu: 400m, memory: 1Gi }, limits: { memory: 3Gi } }
graphrag:
replicas: 2
workflows:
replicas: 2
workflows:
concurrency: "8"
dataTier:
qdrant:
resources: { requests: { cpu: 200m, memory: 512Mi }, limits: { memory: 4Gi } }Primijenite to pomoću helm upgrade kao što je gore navedeno. Veličine volumena određuju se pod dataTier.<store>.size; provjerite može li vaša klasa pohrane povećati volumen prije nego što povećate vrijednost. Stranica Stanje instalacije grafički prikazuje koliko su procesori i memorija klastera bili opterećeni te koliko je prostora preostalo u svakom od njih. Povećajte ono čega prvo ponestane.
Paketi za podršku
Kada Harrow treba pomoć Adveranta, Tomás izrađuje paket za podršku:
nexusctl support-bundle --out harrow-support-4471.tar.gzStranica Paket za podršku u konzoli izrađuje istu datoteku. Ona prikuplja dnevnike pogona iz posljednja 24 sata s pojedinostima o stanju ispravnosti i verziji. Postavke ulaze bez svojih tajni, zajedno s izvješćima o predprovjeri i instalaciji. Prije nego što se bilo što zapiše, redakcija zamjenjuje imena i tajne rezerviranim mjestima, a vi možete pregledati točno ono što će biti poslano. Vlastiti sadržaj korisnika nikada se ne prikuplja. Paket odlazi u Adverant ili prijenosom na stranicu Podrška i paketi za podršku vašeg računa ili kao datoteka iznesena na mediju. Mogu ga otvoriti samo inženjeri podrške navedeni u zahtjevu, a briše se nakon 30 dana.
Izvoz dokaza
Revizori i vaš vlastiti tim za usklađenost često traže dokaz da se platforma ponaša kako je opisano. nexusctl evidence export ga zapisuje:
nexusctl evidence export --out harrow-evidence-2027-01Uz zapise koje izvozi, naredba pokreće sonde prihvatljivosti platforme: usmjerivač umjetne inteligencije (AI) je dostupan i odgovara, UNO posao se šalje i završava, a čitanje između organizacija se odbija. Njihovi rezultati nalaze se u probes.json u izlaznoj mapi.
Brzi pregled stanja
nexusctl status --json daje odgovor je li instalacija ispravna i u kojem se stanju nalazi svaka komponenta. Također izvještava o stanju licence s datumom isteka, izdanju i verziji koja se trenutno izvodi. Svaki kompilirani dio naveden je sa svojim sažetkom i potpisom. To je naredba koju trebate postaviti iza vlastitog sustava nadzora.
Deinstalacija
nexusctl uninstall --profile <profile-file><profile-file> je profil postavljanja za klaster, ista datoteka koju ste proslijedili u nexusctl handoff --profile <profile-file> --out <dir> ako vaš tim za platformu upravlja klasterom. Primopredaja za taj tim ispisuje popis na jednostavnom jeziku o tome što Nexus treba od klastera te manifeste za ispunjavanje tih zahtjeva. Deinstalacija uklanja imenske prostore Nexusa i ništa drugo, te zadržava vaše sigurnosne kopije. Identitet instalacije odlazi s njom. Kasnija instalacija na istom klasteru nova je instalacija s novim identitetom, pa je njezino preuzimanje vlasništva novo preuzimanje, a njezina licenca nova licenca.
Stranice Ova instalacija
Operateri instalacije imaju vlastitu grupu u izborniku, Ova instalacija, a njezine stranice mjesto su gdje se odvija većina ovog poglavlja u konzoli. Član koji otvori jednu od njih vidi stranicu Niste administrator, koja navodi tko može djelovati.
| Stranica | Čemu služi |
|---|---|
| Licenca i što ona otključava | Licenca i njezine grupe značajki (poglavlje 2.13, Licence) |
| Ako licenca istekne | Stupnjevi isteka opisani riječima, s datumima ove licence |
| Kompilirani dijelovi | Svaki licencirani modul sa svojom noćnom provjerom potpisa |
| Izvješće o korištenju za Adverant | Godišnji brojači, čitljivi prije slanja |
| Verzije i nadogradnje | Svaka instalirana verzija, s podatkom tko ju je instalirao i kada |
| Nadogradnja | Fazna nadogradnja i put za povratak |
| Sigurnosno kopiranje i vraćanje | Svaka pohrana, njezina posljednja sigurnosna kopija i posljednje testirano vraćanje |
| Stanje instalacije | Čvorovi, kapacitet i trošak rada, s upozorenjima |
| Ključevi i brisanje | Ključ svake organizacije te opcija Erase uz navođenje razloga i odobrenje druge osobe |
| Incidenti | Otvoreni i zatvoreni problemi, s onim što je poduzeto |
| Uskoro se ukida | Značajke koje se isključuju, s datumima, izvozom i zamjenom |
| Status | Svaki dio Nexusa sada i tijekom 30 dana, riječima koje svatko može razumjeti |
| Paket za podršku | Što se šalje u Adverant i kako |
Dvije od ovih stranica zaslužuju poseban osvrt. Kompilirani dijelovi svake noći provjerava svaki licencirani modul u odnosu na Adverantov potpis. Izmijenjena kopija modula se odbija i nikada se ne učitava, dok potpisana kopija nastavlja raditi, a stranica broji odbijanja po mjesecima kako neovlašteno izmijenjena kopija ne bi mogla proći nezapaženo. Status je napisan tako da ga svatko u organizaciji može razumjeti. Prikazuje svaki dio Nexusa sada i tijekom posljednjih 30 dana kao traku po danima, s planiranim održavanjem i nedavnim incidentima, a operater s iste stranice dodaje incident ili termin održavanja.
Community instalacija ima jednu stranicu, Ova instalacija (Community), sa svojom verzijom, stanjem ispravnosti i ažuriranjima. Enterprise stranice pojavljuju se na njoj kao najave koje navode tko ih može uključiti.




