Flags globaux
Flags disponibles sur chaque sous-commande d’aggrega.
--workspace-root <path>
Utilise <path> comme racine du workspace, en ignorant entièrement la découverte. Lorsque le flag est omis, aggrega découvre la racine en remontant depuis le répertoire courant — ou, lorsque cette remontée ne trouve rien et que la commande désigne sa Release ou son document par un chemin absolu, en remontant plutôt depuis le dossier de ce fichier ; voir Configuration pour savoir ce qui ancre une racine, dans quel ordre, et quelles commandes désignent un tel fichier.
AGGREGA_WORKSPACE_ROOT est l’équivalent dans l’environnement : lorsque --workspace-root n’est pas donné, la variable fournit la racine. Le flag l’emporte lorsqu’il est défini.
La racine est la racine où qu’elle soit donnée, serveurs compris : une requête à aggrega mcp qui ne désigne aucun workspace propre reçoit une réponse dans celle-ci, sans que rien au-dessus ne soit parcouru. Une racine qui n’est pas un dossier existant — un chemin qui ne désigne rien, ou qui désigne un fichier — est refusée par chaque commande qui lit son workspace, avant que la commande ne fasse quoi que ce soit d’autre ; aggrega serve et un listener aggrega mcp refusent de démarrer avec une telle racine, et aggrega mcp sur l’entrée et la sortie standard démarre malgré tout et répond par le refus à chaque appel qui agit dans ce workspace. Le refus nomme celui des deux qui l’a fournie, --workspace-root ou AGGREGA_WORKSPACE_ROOT, avec la valeur exactement telle qu’elle a été donnée. Une commande qui ne lit aucun workspace, comme aggrega version, ne lit pas non plus la racine et n’est pas refusée à cause d’elle.
Lorsqu’aucun des deux n’est donné et que la découverte n’ancre rien, le dossier dans lequel s’exécute la commande est la racine, et une commande qui lit son workspace le signale en une ligne sur la sortie d’erreur standard, en nommant ce dossier et ce flag ; voir Configuration, qui explique aussi pourquoi rien n’est écrit dans un cache d’artefacts dans un tel dossier.
Fichier de configuration global
--config <path> désigne explicitement le fichier de configuration global pour une invocation. Il l’emporte sur la variable d’environnement AGGREGA_CONFIG, qui l’emporte à son tour sur l’emplacement par défaut — et comme tous deux désignent un fichier délibérément, un chemin qui n’existe pas est une erreur signalée clairement plutôt qu’un repli silencieux. Contrairement aux variables de paramètre AGGREGA_*, aucun des deux ne remplace un seul paramètre ; ils sélectionnent quel fichier s’applique. Quel que soit le fichier résolu, les fichiers de configuration propres au projet continuent de se superposer à lui. Configuration présente l’ordre de résolution et ce qui a sa place dans ce fichier.
--config et la variable d’environnement AGGREGA_CONFIG sélectionnent la cible d’écriture aussi bien que la source de lecture : une commande exécutée avec --config <path> lit sa configuration dans ce fichier et applique sa modification à ce même fichier, de sorte que ce qu’écrit une commande est ce que relit la commande suivante de même forme d’invocation.
Les commandes qui modifient la configuration choisissent le fichier dans lequel elles écrivent selon la nature du paramètre : la configuration d’outillage à l’échelle de la machine (un registre) va par défaut dans le fichier global, tandis que la configuration qui participe au build (une liaison de provider ou un rattachement de socket de gouvernance/linter/importer) va par défaut dans le fichier committé du projet. Passez --global ou --workspace pour changer de cible, et la commande affiche où elle a écrit.
Pour initialiser une configuration globale sur une machine neuve — en enregistrant un registre et sa politique de confiance des signatures afin que les artefacts signés soient récupérés et vérifiés sans modifier le YAML à la main —, exécutez aggrega config init. Pour voir ce qui s’applique en ce moment, et avec --origin quelle couche a décidé chaque paramètre, exécutez aggrega config show.
--offline
Refuser tout accès réseau pour cette seule exécution.
Le mode hors ligne est une posture du workspace plutôt qu’un mode d’une seule commande, et il est accessible depuis trois endroits : ce flag, AGGREGA_OFFLINE et la clé de premier niveau offline dans un fichier de configuration. Ils signifient la même chose et suivent l’ordre habituel — le flag l’emporte sur la variable, qui l’emporte sur le fichier.
Le sens de la désactivation est tout autant le rôle du flag que celui de l’activation. --offline=false autorise le réseau pour une commande là où un fichier de configuration committé ou une variable exportée a activé la posture. Cela compte lorsque le fichier n’est pas le vôtre à modifier : un projet dont le .aggrega-config.yaml contient offline: true refuse une publication à quiconque le clone, et passer --offline=false est la seule réponse qui ne nécessite ni commit ni variable exportée.
Ce qui est refusé, et ce qui ne l’est pas
La limite tient à ce dont le travail a besoin plutôt qu’à la commande qui a été saisie.
Refusé, parce que cela ne peut être vrai sans atteindre un registre :
--upgrade, où qu’il apparaisse. Il résout à nouveau chaque dépendance et fait passer chacune à la version la plus élevée qu’un registre propose actuellement, et « la plus élevée disponible » est une affirmation sur ce qu’un registre sert en ce moment. L’exécuter sur un cache déjà rempli pinnerait ce qui se trouvait en cache tout en signalant être passé à la plus récente, ce qui est pire qu’un arrêt.- Les commandes dont le travail même est un aller-retour réseau :
aggrega push,aggrega push-artifactetaggrega registry update. Elles le signalent avant de lire votre entité ou de parcourir vos dépôts, et le refus nomme celui des trois endroits qui a défini la posture, afin que quelqu’un qui n’a saisi aucun flag sache où regarder.
Non refusé, parce que la machine peut déjà être en mesure d’y répondre :
- Un
aggrega pullordinaire, etaggrega build --auto-pull. Tous deux respectent les pins déjà enregistrés et ne résolvent que ce qui n’en a pas, de sorte qu’un workspace dont les références sont toutes en cache ou présentes dans un cataloguecatalog_dirsse termine sans aucun accès extérieur. Lorsqu’une telle exécution a réellement besoin de récupérer quelque chose, elle est refusée à ce moment-là et on lui indique quelle référence elle n’a pas pu satisfaire. aggrega buildavec un lockfile rempli, qui lit toute sa fermeture depuis le cache. Le seul accès qu’il ait est une réparation : lorsque la copie d’une entrée externe pinnée a disparu du store, cette entrée est récupérée à nouveau par le digest que le lockfile enregistre déjà. Sous la posture, il n’y a aucun transport, même pour cela, de sorte que la copie manquante arrête plutôt le build, en nommant la posture.- Une publication avec
--dry-run. Tout son comportement consiste à indiquer ce qu’elle publierait sans rien appeler, ce qui en fait la forme de publication sûre hors ligne plutôt qu’une contradiction de la posture.
Une machine isolée du réseau qui détient une copie locale de son catalogue et de ses artefacts est le cas que cette distinction existe pour maintenir en état de marche : un tel workspace est hors ligne, et presque tout ce qu’il fait reste réalisable.
Priorité de la configuration
Un flag l’emporte sur tout : sur une variable d’environnement, sur les fichiers de configuration et sur la valeur par défaut intégrée. Configuration présente l’échelle complète, et environment-variables.md la liste des variables préfixées par AGGREGA_.
aggrega config show --origin indique laquelle de ces couches a décidé chaque paramètre, et un flag que vous avez saisi est signalé comme flag — ainsi, lorsqu’un refus nomme une couche à laquelle vous ne vous attendiez pas, c’est avec cette commande que vous le confirmez.
Voir aussi
- configuration.md — dans quel fichier un paramètre doit figurer, et le modèle de priorité complet.
- environment-variables.md — la référence complète des variables
AGGREGA_*. - aggrega-serve.md — le daemon résout son workspace par le même chemin de découverte de la racine.
| Option | Par défaut | Description |
|---|---|---|
--config | — | chemin du fichier de configuration global, qui remplace la variable d’environnement AGGREGA_CONFIG et l’emplacement par défaut. Les fichiers de configuration de l’arborescence du workspace continuent de s’y superposer |
--no-color | false | Désactive la couleur ANSI dans toute la sortie. Également pris en compte via la variable d’environnement NO_COLOR |
--offline | false | Refuser tout accès réseau pour cette seule exécution : la posture hors ligne, activée sans modifier la configuration. Passez —offline=false pour la désactiver pour une exécution là où le fichier de configuration ou AGGREGA_OFFLINE l’active déjà. Ce qui est refusé, c’est ce qui ne peut être vrai sans registre : —upgrade, dont le seul rôle est de faire passer chaque dépendance à la version la plus élevée qu’un registre propose actuellement, et les commandes dont le travail même est un aller-retour réseau — push, push-artifact et registry update. Ce qui s’exécute toujours, c’est tout ce que la machine peut déjà satisfaire : un build avec un lockfile rempli, —auto-pull sur des références déjà en cache ou présentes dans un catalogue local, et un dry run, qui indique ce qu’il publierait sans rien appeler |
--plain | false | Mode accessible : désactive la couleur et affiche des lignes de progression simples et statiques, sans animation de spinner ni redessin du curseur, même dans un terminal. Destiné aux lecteurs d’écran |
--workspace-root | — | chemin absolu à utiliser comme racine du workspace (ignore la découverte) |