Versie 1.0.0-alpha.1nieuwste
Hoofdstuk 2.15
Dag twee: Nexus beheren
Het routinewerk van het beheren van een installatie na de eerste week. Het begint met het ontgrendelen van de sleutelkluis na een herstart en eindigt met het verwijderen van de installatie.
Deze pagina is door AI vertaald vanuit het Engelse origineel. Als er iets onduidelijk is, geldt de Engelse pagina als referentie. Lees deze pagina in het Engels

De eerste keer dat de stroom uitviel in de serverruimte van Harrow Port Authority, kwam alles weer op, behalve de onderdelen die sleutels nodig hadden. Pods stonden op Running en de console werd geladen. Niemand kon een bestand openen. Tomás Reilly had hierover gelezen en toch kostte het hem twintig minuten om zich te herinneren waarom. De unsealer van de sleutelkluis start verzegeld na elke herstart van zijn node, en alleen een beheerder (custodian) kan deze openen.
Dit hoofdstuk volgt de routine van de operator na de eerste week, van de sleutelkluis en zijn beheerders tot het verwijderen van de installatie. Elk nexusctl-werkwoord hier accepteert --explain, waarmee de kubectl- en helm-bewerkingen worden weergegeven die zouden worden uitgevoerd, zonder ze daadwerkelijk uit te voeren. Gebruik dit de eerste keer dat u iets op een productiecluster uitvoert.
Beheer van de sleutelkluis
Een installatie heeft twee OpenBao-servers in zijn namespace. De sleutelkluis, openbao, bevat elke sleutel die Nexus gebruikt. De unsealer, openbao-unsealer, is een tweede, kleine OpenBao met als enige taak het ontzegelen van de sleutelkluis. De sleutelkluis ontzegelt zichzelf via de transitsleutel van de unsealer; de unsealer is verzegeld met het schema van Shamir, als 5 sleuteldelen (shares) waarvan er willekeurig 3 nodig zijn om deze te ontzegelen.
Bij de eerste installatie initialiseert een custody-Job beide servers binnen het cluster. Deze versleutelt de sleuteldelen van de unsealer en de herstelsleutels van de sleutelkluis in zijn eigen geheugen voor elke beheerder die wordt genoemd in keys.custody.recipients, en slaat alleen de cijfertekst op (de Secrets openbao-unseal-shares-encrypted en openbao-recovery-keys-encrypted). Het trekt in dezelfde Job beide root-tokens in. De bundel van elke beheerder bevat voldoende sleuteldelen om zelfstandig te ontzegelen, zodat u na een herstart slechts één beheerder nodig hebt.
Na een herstart van een node
Na elke herstart van de node waarop de unsealer draait (een stroomuitval, een herstart van de machine, een herstart van de containerruntime) start de unsealer verzegeld op. Totdat een beheerder deze ontzegelt, blijft ook de sleutelkluis verzegeld en werkt niets dat een sleutel nodig heeft. De console reageert nog steeds en mensen kunnen zich nog steeds aanmelden, maar elke handeling waarvoor een sleutel uit de sleutelkluis nodig is, wacht: het openen van versleutelde inhoud, een claim, een controle van een gecompileerd onderdeel.
Vraag het aan OpenBao zelf, in elke pod. Dit is de unsealer:
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 $?"Voer dezelfde opdracht uit tegen openbao-0 met -tls-server-name=openbao voor de sleutelkluis. bao status sluit af met 0 wanneer de server ontzegeld is, met 2 wanneer deze verzegeld is en met 1 wanneer deze niet kon antwoorden. Een afsluitcode van 1 zegt niets, omdat de pod mogelijk nog niet actief is. Wacht een minuut en vraag het opnieuw. Als de unsealer ontzegeld is en de sleutelkluis nog steeds verzegeld is, is de sleutelkluis bezig zichzelf te ontzegelen en hoeft u niets te doen.
Ontzegelen
De chart levert unseal.sh mee in zijn files/custody/-map, byte voor byte hetzelfde in elke release. Een beheerder voert dit uit op zijn eigen machine. Het leest het versleutelde Secret, ontsleutelt het eenmalig met de identiteit van de beheerder (een Secure Enclave-identiteit vraagt eenmalig om Touch ID), dient de sleuteldelen in bij de unsealer en bevestigt dat deze ontzegeld is. Er wordt nooit een sleuteldeel naar een bestand geschreven of op een opdrachtregel geplaatst.
Harrow voert dit uit in directe modus, via een 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> is het age-identiteitsbestand van de beheerder, de privéhelft van een van de ontvangers in keys.custody.recipients. UNSEAL_RESOLVE is de naam die het certificaat van de unsealer draagt (<namespace> is de namespace waarin Nexus is geïnstalleerd, standaard nexus), zodat TLS wordt gecontroleerd tegen de eigen CA van de unsealer, zelfs als de verbinding naar 127.0.0.1 gaat. Het script schakelt certificaatcontrole nooit uit.
| Afsluitcode | Laatste regel | Betekenis |
|---|---|---|
| 0 | UNSEALED nexus/openbao-unsealer-0 |
Ontzegeld. Als dit al het geval was, is er niets verzonden |
| 1 | STILL-SEALED … |
Nog steeds verzegeld, of een ontzegelingsaanroep is mislukt |
| 2 | UNSEAL-REFUSED … |
Er ontbreekt een vereiste, die in het bericht wordt genoemd |
| 3 | UNSEAL-REFUSED … |
Deze identiteit kan de sleuteldelen niet ontsleutelen en is dus geen beheerder van deze installatie. Er is niets verzonden |
Binnen een minuut volgt de sleutelkluis vanzelf. Controleer met kubectl -n nexus get deploy,statefulset of alles weer gereed is.
Beheerders worden vóór de installatie gekozen en maken elk hun eigen sleutel aan op hun eigen machine. De chart ziet uitsluitend de publieke helft:
age-keygen -o custodian.key
age-plugin-se keygen --access-control=any-biometry -o custodian.keyDe eerste opdracht maakt een gewone age-identiteit aan; de ontvanger ervan is de regel # public key: age1... in het bestand. De tweede maakt er een aan die wordt bewaard in de Secure Enclave van een Mac, met een ontvanger die begint met age1se1. Beide soorten ontvangers gaan in keys.custody.recipients. Het identiteitsbestand blijft offline bij zijn beheerder.
Back-up en herstel
Back-up en herstel toont elke opslagplaats (store) met de laatste back-up en de laatste keer dat een herstel ervan daadwerkelijk is getest. Een back-up is pas bewezen als deze is hersteld, dus de pagina houdt beide bij. Van zes opslagplaatsen wordt een back-up gemaakt. De hoofddatabase bevat personen en instellingen; taken en het auditlogboek. Daarnaast bevinden zich de kennisgraaf en de zoekindex, en vervolgens de bestandsopslag en de geheugenopslag. De sleutels vormen de zesde, verzegeld en gescheiden gehouden van de gegevens. Back-ups gaan naar uw eigen opslag, versleuteld met uw eigen sleutels, en Adverant kan ze niet lezen. Wanneer een opslagplaats niet binnen uw regel via een test is hersteld, toont de pagina het plaatje RESTORE_TEST_OVERDUE met een knop Nu testen. Een testherstel wordt uitgevoerd in een aparte ruimte en niemand merkt er iets van.
Dezelfde twee handelingen zijn beschikbaar vanaf de opdrachtregel:
nexusctl backup now
nexusctl backup verifybackup now maakt in één keer een back-up van elke opslagplaats. backup verify controleert de laatste back-up. Voer beide uit vóór elke wijziging waar u nerveus over bent.
Om te herstellen, noemt u de naam van de back-up:
nexusctl restore --from <backup-id><backup-id> komt uit de lijst op Back-up en herstel. Een herstel moet door een tweede persoon worden goedgekeurd, en terwijl het loopt, toont de voortgangsbalk dit met de starttijd en wie het heeft goedgekeurd. Iedereen heeft tijdens het herstel alleen-lezenrechten, wat iets anders is dan buitengesloten zijn: mensen kunnen zich aanmelden en lezen. Taken starten niet (schema's wachten en halen de achterstand in), en de zoekfunctie keert terug wanneer de zoekindex weer beschikbaar is. Alles wat is geschreven nadat de back-up was gemaakt, gaat verloren; het herstelrapport vermeldt dit daarom per eigenaar, zodat zij het opnieuw kunnen doen.
Bewaar nog één ding bij uw back-ups: het Secret nexus-generated in de nexus-namespace. De chart maakt bij de eerste installatie de gegenereerde wachtwoorden en versleutelingssleutels van de installatie aan en leest deze bij elke upgrade terug uit dat Secret. Gegevens die zijn verzegeld onder EXTERNAL_KEY_ENCRYPTION_KEY kunnen alleen met die sleutel worden geopend. Bewaar een kopie van het Secret op de plek waar u uw meest gevoelige materiaal bewaart, want iedereen die het in bezit heeft, heeft die sleutels in bezit.
Upgrades
Tomás voert upgrades uit in twee stappen. Eerst vraagt hij wat er zal veranderen:
nexusctl upgrade plan --bundle nexus-alpha-1.0.0-alpha.2-enterprise.tarHet plan vermeldt wat er verandert in de release, elke wijziging in de structuur van de database en of het ongedaan kan worden gemaakt. Daarna past hij het toe:
nexusctl upgrade apply --bundle nexus-alpha-1.0.0-alpha.2-enterprise.tarHet toepassen maakt eerst een back-up en voert een preflight-controle uit. Vervolgens verplaatst het de engines in golven, waarbij elke golf wacht totdat de vorige gedurende 10 minuten gezond is geweest. De pagina Upgrade toont elke golf terwijl deze loopt en in de tussentijd de gezondheid van de installatie. Er staat ook vermeld tot wanneer de weg terug open blijft; na die datum is voor teruggaan een herstel nodig. Als een stap mislukt, rolt Nexus elke engine terug naar de vorige release en controleert ze. De melding UPGRADE_ROLLED_BACK noemt vervolgens de stap die is mislukt en geeft aan dat er geen gegevens zijn gewijzigd. De oplossing wordt weergegeven vóór Opnieuw proberen, en de ondersteuningsbundel is één knop verwijderd.
Voor een installatie zonder verbinding met buiten komt de bundel binnen op een gegevensdrager. Importeren vanaf media controleert de handtekening van de release tegen de Adverant-releasesleutel die op de installatie is geïnstalleerd en controleert of versies alleen vooruitgaan. Bestanden die door iemand anders zijn ondertekend, worden geweigerd met MEDIA_SIGNATURE_INVALID: er wordt niets geladen en de actieve release blijft draaien.
Wat er onder de motorkap gebeurt
nexusctl upgrade apply voert helm upgrade uit tegen de chart. Als u zelf met Helm upgradet, gelden dezelfde regels:
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=900sHet schema wordt verplaatst voordat de nieuwe pods worden uitgerold. De migraties van de chart zijn pre-upgrade hooks die op volgorde worden uitgevoerd: eerst de database-bootstrap, daarna de migraties van elke service en vervolgens die van de backend-for-frontend (BFF) van de console. De custody-Job wordt ook uitgevoerd, en op een installatie die al is geïnitialiseerd, bevestigt deze dat en verandert er niets. Elke hook-Job heeft een backoff-limiet van 0, zodat een migratie die mislukt de upgrade stopt en nooit stilzwijgend opnieuw wordt geprobeerd: lees het logboek ervan met kubectl -n nexus logs job/<hook-job> voordat u het opnieuw probeert.
De pod van elke service wacht in een init-container, wait-for-schema, totdat het releaseregister aangeeft dat de migraties zijn toegepast voor het image van de nieuwe release. Na een rollback, of een upgrade waarbij alleen waarden zijn gewijzigd, vindt een herstarte pod zijn rij en start deze onmiddellijk.
Voordat u upgradet
Drie punten uit de releasenotes zijn het waard om rekening mee te houden in uw planning:
- Upgrade in een rustige periode. Bij de eerste upgrade van een installatie die is gemaakt vanuit een eerdere chart, neemt de bootstrap-taak de oude standaard tabelrechten weg en krijgt elke service zijn eigen rechten terug vanuit zijn eigen migratie. Totdat die migratie wordt uitgevoerd, kan een service zijn tabellen niet gebruiken. De onderbreking duurt enkele seconden. Als seconden tellen, schaal de services dan eerst terug naar nul en schaal ze weer op zodra de migratietaken zijn voltooid.
- Geef elke application programming interface (API)-sleutel een organisatie. Een sleutel zonder organisatie wordt geweigerd met
403 TOKEN_ORG_MISSINGdoor elke service die sleutels controleert via nexus-auth, inclusief nexus-graphrag. Geef vóór het upgraden elke dergelijke sleutel een organisatie of geef een nieuwe sleutel uit. Oude bcrypt-sleutels blijven werken tot de datum waarop ze definitief worden ingetrokken. - Wis na afloop de gecachte API-sleutels. Tot een uur aan gecachte sleutelvermeldingen draagt de verkeerde applicatienaam totdat u dit doet. Voer dit uit tegen de cache van nexus-auth, de Valkey van de installatie (
nexus-valkey, wachtwoord in het Secretnexus-generatedonderVALKEY_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"Dat geldt voor de standaard opslag binnen het cluster. Met dataTier.valkey.mode: external is er niet zo'n pod: voer dezelfde scan en verwijdering uit tegen uw eigen Valkey-host, met het wachtwoord uit het Secret dat wordt genoemd in dataTier.valkey.external.existingSecret.
Terugdraaien
Binnen het tijdvenster dat de pagina Upgrade toont, zet Teruggaan elke engine terug naar de vorige release. Na dit tijdvenster betekent teruggaan het herstellen van de back-up die de upgrade als eerste heeft gemaakt.
Twee waarden mogen nooit veranderen tijdens een upgrade of een rollback.
keys.installationName is permanent. De eerste bootstrap van de sleutelkluis maakt hieronder de identiteit van de installatie aan, en die identiteit is wat uw licentie vermeldt. Gebruik exact dezelfde waarde in elk values-bestand dat u ooit op deze installatie toepast.
Het Secret nexus-generated moet blijven zoals het is. Bij elke upgrade leest de chart EXTERNAL_KEY_ENCRYPTION_KEY eruit en controleert de vorm ervan. Een waarde die noch base64 van 32 bytes is, noch de ruwe sleutel van 32 bytes van een oudere installatie, stopt het renderen met EXTERNAL_KEY_ENCRYPTION_KEY_INVALID, en de chart drukt de waarde nooit af. Dit betekent dat iemand het Secret heeft bewerkt of vervangen. Zet de sleutel terug waaronder de gegevens van deze installatie zijn verzegeld, als base64 van de 32 bytes (printf %s "$OLD" | base64), en voer de upgrade opnieuw uit. Een nieuwe willekeurige sleutel zou alles wat onder de oude sleutel is verzegeld onleesbaar maken.
Schalen
Elke component heeft een schakelaar en een grootte in het values-bestand. Vereiste componenten kunnen niet worden uitgeschakeld: de chart voert ze uit, ongeacht wat hun schakelaar aangeeft. De overige kunnen meer replica's en meer resources krijgen.
# 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 } }Pas dit toe met helm upgrade zoals hierboven. De grootte van volumes wordt ingesteld onder dataTier.<store>.size; controleer of uw opslagklasse een volume kan vergroten voordat u er een verhoogt. Hoe de installatie presteert brengt in kaart hoe druk de processors en het geheugen van het cluster zijn geweest, met de resterende ruimte in elk. Vergroot wat het eerst opraakt.
Ondersteuningsbundels
Wanneer Harrow de hulp van Adverant nodig heeft, maakt Tomás een ondersteuningsbundel:
nexusctl support-bundle --out harrow-support-4471.tar.gzDe pagina Ondersteuningsbundel van de console maakt hetzelfde bestand aan. Het verzamelt de enginelogboeken van de afgelopen 24 uur met gezondheids- en versiegegevens. Instellingen worden opgenomen zonder hun geheimen, samen met de preflight- en installatierapporten. Voordat er iets wordt weggeschreven, vervangt redactie namen en geheimen door plaatshouders, en krijgt u een voorbeeld te zien van wat er precies naar buiten gaat. De eigen inhoud van mensen wordt nooit verzameld. De bundel gaat naar Adverant, hetzij als een upload naar de pagina Ondersteuning en ondersteuningsbundels van uw account, hetzij als een bestand dat op een gegevensdrager wordt meegenomen. Alleen de op de aanvraag genoemde support engineers kunnen het openen, en het wordt na 30 dagen gewist.
Bewijsexport
Auditors en uw eigen complianceteam willen vaak bewijs dat het platform zich gedraagt zoals beschreven. nexusctl evidence export schrijft dit weg:
nexusctl evidence export --out harrow-evidence-2027-01Naast de records die het exporteert, voert de opdracht de acceptatieprobes van het platform uit: de AI-router (artificial intelligence) is bereikbaar en antwoordt, een UNO-taak wordt verzonden en voltooid, en een leesactie tussen verschillende organisaties wordt geweigerd. De resultaten hiervan staan in probes.json in de uitvoermap.
Status in één oogopslag
nexusctl status --json geeft antwoord op de vraag of de installatie gezond is en in welke staat elke component verkeert. Het rapporteert ook de licentiestatus met de vervaldatum, de editie en de actieve release. Elk gecompileerd onderdeel wordt vermeld met zijn digest en handtekening. Dit is de opdracht om achter uw eigen monitoring te plaatsen.
De-installeren
nexusctl uninstall --profile <profile-file><profile-file> is het implementatieprofiel voor het cluster, hetzelfde bestand dat u hebt doorgegeven aan nexusctl handoff --profile <profile-file> --out <dir> als uw platformteam het cluster beheert. Handoff schrijft voor dat team een lijst in duidelijke taal van wat Nexus nodig heeft van het cluster en de manifesten om daaraan te voldoen. Uninstall verwijdert de Nexus-namespaces en niets anders, en behoudt uw back-ups. De identiteit van de installatie verdwijnt hiermee ook. Een latere installatie op hetzelfde cluster is een nieuwe installatie met een nieuwe identiteit, dus de claim ervan is een nieuwe claim en de licentie ervan is een nieuwe licentie.
De pagina's onder Deze installatie
Operators van de installatie hebben hun eigen groep in het menu, Deze installatie, en op die pagina's vindt het grootste deel van dit hoofdstuk plaats in de console. Een lid dat een van deze pagina's opent, ziet de pagina Geen beheerder, waarop staat vermeld wie er wel mag handelen.
| Pagina | Waar het voor dient |
|---|---|
| Licentie en wat deze ontgrendelt | De licentie en de bijbehorende functiegroepen (hoofdstuk 2.13, Licenties) |
| Als de licentie verloopt | De vervalladder in woorden, met de datums van deze licentie |
| Gecompileerde onderdelen | Elke gelicentieerde module met zijn nachtelijke handtekeningcontrole |
| Gebruiksoverzicht voor Adverant | De jaarlijkse tellers, leesbaar voordat ze naar buiten gaan |
| Versies en upgrades | Elke geïnstalleerde versie, met wie deze heeft geïnstalleerd en wanneer |
| Upgraden | De gefaseerde upgrade en de weg terug |
| Back-up en herstel | Elke opslagplaats, de laatste back-up en het laatst geteste herstel ervan |
| Status van de installatie | Nodes, capaciteit en lopende kosten, met waarschuwingen |
| Sleutels en wissen | De sleutel van elke organisatie, en Wissen met een reden en een tweede persoon |
| Incidenten | Open en gesloten problemen, met wat er is gedaan |
| Binnenkort uitgefaseerd | Functies die worden uitgeschakeld, met datums, export en vervanging |
| Status | Elk onderdeel van Nexus nu en over de afgelopen 30 dagen, in woorden die iedereen kan begrijpen |
| Ondersteuningsbundel | Wat er naar Adverant gaat, en hoe |
Twee van deze pagina's verdienen een korte toelichting. Gecompileerde onderdelen controleert elke nacht elke gelicentieerde module tegen de handtekening van Adverant. Een gewijzigde kopie van een module wordt geweigerd en nooit geladen, terwijl de ondertekende kopie blijft draaien, en de pagina telt weigeringen per maand zodat een gemanipuleerde kopie niet onopgemerkt kan blijven. Status is zo geschreven dat iedereen in de organisatie het kan lezen. Het toont elk onderdeel van Nexus nu en over de afgelopen 30 dagen als een reeks dagen, met gepland onderhoud en recente incidenten, en een operator voegt vanaf dezelfde pagina een incident of een onderhoudsvenster toe.
Een Community-installatie heeft één pagina, Deze installatie (Community), met de versie, gezondheid en updates ervan. De Enterprise-pagina's verschijnen hierop als teasers die aangeven wie ze kan inschakelen.




