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.
- Backend —
disabled(par défaut ; rien n'est mis en cache),memory(dans le processus de l'agent — effacé au redémarrage, par réplica), ouvalkey(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.
| Field | Type | Description |
|---|---|---|
backendRequired | disabled | memory | valkey | Où 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 | id | La 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 | int | Duré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 | int | Plafond par défaut du nombre d'entrées mises en cache. |
defaults.maxBytesOptional | int | Plafond par défaut de la taille mise en cache, en octets. |
resources[].nameOptional | string | Un libellé pour le segment. default est réservé, et les noms doivent être uniques au sein de l'environnement. |
resources[].matchRequired | glob | Un 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 | int | Remplace 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
promotedans 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.
Tableau de bord
Le tableau de bord est l'endroit où vous configurez les compléments et surveillez les agents qui les servent. Tout est délimité par l'URL — organisation, puis complément, puis environnement — de sorte que le fil d'Ariane vous indique exactement ce que vous modifiez.
Versions
Chaque environnement conserve un historique restaurable des configurations publiées. Cette page couvre le modèle brouillon/version active, l'enregistrement et la publication d'une version, la comparaison de deux instantanés (y compris votre brouillon non publié), la restauration, et la promotion d'une version entre environnements.