Flags globales
Flags disponibles en cada subcomando de aggrega.
--workspace-root <path>
Usa <path> como raíz del workspace, omitiendo por completo el descubrimiento. Cuando se omite el flag, aggrega descubre la raíz subiendo desde el directorio actual — o, donde ese recorrido no encuentra nada y el comando indica su Release o su documento con una ruta absoluta, subiendo en cambio desde la carpeta de ese archivo; consulta Configuración para saber qué ancla una raíz, en qué orden y qué comandos indican un archivo así.
AGGREGA_WORKSPACE_ROOT es el equivalente en el entorno: cuando no se da --workspace-root, la variable aporta la raíz. El flag prevalece cuando está establecido.
La raíz es la raíz dondequiera que se dé, servidores incluidos: una solicitud a aggrega mcp que no indica un workspace propio se responde en ella, sin buscar nada por encima. Una raíz que no es una carpeta existente — una ruta que no indica nada, o que indica un archivo — la rechaza cada comando que lee su workspace, antes de que el comando haga cualquier otra cosa; aggrega serve y un listener de aggrega mcp se niegan a arrancar con ella, y aggrega mcp sobre la entrada y salida estándar arranca de todos modos y responde con el rechazo a cada llamada que actúa en ese workspace. El rechazo nombra cuál de los dos la aportó, --workspace-root o AGGREGA_WORKSPACE_ROOT, con el valor exactamente como se dio. Un comando que no lee ningún workspace, como aggrega version, tampoco lee la raíz y no se rechaza por ella.
Donde no se da ninguno de los dos y el descubrimiento no ancla nada, la carpeta en la que se ejecuta el comando es la raíz, y un comando que lee su workspace lo indica en una línea en la salida de error estándar, nombrando esa carpeta y este flag; consulta Configuración, que también explica por qué en una carpeta así no se escribe nada en una caché de artefactos.
Archivo de configuración global
--config <path> indica explícitamente el archivo de configuración global para una invocación. Prevalece sobre la variable de entorno AGGREGA_CONFIG, que a su vez prevalece sobre la ubicación predeterminada — y como ambos indican un archivo deliberadamente, una ruta que no existe es un error visible en lugar de una alternativa silenciosa. A diferencia de las variables de ajuste AGGREGA_*, ninguno de los dos anula un solo ajuste; seleccionan qué archivo se aplica. Sea cual sea el archivo que se resuelva, los archivos de configuración propios del proyecto siguen superponiéndose a él. Configuración recoge el orden de resolución y lo que corresponde a ese archivo.
--config y la variable de entorno AGGREGA_CONFIG seleccionan el destino de escritura además del origen de lectura: un comando ejecutado con --config <path> lee su configuración de ese archivo y aplica su cambio a ese mismo archivo, así que lo que escribe un comando es lo que vuelve a leer el siguiente comando con la misma forma de invocación.
Los comandos que modifican la configuración eligen en qué archivo escriben según la naturaleza del ajuste: la configuración de herramientas de toda la máquina (un registro) va de forma predeterminada al archivo global, mientras que la configuración que participa en la compilación (un enlace de provider o una conexión a un socket de gobernanza/linter/importador) va de forma predeterminada al archivo confirmado del proyecto. Pasa --global o --workspace para cambiarlo, y el comando imprime dónde escribió.
Para inicializar una configuración global en una máquina nueva — registrando un registro y su política de confianza de firmas para que los artefactos firmados se obtengan y verifiquen sin editar YAML a mano —, ejecuta aggrega config init. Para ver qué se aplica ahora mismo, y con --origin qué capa decidió cada ajuste, ejecuta aggrega config show.
--offline
Rechaza todo acceso a la red en esta ejecución.
El modo sin conexión es una postura del workspace y no un modo de un solo comando, y se puede activar desde tres lugares: este flag, AGGREGA_OFFLINE y la clave de nivel superior offline en un archivo de configuración. Significan lo mismo y siguen el orden habitual — el flag prevalece sobre la variable, que prevalece sobre el archivo.
La dirección de desactivación es tan tarea del flag como la de activación. --offline=false permite la red para un comando donde un archivo de configuración confirmado o una variable exportada ha activado la postura. Eso importa cuando no te corresponde editar el archivo: un proyecto cuyo .aggrega-config.yaml lleva offline: true rechaza una publicación para cualquiera que lo clone, y pasar --offline=false es la única respuesta que no requiere ni un commit ni una variable exportada.
Qué se rechaza y qué no
El límite lo marca lo que necesita el trabajo, no qué comando se escribió.
Se rechaza, porque no puede ser cierto sin alcanzar un registro:
--upgrade, dondequiera que aparezca. Vuelve a resolver cada dependencia y lleva cada una a la versión más alta que un registro ofrece actualmente, y «la más alta disponible» es una afirmación sobre lo que un registro sirve en este momento. Ejecutarlo contra una caché ya llena fijaría lo que hubiera en caché mientras informa de que ha pasado a la más reciente, lo cual es peor que una detención.- Los comandos cuyo propio trabajo es un viaje de ida y vuelta por la red:
aggrega push,aggrega push-artifactyaggrega registry update. Estos lo indican antes de leer tu entidad o de recorrer tus repositorios, y el rechazo nombra cuál de los tres lugares estableció la postura, para que quien no escribió ningún flag sepa dónde mirar.
No se rechaza, porque es posible que la máquina ya pueda satisfacerlo:
- Un
aggrega pullnormal, yaggrega build --auto-pull. Ambos respetan los pins ya registrados y resuelven solo lo que no tiene ninguno, así que un workspace cuyas referencias están todas en caché o presentes en un catálogo decatalog_dirstermina sin acceder al exterior en absoluto. Donde una ejecución así realmente necesita obtener algo, se rechaza en ese punto y se le indica qué referencia no pudo satisfacer. aggrega buildcon un lockfile completo, que lee todo su cierre desde la caché. El único acceso que tiene es una reparación: donde la copia en el almacén de una entrada externa fijada ha desaparecido, esa entrada se vuelve a obtener por el digest que el lockfile ya registra. Con la postura activa no hay transporte ni siquiera para eso, así que la copia que falta detiene en cambio la compilación, nombrando la postura.- Una publicación con
--dry-run. Todo su comportamiento consiste en informar de lo que publicaría sin llamar a nada, lo que la convierte en la forma de publicar segura sin conexión y no en una contradicción de la postura.
Una máquina aislada de la red que guarda una copia local de su catálogo y sus artefactos es el caso que esta división existe para mantener en funcionamiento: un workspace así está sin conexión, y casi todo lo que hace sigue siendo satisfacible.
Precedencia de la configuración
Un flag prevalece sobre todo: sobre una variable de entorno, sobre los archivos de configuración y sobre el valor predeterminado integrado. Configuración recoge la escala completa, y environment-variables.md la lista de variables con el prefijo AGGREGA_.
aggrega config show --origin informa de cuál de esas capas decidió cada ajuste, y un flag que escribiste se informa como el flag — así que cuando un rechazo nombra una capa que no esperabas, ese comando es donde lo confirmas.
Véase también
- configuration.md — en qué archivo va un ajuste, y el modelo de precedencia completo.
- environment-variables.md — la referencia completa de las variables
AGGREGA_*. - aggrega-serve.md — el daemon resuelve su workspace por la misma vía de descubrimiento de la raíz.
| Flag | Predeterminado | Descripción |
|---|---|---|
--config | — | ruta al archivo de configuración global, que anula la variable de entorno AGGREGA_CONFIG y la ubicación predeterminada. Los archivos de configuración del árbol del workspace siguen superponiéndose |
--no-color | false | Desactiva el color ANSI en toda la salida. También se respeta mediante la variable de entorno NO_COLOR |
--offline | false | Rechaza todo acceso a la red en esta ejecución: la postura sin conexión, activada sin editar la configuración. Pasa —offline=false para desactivarla en una ejecución donde el archivo de configuración o AGGREGA_OFFLINE ya la activa. Se rechaza lo que no puede ser cierto sin un registro: —upgrade, cuyo único trabajo es llevar cada dependencia a la versión más alta que un registro ofrece actualmente, y los comandos cuyo propio trabajo es un viaje de ida y vuelta por la red — push, push-artifact y registry update. Sigue ejecutándose todo lo que la máquina ya puede satisfacer: una compilación con un lockfile completo, —auto-pull sobre referencias ya en caché o presentes en un catálogo local, y un dry run, que informa de lo que publicaría sin llamar a nada |
--plain | false | Modo accesible: desactiva el color y dibuja líneas de progreso simples y estáticas, sin animación de spinner ni redibujado del cursor, incluso en un terminal. Pensado para lectores de pantalla |
--workspace-root | — | ruta absoluta que se usa como raíz del workspace (omite el descubrimiento) |