ConnexionPlanifier un briefing

Chapitre 2.11

Variantes : stockages externes, TLS et ingress

Les valeurs permettant d'adapter Nexus à un cluster qui n'est pas vierge, TLS (Transport Layer Security) compris, avec les bases de données que vous exploitez déjà, vos propres certificats, un autre contrôleur ingress, les classes de stockage, la messagerie électronique, les proxys, les réplicas et Kubernetes managé.

Cette page a été traduite par l'IA à partir de l'original en anglais. En cas de doute, la page en anglais fait foi. Lire cette page en anglais

17 minutes de lecture

Le cluster de production de Harrow Port Authority ne part pas de zéro, et la seule gestion du TLS (Transport Layer Security) y comporte trois volets. L'équipe chargée des bases de données exploite PostgreSQL sur ses propres machines et souhaite y héberger chaque base, sauvegardée selon ses propres méthodes. Les certificats proviennent de l'autorité de certification (CA) interne de Harrow via cert-manager. Le contrôleur Ingress n'est pas Traefik et réside dans son propre espace de noms. Rien de tout cela n'exige de dupliquer (fork) le chart. Chaque différence correspond à une valeur, et ce chapitre les passe en revue dans l'ordre où Tomás Reilly les a rencontrées.

Chaque bloc de valeurs de ce chapitre est un fragment. Fusionnez ceux dont vous avez besoin dans votre propre fichier de valeurs, aux côtés de global, hosts, edition et keys issus du chapitre 2.6, Installation de l'édition Community sur Kubernetes. Le schéma du chart refuse toute clé qu'il ne reconnaît pas ; une clé mal orthographiée fait donc échouer helm lint --strict ainsi que l'installation au lieu d'être ignorée. C'est intentionnel : une faute de frappe dans dataTier qui laisserait silencieusement un magasin de données dans le cluster serait pire qu'une erreur.

Systèmes de stockage de données externes

Nexus conserve ses données dans cinq magasins. Par défaut, chacun s'exécute au sein du cluster à partir de l'image signée propre à la version, avec son propre volume.

Magasin Clé des valeurs Valeur par défaut dans le cluster Volume par défaut
PostgreSQL 16 avec PostGIS 3 et pgvector 0.8 dataTier.postgres l'image de la version 50Gi
Valkey 8.1 dataTier.valkey l'image de la version 5Gi
Neo4j 5.26 Community Edition dataTier.neo4j l'image de la version 20Gi
Qdrant 1.15 dataTier.qdrant l'image de la version 10Gi
SeaweedFS 4.48, le magasin d'objets compatible avec Amazon S3 (Simple Storage Service) dataTier.objectStore l'image de la version 50Gi

Chacun d'entre eux peut être remplacé par une instance que vous exploitez vous-même. Définissez son paramètre mode sur external, indiquez son hôte et nommez un Secret contenant ses identifiants. Ajoutez également l'adresse du magasin à networkPolicy.externalEgressCIDRs (voir la section sur la politique réseau ci-dessous), car l'espace de noms bloque tout autre trafic sortant. Pour un magasin externe, le chart ne génère aucune ressource associée : ni StatefulSet, ni Service, ni volume. Les services se connectent à l'hôte que vous avez indiqué.

# 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

Vous créez vous-même le Secret avant l'installation, dans l'espace de noms où Nexus s'installe. Le chart ne conserve que son nom : les pods qui ont besoin d'un identifiant le lisent dans votre Secret au démarrage, et rien n'est copié dans les propres Secrets du chart. Modifiez un identifiant et redémarrez les pods qui l'utilisent ; il n'y a rien à régénérer.

Chaque magasin recherche des noms de clés fixes dans son Secret :

Magasin Clés dans son Secret
PostgreSQL username et password pour un superutilisateur sur ce serveur, et ca.crt, l'autorité de certification (CA) qui a signé le certificat du serveur
Valkey password
Neo4j username et password
Qdrant api-key
Magasin d'objets access-key et secret-key

Chargez chaque valeur depuis un fichier, afin qu'elle n'apparaisse ni dans l'historique de votre shell ni dans votre fichier de valeurs :

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 magasin externe sans Secret nommé interrompt la génération des manifestes, exactement comme s'il n'avait pas d'hôte.

PostgreSQL

Le serveur externe doit offrir les mêmes composants que l'image de la version : PostgreSQL 16 avec PostGIS 3 et pgvector. Le trafic vers celui-ci est toujours chiffré et vérifié par rapport au ca.crt de votre Secret. Définissez sslmode sur verify-full, ce qui vérifie également que le certificat du serveur mentionne l'hôte que vous avez indiqué, ou sur verify-ca. Avec un serveur externe, la génération refuse disable et require. L'instance Postgres interne au cluster fonctionne à l'inverse : son trafic ne quitte jamais l'espace de noms, la politique réseau l'y maintient et elle n'accepte que disable. Quel que soit le mode choisi, le certificat doit mentionner l'hôte défini dans external.host, car certains services vérifient ce nom à chaque connexion.

Lors de l'installation, un Job d'initialisation (bootstrap) se connecte au serveur avec le compte de votre Secret et crée les rôles sous lesquels Nexus s'exécute. Il crée un rôle de migration propriétaire du schéma, un rôle d'exécution et un rôle de connexion pour chaque service. Nexus génère leurs mots de passe et les conserve. Aucun d'entre eux n'est superutilisateur et aucun ne peut contourner la sécurité au niveau des lignes (row-level security) ; chaque politique d'isolation de la base de données s'applique donc à chaque service. L'initialisation elle-même requiert en revanche un superutilisateur : l'une de ses étapes verrouille une fonction native de PostgreSQL, ce que seul un superutilisateur peut faire. Seuls le processus d'initialisation et l'étape d'approvisionnement propre à la console utilisent ce compte. C'est pourquoi un service de base de données géré dont le rôle d'administrateur n'est pas un véritable superutilisateur ne peut pas héberger la base de données de Nexus.

Le Job vérifie votre serveur avant d'y apporter la moindre modification. Il s'arrête sans rien modifier si le compte de votre Secret n'est pas un superutilisateur. Si un rôle nommé nexus existe déjà avec SUPERUSER ou BYPASSRLS, le Job s'arrête avec l'erreur 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. Retirez ces attributs de ce rôle, ou utilisez un serveur où ce nom est libre, puis relancez l'installation.

Valkey, Neo4j, Qdrant et le magasin d'objets

Les quatre autres acceptent les trois mêmes paramètres : mode, external.host et external.existingSecret. Les voici tous les quatre basculés sur les instances propres à 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 }

Exécutez les versions embarquées dans les images de la version, indiquées dans le tableau ci-dessus, sur les ports utilisés par les services. Valkey écoute sur le port 6379 et Neo4j sur le port 7687 ; Qdrant utilise le port 6333 et le magasin d'objets le port 8333. Le magasin d'objets doit être compatible S3. Le mot de passe Valkey étant intégré à une adresse de connexion dans chaque pod, limitez-le à des lettres et des chiffres (les caractères -._~ sont également acceptés).

Si mode est défini sur external et que external.host est vide, la génération s'arrête avec l'erreur dataTier.<store>.external.host is required when mode is external. Passer un magasin de données du cluster vers l'extérieur après que des utilisateurs ont commencé à utiliser Nexus représente une migration de données que vous devez effectuer vous-même ; le chart ne copiera rien pour vous. Prenez votre décision avant la première installation.

Le magasin de clés, OpenBao, ne figure pas dans cette liste et ne peut pas être externe. Il fait partie de l'identité de l'installation et s'exécute dans le cluster pour chaque installation.

TLS à la périphérie publique

tls.mode détermine uniquement la manière dont les trois hôtes publics obtiennent leurs certificats. Le trafic entre les services utilise toujours le TLS mutuel avec des certificats provenant de l'autorité de certification locale propre au chart, émis par cert-manager, quel que soit le mode. Il n'y a pas de maillage de services (service mesh), et istio.enabled reste défini sur false.

tls.mode Qui produit le certificat Ce que vous devez définir
existing (par défaut) Vous. Un seul Secret contient un certificat pour les trois hôtes. tls.existingSecret
cert-manager Un ClusterIssuer que vous exploitez déjà. Le chart lui demande un certificat par hôte. tls.clusterIssuer
none Personne dans le cluster. Le TLS se termine en amont, au niveau de votre équilibreur de charge ou de votre proxy. Rien, mais lisez l'avertissement ci-dessous

existing

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

Chaque Ingress sert le Secret harrow-public-tls ; son certificat doit donc mentionner console.harrow.example, api.harrow.example et auth.harrow.example. Créez-le dans l'espace de noms avant l'installation :

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

La vérification préalable (preflight) le lit, émet un avertissement s'il expire dans moins de 30 jours et indique le nom du Secret s'il est manquant. Lorsque le mode est existing et que le nom est vide, la génération s'arrête avec l'erreur 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

Le chart ajoute l'annotation cert-manager.io/cluster-issuer à chacun des trois Ingress, et cert-manager crée les Secrets nexus-console-tls, nexus-api-tls et nexus-auth-tls. Sans tls.clusterIssuer, la génération s'arrête avec l'erreur tls.clusterIssuer is required when tls.mode is cert-manager.

Si votre émetteur utilise ACME (Automatic Certificate Management Environment) avec le défi HTTP-01, rien d'autre n'est requis. Le chart n'ajoute aucune redirection propre ; une requête vers /.well-known/acme-challenge/ atteint donc le solveur de votre émetteur sans modification. Sur un site sans accès à Internet, le solveur est lui aussi une image : placez l'image cert-manager-acmesolver de cert-manager dans votre registre, faute de quoi chaque pod de défi restera bloqué en ErrImagePull.

aucun

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

Avec none, les ressources Ingress ne comportent aucune section TLS. Utilisez ce mode lorsqu'un équilibreur de charge ou un proxy inverse situé en amont du cluster assure la terminaison TLS pour les trois hôtes.

proxy.trustedCIDRs désigne les sauts de proxy dont l'en-tête X-Forwarded-For est jugé fiable par nexus-auth. La valeur par défaut, 10.42.0.0/16, correspond au réseau de pods de k3s, où s'exécute son contrôleur Ingress. Sur tout autre cluster, définissez cette valeur sur le réseau utilisé par les pods de votre contrôleur Ingress, afin que les limites de fréquence de connexion et les journaux d'audit enregistrent l'adresse de l'utilisateur et non celle du proxy.

Adresse, certificat, proxy et messagerie
Adresse, certificat, proxy et messagerie
Une fois l'installation terminée, l'adresse, le certificat, le proxy et la messagerie disposent chacun de leur propre test sur une même page, et le résultat est rédigé en toutes lettres.

Contrôleurs ingress

Le chart crée trois ressources Ingress Kubernetes standard, une par hôte public. Chacune achemine le chemin / vers un Service.

Ingress Hôte Service et port
nexus-console hosts.console nexus-alpha, 3000
nexus-api hosts.api nexus-gateway, 9092
nexus-auth hosts.auth nexus-auth, 9101

Trois valeurs les configurent, et une valeur de la politique réseau doit concorder.

# harrow-ingress.yaml (Helm values)
ingress:
  enabled: true
  className: harrow-nginx
  annotations:
    "<annotation-key>": "<annotation-value>"
networkPolicy:
  ingressNamespace: ingress-harrow
  • ingress.className nomme l'IngressClass. S'il est laissé vide, le chart omet la classe et la classe par défaut du cluster prend en charge les trois Ingress. La vérification préalable contrôle que la classe existe ou, si vous n'en avez nommé aucune, qu'exactement une classe est marquée par défaut.
  • ingress.annotations est ajouté aux trois Ingress. Les valeurs étant des chaînes de caractères, placez les nombres et les booléens entre guillemets. Utilisez ce paramètre pour les réglages propres à votre contrôleur.
  • ingress.enabled: false ne génère aucun Ingress, pour un site qui achemine le trafic vers les trois Services par un autre moyen.
  • networkPolicy.ingressNamespace est l'espace de noms dans lequel s'exécute votre contrôleur Ingress.

Ce dernier paramètre piège souvent les utilisateurs. Par défaut, la politique réseau du chart refuse tout trafic entrant dans l'espace de noms, puis n'autorise le contrôleur Ingress à accéder aux trois Services publics que depuis l'espace de noms que vous avez indiqué. La valeur par défaut, kube-system, convient à k3s, qui y exécute Traefik. Avec tout autre contrôleur, si vous laissez cette valeur inchangée, le contrôleur ne pourra pas joindre Nexus : les Ingress existent, le contrôleur consigne des délais d'attente de connexion dépassés (timeouts) et le navigateur reçoit une erreur de passerelle. Le test « Ingress ports » de la vérification préalable recherche un Service dans cet espace de noms ouvert sur les ports 80 et 443, de type LoadBalancer ou NodePort, et sa ligne fix mentionne cette valeur.

À gauche, un cadre « ingress controller » se trouve à l'intérieur d'une bordure en pointillés intitulée « namespace: networkPolicy.ingressNamespace (kube-system on k3s) ». Trois flèches en partent, intitulées console.harrow.example, api.harrow.example et auth.harrow.example. Elles traversent une ligne continue intitulée « nexus namespace: default deny » et arrivent à trois cadres : « nexus-alpha :3000 », « nexus-gateway :9092 » et « nexus-auth :9101 ». Une quatrième flèche grisée partant d'un cadre « any other namespace » s'arrête à la ligne continue avec une petite croix.
Les trois hôtes publics, l'espace de noms du contrôleur Ingress et la politique réseau qui n'autorise que cet espace de noms.

Le reste de la politique réseau

networkPolicy.enabled est défini sur true par défaut et doit le rester. Ainsi, rien dans l'espace de noms ne peut communiquer avec l'extérieur, à l'exception du DNS (Domain Name System), de l'API (application programming interface) Kubernetes pour les vérificateurs de jetons, et des adresses que vous listez.

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

apiServerCIDRs correspond à l'adresse du serveur d'API sous forme de blocs CIDR (Classless Inter-Domain Routing) en /32. S'il est vide, le chart lit cette adresse depuis le cluster lors de l'installation. helm template n'ayant pas de cluster à interroger, indiquez-la à cet endroit. externalEgressCIDRs regroupe tout le reste de ce qu'une charge de travail est autorisée à joindre (vide par défaut). Harrow y liste son relais de messagerie. Tout magasin de données externe situé en dehors de l'espace de noms doit également figurer ici, sans quoi la politique de refus par défaut empêchera les services de le joindre.

Seules trois charges de travail communiquent avec le serveur d'API : le service de preuves nexus-probitas, l'orchestrateur et le Job de garde du magasin de clés. Ils vérifient les jetons de compte de service présentés par les autres charges de travail. La politique accorde l'accès à l'adresse du serveur d'API, sur les ports 6443 et 443, à ces trois composants et à aucun autre. Si ces trois composants ne peuvent pas le joindre, ils ne peuvent pas vérifier les jetons présentés par les autres charges de travail ; indiquez donc toutes les adresses qu'il est susceptible d'avoir.

Choisir un mode TLS

Harrow a choisi cert-manager avec son autorité de certification interne configurée en tant que ClusterIssuer, et ce pour des raisons de renouvellement. Avec existing, une personne doit renouveler le certificat dans le Secret avant son expiration, et l'avertissement à 30 jours de la vérification préalable constitue le seul rappel. Avec cert-manager, le renouvellement s'effectue automatiquement sans que personne ait à y penser. none convient à un site où chaque adresse publique se trouve déjà derrière un équilibreur de charge qui assure la terminaison TLS pour de nombreux systèmes, et où l'équipe responsable gère les certificats. Quel que soit votre choix, le certificat présenté au navigateur doit être reconnu comme fiable par celui-ci. Un certificat auto-signé que les utilisateurs acceptent malgré l'avertissement empêche le fonctionnement des clés d'accès (passkeys), car Chrome refuse de créer ou d'utiliser une clé d'accès derrière un avertissement de certificat.

Stockage, messagerie électronique, réplicas et ressources

Classe de stockage

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

storage.className s'applique à chaque PVC (persistent volume claim) de la couche de données ainsi qu'aux volumes du magasin de clés. Une valeur vide désigne la classe par défaut du cluster, et la vérification préalable échoue si aucune classe n'est marquée par défaut et que vous n'en avez nommé aucune. Chaque magasin interne au cluster possède son propre paramètre size. Ceux du magasin de clés sont keys.openbao.storage.unsealer et keys.openbao.storage.keystore, avec keys.receiptsStorage pour les reçus. Choisissez des tailles adaptées à une année de croissance.

Messagerie

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

Nexus envoie les invitations et les notifications via votre serveur de messagerie. smtp.existingSecret nomme un Secret que vous créez dans l'espace de noms avec les paramètres du serveur de messagerie. Comme pour chaque intégration, le chart accepte le nom d'un Secret et jamais un identifiant directement. N'oubliez pas la politique réseau : ajoutez l'adresse du relais à networkPolicy.externalEgressCIDRs, sinon les courriels seront bloqués à la frontière de l'espace de noms. Tant que la messagerie ne fonctionne pas, les invitations ne peuvent pas être envoyées, et la liste de contrôle du premier administrateur l'indique.

Réplicas et ressources

Chaque composant principal dispose d'un nombre de réplicas et de ressources Kubernetes sous components, et chaque magasin interne au cluster dispose de ressources sous 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 } }

Le pod Neo4j par défaut demande 2 GiB et peut utiliser jusqu'à 4 GiB. Avec 3 GB de tas (heap) et de cache de pages, augmentez également sa demande (request) afin que le pod soit placé sur un nœud disposant de la mémoire nécessaire.

Les composants dotés de replicas et resources sont console, bff, auth, orchestrator, workflows, gateway, graphrag, probitas et skillsEngine. Le service de clés, keys, accepte uniquement resources. Ces composants principaux sont obligatoires et ne peuvent pas être désactivés ; le chart les exécute quelle que soit la valeur de leur commutateur enabled. Les magasins de la couche de données exécutent un seul réplica chacun.

Sur un stockage lent, deux valeurs supplémentaires laissent aux services le temps de démarrer : probes.startupFailureThreshold (60 par défaut) et schemaWait.timeoutSeconds (1800), qui définissent la durée pendant laquelle un service attend la fin des migrations de sa base de données avant que son conteneur de démarrage n'échoue explicitement.

Sessions de connexion, limites de débit et hôtes de modèles privés

Trois petits groupes de valeurs méritent d'être connus avant l'installation, car les utilisateurs en remarquent les effets dès le premier jour.

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

auth.accessTokenTTL et auth.refreshTokenTTL définissent la durée de validité des deux jetons d'une session. Avec les valeurs par défaut, 15 minutes et 12 heures, une personne qui ferme son ordinateur portable le soir doit se reconnecter le lendemain matin. Raccourcissez la durée du jeton d'actualisation (refresh token) si votre politique l'exige, et attendez-vous à des connexions plus fréquentes.

auth.rateLimitPerMinute correspond au nombre maximal de requêtes qu'un utilisateur connecté peut adresser au service d'authentification en une minute avant que celui-ci ne réponde par un code 429. La valeur par défaut, 5000, représente environ 83 requêtes par seconde pour un même compte, ce qui est largement suffisant pour la console et pour les scripts. Une installation ne comportant pas de forfaits d'abonnement, la même limite s'applique à chaque personne. Abaissez-la pour renforcer la protection contre les abus, ou augmentez-la en cas d'automatisation intensive. La protection contre les attaques par force brute lors de la connexion, comme le verrouillage de compte et la limitation des tentatives de seconde vérification, est gérée séparément et ne se configure pas ici.

ai.installationHosts répertorie les noms d'hôtes supplémentaires internes à l'installation, destinés aux propres serveurs de modèles d'IA (intelligence artificielle) de l'organisation utilisant des noms privés. Chaque entrée est un nom d'hôte, un motif .suffix correspondant à tous les sous-noms associés, une adresse IP ou un bloc CIDR (Classless Inter-Domain Routing) IPv4. Le routeur les traite comme faisant partie intégrante de l'installation, au même titre que les hôtes propres à la version. Le serveur de modèles lui-même est nommé dans ai.localProvider.baseUrl ; le chapitre 2.14, Fournisseurs et modèles d'IA, traite de ces deux aspects.

Ce qui ne figure jamais dans le fichier values

Certains éléments que l'on cherche parfois dans un fichier de valeurs ne s'y trouvent pas, et c'est volontaire.

Absent du fichier de valeurs Pourquoi, et où le trouver à la place
La licence Elle est importée après l'installation, dans la console ou avec nexusctl licence import <file>. Une licence n'est jamais une valeur de chart ni un fichier monté. Le chapitre 2.13, Licences, donne tous les détails.
Clés des modèles Chaque organisation conserve ses propres clés dans son propre pool, saisies dans la console. Aucun identifiant de fournisseur d'IA n'est jamais une valeur de chart.
Renforcement de la sécurité à l'inscription Le CAPTCHA Internet et le filtrage réseau à l'inscription sont tous deux désactivés sur une installation, et aucune valeur ne permet de les activer. Le CAPTCHA nécessiterait un accès à Internet à chaque inscription. Le filtrage réseau exigerait une base de données de géolocalisation sous licence que le chart n'embarque pas. À la place, l'inscription d'un inconnu est mise en attente pour approbation par un administrateur, comme l'explique le chapitre 2.12, Le premier démarrage.
Télémétrie Le schéma n'accepte qu'un seul réglage pour telemetry.enabled, à savoir false. Aucune donnée ne quitte une installation, et les rapports propres à la couche de données (rapport d'utilisation de Neo4j, télémétrie de Qdrant) sont également désactivés.

Vérifier l'intégralité du fichier avant d'installer

Une fois les fragments fusionnés en un seul fichier, exécutez deux vérifications sur celui-ci depuis votre poste de travail. helm lint --strict valide chaque clé par rapport au schéma du chart, et helm template génère les manifestes de toute la version afin que vous puissiez les relire avant que quoi que ce soit ne soit créé. Les commandes utilisent l'adresse du chart Community ; pour l'édition Enterprise, indiquez à la place le chemin du chart Enterprise que vous avez téléchargé (chapitre 2.7, Installation de l'édition Enterprise et application d'une licence). Une génération sur votre poste de travail ne pouvant pas lire l'adresse du serveur d'API depuis un cluster, définissez d'abord networkPolicy.apiServerCIDRs dans le fichier.

Les deux vérifications :

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

Une clé mal orthographiée fait échouer la validation (lint) avec la mention « additional properties » en indiquant le nom de la clé. Une valeur obligatoire manquante, telle qu'un hôte lorsqu'un magasin est externe, fait échouer la génération avec la phrase citée dans ce chapitre. helm template n'ayant pas de cluster à interroger, indiquez networkPolicy.apiServerCIDRs lorsque vous générez les manifestes hors ligne, sinon le processus s'arrête et vous les demande.

Exécutez ensuite la vérification préalable (preflight) avec le même fichier. La vérification préalable est le seul contrôle qui lit simultanément le cluster et les valeurs : c'est là qu'un mauvais espace de noms Ingress, une classe de stockage manquante ou un certificat expirant la semaine suivante sont détectés avant que quiconque ne dépende de l'installation.

Kubernetes managé

Nexus s'exécute sur n'importe quel cluster Kubernetes 1.33 ou version ultérieure conforme, y compris le service géré d'un fournisseur cloud. Rien dans le chart n'est spécifique à un fournisseur particulier. Ce qui change par rapport à k3s se résume à une poignée de valeurs, toutes abordées ci-dessus :

  • cert-manager v1.21.3 est installé en premier, comme sur n'importe quel cluster. | Sur un cluster géré | Quoi définir ou vérifier | |---|---| | Stockage | Nommez la classe du fournisseur dans storage.className, ou marquez-en une comme classe par défaut. | | Ingress | Installez le contrôleur Ingress que vous utilisez, exposez-le sur les ports 80 et 443, définissez ingress.className s'il ne s'agit pas de la classe par défaut, et définissez networkPolicy.ingressNamespace sur son espace de noms. | | Les sauts de proxy | Définissez proxy.trustedCIDRs sur le réseau de pods de ce contrôleur. | | Le serveur d'API | Si l'installation ne peut pas lire l'adresse du serveur d'API depuis le cluster, indiquez-la dans networkPolicy.apiServerCIDRs. | | Application de la politique réseau | Les politiques du chart ne prennent effet que si le plugin réseau du cluster applique les ressources NetworkPolicy. Choisissez une configuration de cluster qui le fait. | | Images | Les nœuds doivent pouvoir joindre registry.adverant.ai, ou votre propre registre nommé dans global.imageRegistry. |

Exécutez la vérification préalable avant toute autre chose. Elle lit simultanément le cluster et le fichier de valeurs et affiche chacun de ces points sous forme de ligne, avec le correctif en regard de chaque élément manquant. Le chapitre 2.5, Vérification préalable avec nexusctl, présente ce rapport.

Avant d'installer
Avant d'installer
Une vérification préalable réussie sur un cluster de production. Chaque ligne correspond à une exigence, et chaque avertissement comporte son correctif sur la ligne du dessous.