Verżjoni 1.0.0-alpha.1l-aħħar
Kapitlu 2.11
Varjazzjonijiet: ħażniet esterni, TLS u ingress
Il-valuri li jadattaw lil Nexus għal cluster li mhuwiex vojt, bit-TLS (Transport Layer Security) inkluż, flimkien ma' databases li diġà tħaddem, iċ-ċertifikati tiegħek stess, kontrollur ieħor tal-ingress, klassijiet ta' ħażna, posta, proxies, repliki u Kubernetes immaniġġjat.
Din il-paġna ġiet tradotta bl-IA mill-oriġinal bl-Ingliż. Jekk xi ħaġa mhijiex ċara, il-paġna bl-Ingliż hija r-referenza. Aqra din il-paġna bl-Ingliż

Il-cluster tal-produzzjoni ta' Harrow Port Authority mhuwiex wieħed vojt, u l-istorja tiegħu tat-TLS (Transport Layer Security) waħedha għandha tliet partijiet. It-tim tad-database iħaddem PostgreSQL fuq il-magni tiegħu stess u jrid kull database hemmhekk, b'backup magħmul bil-mod tagħhom. Iċ-ċertifikati jiġu mis-CA (awtorità taċ-ċertifikati) interna ta' Harrow permezz ta' cert-manager. L-ingress controller mhuwiex Traefik, u jinsab fin-namespace tiegħu stess. Xejn minn dan ma jeħtieġ fork taċ-chart. Kull differenza hija valur, u dan il-kapitlu jgħaddi minnhom fl-ordni li bih iltaqa' magħhom Tomás Reilly.
Kull blokk ta' valuri f'dan il-kapitlu huwa framment. Għaqqad dawk li għandek bżonn fil-fajl tal-valuri tiegħek stess, maġenb global, hosts, edition u keys minn kapitlu 2.6, Installazzjoni ta' Community fuq Kubernetes. L-iskema taċ-chart tirrifjuta kwalunkwe ċavetta li ma tafx, għalhekk ċavetta miktuba ħażin tfalli helm lint --strict u l-installazzjoni minflok ma tiġi injorata. Dan huwa apposta: żball tat-tajpjar f'dataTier li jħalli ħażna fil-cluster fis-skiet ikun agħar minn żball.
Ħażniet tad-data esterni
Nexus iżomm id-data tiegħu f'ħames imħażen. B'mod awtomatiku kull wieħed jaħdem ġewwa l-cluster mill-immaġni ffirmata tar-release stess, bil-volum tiegħu stess.
| Ħażna | Ċavetta tal-valuri | Default ġewwa l-cluster | Volum awtomatiku |
|---|---|---|---|
| PostgreSQL 16 b'PostGIS 3 u pgvector 0.8 | dataTier.postgres |
l-immaġni tar-release | 50Gi |
| Valkey 8.1 | dataTier.valkey |
l-immaġni tar-release | 5Gi |
| Neo4j 5.26 Community Edition | dataTier.neo4j |
l-immaġni tar-release | 20Gi |
| Qdrant 1.15 | dataTier.qdrant |
l-immaġni tar-release | 10Gi |
| SeaweedFS 4.48, il-ħażna tal-oġġetti kompatibbli ma' Amazon S3 (Simple Storage Service) | dataTier.objectStore |
l-immaġni tar-release | 50Gi |
Kwalunkwe wieħed minnhom jista' jkun wieħed li tħaddem int minflok. Issettja l-mode tiegħu għal external, agħti l-host tiegħu, u semmi Secret li jżomm il-kredenzjali tiegħu. Żid l-indirizz tal-ħażna ma' networkPolicy.externalEgressCIDRs ukoll (ara t-taqsima tal-politika tan-netwerk hawn taħt), għaliex in-namespace jiċħad kull egress ieħor. Għal ħażna esterna ċ-chart ma jirrendi xejn minn dik il-ħażna: l-ebda StatefulSet, l-ebda Service u l-ebda volum. Is-servizzi jikkonnettjaw mal-host li tajt.
# harrow-external-postgres.yaml (Helm values)
dataTier:
postgres:
mode: external
port: 5432
sslmode: verify-full
external:
host: pg-nexus.db.harrow.example
existingSecret: harrow-postgresIs-Secret jinħoloq minnek, fin-namespace li Nexus jinstalla fih, qabel l-installazzjoni. Iċ-chart iżomm biss ismu: il-pods li għandhom bżonn kredenzjali jaqrawha mis-Secret tiegħek meta jibdew, u xejn ma jiġi kkopjat fis-Secrets taċ-chart stess. Ibdel kredenzjali u erġa' ibda l-pods li jużawha; m'hemm xejn x'terġa' tirrendi.
Kull ħażna tfittex ismijiet ta' ċwievet fissi fis-Secret tagħha:
| Ħażna | Ċwievet fis-Secret tagħha |
|---|---|
| PostgreSQL | username u password għal superuser fuq dak is-server, u ca.crt, l-awtorità taċ-ċertifikati (CA) li ffirmat iċ-ċertifikat tas-server |
| Valkey | password |
| Neo4j | username u password |
| Qdrant | api-key |
| Ħażna tal-oġġetti | access-key u secret-key |
Għabbi kull valur minn fajl, sabiex jibqa' barra mill-kronoloġija tax-shell tiegħek u barra mill-fajl tal-valuri tiegħek:
kubectl create namespace nexus
kubectl -n nexus create secret generic harrow-postgres \
--from-file=username=./pg-username --from-file=password=./pg-password --from-file=ca.crt=./harrow-db-ca.crtĦażna esterna mingħajr Secret imsemmi twaqqaf ir-render, eżattament bħal waħda mingħajr host.
PostgreSQL
Is-server estern irid joffri dak li toffri l-immaġni tar-release: PostgreSQL 16 b'PostGIS 3 u pgvector. It-traffiku lejh huwa dejjem ikkriptat u ċċekkjat mal-ca.crt fis-Secret tiegħek. Issettja sslmode għal verify-full, li jiċċekkja wkoll li ċ-ċertifikat tas-server isemmi l-host li tajt, jew għal verify-ca. B'server estern ir-render jirrifjuta disable u require. Postgres ġewwa l-cluster huwa l-oppost: it-traffiku tiegħu qatt ma joħroġ min-namespace, il-politika tan-netwerk iżżommu hemmhekk, u jieħu disable biss. Irrispettivament mill-mod li tagħżel, iċ-ċertifikat irid isemmi l-host f'external.host, għaliex uħud mis-servizzi jiċċekkjaw l-isem fuq kull konnessjoni.
Waqt l-installazzjoni, bootstrap Job jikkonnettja mas-server bil-kont fis-Secret tiegħek u joħloq ir-rwoli li Nexus jaħdem bihom. Joħloq rwol ta' migratur li huwa s-sid tal-iskema, rwol ta' runtime, u rwol wieħed ta' login għal kull servizz. Nexus jiġġenera l-passwords tagħhom u jżommhom. Ħadd minnhom mhu superuser u ħadd ma jista' jaqbeż is-sigurtà fil-livell tar-ringiela, għalhekk kull politika ta' iżolament fid-database tapplika għal kull servizz. Il-bootstrap innifsu għandu bżonn superuser: wieħed mill-passi tiegħu jsakkar funzjoni inkorporata ta' PostgreSQL, u superuser biss jista' jagħmel dan. Il-bootstrap u l-pass ta' proviżjonament tal-console stess biss jużaw il-kont. Servizz ta' database amministrat li r-rwol ta' amministratur tiegħu mhuwiex superuser reali ma jistax jospita d-database ta' Nexus għal dik ir-raġuni.
Il-Job jiċċekkja s-server tiegħek qabel ma jmissu. Jieqaf, mingħajr ma jkun biddel xejn, jekk il-kont fis-Secret tiegħek mhuwiex superuser. Jekk rwol imsejjaħ nexus diġà jeżisti b'SUPERUSER jew BYPASSRLS, il-Job jieqaf b'nexus-db-bootstrap: role nexus exists with SUPERUSER or BYPASSRLS on this server; nexus_migrator will not be made a member of it. Nothing more was done. Neħħi dawk l-attributi minn dak ir-rwol, jew uża server fejn l-isem huwa ħieles, u erġa' installa.
Valkey, Neo4j, Qdrant u l-ħażna tal-oġġetti
L-erbgħa l-oħra jieħdu l-istess tliet settings: mode, external.host u external.existingSecret. Hawn huma l-erbgħa kollha mibdula għal dawk ta' Harrow stess:
# harrow-external-stores.yaml (Helm values)
dataTier:
valkey:
mode: external
external: { host: valkey.db.harrow.example, existingSecret: harrow-valkey }
neo4j:
mode: external
external: { host: neo4j.db.harrow.example, existingSecret: harrow-neo4j }
qdrant:
mode: external
external: { host: qdrant.db.harrow.example, existingSecret: harrow-qdrant }
objectStore:
mode: external
external: { host: objects.db.harrow.example, existingSecret: harrow-objects }Ħaddem il-verżjonijiet li jġorru l-immaġnijiet tar-release, elenkati fit-tabella ta' hawn fuq, fuq il-ports li jużaw is-servizzi. Valkey jisma' fuq 6379 u Neo4j fuq 7687; Qdrant jieħu 6333 u l-ħażna tal-oġġetti 8333. Il-ħażna tal-oġġetti trid tkun kompatibbli ma' S3. Il-password ta' Valkey tidħol f'indirizz ta' konnessjoni ġewwa kull pod, għalhekk żommha għal ittri u ċifri (il-karattri -._~ huma tajbin ukoll).
Jekk mode huwa external u external.host huwa vojt, ir-render jieqaf b'dataTier.<store>.external.host is required when mode is external. Li tmexxi ħażna minn ġewwa l-cluster għal esterna wara li n-nies ikunu użaw Nexus hija migrazzjoni tad-data li tagħmilha int stess, u ċ-chart mhux se jikkopja xejn għalik. Iddeċiedi qabel l-ewwel installazzjoni.
Il-ħażna taċ-ċwievet, OpenBao, mhijiex f'din il-lista u ma tistax tkun esterna. Hija parti mill-identità tal-installazzjoni u taħdem fil-cluster fuq kull installazzjoni.
TLS fit-tarf pubbliku
tls.mode jiddeċiedi kif it-tliet hosts pubbliċi jiksbu ċ-ċertifikati tagħhom, u xejn aktar. It-traffiku bejn is-servizzi dejjem juża TLS reċiproku b'ċertifikati mis-CA lokali taċ-chart stess, maħruġa minn cert-manager, ikun xi jkun il-mod. M'hemm l-ebda service mesh, u istio.enabled jibqa' false.
tls.mode |
Min jagħmel iċ-ċertifikat | X'inhu dak li trid tissettja |
|---|---|---|
existing (il-predefinit) |
Int. Secret wieħed iżomm ċertifikat għat-tliet hosts kollha. | tls.existingSecret |
cert-manager |
ClusterIssuer li diġà tħaddem. Iċ-chart jitolbu ċertifikat wieħed għal kull host. | tls.clusterIssuer |
none |
Ħadd fil-cluster. It-TLS jintemm quddiemu, fil-load balancer jew fil-proxy tiegħek. | Xejn, iżda aqra t-twissija hawn taħt |
existing
# harrow-tls-existing.yaml (Helm values)
tls:
mode: existing
existingSecret: harrow-public-tlsKull Ingress iservi s-Secret harrow-public-tls, għalhekk iċ-ċertifikat tiegħu jrid isemmi console.harrow.example, api.harrow.example u auth.harrow.example. Oħolqu fin-namespace qabel ma tinstalla:
kubectl -n nexus create secret tls harrow-public-tls --cert=harrow-public.crt --key=harrow-public.keyPreflight jaqrah, iwissi meta jiskadi fi żmien 30 jum, u jsemmi s-Secret meta jkun nieqes. Meta l-mod ikun existing u l-isem ikun vojt, ir-render jieqaf b'tls.existingSecret is required when tls.mode is existing.
cert-manager
# harrow-tls-cert-manager.yaml (Helm values)
tls:
mode: cert-manager
clusterIssuer: harrow-internal-caIċ-chart iżid l-annotazzjoni cert-manager.io/cluster-issuer ma' kull wieħed mit-tliet Ingresses, u cert-manager jagħmel is-Secrets nexus-console-tls, nexus-api-tls u nexus-auth-tls. Mingħajr tls.clusterIssuer ir-render jieqaf b'tls.clusterIssuer is required when tls.mode is cert-manager.
Jekk l-issuer tiegħek juża ACME (Automatic Certificate Management Environment) bl-isfida HTTP-01, m'hemm bżonn ta' xejn ieħor. Iċ-chart ma jżid l-ebda ridirezzjoni tiegħu stess, għalhekk talba għal /.well-known/acme-challenge/ tilħaq is-solver tal-issuer tiegħek mingħajr tibdil. Fuq sit mingħajr internet, is-solver huwa immaġni wkoll: poġġi l-immaġni cert-manager-acmesolver ta' cert-manager fir-reġistru tiegħek, inkella kull pod ta' sfida jistenna f'ErrImagePull.
ebda
# harrow-tls-none.yaml (Helm values)
tls:
mode: none
proxy:
trustedCIDRs: "10.30.0.0/16"B'none, l-Ingresses ma jġorru l-ebda taqsima tat-TLS. Użah meta load balancer jew reverse proxy quddiem il-cluster itemm it-TLS għat-tliet hosts.
proxy.trustedCIDRs isemmi l-hops tal-proxy li nexus-auth jemmen il-header X-Forwarded-For tagħhom. Id-default, 10.42.0.0/16, huwa n-netwerk tal-pods ta' k3s, fejn jaħdem l-ingress controller tiegħu. Fuq kwalunkwe cluster ieħor, issettjah għan-netwerk li jużaw il-pods tal-ingress controller tiegħek, sabiex il-limiti tar-rata tal-login u r-rekords tal-awditjar jaraw l-indirizz tal-persuna u mhux tal-proxy.
Kontrolluri tal-ingress
Iċ-chart jagħmel tliet Ingresses sempliċi ta' Kubernetes, wieħed għal kull host pubbliku. Kull wieħed jibgħat il-passaġġ / lejn Service wieħed.
| Ingress | Host | Service u port |
|---|---|---|
nexus-console |
hosts.console |
nexus-alpha, 3000 |
nexus-api |
hosts.api |
nexus-gateway, 9092 |
nexus-auth |
hosts.auth |
nexus-auth, 9101 |
Tliet valuri jsawruhom, u valur wieħed fil-politika tan-netwerk irid jaqbel.
# harrow-ingress.yaml (Helm values)
ingress:
enabled: true
className: harrow-nginx
annotations:
"<annotation-key>": "<annotation-value>"
networkPolicy:
ingressNamespace: ingress-harrowingress.classNameisemmi l-IngressClass. Jekk jitħalla vojt, iċ-chart iħalli l-klassi barra u l-klassi default tal-cluster tieħu t-tliet Ingresses. Preflight jiċċekkja li l-klassi teżisti jew, meta ma tkun semmejt l-ebda waħda, li eżattament klassi waħda hija mmarkata bħala default.ingress.annotationsjiżdied mat-tliet Ingresses kollha. Il-valuri huma strings, għalhekk poġġi n-numri u l-booleans fil-virgoletti. Użah għas-settings tal-controller tiegħek stess.ingress.enabled: falsema jirrendi l-ebda Ingress, għal sit li jibgħat it-traffiku lejn it-tliet Services b'xi mod ieħor.networkPolicy.ingressNamespacehuwa n-namespace li jaħdem fih l-ingress controller tiegħek.
Dak tal-aħħar iħawwad lin-nies. Il-politika tan-netwerk taċ-chart tiċħad it-traffiku kollu lejn in-namespace b'mod awtomatiku u mbagħad tħalli l-ingress controller jidħol fit-tliet Services pubbliċi biss min-namespace li ssemmi int. Id-default, kube-system, huwa tajjeb għal k3s, li jħaddem Traefik hemmhekk. B'kwalunkwe controller ieħor, jekk tħallih mhux mibdul il-controller ma jkunx jista' jilħaq lil Nexus: l-Ingresses jeżistu, il-controller jirreġistra timeouts tal-konnessjoni, u l-brawżer jikseb żball tal-gateway. Il-kontroll "Ingress ports" ta' Preflight ifittex Service f'dak in-namespace miftuħ fuq il-ports 80 u 443, bħala LoadBalancer jew NodePort, u l-linja fix tiegħu ssemmi dan il-valur.
Il-bqija tal-politika tan-netwerk
networkPolicy.enabled huwa true b'mod awtomatiku u għandu jibqa' hekk. Bih, xejn fin-namespace ma joħroġ 'il barra ħlief id-DNS (Domain Name System), il-Kubernetes API (application programming interface) għar-reviżuri tat-tokens, u l-indirizzi li telenka int.
# harrow-network.yaml (Helm values)
networkPolicy:
apiServerCIDRs: ["10.30.0.1/32"]
externalEgressCIDRs: ["10.30.40.25/32"]apiServerCIDRs huwa l-indirizz tal-API server bħala /32 CIDRs (Classless Inter-Domain Routing). Meta jkun vojt, iċ-chart jaqrah mill-cluster waqt l-installazzjoni. helm template m'għandu l-ebda cluster x'jaqra, għalhekk agħtih hemmhekk. externalEgressCIDRs huwa kull ħaġa oħra li workload jista' jilħaq, vojt b'mod awtomatiku. Harrow jelenka r-relay tal-posta tiegħu. Kull ħażna tad-data esterna barra n-namespace trid tiġi elenkata hawn ukoll, inkella l-politika ta' ċaħda awtomatika twaqqaf lis-servizzi milli jilħquha.
Tliet workloads biss jitkellmu mal-API server: is-servizz tal-evidenza nexus-probitas, l-orkestratur, u l-Job tal-kustodja tal-ħażna taċ-ċwievet. Huma jiċċekkjaw it-tokens tas-service-account li jippreżentaw workloads oħra. Il-politika tagħti l-indirizz tal-API server, fuq il-ports 6443 u 443, lil dawk it-tlieta u lil xejn ieħor. Jekk it-tlieta ma jistgħux jilħquh, ma jistgħux jiċċekkjaw it-tokens li jippreżentaw workloads oħra, għalhekk agħti kull indirizz li jista' jkollu.
L-għażla ta' mod tat-TLS
Harrow għażel cert-manager bis-CA interna tiegħu bħala ClusterIssuer, u r-raġuni kienet it-tiġdid. B'existing, persuna ġġedded iċ-ċertifikat fis-Secret qabel ma jiskadi, u t-twissija ta' 30 jum ta' preflight hija l-unika tfakkira. B'cert-manager, it-tiġdid iseħħ waħdu u ħadd m'għandu għalfejn jiftakar. none jgħodd għal sit fejn kull indirizz pubbliku diġà jinsab wara load balancer li jtemm it-TLS għal ħafna sistemi, u fejn dak it-tim huwa s-sid taċ-ċertifikati. Tkun xi tkun l-għażla tiegħek, iċ-ċertifikat li jara brawżer irid ikun wieħed li l-brawżer jafda. Ċertifikat iffirmat minnu nnifsu li n-nies jikklikkjaw biex jaqbżuh ikisser il-passkeys, għaliex Chrome ma jagħmilx jew ma jużax passkey wara twissija ta' ċertifikat.
Ħażna, posta, u repliki u riżorsi
Klassi ta' ħażna (storage class)
# harrow-storage.yaml (Helm values)
storage:
className: harrow-ssd
dataTier:
postgres:
size: 200Gi
objectStore:
size: 500Gistorage.className japplika għal kull PVC (persistent volume claim) tas-saff tad-data u għall-volumi tal-ħażna taċ-ċwievet. Vojt ifisser il-klassi default tal-cluster, u preflight ifalli meta l-ebda klassi ma tkun immarkata bħala default u int ma tkun semmejt l-ebda waħda. Kull ħażna ġewwa l-cluster għandha l-size tagħha stess. Dawk tal-ħażna taċ-ċwievet huma keys.openbao.storage.unsealer u keys.openbao.storage.keystore, b'keys.receiptsStorage għall-irċevuti. Agħżel daqsijiet għat-tkabbir ta' sena.
Posta elettronika
# harrow-mail.yaml (Helm values)
smtp:
existingSecret: harrow-smtpNexus jibgħat stediniet u avviżi permezz tas-server tal-posta tiegħek. smtp.existingSecret isemmi Secret li toħloq int, fin-namespace, bid-dettalji tas-server tal-posta. Bħal f'kull integrazzjoni, iċ-chart jieħu l-isem ta' Secret u qatt kredenzjali. Ftakar fil-politika tan-netwerk: żid l-indirizz tar-relay ma' networkPolicy.externalEgressCIDRs, inkella l-posta tieqaf fit-tarf tan-namespace. Sakemm il-posta ma taħdimx, l-istediniet ma jistgħux jintbagħtu, u l-lista ta' kontroll tal-ewwel amministratur tgħid hekk.
Repliki u riżorsi
Kull komponent ewlieni għandu għadd ta' repliki u riżorsi ta' Kubernetes taħt components, u kull ħażna ġewwa l-cluster għandha riżorsi taħt dataTier.
# harrow-sizing.yaml (Helm values)
components:
console: { replicas: 2, resources: { requests: { cpu: 200m, memory: 512Mi }, limits: { memory: 1Gi } } }
auth: { replicas: 2 }
gateway: { replicas: 2, resources: { requests: { cpu: 400m, memory: 1Gi }, limits: { memory: 2Gi } } }
graphrag: { resources: { requests: { cpu: 400m, memory: 1Gi }, limits: { memory: 3Gi } } }
dataTier:
postgres:
resources: { requests: { cpu: "1", memory: 4Gi }, limits: { memory: 8Gi } }
neo4j:
heap: 2G
pagecache: 1G
resources: { requests: { cpu: 500m, memory: 4Gi }, limits: { memory: 4Gi } }Il-pod default ta' Neo4j jitlob 2 GiB u jista' juża sa 4 GiB. Bi 3 GB ta' heap u page cache, għolli t-talba tiegħu wkoll, sabiex il-pod jitqiegħed fuq node li għandu l-memorja.
Il-komponenti b'replicas u resources huma console, bff, auth, orchestrator, workflows, gateway, graphrag, probitas u skillsEngine. Is-servizz taċ-ċwievet, keys, jieħu resources biss. Dawn il-komponenti ewlenin huma meħtieġa u ma jistgħux jintfew; iċ-chart iħaddimhom ikun xi jkun dak li jgħid is-swiċċ enabled tagħhom. L-imħażen tas-saff tad-data jħaddmu replika waħda kull wieħed.
Fuq ħażna bil-mod, żewġ valuri oħra jagħtu ħin lis-servizzi biex jibdew: probes.startupFailureThreshold (60 b'mod awtomatiku) u schemaWait.timeoutSeconds (1800), kemm idum jistenna servizz għall-migrazzjonijiet tad-database tiegħu qabel ma l-container tal-bidu tiegħu jfalli b'ismu.
Sessjonijiet ta' dħul, limiti tar-rata u hosts ta' mudelli privati
Tliet gruppi iżgħar ta' valuri ta' min ikun jafhom qabel l-installazzjoni, għaliex in-nies jindunaw bihom fl-ewwel jum.
# harrow-auth.yaml (Helm values)
auth:
accessTokenTTL: 15m
refreshTokenTTL: 12h
rateLimitPerMinute: 5000
ai:
installationHosts: [models.harrow.internal, .gpu.harrow.internal]auth.accessTokenTTL u auth.refreshTokenTTL huma kemm idumu ż-żewġ tokens ta' sessjoni. Id-defaults, 15-il minuta u 12-il siegħa, ifissru li persuna li tagħlaq il-laptop filgħaxija terġa' tidħol fis-sistema filgħodu. Qassar ir-refresh token jekk il-politika tiegħek titlob dan, u stenna aktar logins.
auth.rateLimitPerMinute huwa l-aktar talbiet li persuna li tkun daħlet fis-sistema tista' tagħmel lis-servizz tal-login f'minuta qabel ma jwieġeb 429. Id-default, 5000, huwa madwar 83 fis-sekonda minn kont wieħed, biżżejjed għall-console u għall-iskripts. Installazzjoni m'għandhiex pjanijiet ta' abbonament, għalhekk kull persuna tikseb l-istess limitu. Niżżlu biex issaħħaħ il-protezzjoni kontra l-abbuż, jew għollieh għal awtomazzjoni tqila. Il-protezzjoni kontra l-brute-force tal-login, bħall-imblukkar tal-kont u l-limiti fuq it-tentattivi tat-tieni kontroll, hija separata u mhijiex issettjata hawn.
ai.installationHosts jelenka ismijiet ta' hosts żejda ġewwa l-installazzjoni, għas-servers tal-mudelli tal-IA (intelliġenza artifiċjali) tal-organizzazzjoni stess fuq ismijiet privati. Kull entrata hija isem ta' host, .suffix li jaqbel ma' kull isem taħtu, indirizz IP, jew blokk IPv4 CIDR (Classless Inter-Domain Routing). Ir-router jittrattahom bħala parti mill-installazzjoni maġenb il-hosts tar-release stess. Is-server tal-mudell innifsu jissemma f'ai.localProvider.baseUrl; kapitlu 2.14, Fornituri u mudelli tal-IA, ikopri t-tnejn.
X'qatt mhu valur
Xi affarijiet li n-nies ifittxu f'fajl tal-valuri mhumiex hemm, apposta.
| Mhux fil-fajl tal-valuri | Għaliex, u fejn jinsab minflok |
|---|---|
| Il-liċenzja | Tiġi importata wara l-installazzjoni, fil-console jew b'nexusctl licence import <file>. Liċenzja qatt mhi valur taċ-chart jew fajl immuntat. Kapitlu 2.13, Liċenzji, għandu d-dettalji. |
| Ċwievet tal-mudelli | Kull organizzazzjoni żżomm iċ-ċwievet tagħha stess fil-pool tagħha stess, imdaħħla fil-console. L-ebda kredenzjali ta' fornitur tal-IA mhi qatt valur taċ-chart. |
| Tisħiħ tar-reġistrazzjoni | Il-CAPTCHA tal-internet u l-iskrin tan-netwerk tar-reġistrazzjoni huma t-tnejn mitfija fuq installazzjoni, u m'hemm l-ebda valur biex tixgħel wieħed jew l-ieħor. Il-CAPTCHA jkun jeħtieġ l-internet f'kull reġistrazzjoni. L-iskrin tan-netwerk ikun jeħtieġ database ta' ġeolokalizzazzjoni liċenzjata li ċ-chart ma jġorrx. Ir-reġistrazzjoni ta' barrani tinżamm għall-approvazzjoni ta' amministratur minflok, kif jispjega kapitlu 2.12, L-ewwel tħaddim. |
| Telemetrija | L-iskema taċċetta setting wieħed għal telemetry.enabled, li huwa false. Xejn ma joħroġ minn installazzjoni, u r-rappurtar tas-saff tad-data stess (ir-rapport tal-użu ta' Neo4j, it-telemetrija ta' Qdrant) huwa mitfi wkoll. |
Iċċekkja l-fajl kollu qabel ma tinstalla
Bil-frammenti magħquda f'fajl wieħed, ħaddem żewġ kontrolli fuqu mill-workstation tiegħek. helm lint --strict jivvalida kull ċavetta mal-iskema taċ-chart, u helm template jirrendi r-release kollu biex taqrah qabel ma jsir xejn. Il-kmandi jużaw l-indirizz taċ-chart ta' Community; għal Enterprise, agħti l-passaġġ taċ-chart ta' Enterprise li niżżilt minflok (kapitlu 2.7, Installazzjoni ta' Enterprise u l-applikazzjoni ta' liċenzja). Render fuq il-workstation tiegħek ma jistax jaqra l-indirizz tal-API server minn cluster, għalhekk issettja networkPolicy.apiServerCIDRs fil-fajl l-ewwel.
Iż-żewġ kontrolli:
helm lint --strict oci://registry.adverant.ai/nexus/charts/nexus --version 1.0.0-alpha.1 -f harrow-prod-values.yaml
helm template nexus oci://registry.adverant.ai/nexus/charts/nexus --version 1.0.0-alpha.1 \
-n nexus -f harrow-prod-values.yaml > harrow-render.yamlĊavetta miktuba ħażin tfalli l-lint b'"additional properties" u ssemmi ċ-ċavetta. Valur meħtieġ nieqes, bħal host meta ħażna tkun esterna, ifalli r-render bis-sentenza kkwotata f'dan il-kapitlu. helm template m'għandu l-ebda cluster x'jaqra, għalhekk agħti networkPolicy.apiServerCIDRs meta tirrendi offline, inkella jieqaf u jistaqsi għalihom.
Imbagħad ħaddem preflight bl-istess fajl. Preflight huwa l-uniku kontroll li jaqra l-cluster u l-valuri flimkien: huwa fejn namespace tal-ingress ħażin, klassi tal-ħażna nieqsa jew ċertifikat li jiskadi l-ġimgħa d-dieħla jidher qabel ma xi ħadd jiddependi fuq l-installazzjoni.
Kubernetes immaniġġjat
Nexus jaħdem fuq kwalunkwe Kubernetes 1.33 konformi jew aktar tard, inkluż is-servizz amministrat ta' fornitur tal-cloud. Xejn fiċ-chart mhu speċifiku għal fornitur wieħed. Dak li jinbidel minn k3s huwa numru żgħir ta' valuri, kull wieħed kopert hawn fuq:
- cert-manager v1.21.3 jiġi installat l-ewwel, bħal fuq kwalunkwe cluster. | Fuq cluster amministrat | X'għandek tissettja jew tiċċekkja | |---|---| | Ħażna | Semmi l-klassi tal-fornitur f'
storage.className, jew immarka waħda bħala default. | | Ingress | Installa l-ingress controller li tuża, esponih fuq il-ports 80 u 443, issettjaingress.classNamejekk mhuwiex id-default, u ssettjanetworkPolicy.ingressNamespacegħan-namespace tiegħu. | | Il-hops tal-proxy | Issettjaproxy.trustedCIDRsgħan-netwerk tal-pods ta' dak il-controller. | | L-API server | Jekk l-installazzjoni ma tistax taqra l-indirizz tal-API server mill-cluster, agħtih f'networkPolicy.apiServerCIDRs. | | Infurzar tal-politika tan-netwerk | Il-politiki taċ-chart jidħlu fis-seħħ biss fejn il-plugin tan-netwerk tal-cluster jinforza NetworkPolicy. Agħżel konfigurazzjoni tal-cluster li tagħmel dan. | | Immaġnijiet | In-nodes iridu jilħquregistry.adverant.ai, jew ir-reġistru tiegħek stess imsemmi f'global.imageRegistry. |
Ħaddem preflight qabel kull ħaġa oħra. Jaqra l-cluster u l-fajl tal-valuri flimkien u jistampa kull wieħed minn dawn bħala ringiela, bit-tiswija maġenb kull wieħed li jonqos. Kapitlu 2.5, Preflight b'nexusctl, juri r-rapport.

