AccediPrenota un briefing

Capitolo 2.11

Varianti: archivi esterni, TLS e ingress

I valori che adattano Nexus a un cluster non vuoto, incluso TLS (Transport Layer Security), insieme a database già in esecuzione, certificati propri, un altro ingress controller, classi di archiviazione, posta elettronica, proxy, repliche e Kubernetes gestito.

Questa pagina è stata tradotta dall'IA a partire dall'originale in inglese. In caso di dubbi, fa fede la pagina in inglese. Legga questa pagina in inglese

17 minuti di lettura

Il cluster di produzione di Harrow Port Authority non parte da zero, e già solo la configurazione TLS (Transport Layer Security) si articola in tre parti. Il team dei database gestisce PostgreSQL sulle proprie macchine e vuole che ogni database risieda lì, con il proprio sistema di backup. I certificati provengono dalla CA (autorità di certificazione) interna di Harrow tramite cert-manager. L'ingress controller non è Traefik e risiede in un proprio namespace. Nulla di tutto ciò richiede un fork del chart. Ogni differenza corrisponde a un valore, e questo capitolo li esamina nell'ordine in cui Tomás Reilly li ha affrontati.

Ogni blocco di valori in questo capitolo è un frammento. Unisca quelli necessari nel Suo file dei valori, accanto a global, hosts, edition e keys del capitolo 2.6, Installazione di Community su Kubernetes. Lo schema del chart rifiuta qualsiasi chiave sconosciuta, pertanto una chiave scritta in modo errato fa fallire helm lint --strict e l'installazione anziché essere ignorata. Ciò è intenzionale: un errore di battitura in dataTier che lasciasse silenziosamente un archivio dati nel cluster sarebbe peggio di un errore.

Archivi dati esterni

Nexus conserva i propri dati in cinque archivi dati. Per impostazione predefinita, ciascuno viene eseguito all'interno del cluster a partire dall'immagine firmata della release stessa, con il proprio volume.

Archivio Chiave dei valori Predefinito nel cluster Volume predefinito
PostgreSQL 16 con PostGIS 3 e pgvector 0.8 dataTier.postgres l'immagine della release 50Gi
Valkey 8.1 dataTier.valkey l'immagine della release 5Gi
Neo4j 5.26 Community Edition dataTier.neo4j l'immagine della release 20Gi
Qdrant 1.15 dataTier.qdrant l'immagine della release 10Gi
SeaweedFS 4.48, l'object store compatibile con Amazon S3 (Simple Storage Service) dataTier.objectStore l'immagine della release 50Gi

Ciascuno di essi può invece essere gestito autonomamente da Lei. Imposti il relativo mode su external, indichi l'host e specifichi il nome di un Secret che ne contiene le credenziali. Aggiunga l'indirizzo dell'archivio dati anche a networkPolicy.externalEgressCIDRs (veda la sezione sulle policy di rete più avanti), poiché il namespace nega tutto il resto del traffico in uscita. Per un archivio dati esterno il chart non genera alcun componente di tale archivio: nessuno StatefulSet, nessun Service e nessun volume. I servizi si connettono all'host da Lei indicato.

# 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

Il Secret viene creato da Lei, nel namespace in cui viene installato Nexus, prima dell'installazione. Il chart ne conserva esclusivamente il nome: i pod che necessitano di una credenziale la leggono dal Suo Secret all'avvio, e nulla viene copiato nei Secret propri del chart. Modifichi una credenziale e riavvii i pod che la utilizzano; non c'è nulla da rigenerare.

Ogni archivio dati cerca nomi di chiave fissi nel proprio Secret:

Archivio Chiavi nel relativo Secret
PostgreSQL username e password per un superuser su quel server, e ca.crt, l'autorità di certificazione (CA) che ha firmato il certificato del server
Valkey password
Neo4j username e password
Qdrant api-key
Object store access-key e secret-key

Carichi ciascun valore da un file, in modo che rimanga fuori dalla cronologia della shell e dal file dei valori:

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

Un archivio dati esterno senza un Secret specificato interrompe la generazione dei manifest, esattamente come uno privo di host.

PostgreSQL

Il server esterno deve offrire ciò che offre l'immagine della release: PostgreSQL 16 con PostGIS 3 e pgvector. Il traffico verso di esso è sempre crittografato e verificato rispetto a ca.crt nel Suo Secret. Imposti sslmode su verify-full, che verifica anche che il certificato del server indichi l'host da Lei specificato, oppure su verify-ca. Con un server esterno la generazione dei manifest rifiuta disable e require. Postgres interno al cluster funziona all'opposto: il suo traffico non lascia mai il namespace, la policy di rete lo trattiene lì e accetta solo disable. Qualunque modalità scelga, il certificato deve indicare l'host in external.host, poiché alcuni servizi verificano il nome a ogni connessione.

All'installazione, un Job di bootstrap si connette al server con l'account presente nel Suo Secret e crea i ruoli con cui viene eseguito Nexus. Crea un ruolo migrator che possiede lo schema, un ruolo runtime e un ruolo di accesso per ciascun servizio. Nexus ne genera le password e le conserva. Nessuno di essi è un superuser e nessuno può aggirare la sicurezza a livello di riga (row-level security), pertanto ogni policy di isolamento nel database si applica a ogni servizio. Il bootstrap stesso necessita invece di un superuser: uno dei suoi passaggi blocca una funzione integrata di PostgreSQL, e solo un superuser può farlo. Solo il bootstrap e il passaggio di provisioning proprio della console utilizzano tale account. Per questo motivo, un servizio di database gestito il cui ruolo di amministratore non sia un vero superuser non può ospitare il database di Nexus.

Il Job verifica il Suo server prima di apportarvi modifiche. Si arresta, senza aver modificato nulla, se l'account nel Suo Secret non è un superuser. Se esiste già un ruolo chiamato nexus con SUPERUSER o BYPASSRLS, il Job si arresta con 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. Rimuova tali attributi da quel ruolo, oppure utilizzi un server in cui il nome sia libero, e ripeta l'installazione.

Valkey, Neo4j, Qdrant e l'object store

Gli altri quattro richiedono le stesse tre impostazioni: mode, external.host e external.existingSecret. Eccoli tutti e quattro configurati per utilizzare le istanze di Harrow:

# 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 }

Esegua le versioni contenute nelle immagini della release, elencate nella tabella precedente, sulle porte utilizzate dai servizi. Valkey è in ascolto sulla 6379 e Neo4j sulla 7687; Qdrant utilizza la 6333 e l'object store la 8333. L'object store deve essere compatibile con S3. La password di Valkey viene inserita in un indirizzo di connessione all'interno di ciascun pod, pertanto la limiti a lettere e cifre (anche i caratteri -._~ sono ammessi).

Se mode è external e external.host è vuoto, la generazione dei manifest si arresta con dataTier.<store>.external.host is required when mode is external. Spostare un archivio dati dall'interno del cluster all'esterno dopo che gli utenti hanno utilizzato Nexus comporta una migrazione dei dati a Suo carico, e il chart non copierà nulla per Lei. Prenda questa decisione prima della prima installazione.

Il key store, OpenBao, non è in questo elenco e non può essere esterno. Fa parte dell'identità dell'installazione e viene eseguito nel cluster a ogni installazione.

TLS sul perimetro pubblico

tls.mode stabilisce come i tre host pubblici ottengono i propri certificati, e nient'altro. Il traffico tra i servizi utilizza sempre mutual TLS con certificati provenienti dalla CA locale propria del chart, emessi da cert-manager, indipendentemente dalla modalità. Non c'è alcun service mesh e istio.enabled rimane false.

tls.mode Chi genera il certificato Cosa deve impostare
existing (il valore predefinito) Lei. Un unico Secret contiene un certificato per tutti e tre gli host. tls.existingSecret
cert-manager Un ClusterIssuer già in esecuzione. Il chart gli richiede un certificato per host. tls.clusterIssuer
none Nessuno nel cluster. Il TLS termina davanti ad esso, sul Suo load balancer o proxy. Nulla, ma legga l'avvertenza seguente

existing

# harrow-tls-existing.yaml (Helm values)
tls:
  mode: existing
  existingSecret: harrow-public-tls

Ogni Ingress utilizza il Secret harrow-public-tls, pertanto il relativo certificato deve includere i nomi console.harrow.example, api.harrow.example e auth.harrow.example. Lo crei nel namespace prima dell'installazione:

kubectl -n nexus create secret tls harrow-public-tls --cert=harrow-public.crt --key=harrow-public.key

Il preflight lo legge, avvisa quando scade entro 30 giorni e indica il nome del Secret qualora sia mancante. Quando la modalità è existing e il nome è vuoto, la generazione dei manifest si arresta con 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

Il chart aggiunge l'annotazione cert-manager.io/cluster-issuer a ciascuno dei tre Ingress, e cert-manager crea i Secret nexus-console-tls, nexus-api-tls e nexus-auth-tls. Senza tls.clusterIssuer la generazione dei manifest si arresta con tls.clusterIssuer is required when tls.mode is cert-manager.

Se il Suo issuer utilizza ACME (Automatic Certificate Management Environment) con la challenge HTTP-01, non occorre altro. Il chart non aggiunge alcun reindirizzamento proprio, quindi una richiesta per /.well-known/acme-challenge/ raggiunge il solver del Suo issuer invariata. In un sito privo di accesso a Internet, anche il solver è un'immagine: inserisca l'immagine cert-manager-acmesolver di cert-manager nel Suo registry, altrimenti ogni pod di challenge rimarrà in attesa in ErrImagePull.

nessuno

# harrow-tls-none.yaml (Helm values)
tls:
  mode: none
proxy:
  trustedCIDRs: "10.30.0.0/16"

Con none, gli Ingress non contengono alcuna sezione TLS. Lo utilizzi quando un load balancer o un reverse proxy posto davanti al cluster termina il TLS per i tre host.

proxy.trustedCIDRs indica i proxy hop il cui header X-Forwarded-For viene ritenuto attendibile da nexus-auth. Il valore predefinito, 10.42.0.0/16, è la rete dei pod di k3s, dove viene eseguito il relativo ingress controller. Su qualsiasi altro cluster, lo imposti sulla rete utilizzata dai pod del Suo ingress controller, in modo che i limiti di frequenza di accesso e i record di audit rilevino l'indirizzo dell'utente e non quello del proxy.

Indirizzo, certificato, proxy e posta
Indirizzo, certificato, proxy e posta
Una volta installato, l'indirizzo, il certificato, il proxy e la posta dispongono ciascuno del proprio test in un'unica pagina, e il risultato è espresso a parole.

Ingress controller

Il chart crea tre normali Ingress Kubernetes, uno per host pubblico. Ciascuno instrada il percorso / verso un Service.

Ingress Host Service e porta
nexus-console hosts.console nexus-alpha, 3000
nexus-api hosts.api nexus-gateway, 9092
nexus-auth hosts.auth nexus-auth, 9101

Tre valori li definiscono, e un valore nella policy di rete deve concordare.

# harrow-ingress.yaml (Helm values)
ingress:
  enabled: true
  className: harrow-nginx
  annotations:
    "<annotation-key>": "<annotation-value>"
networkPolicy:
  ingressNamespace: ingress-harrow
  • ingress.className indica il nome della IngressClass. Se lasciato vuoto, il chart omette la classe e la classe predefinita del cluster prende in carico i tre Ingress. Il preflight verifica che la classe esista o, qualora non ne sia stata specificata alcuna, che esattamente una classe sia contrassegnata come predefinita.
  • ingress.annotations viene aggiunto a tutti e tre gli Ingress. I valori sono stringhe, quindi racchiuda numeri e valori booleani tra virgolette. Lo utilizzi per le impostazioni specifiche del Suo controller.
  • ingress.enabled: false non genera alcun Ingress, per un sito che instrada il traffico verso i tre Service in altro modo.
  • networkPolicy.ingressNamespace è il namespace in cui viene eseguito il Suo ingress controller.

Quest'ultimo valore trae spesso in inganno. La policy di rete del chart nega per impostazione predefinita tutto il traffico in ingresso nel namespace e ammette poi l'ingress controller ai tre Service pubblici solo dal namespace da Lei indicato. Il valore predefinito, kube-system, è corretto per k3s, che esegue Traefik lì. Con qualsiasi altro controller, se lo lascia invariato il controller non potrà raggiungere Nexus: gli Ingress esistono, il controller registra timeout di connessione e il browser riceve un errore di gateway. Il controllo "Ingress ports" del preflight cerca un Service in quel namespace aperto sulle porte 80 e 443, come LoadBalancer o NodePort, e la relativa riga fix indica questo valore.

A sinistra, un riquadro "ingress controller" si trova all'interno di un perimetro tratteggiato con l'etichetta "namespace: networkPolicy.ingressNamespace (kube-system on k3s)". Da esso partono tre frecce, con le etichette console.harrow.example, api.harrow.example e auth.harrow.example. Esse attraversano una linea continua con l'etichetta "nexus namespace: default deny" e arrivano a tre riquadri: "nexus-alpha :3000", "nexus-gateway :9092" e "nexus-auth :9101". Una quarta freccia in grigio, che parte da un riquadro "any other namespace", si ferma sulla linea continua con una piccola croce.
I tre host pubblici, il namespace dell'ingress controller e la policy di rete che ammette solo quel namespace.

Il resto della policy di rete

networkPolicy.enabled è impostato su true per impostazione predefinita e dovrebbe rimanere tale. Con esso, nulla nel namespace può comunicare con l'esterno ad eccezione del DNS (Domain Name System), dell'API (application programming interface) di Kubernetes per i verificatori di token e degli indirizzi da Lei elencati.

# harrow-network.yaml (Helm values)
networkPolicy:
  apiServerCIDRs: ["10.30.0.1/32"]
  externalEgressCIDRs: ["10.30.40.25/32"]

apiServerCIDRs è l'indirizzo dell'API server sotto forma di CIDR (Classless Inter-Domain Routing) /32. Se vuoto, il chart lo legge dal cluster al momento dell'installazione. helm template non ha alcun cluster da cui leggere, quindi lo specifichi lì. externalEgressCIDRs rappresenta tutto il resto che un carico di lavoro può raggiungere, vuoto per impostazione predefinita. Harrow vi elenca il proprio relay di posta. Anche ogni archivio dati esterno al di fuori del namespace deve essere elencato qui, altrimenti la policy di diniego predefinito impedisce ai servizi di raggiungerlo.

Solo tre carichi di lavoro comunicano con l'API server: il servizio di evidenze nexus-probitas, l'orchestrator e il Job di custodia del key store. Essi verificano i token di service account presentati dagli altri carichi di lavoro. La policy concede l'indirizzo dell'API server, sulle porte 6443 e 443, a quei tre e a nient'altro. Se i tre non riescono a raggiungerlo, non possono verificare i token presentati dagli altri carichi di lavoro, pertanto specifichi tutti gli indirizzi che può assumere.

Scelta di una modalità TLS

Harrow ha scelto cert-manager con la propria CA interna come ClusterIssuer, e il motivo è stato il rinnovo. Con existing, una persona rinnova il certificato nel Secret prima della scadenza, e l'avviso a 30 giorni del preflight è l'unico promemoria. Con cert-manager, il rinnovo avviene automaticamente e nessuno deve ricordarsene. none è adatto a un sito in cui ogni indirizzo pubblico si trova già dietro un load balancer che termina il TLS per molti sistemi, e dove quel team gestisce i certificati. Qualunque opzione scelga, il certificato visto dal browser deve essere considerato attendibile dal browser stesso. Un certificato autofirmato che gli utenti accettano ignorando l'avviso compromette il funzionamento delle passkey, poiché Chrome non crea né utilizza una passkey dietro un avviso di certificato.

Archiviazione, posta elettronica, repliche e risorse

Storage class

# harrow-storage.yaml (Helm values)
storage:
  className: harrow-ssd
dataTier:
  postgres:
    size: 200Gi
  objectStore:
    size: 500Gi

storage.className si applica a ogni PVC (persistent volume claim) del livello dati e ai volumi del key store. Vuoto significa la classe predefinita del cluster, e il preflight fallisce quando nessuna classe è contrassegnata come predefinita e Lei non ne ha indicata alcuna. Ogni archivio dati interno al cluster ha il proprio size. Quelli del key store sono keys.openbao.storage.unsealer e keys.openbao.storage.keystore, con keys.receiptsStorage per le ricevute. Scelga le dimensioni prevedendo la crescita di un anno.

Posta

# harrow-mail.yaml (Helm values)
smtp:
  existingSecret: harrow-smtp

Nexus invia inviti e notifiche tramite il Suo server di posta. smtp.existingSecret indica il nome di un Secret da Lei creato, nel namespace, con i dettagli del server di posta. Come per ogni integrazione, il chart richiede il nome di un Secret e mai una credenziale. Ricordi la policy di rete: aggiunga l'indirizzo del relay a networkPolicy.externalEgressCIDRs, altrimenti la posta si fermerà al confine del namespace. Finché la posta non funziona, gli inviti non possono essere inviati, e la lista di controllo del primo amministratore lo segnala.

Repliche e risorse

Ogni componente principale ha un numero di repliche e risorse Kubernetes sotto components, e ogni archivio dati interno al cluster ha risorse sotto 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 Neo4j predefinito richiede 2 GiB e può utilizzare fino a 4 GiB. Con 3 GB di heap e page cache, aumenti anche la relativa richiesta (request), in modo che il pod venga collocato su un nodo che dispone della memoria necessaria.

I componenti con replicas e resources sono console, bff, auth, orchestrator, workflows, gateway, graphrag, probitas e skillsEngine. Il servizio chiavi, keys, accetta solo resources. Questi componenti principali sono obbligatori e non possono essere disattivati; il chart li esegue indipendentemente da ciò che indica il loro parametro enabled. Gli archivi del livello dati eseguono una replica ciascuno.

Su storage lenti, altri due valori concedono ai servizi il tempo di avviarsi: probes.startupFailureThreshold (60 per impostazione predefinita) e schemaWait.timeoutSeconds (1800), ovvero il tempo di attesa di un servizio per le migrazioni del database prima che il relativo container di avvio fallisca indicando il nome.

Sessioni di accesso, limiti di frequenza e host di modelli privati

Vale la pena conoscere tre gruppi più piccoli di valori prima dell'installazione, poiché gli utenti li notano fin dal primo giorno.

# harrow-auth.yaml (Helm values)
auth:
  accessTokenTTL: 15m
  refreshTokenTTL: 12h
  rateLimitPerMinute: 5000
ai:
  installationHosts: [models.harrow.internal, .gpu.harrow.internal]

auth.accessTokenTTL e auth.refreshTokenTTL indicano la durata dei due token di una sessione. I valori predefiniti, 15 minuti e 12 ore, implicano che una persona che chiude il portatile la sera dovrà effettuare nuovamente l'accesso la mattina seguente. Riduca la durata del refresh token se la Sua policy lo richiede, mettendo in conto un maggior numero di accessi.

auth.rateLimitPerMinute è il numero massimo di richieste che un utente autenticato può effettuare al servizio di accesso in un minuto prima che questo risponda con 429. Il valore predefinito, 5000, corrisponde a circa 83 al secondo da un singolo account, più che sufficiente per la console e per gli script. Un'installazione non prevede piani di abbonamento, quindi a ogni persona si applica lo stesso limite. Lo riduca per rafforzare la protezione dagli abusi, oppure lo aumenti in caso di automazione intensiva. La protezione contro gli attacchi brute-force all'accesso, come il blocco dell'account e i limiti sui tentativi di secondo fattore, è separata e non si imposta qui.

ai.installationHosts elenca nomi host aggiuntivi all'interno dell'installazione, per i server di modelli di IA (intelligenza artificiale) propri dell'organizzazione su nomi privati. Ogni voce è un nome host, un .suffix che corrisponde a ogni nome sottostante, un indirizzo IP o un blocco CIDR (Classless Inter-Domain Routing) IPv4. Il router li tratta come parte dell'installazione accanto agli host propri della release. Il server del modello stesso viene indicato in ai.localProvider.baseUrl; il capitolo 2.14, Provider e modelli di IA, tratta entrambi.

Cosa non è mai un valore di configurazione

Alcuni elementi che le persone cercano in un file dei valori non sono presenti, intenzionalmente.

Non presente nel file dei valori Perché, e dove si trova invece
La licenza Viene importata dopo l'installazione, nella console o con nexusctl licence import <file>. Una licenza non è mai un valore del chart né un file montato. Il capitolo 2.13, Licenze, contiene i dettagli.
Chiavi dei modelli Ogni organizzazione conserva le proprie chiavi nel proprio pool, inserite nella console. Nessuna credenziale di provider di IA è mai un valore del chart.
Hardening della registrazione Il CAPTCHA Internet e il filtro di rete alla registrazione sono entrambi disattivati in un'installazione, e non esiste alcun valore per attivare l'uno o l'altro. Il CAPTCHA richiederebbe la connessione a Internet a ogni registrazione. Il filtro di rete richiederebbe un database di geolocalizzazione con licenza che il chart non include. La registrazione di un utente sconosciuto viene invece trattenuta in attesa dell'approvazione di un amministratore, come spiega il capitolo 2.12, Il primo avvio.
Telemetria Lo schema accetta una sola impostazione per telemetry.enabled, ovvero false. Nulla esce da un'installazione, e anche l'invio di report proprio del livello dati (il report di utilizzo di Neo4j, la telemetria di Qdrant) è disattivato.

Verificare l'intero file prima di installare

Una volta uniti i frammenti in un unico file, esegua due controlli su di esso dalla Sua workstation. helm lint --strict convalida ogni chiave rispetto allo schema del chart, mentre helm template genera i manifest dell'intera release affinché Lei possa esaminarli prima che venga creato alcunché. I comandi utilizzano l'indirizzo del chart Community; per Enterprise, specifichi invece il percorso del chart Enterprise scaricato (capitolo 2.7, Installazione di Enterprise e applicazione di una licenza). Una generazione dei manifest sulla Sua workstation non può leggere l'indirizzo dell'API server da un cluster, pertanto imposti prima networkPolicy.apiServerCIDRs nel file.

I due controlli:

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

Una chiave scritta in modo errato fa fallire il lint con "additional properties" e indica il nome della chiave. Un valore obbligatorio mancante, come un host quando un archivio dati è esterno, fa fallire la generazione dei manifest con la frase citata in questo capitolo. helm template non ha alcun cluster da cui leggere, quindi specifichi networkPolicy.apiServerCIDRs quando genera i manifest offline, altrimenti si arresta e li richiede.

Esegua quindi il preflight con lo stesso file. Il preflight è l'unico controllo che legge contemporaneamente il cluster e i valori: è qui che emergono un namespace di ingress errato, una classe di storage mancante o un certificato in scadenza la settimana successiva, prima che qualcuno dipenda dall'installazione.

Kubernetes gestito

Nexus viene eseguito su qualsiasi Kubernetes 1.33 o successivo conforme, incluso il servizio gestito di un cloud provider. Nulla nel chart è specifico per un singolo provider. Ciò che cambia rispetto a k3s è una manciata di valori, ciascuno trattato in precedenza:

  • cert-manager v1.21.3 viene installato per primo, come su qualsiasi cluster. | Su un cluster gestito | Cosa impostare o verificare | |---|---| | Storage | Indichi la classe del provider in storage.className, oppure ne contrassegni una come predefinita. | | Ingress | Installi l'ingress controller che utilizza, lo esponga sulle porte 80 e 443, imposti ingress.className se non è quello predefinito e imposti networkPolicy.ingressNamespace sul relativo namespace. | | I proxy hop | Imposti proxy.trustedCIDRs sulla rete dei pod di quel controller. | | L'API server | Se l'installazione non riesce a leggere l'indirizzo dell'API server dal cluster, lo specifichi in networkPolicy.apiServerCIDRs. | | Applicazione delle policy di rete | Le policy del chart hanno effetto solo laddove il plugin di rete del cluster applichi le NetworkPolicy. Scelga una configurazione del cluster che lo faccia. | | Immagini | I nodi devono poter raggiungere registry.adverant.ai, oppure il Suo registry indicato in global.imageRegistry. |

Esegua il preflight prima di qualsiasi altra cosa. Esso legge contemporaneamente il cluster e il file dei valori e stampa ciascuno di questi elementi come una riga, con la relativa correzione accanto a ciascun requisito non soddisfatto. Il capitolo 2.5, Preflight con nexusctl, mostra il report.

Prima dell'installazione
Prima dell'installazione
Un preflight superato su un cluster di produzione. Ogni riga rappresenta un requisito e ogni avviso riporta la relativa correzione nella riga sottostante.