IdħolIbbukkja laqgħa informattiva

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ż

17 minuti qari

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-postgres

Is-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-tls

Kull 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.key

Preflight 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-ca

Iċ-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.

Indirizz, ċertifikat, proxy u posta
Indirizz, ċertifikat, proxy u posta
Ladarba jiġi installat, l-indirizz, iċ-ċertifikat, il-proxy u l-posta kull wieħed għandu t-test tiegħu stess fuq paġna waħda, u r-riżultat jinkiteb bil-kliem.

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-harrow
  • ingress.className isemmi 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.annotations jiż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: false ma jirrendi l-ebda Ingress, għal sit li jibgħat it-traffiku lejn it-tliet Services b'xi mod ieħor.
  • networkPolicy.ingressNamespace huwa 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.

Fuq ix-xellug, kaxxa "ingress controller" tinsab ġewwa konfini b'linji maqtugħa ttikkettat "namespace: networkPolicy.ingressNamespace (kube-system on k3s)". Tliet vleġeġ joħorġu minnha, ittikkettati console.harrow.example, api.harrow.example u auth.harrow.example. Jaqsmu linja solida ttikkettata "nexus namespace: default deny" u jaslu fi tliet kaxxi: "nexus-alpha :3000", "nexus-gateway :9092" u "nexus-auth :9101". Ir-raba' vleġġa, griża minn kaxxa "any other namespace" tieqaf fil-linja solida b'salib żgħir.
It-tliet hosts pubbliċi, in-namespace tal-ingress controller, u l-politika tan-netwerk li tħalli jidħol biss dak in-namespace.

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: 500Gi

storage.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-smtp

Nexus 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, issettja ingress.className jekk mhuwiex id-default, u ssettja networkPolicy.ingressNamespace għan-namespace tiegħu. | | Il-hops tal-proxy | Issettja proxy.trustedCIDRs għ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ħqu registry.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.

Qabel ma tinstalla
Qabel ma tinstalla
Preflight li għadda fuq cluster tal-produzzjoni. Kull ringiela hija rekwiżit wieħed, u kull twissija ġġorr it-tiswija tagħha fuq il-linja ta' taħt.