Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

Flag globali

Flag disponibili su ogni sottocomando di aggrega.

--workspace-root <path>

Usa <path> come radice del workspace, saltando completamente la scoperta. Quando il flag è omesso, aggrega scopre la radice risalendo dalla directory corrente — oppure, dove quella risalita non trova nulla e il comando indica la propria Release o il proprio documento con un percorso assoluto, risalendo invece dalla cartella di quel file; vedi Configurazione per sapere cosa ancora una radice, in quale ordine, e quali comandi indicano un file del genere.

AGGREGA_WORKSPACE_ROOT è il corrispettivo nell’ambiente: quando --workspace-root non è dato, la variabile fornisce la radice. Il flag prevale quando è impostato.

La radice è la radice ovunque venga data, server inclusi: a una richiesta ad aggrega mcp che non indica un workspace proprio si risponde in essa, senza cercare nulla al di sopra. Una radice che non è una cartella esistente — un percorso che non indica nulla, o che indica un file — viene rifiutata da ogni comando che legge il proprio workspace, prima che il comando faccia qualsiasi altra cosa; aggrega serve e un listener di aggrega mcp si rifiutano di partire con una tale radice, e aggrega mcp su standard input e output parte comunque e risponde con il rifiuto a ogni chiamata che agisce in quel workspace. Il rifiuto nomina quale dei due l’ha fornita, --workspace-root o AGGREGA_WORKSPACE_ROOT, con il valore esattamente come è stato dato. Un comando che non legge alcun workspace, come aggrega version, non legge nemmeno la radice e non viene rifiutato per essa.

Dove nessuno dei due è dato e la scoperta non ancora nulla, la cartella in cui viene eseguito il comando è la radice, e un comando che legge il proprio workspace lo dice in una riga sullo standard error, indicando quella cartella e questo flag; vedi Configurazione, che spiega anche perché in una cartella del genere non viene scritto nulla in una cache degli artifact.

File di configurazione globale

--config <path> indica esplicitamente il file di configurazione globale per una singola invocazione. Prevale sulla variabile d’ambiente AGGREGA_CONFIG, che a sua volta prevale sulla posizione predefinita — e poiché entrambi indicano un file deliberatamente, un percorso che non esiste è un errore esplicito anziché un ripiego silenzioso. A differenza delle variabili di impostazione AGGREGA_*, nessuno dei due sovrascrive una singola impostazione; selezionano quale file si applica. Qualunque file venga risolto, i file di configurazione del progetto continuano a sovrapporsi a esso. Configurazione riporta l’ordine di risoluzione e cosa va in quel file.

--config e la variabile d’ambiente AGGREGA_CONFIG selezionano la destinazione della scrittura oltre che la sorgente della lettura: un comando eseguito con --config <path> legge la propria configurazione da quel file e applica la propria modifica a quello stesso file, quindi ciò che un comando scrive è ciò che il comando successivo con la stessa forma di invocazione rilegge.

I comandi che modificano la configurazione scelgono in quale file scrivere in base alla natura dell’impostazione: la configurazione degli strumenti a livello di macchina (un registry) va per impostazione predefinita nel file globale, mentre la configurazione che partecipa alla build (un binding di provider o un collegamento a un socket di governance/linter/importer) va per impostazione predefinita nel file committato del progetto. Passa --global o --workspace per cambiare la destinazione, e il comando stampa dove ha scritto.

Per inizializzare una configurazione globale su una macchina nuova — registrando un registry e la sua policy di fiducia delle firme in modo che gli artifact firmati vengano scaricati e verificati senza modificare YAML a mano — esegui aggrega config init. Per vedere cosa si applica in questo momento, e con --origin quale livello ha deciso ciascuna impostazione, esegui aggrega config show.

--offline

Rifiuta ogni accesso alla rete per questa singola esecuzione.

Offline è una postura del workspace anziché una modalità di un singolo comando, ed è raggiungibile da tre punti: questo flag, AGGREGA_OFFLINE e la chiave di primo livello offline in un file di configurazione. Significano la stessa cosa e seguono l’ordine consueto — il flag prevale sulla variabile, che prevale sul file.

La direzione di disattivazione è compito del flag quanto quella di attivazione. --offline=false consente la rete per un comando dove un file di configurazione committato o una variabile esportata ha attivato la postura. Ciò conta quando non spetta a te modificare il file: un progetto il cui .aggrega-config.yaml contiene offline: true rifiuta una pubblicazione per chiunque lo cloni, e passare --offline=false è l’unica risposta che non richiede né un commit né una variabile esportata.

Cosa viene rifiutato e cosa no

Il confine è ciò di cui il lavoro ha bisogno, non quale comando è stato digitato.

Rifiutato, perché non può essere vero senza raggiungere un registry:

  • --upgrade, ovunque compaia. Risolve di nuovo ogni dipendenza e porta ciascuna alla versione più alta che un registry offre attualmente, e «la più alta disponibile» è un’affermazione su ciò che un registry serve in questo momento. Eseguirlo su una cache già popolata fisserebbe qualunque cosa si trovasse in cache dichiarando al contempo di essere passato alla più recente, il che è peggio di un arresto.
  • I comandi il cui lavoro è di per sé un round trip di rete: aggrega push, aggrega push-artifact e aggrega registry update. Questi lo dicono prima di leggere la tua entità o di percorrere i tuoi repository, e il rifiuto indica quale dei tre punti ha impostato la postura, così chi non ha digitato alcun flag sa dove guardare.

Non rifiutato, perché la macchina potrebbe già essere in grado di soddisfarlo:

  • Un normale aggrega pull, e aggrega build --auto-pull. Entrambi rispettano i pin già registrati e risolvono solo ciò che non ne ha, quindi un workspace i cui riferimenti sono tutti in cache o presenti in un catalogo catalog_dirs si completa senza accedere all’esterno. Dove un’esecuzione del genere ha davvero bisogno di scaricare qualcosa, viene rifiutata in quel punto e le viene detto quale riferimento non ha potuto soddisfare.
  • aggrega build con un lockfile compilato, che legge l’intera chiusura dalla cache. L’unico accesso che ha è una riparazione: dove la copia nello store di un input esterno fissato è andata persa, quell’input viene scaricato di nuovo tramite il digest che il lockfile registra già. Con la postura attiva non c’è trasporto nemmeno per quello, quindi la copia mancante arresta invece la build, indicando la postura.
  • Una pubblicazione con --dry-run. Tutto il suo comportamento consiste nel riportare ciò che pubblicherebbe senza chiamare nulla, il che la rende la forma di pubblicazione sicura offline anziché una contraddizione della postura.

Una macchina airgapped che conserva una copia locale del proprio catalogo e dei propri artifact è il caso che questa distinzione esiste per mantenere funzionante: un workspace del genere è offline, e quasi tutto ciò che fa è ancora soddisfacibile.

Precedenza della configurazione

Un flag prevale su tutto: su una variabile d’ambiente, sui file di configurazione e sul valore predefinito integrato. Configurazione riporta la scala completa, e environment-variables.md l’elenco delle variabili con prefisso AGGREGA_.

aggrega config show --origin riporta quale di quei livelli ha deciso ciascuna impostazione, e un flag che hai digitato viene riportato come flag — quindi quando un rifiuto indica un livello che non ti aspettavi, è con quel comando che lo verifichi.

Vedi anche

  • configuration.md — in quale file va un’impostazione, e il modello di precedenza completo.
  • environment-variables.md — il riferimento completo delle variabili AGGREGA_*.
  • aggrega-serve.md — il daemon risolve il proprio workspace attraverso lo stesso percorso di scoperta della radice.
FlagPredefinitoDescrizione
--config—percorso del file di configurazione globale, che sovrascrive la variabile d’ambiente AGGREGA_CONFIG e la posizione predefinita. I file di configurazione dell’albero del workspace continuano a sovrapporsi
--no-colorfalseDisabilita il colore ANSI in tutto l’output. Rispettato anche tramite la variabile d’ambiente NO_COLOR
--offlinefalseRifiuta ogni accesso alla rete per questa singola esecuzione: la postura offline, attivata senza modificare la configurazione. Passa —offline=false per disattivarla per un’esecuzione dove il file di configurazione o AGGREGA_OFFLINE la attivano già. Viene rifiutato ciò che non può essere vero senza un registry: —upgrade, il cui unico compito è portare ogni dipendenza alla versione più alta che un registry offre attualmente, e i comandi il cui lavoro è di per sé un round trip di rete — push, push-artifact e registry update. Continua a funzionare tutto ciò che la macchina può già soddisfare: una build con un lockfile compilato, —auto-pull su riferimenti già in cache o presenti in un catalogo locale, e un dry run, che riporta ciò che pubblicherebbe senza chiamare nulla
--plainfalseModalità accessibile: disabilita il colore e disegna righe di avanzamento semplici e statiche, senza animazione di spinner né ridisegno del cursore, anche su un terminale. Pensata per gli screen reader
--workspace-root—percorso assoluto da usare come radice del workspace (salta la scoperta)