Útgáfa 1.0.0-alpha.1nýjast
Kafli 2.3
Undirbúningur uppsetningar
Hvað Kubernetes-uppsetning á Nexus þarf áður en þú slærð inn skipun, hversu stór hún er og ákvarðanirnar tvær sem ekki er hægt að draga til baka: nafn uppsetningarinnar og lyklavörsluaðilar. Endar á útfylltu undirbúningsblaði Harrow Port Authority.
Þessi síða var þýdd með gervigreind úr enska frumtextanum. Ef eitthvað er óljóst gildir enska síðan til viðmiðunar. Lesa þessa síðu á ensku

Þegar við settum upp Nexus hjá Harrow Port Authority tóku skipanirnar einn síðdegispart. Undirbúningurinn tók viku og megnið af þeirri viku fór í tvær spurningar sem tengjast Kubernetes ekki neitt: hvað við ætluðum að kalla uppsetninguna og hvaða fólk myndi varðveita endurheimtarlyklana hennar. Bæði svörin eru varanleg. Öllu öðru í þessum kafla má breyta síðar með gildisskrá (values file) og helm upgrade.
Ég heiti Tomás Reilly og er kerfisverkfræðingur hjá Harrow. Harrow rekur tvær uppsetningar. Í þessum kafla er skipulögð sú tengda á innra neti fyrirtækisins, þar sem við prófuðum Community fyrst. Rekstrarnet hafnarinnar, sem hefur enga leið út á internetið, fékk sína eigin uppsetningu síðar; kafli 2.10, Einangruð uppsetning (air-gapped), fjallar um hana. Þessi kafli er það sem ég vildi að ég hefði haft fyrsta morguninn: klasann sem Nexus gerir ráð fyrir, nöfnin sem kerfið svarar, hve mikið það krefst af hnútunum þínum og þær ákvarðanir sem þarf að ganga frá með yfirmanni upplýsingatæknimála fyrir uppsetninguna. Kaflanum lýkur með vinnublaðinu sem Aoife Brennan, yfirmaður upplýsingatæknimála hjá okkur, samþykkti áður en við byrjuðum. Kafli 2.4, Útgáfa sótt og sannreynd, fjallar um hvernig útgáfan er sótt og yfirfarin, og kafli 2.5, Forathugun með nexusctl, prófar klasann þinn gagnvart öllu sem hér kemur fram.
Hvað klasinn verður að hafa
Nexus er sett upp sem eitt Helm-kort (chart), nexus, útgáfa 1.0.0-alpha.1. Kortið inniheldur kerfisþjónusturnar og gagnalag þeirra og það neitar að setja sig upp á klasa sem vantar þætti hér að neðan.
| Krafa | Hvað Nexus gerir ráð fyrir | Ástæða |
|---|---|---|
| Kubernetes | 1.33 eða nýrra. Prófað á k3s v1.33.6+k3s1 |
kubeVersion kortsins er >=1.33.0-0, og helm install framfylgir því |
| cert-manager | v1.21.3, sett upp á undan Nexus |
Kortið býr til sína eigin staðbundnu vottunarstöð (CA) og skilríkin sem þjónustur þess nota til að tala saman |
| Helm | v4 (við notuðum v4.3.1) | Helm 4 bíður sjálfgefið eftir hook Jobs kortsins, sem uppsetningin er háð |
| Geymsluflokkur (storage class) | Einn sem er merktur sjálfgefinn, eða einn sem þú tilgreinir í storage.className |
Hver gagnageymsla gerir kröfu um varanlegt geymslurými (persistent volume) |
| Inngangsflokkur (ingress class) | Einn sem er merktur sjálfgefinn, eða einn sem þú tilgreinir í ingress.className |
Opinberu vistföngin þrjú eru venjuleg networking.k8s.io/v1 Ingress-tilföng |
| Gáttir 80 og 443 | Opnar á inngangsstýringunni (ingress controller), sem LoadBalancer- eða NodePort-þjónusta | Notendur ná sambandi við Nexus í gegnum inngangsstýringuna |
| Kerfishönnun | linux/amd64 eða linux/arm64 hnútar |
Hver mynd (image) er smíðuð fyrir hvort tveggja |
Tvennt er vísvitandi undanskilið í þessari töflu. Nexus þarf ekkert þjónustunet (service mesh): gagnkvæmt TLS (mTLS, Transport Layer Security í báðar áttir) milli þjónusta kemur frá staðbundinni vottunarstöð (CA) kortsins í gegnum cert-manager. Kortið er með istio.enabled lykil sem er sjálfgefið stilltur á false, og þú ættir að láta hann vera þannig. Nexus þarf heldur enga eigin stefnuvél fyrir aðgangsheimildir (admission policy engine).
Á vinnustöðinni þinni þarftu kubectl, Helm v4, cosign v3 til að sannreyna undirskriftir, age til að búa til vörslulykla og nexusctl, skipanalínuviðmót (CLI) Nexus-rekstraraðilans. Í kafla 2.4, Útgáfa sótt og sannreynd, kemur fram hvar hvert niðurhal fyrir Nexus er að finna.
Þrjú vistföng
Hver uppsetning svarar á þremur vélarheitum (host names). Kortið kallar þau auðkenni uppsetningarinnar og allar þjónustur neita að ræsa sig án þeirra.
| Gildislykill | Nafn hjá Harrow | Hvað svarar þar |
|---|---|---|
hosts.console |
console.harrow.example |
Stjórnborðið (console), vefforritið sem fólk skráir sig inn í |
hosts.api |
api.harrow.example |
Gáttin (gateway), sem þjónustar forritaskilin (API) og beinir öllum beiðnum um gervigreind (AI) |
hosts.auth |
auth.harrow.example |
Innskráningarþjónustan, nexus-auth |
global.domain geymir lénið sem þessi þrjú eru undir, sem er harrow.example hjá okkur. Hvert vélarheiti er fullt nafn í sjálfu sér og má vera undir hvaða léni sem er á þínu valdi. Við höfðum öll þrjú undir sama léni vegna þess að þá gat eitt skilríki náð yfir þau öll.
Búðu til DNS-færslu (Domain Name System) fyrir hvert þeirra þriggja sem vísar á vistfang inngangsstýringarinnar þinnar. Gerðu það fyrir forathugunina (preflight). nexusctl preflight flettir hverju nafni upp frá vinnustöðinni þinni og stöðvar uppsetninguna ef eitt þeirra er ekki með færslu, því notandi getur ekki náð í nafn sem svarar ekki.
Valið hvar TLS endar
tls.mode kortsins ræður því hver heldur utan um skilríkin fyrir opinberu vistföngin þrjú. Það eru þrír valkostir í boði og þú getur skipt á milli þeirra síðar með uppfærslu.
tls.mode |
Þú leggur til | Hvað kortið gerir |
|---|---|---|
existing (sjálfgefið) |
Kubernetes TLS Secret í nexus nafnarýminu, sem nefnt er í tls.existingSecret |
Öll þrjú Ingress-tilföngin nota þetta eina Secret |
cert-manager |
ClusterIssuer sem þú keyrir, nefndan í tls.clusterIssuer |
Bætir skýringum (annotations) við hvert Ingress þannig að cert-manager gefur út nexus-console-tls, nexus-api-tls og nexus-auth-tls |
none |
Eitthvað fyrir framan klasann sem lýkur TLS-tengingunni, svo sem þinn eigin álagsjafnara (load balancer) | Birtir Ingress-tilföngin án TLS-hluta |
Með existing þjónar eitt skilríki öllum þremur vélarheitunum, þannig að það verður að tilgreina þau öll þrjú, annaðhvort sem þrjú aukavélarheiti (subject alternative names) eða sem algildistákn (wildcard) fyrir lénið þitt. Við notuðum skilríki frá innri vottunarstöð (CA) Harrow. Forathugunin les þetta Secret fyrir uppsetningu og varar við ef skilríkið rennur út innan 30 daga.
Með cert-manager og ACME-útgefanda (Automatic Certificate Management Environment) bætir kortið engri áframsendingu við af sjálfu sér, þannig að /.well-known/acme-challenge/ beiðni á gátt 80 berst óbreytt til lausnarans (solver). Ekki bæta við áframsendingu úr HTTP í HTTPS á inngangsstýringunni sem keyrir á undan áskorunarleiðinni (challenge path); skilríki sem getur ekki endurnýjað sig bilar hljóðlega, vikum síðar.
Sama hvað þú velur fyrir ytri jaðarinn tala þjónusturnar innan nafnarýmisins alltaf saman yfir TLS frá staðbundinni vottunarstöð kortsins. Sá hluti er ekki valkvæður, og þess vegna er cert-manager forsenda jafnvel þegar tls.mode er existing eða none.
Hvað fer út úr klasanum og hvað ekki
Kortið býr til netstefnu sem hafnar öllu sjálfgefið (default-deny) fyrir nexus nafnarýmið. Eftir það eru aðeins þessar samskiptaleiðir leyfðar:
- umferð milli Nexus-belgja (pods) innan nafnarýmisins;
- DNS-uppflettingar til DNS-þjónustu klasans;
- Kubernetes API-þjónninn, fyrir þær fáu þjónustur sem yfirfara vinnslutákn (workload tokens);
- nafnarými inngangsstýringarinnar, til opinberu þjónustanna þriggja;
- öll CIDR-vistfangabil (Classless Inter-Domain Routing) sem þú tilgreinir í
networkPolicy.externalEgressCIDRs.
Þessi síðasti listi er tómur sjálfgefið. Ef þú ætlar að nota póstmiðlara (mail relay) eða líkanaþjón (model server) utan klasans fer vistfangabilið hans þangað. Fjarmælingar (telemetry) eru óvirkar og haldast óvirkar: skemað tekur aðeins við telemetry.enabled: false, og einnig er slökkt á eigin notkunarskýrslum gagnageymslnanna.
Kortið les vistföng API-þjónsins úr klasanum þegar þú setur kerfið upp. Ef aðgangurinn þinn getur ekki lesið kubernetes Endpoints í default nafnarýminu skaltu gefa þau upp sjálfur í networkPolicy.apiServerCIDRs, sem /32 bil. proxy.trustedCIDRs tilgreinir belgjanetið (pod network) sem inngangsstýringin þín er á, þannig að nexus-auth viti hvaða X-Forwarded-For haus á að treysta. Sjálfgefna gildið, 10.42.0.0/16, er belgjanet k3s.
Stærðaráætlun
Sjálfgefnar auðlindabeiðnir (requests) kortsins nema samtals um 2.05 örgjörvakjörnum (CPU cores) og 6.7 GiB af minni. Þetta er það sem verkefnastjórinn (scheduler) tekur frá; hámarksgildin (limits) eru hærri og gagnageymslurnar vaxa upp í þau eftir því sem þú bætir við fólki og skrám.
| Hluti | Umbeðinn örgjörvi (CPU) | Umbeðið minni |
|---|---|---|
| Níu kerfisþjónustur (console, bakendi fyrir framenda (BFF), auth, orchestrator, workflows, gateway, graphrag, probitas, skills engine) | 1.1 cores | 2.6 GiB |
Lyklaþjónustan, nexus-keys |
0.05 cores | 64 MiB |
| PostgreSQL | 0.25 cores | 1 GiB |
| Neo4j | 0.25 cores | 2 GiB |
| Valkey, Qdrant og hlutageymslan (object store) samanlagt | 0.25 cores | 640 MiB |
| OpenBao-þjónarnir tveir í lyklageymslunni | 0.15 cores | 384 MiB |
Sjálfgefnu geymslurýmin telja samtals 142 GiB:
| Gagnageymsla | Gildislykill | Sjálfgefin stærð |
|---|---|---|
| PostgreSQL 16 með PostGIS 3 og pgvector 0.8 | dataTier.postgres.size |
50Gi |
| Hlutageymsla (SeaweedFS) | dataTier.objectStore.size |
50Gi |
| Neo4j 5.26 Community Edition | dataTier.neo4j.size |
20Gi |
| Qdrant | dataTier.qdrant.size |
10Gi |
| Valkey | dataTier.valkey.size |
5Gi |
| Lyklageymslan og afinnsiglarinn (unsealer) hennar | keys.openbao.storage.keystore, keys.openbao.storage.unsealer |
5Gi og 1Gi |
| Kvittanir lyklaþjónustu | keys.receiptsStorage |
1Gi |
Fyrir stakan hnút skaltu gera ráð fyrir 8 vCPU, 32 GiB af vinnsluminni (RAM) og 250 GB SSD-drifi (solid-state drive). Fyrir prófunaruppsetningu duga 4 vCPU, 16 GiB og 200 GB. Uppsetningardiskmyndin hafnar vél með minna en 16 GiB af minni (sjá kafla 2.9, Uppsetningardiskmyndin), og ég myndi líta á það sem lágmarkið alls staðar.
Skjákortshnútar eru valkvæðir. Án hnúts sem býður upp á skjákort (GPU) svarar aðstoðarmaðurinn í gegnum hýst líkan og notar til þess lykil fyrirtækisins sjálfs. Forathugunin tilkynnir það sem viðvörun, aldrei sem villu. Í kafla 2.14, Gervigreindarveitur og líkön, er fjallað um báðar leiðirnar.
Hver geymsla getur einnig keyrt utan klasans: stilltu dataTier.<store>.mode á external og tilgreindu vélarheiti hennar og Secret. Ytri PostgreSQL þarf ofurnotandaaðgang (superuser) fyrir frumstillingu uppsetningarinnar og skilríki sem Nexus getur sannreynt. Í kafla 2.11, Afbrigði: ytri geymslur, TLS og inngangur, er fjallað um það. Ef þú heldur þeim innan klasans skaltu setja þær á geymsluflokk með raunverulegum diskum á bak við sig. Gagnagrunnurinn er sá hluti sem þú munt sakna mest ef staðbundinn diskur á hnút deyr.
Nafn uppsetningarinnar er varanlegt
keys.installationName er það sem rekstraraðilar kalla þessa uppsetningu. Það verður að passa við ^[a-z][a-z0-9-]{0,62}$: lágstafur, og síðan allt að 62 lágstafir, tölustafir eða bandstrik.
Í fyrsta sinn sem lyklageymslan ræsir sig býr hún til auðkenni uppsetningarinnar undir þessu nafni, og það auðkenni er fest til frambúðar. Leyfi frá Adverant er gefið út fyrir það auðkenni, þannig að leyfi sem búið er til fyrir eina uppsetningu er hafnað á annarri með LICENCE_OTHER_INSTALLATION. Endurnefning myndi þýða nýja uppsetningu, nýtt auðkenni og ný leyfi.
Kortið er ekki með neitt sjálfgefið gildi fyrir nafnið. Það hafnar uppsetningu án nafns (INSTALLATION_NAME_MISSING) og hafnar sýnishornsnafninu úr sínum eigin sýnishornsskrám fyrir gildi (INSTALLATION_NAME_EXAMPLE). Forathugunin tilkynnir um hvort tveggja áður en svo langt er komið.
Hjá Harrow eyddum við meiri tíma í þetta en ég kæri mig um að viðurkenna. Við enduðum á harrow-port-authority: það nefnir stofnunina, segir ekkert um á hvaða klasa hún keyrir og mun enn eiga við þegar vélbúnaðinum verður skipt út. Forðastu nöfn eins og prod-k3s-2 sem lýsa vélum dagsins í dag.
Lyklavarsla
Nexus geymir lykla allra eininga í sinni eigin lyklageymslu, inni í klasanum. Þú rekur hana ekki frá degi til dags, en þú ákveður hins vegar fyrir uppsetningu hver getur komið henni í gang aftur eftir endurræsingu. Þetta er sú ákvörðun sem kostar mest ef illa tekst til.
Lyklageymslan samanstendur af tveimur OpenBao-þjónum. Aðalþjónninn, openbao, geymir lyklana og afinnsiglar sig í gegnum annan minni þjón, openbao-unsealer. Afinnsiglarinn er innsiglaður með kerfi Shamirs: fimm hlutir (shares), þar sem hvaða þrír sem er opna hann. Þegar þú setur upp kerfið frumstillir vörsluverk (custody Job) báða þjónana inni í klasanum. Í minni þess verks dulkóðar það hluti afinnsiglarans og endurheimtarlykla lyklageymslunnar fyrir hvern vörsluaðila (custodian) sem þú tilgreinir, geymir aðeins dulmálið (í Secret-tilföngunum openbao-unseal-shares-encrypted og openbao-recovery-keys-encrypted) og afturkallar bæði rótartáknin (root tokens) áður en það lýkur sér af. Enginn ókóðaður hlutur fer nokkurn tíma á disk eða í atburðaskrá.
Eftir sérhverja endurræsingu á hnút afinnsiglarans ræsist afinnsiglarinn innsiglaður. Lyklageymslan bíður eftir honum og ekkert sem þarf á lykli að halda virkar fyrr en vörsluaðili afinnsiglar hann. Það krefst einnar afkóðunar með einkalykli vörsluaðilans sjálfs. Ferlið er í kafla 2.15, Dagur tvö: rekstur Nexus.
Að búa til vörslulykil
Vörsluaðili er tilgreindur með opinbera helmingi age lykils, sem kallast viðtakandi (recipient) hans. Hver vörsluaðili býr til sinn eigin lykil á sinni eigin vél og afhendir þér aðeins viðtakandann:
age-keygen -o custodian.key# public key: línan í skránni er viðtakandinn, sem byrjar á age1. Vörsluaðili með Mac getur geymt lykilinn í Secure Enclave á Mac-tölvunni í staðinn, þannig að einkahelmingurinn yfirgefur aldrei kubbinn og hver notkun biður um fingrafar:
age-plugin-se keygen --access-control=any-biometry -o custodian.keySá viðtakandi byrjar á age1se1. Vörsluverkið dulkóðar fyrir fimm tegundir viðtakenda: age1 (X25519), age1tag1 og age1tagpq1 (tag), age1pq1 (blandað skammtaþolið, hybrid post-quantum) og age1se1 (Secure Enclave). Það hafnar öllum öðrum viðbótarsniðum, svo sem age1yubikey1; tilgreindu þann lykil á einu af samþykktu sniðunum í staðinn.
Kortið yfirfer hvern viðtakanda þegar það er teiknað upp (renders). Innsláttarvilla veldur því að bech32-prófsummu lýkur með villu og viðtakandanum er hafnað, þannig að ekkert er nokkurn tíma innsiglað með lykli sem enginn hefur undir höndum. Ef einhver límir einkalykil inn í listann fyrir mistök hafnar kortið honum án þess að endurvarpa honum. Sýnishornsviðtakandanum í eigin gildisskrám kortsins er einnig hafnað (KEYS_CUSTODIAN_EXAMPLE); enginn hefur einkahelming hans undir höndum.
Hve margir vörsluaðilar
Hver hlutur er dulkóðaður fyrir hvern vörsluaðila, þannig að hver einasti vörsluaðili getur afinnsiglað einn síns liðs. Fleiri vörsluaðilar þýða fleiri leiðir til endurheimtar og fleiri einstaklinga sem geta hver um sig gripið til aðgerða einir síns liðs. Við völdum þrjá hjá Harrow: Aoife, mig og Secure Enclave-lykil á varafartölvu sem geymd er í peningaskáp hafnarinnar. Tveir er það minnsta sem ég myndi sætta mig við. Einn er stakur bilunarpunktur sem mun, fyrr eða síðar, vera í fríi þegar hnútur endurræsist.
Val á útgáfu
edition er community eða enterprise, og enterprise.enabled verður að stemma við það. Kortið hafnar ósamræmi og það hafnar öllum útgáfum sem eru ekki önnur af þessum tveimur.
Útgáfan (edition) ræður því einnig hvaða myndir (images) þú setur upp. Hver kortapakki inniheldur myndalás (images lock), sem er listi yfir allar myndir eftir tætigildi (digest), fyrir eina útgáfu. Community-uppsetning notar aðeins Community-myndir. Enterprise-uppsetning notar Enterprise-lásinn, sem inniheldur Community-myndirnar auk Enterprise-smíðanna, og sækir þær með niðurhalstákni (pull token) af Adverant-reikningnum þínum. Í kafla 2.4, Útgáfa sótt og sannreynd, er lásinn útskýrður og í kafla 2.2, Útgáfur undir vélarhlífinni, er útskýrt hvað hver útgáfa inniheldur.
Þú þarft ekki að ákveða þig til frambúðar. Community-uppsetning færist yfir í Enterprise á staðnum og heldur notendum sínum, skrám og sögu; kafli 2.7, Enterprise sett upp og leyfi virkjað, sýnir hvernig. Við keyrðum Community fyrir tilraunaverkefnið hjá Harrow og færðum okkur yfir sex vikum síðar.
Leyfið er aldrei hluti af þessari áætlun. Það er hvorki gildi í kortinu né tengd skrá: þú flytur það inn eftir uppsetninguna, í gegnum stjórnborðið, nexusctl eða forritaskilin (API).
Val á afhendingarformi
| Form | Hvenær það hentar | Kafli |
|---|---|---|
Helm-kort frá registry.adverant.ai |
Þinn eigin Kubernetes-klasi, með netsamband við myndaskrána (registry) | 2.6 og 2.7 |
nexusctl install |
Sami klasi, þar sem forathugunin og undirskriftarprófunin eru keyrðar fyrir þig | 2.6 |
nexusctl install --single-node |
Ein vél, þar sem nexusctl setur klasann líka upp |
2.8 |
| Diskmynd uppsetningarforritsins | auður netþjónn (bare server) eða sýndarvél (VM) sem þú vilt frekar ekki undirbúa í höndunum | 2.9 |
| Ótengdi pakkinn (offline bundle) | Engin leið út á netið; myndir og kort koma á diski | 2.10 |
Kortið er það sama í öllum formum. Það sem breytist er hver býr til klasann og hvaðan myndirnar koma.
Undirbúningsblaðið
Þetta er blaðið frá Harrow, eins og Aoife samþykkti það. Afritaðu vinstri dálkana tvo og fylltu út þann hægri fyrir þína eigin uppsetningu.
| Ákvörðun | Gildislykill eða skipun | Harrow Port Authority |
|---|---|---|
| Kubernetes og útgáfa | (forathugun les þetta) | k3s v1.33.6+k3s1, þrír hnútar |
| Kube-samhengi (context) fyrir uppsetninguna | --context |
harrow-prod |
| Nafnarými (namespace) | --namespace |
nexus |
| Útgáfa | edition, enterprise.enabled |
community fyrir tilraunaverkefnið, síðan enterprise |
| Myndaskrá (image registry) | global.imageRegistry |
registry.adverant.ai |
| Lén | global.domain |
harrow.example |
| Vistfang stjórnborðs | hosts.console |
console.harrow.example |
| API-vistfang | hosts.api |
api.harrow.example |
| Innskráningarvistfang | hosts.auth |
auth.harrow.example |
| TLS á jaðrinum | tls.mode, tls.existingSecret |
existing, Secret harrow-public-tls frá innri vottunarstöð (CA) Harrow |
| Inngangsflokkur (ingress class) | ingress.className |
traefik |
| Nafnarými inngangs (ingress namespace) | networkPolicy.ingressNamespace |
kube-system |
| Geymsluflokkur (storage class) | storage.className |
local-path |
| Gagnageymslur | dataTier.<store>.mode |
Allt in-cluster, sjálfgefnar stærðir |
| Útleiðabil (outbound ranges) | networkPolicy.externalEgressCIDRs |
Aðeins vistfangabil póstmiðlarans |
| Nafn uppsetningar (varanlegt) | keys.installationName |
harrow-port-authority |
| Vörsluaðilar (í raun varanlegt) | keys.custody.recipients |
Þrír: Aoife Brennan, Tomás Reilly, fartölvan í peningaskápnum (age1se1) |
| Skjákortshnútar | (forathugun les þetta) | Engir fyrir tengda tilraunaverkefnið; hýst líkan með eigin lykli Harrow |
| Fyrsti kerfisstjóri | nexusctl claim-code --administrator |
aoife.brennan@harrow.example |
Tvær línur á þessu blaði eru óafturkræfar: nafn uppsetningarinnar, og vörsluaðilarnir í þeim skilningi að ef þeir glatast allir þá glatast lyklageymslan. Fáðu þessar tvær línur samþykktar af einhverjum sem hefur umboð til að segja já. Allt annað er breyting á gildum.
Þegar vinnublaðið er tilbúið skaltu fara í kafla 2.4, Útgáfa sótt og sannreynd, og sækja útgáfuna.
