ConnXL Docs

Exploiter

Environnements

Un complément possède un ensemble ordonné d'environnements — Development, QA, Staging, UAT, Production — et chacun exécute son propre agent, actif indépendamment des autres. Cette page couvre le renommage, le cache de résultats par environnement, et la façon dont la configuration circule entre les environnements.

6 min de lecture

Ce qu'est un environnement

Un complément possède un ensemble ordonné d'environnements nommés — jusqu'à cinq, dans un ordre de promotion fixe (Development, QA, Staging, UAT, Production par défaut ; vous n'êtes pas obligé de remplir chaque emplacement, et les noms sont les vôtres à modifier). Un nouveau complément démarre avec un unique environnement Development.

  • Chaque environnement exécute son propre agent — son propre processus connxl-agent (ou plusieurs réplicas), authentifié par un certificat limité à cet unique environnement. Il n'y a aucun « environnement actif » ni d'épinglage : Development et Production sont servis en parallèle par des agents différents, et rien de ce que vous faites dans l'un n'affecte le fait que l'autre soit actif.
  • Development (position 1) est la source. C'est le seul environnement où vous créez ou modifiez la structure — fonctions, définitions de connexion, boutons de ruban, volet Office. Le backend l'applique, pas seulement le tableau de bord.
  • Tout autre environnement est une cible de promotion. Vous n'y modifiez que des valeurs spécifiques à l'environnement — identifiants, hôtes, réglages de cache. Une modification structurelle (ajouter une fonction, changer la forme d'une connexion) est rejetée en dehors de l'environnement source ; vous faites entrer la structure avec Promouvoir à la place.

Renommer et supprimer

Ouvrez les paramètres d'un environnement pour le renommer. Le slug — comparé sans distinction de casse au CONNXL_ENV_ID déclaré par l'agent à la connexion — est fixé à la création et ne peut pas changer, de sorte que renommer le nom d'affichage ne casse jamais l'identité d'un agent en cours d'exécution.

La suppression est en cascade

Supprimer un environnement retire avec lui ses connexions, fonctions, boutons de ruban, volet Office et historique de versions. L'environnement source et l'environnement dont un complément dépend actuellement pour son dernier agent restant sont protégés contre la suppression.

Le cache de résultats

Chaque environnement porte sa propre configuration de cache — le bloc cache de l'instantané de l'agent, modifié depuis l'onglet Configuration de la page Agent. Il détermine si (et comment) les résultats des fonctions sont mis en cache avant qu'un appel n'atteigne à nouveau votre source de données.

  • Backenddisabled (par défaut ; rien n'est mis en cache), memory (dans le processus de l'agent — effacé au redémarrage, par réplica), ou valkey (partagé entre tous les réplicas de l'environnement, alimenté par une connexion Valkey que vous enregistrez comme n'importe quelle autre source de données).
  • Valeurs par défaut — le TTL et les limites de taille appliqués par défaut à toute fonction qu'aucun segment ci-dessous ne couvre.
  • Segments — une liste ordonnée de règles glob sur les identifiants de fonction (MODULE.NOM, par ex. SALES.*). Le premier segment qui correspond l'emporte, placez donc les motifs les plus précis au-dessus des plus larges. Chaque segment peut définir son propre TTL et ses propres limites de taille, remplaçant les valeurs par défaut pour les seules fonctions qu'il touche.
FieldTypeDescription
backendRequired
disabled | memory | valkeyOù vivent les résultats mis en cache. valkey nécessite une connexion kv enregistrée dans cet environnement — sans elle, l'option est indisponible.
connectionIdOptional
idLa connexion kv (Valkey) alimentant un cache valkey. L'URL de la connexion est un secret, la configuration du cache la référence donc par id plutôt que de stocker l'URL directement.
defaults.ttlSecondsOptional
intDurée de vie par défaut d'un résultat mis en cache, en secondes. Vide/0 signifie qu'aucune limite par défaut n'est fixée.
defaults.maxEntriesOptional
intPlafond par défaut du nombre d'entrées mises en cache.
defaults.maxBytesOptional
intPlafond par défaut de la taille mise en cache, en octets.
resources[].nameOptional
stringUn libellé pour le segment. default est réservé, et les noms doivent être uniques au sein de l'environnement.
resources[].matchRequired
globUn motif glob sur les identifiants de fonction (par ex. SALES.*). Évalués de haut en bas ; le premier qui correspond l'emporte.
resources[].ttlSeconds / maxEntries / maxBytesOptional
intRemplace les valeurs par défaut pour les fonctions que ce segment touche.

Un motif qui ne correspond à rien n'est qu'un avertissement

Le tableau de bord vérifie le motif glob de chaque segment par rapport aux identifiants de fonction actuels de votre environnement et signale celui qui n'en correspond aucun — utile pour repérer un nom de module mal saisi. C'est purement indicatif : un motif peut légitimement viser une fonction que vous n'avez pas encore construite, il ne bloque donc jamais l'enregistrement.

Le cache ne s'applique que lorsqu'un backend autre que disabled est sélectionné ; choisir disabled garde le sélecteur de backend actif (pour pouvoir réactiver le cache) mais rend tous les autres champs inertes.

Comment la configuration circule entre les environnements

La structure ne s'édite jamais toute seule dans un environnement en aval — elle y est apportée délibérément avec Promouvoir, depuis la page de cet environnement. Promouvoir :

  • Copie la structure de l'environnement source (fonctions, forme des connexions, boutons de ruban, volet Office) dans l'environnement cible.
  • Préserve les propres valeurs de la cible — ses identifiants, son hôte d'agent et sa configuration de cache restent intacts, de sorte que promouvoir une nouvelle fonction vers Production n'écrase pas le mot de passe de la base de données de Production.
  • Publie automatiquement — une promotion met à jour la configuration de travail de la cible et l'active en même temps, enregistrée comme une entrée promote dans l'historique de versions de cet environnement.

Consultez Versions pour le déroulement complet enregistrer/publier/comparer/restaurer, et la façon dont une promotion apparaît dans l'historique d'un environnement.

Sur cette page