Flags globais
Flags disponíveis em todos os subcomandos aggrega.
--workspace-root <path>
Usa <path> como raiz do espaço de trabalho, saltando por completo a descoberta. Quando a flag é omitida, aggrega descobre a raiz subindo a partir do diretório atual — ou, quando esse percurso não encontra nada e o comando nomeia a sua Release ou o seu documento por um caminho absoluto, subindo antes a partir da pasta desse ficheiro; consulte Configuração para saber o que ancora uma raiz, por que ordem, e que comandos nomeiam um ficheiro desses.
AGGREGA_WORKSPACE_ROOT é a contraparte no ambiente: quando --workspace-root não é dado, a variável fornece a raiz. A flag prevalece quando definida.
A raiz é a raiz onde quer que seja dada, incluindo nos servidores: um pedido a aggrega mcp que não nomeia um espaço de trabalho próprio é respondido nela, sem que nada acima dela seja pesquisado. Uma raiz que não é uma pasta existente — um caminho que não nomeia nada, ou que nomeia um ficheiro — é recusada por todos os comandos que leem o seu espaço de trabalho, antes de o comando fazer qualquer outra coisa; aggrega serve e um listener de aggrega mcp recusam-se a arrancar sobre uma raiz dessas, e aggrega mcp através da entrada e da saída padrão arranca na mesma e responde a todas as chamadas que atuam nesse espaço de trabalho com a recusa. A recusa nomeia qual dos dois a forneceu, --workspace-root ou AGGREGA_WORKSPACE_ROOT, com o valor exatamente como foi dado. Um comando que não lê nenhum espaço de trabalho, como aggrega version, também não lê a raiz e não é recusado por causa dela.
Quando nenhum dos dois é dado e a descoberta não ancora nada, a pasta em que o comando corre é a raiz, e um comando que lê o seu espaço de trabalho di-lo numa linha no erro padrão, nomeando essa pasta e esta flag; consulte Configuração, que também explica porque é que nada é escrito numa cache de artefactos numa pasta destas.
Ficheiro de configuração global
--config <path> nomeia explicitamente o ficheiro de configuração global para uma invocação. Prevalece sobre a variável de ambiente AGGREGA_CONFIG, que por sua vez prevalece sobre a localização predefinida — e, como ambas nomeiam um ficheiro deliberadamente, um caminho que não existe é um erro ruidoso e não um recurso silencioso. Ao contrário das variáveis de definição AGGREGA_*, nenhuma delas substitui uma única definição; selecionam que ficheiro se aplica. Seja qual for o ficheiro que resolva, os próprios ficheiros de configuração do projeto continuam a sobrepor-se a ele. Configuração apresenta a ordem de resolução e o que pertence a esse ficheiro.
--config e a variável de ambiente AGGREGA_CONFIG selecionam o destino da escrita, bem como a origem da leitura: um comando executado com --config <path> lê a sua configuração desse ficheiro e aplica a sua alteração a esse mesmo ficheiro, pelo que o que um comando escreve é o que o comando seguinte com a mesma forma de invocação lê de volta.
Os comandos que alteram a configuração escolhem em que ficheiro escrevem a partir da natureza da definição: a configuração de ferramentas de toda a máquina (um registo) vai por predefinição para o ficheiro global, enquanto a configuração que participa na compilação (uma associação de fornecedor ou um anexo de socket de governance/linter/importer) vai por predefinição para o ficheiro do projeto incluído no controlo de versões. Passe --global ou --workspace para substituir isto, e o comando imprime onde escreveu.
Para inicializar uma configuração global numa máquina nova — registando um registo e a sua política de confiança de assinaturas para que os artefactos assinados sejam obtidos e verificados sem editar YAML à mão —, execute aggrega config init. Para ver o que se aplica neste momento e, com --origin, que camada decidiu cada definição, execute aggrega config show.
--offline
Recusa qualquer acesso à rede nesta execução.
O modo offline é uma postura do espaço de trabalho e não um modo de um comando, e pode ser ativado a partir de três locais: esta flag, AGGREGA_OFFLINE e a chave offline de nível superior num ficheiro de configuração. Significam a mesma coisa e seguem a ordem habitual — a flag prevalece sobre a variável, que prevalece sobre o ficheiro.
O sentido de desativar é tanto tarefa da flag como o de ativar. --offline=false permite a rede para um comando quando um ficheiro de configuração incluído no controlo de versões ou uma variável exportada ativou a postura. Isso importa quando o ficheiro não é seu para editar: um projeto cujo .aggrega-config.yaml transporta offline: true recusa uma publicação a todos os que o clonam, e passar --offline=false é a única resposta que não precisa de commit nem de variável exportada.
O que é recusado e o que não é
A fronteira é aquilo de que o trabalho precisa, e não o comando que foi escrito.
Recusado, porque não pode ser verdade sem chegar a um registo:
--upgrade, onde quer que apareça. Volta a resolver todas as dependências e faz subir cada uma para a versão mais alta que um registo oferece atualmente, e «a mais alta disponível» é uma afirmação sobre o que um registo serve neste momento. Executá-lo com uma cache preenchida fixaria o que por acaso estivesse em cache, reportando ao mesmo tempo que tinha subido para a mais recente, o que é pior do que uma paragem.- Os comandos cujo próprio trabalho é uma ida e volta pela rede:
aggrega push,aggrega push-artifacteaggrega registry update. Estes dizem-no antes de lerem a sua entidade ou percorrerem os seus repositórios, e a recusa nomeia qual dos três locais definiu a postura, para que quem não escreveu nenhuma flag saiba onde procurar.
Não recusado, porque a máquina pode já conseguir satisfazê-lo:
- Um
aggrega pullnormal, eaggrega build --auto-pull. Ambos respeitam as fixações já registadas e resolvem apenas o que não tem nenhuma, pelo que um espaço de trabalho cujas referências estão todas em cache ou presentes num catálogocatalog_dirsé concluído sem sair para a rede. Quando uma execução destas precisa realmente de obter algo, é recusada nesse ponto e é-lhe indicado que referência não conseguiu satisfazer. aggrega buildcom um lockfile preenchido, que lê todo o seu fecho a partir da cache. O único acesso que tem é uma reparação: quando a cópia de uma entrada externa fixada desapareceu do armazenamento, essa entrada é obtida novamente pelo digest que o lockfile já regista. Sob a postura não há transporte nem sequer para isso, pelo que a cópia em falta para a compilação, nomeando a postura.- Uma publicação
--dry-run. Todo o seu comportamento consiste em reportar o que publicaria sem chamar nada, o que faz dela a forma de publicação segura em modo offline e não uma contradição da postura.
Uma máquina isolada da rede que contém uma cópia local do seu catálogo e dos seus artefactos é o caso que esta divisão existe para manter a funcionar: um espaço de trabalho destes está offline, e quase tudo o que faz continua a poder ser satisfeito.
Precedência da configuração
Uma flag prevalece sobre tudo: sobre uma variável de ambiente, sobre os ficheiros de configuração e sobre a predefinição incorporada. Configuração apresenta a escala completa, e environment-variables.md a lista de variáveis com o prefixo AGGREGA_.
aggrega config show --origin reporta qual dessas camadas decidiu cada definição, e uma flag que escreveu é reportada como a flag — por isso, quando uma recusa nomeia uma camada que não esperava, é com esse comando que o confirma.
Ver também
- configuration.md — em que ficheiro pertence uma definição, e o modelo de precedência completo.
- environment-variables.md — a referência completa das variáveis
AGGREGA_*. - aggrega-serve.md — o daemon resolve o seu espaço de trabalho através do mesmo caminho de descoberta da raiz.
| Flag | Predefinição | Descrição |
|---|---|---|
--config | — | caminho para o ficheiro de configuração global, substituindo a variável de ambiente AGGREGA_CONFIG e a localização predefinida. Os ficheiros de configuração da árvore do espaço de trabalho continuam a sobrepor-se |
--no-color | false | Desativa a cor ANSI em toda a saída. Também é respeitada através da variável de ambiente NO_COLOR |
--offline | false | Recusa qualquer acesso à rede nesta execução: a postura offline, ativada sem editar a configuração. Passe —offline=false para a desativar numa execução em que o ficheiro de configuração ou AGGREGA_OFFLINE já a ativa. É recusado o que não pode ser verdade sem um registo: —upgrade, cujo trabalho é fazer subir cada dependência para a versão mais alta que um registo oferece atualmente, e os comandos cujo próprio trabalho é uma ida e volta pela rede — push, push-artifact e registry update. Continua a correr tudo o que a máquina já consegue satisfazer: uma compilação com um lockfile preenchido, —auto-pull sobre referências já em cache ou presentes num catálogo local, e uma execução de teste (dry run), que reporta o que publicaria sem chamar nada |
--plain | false | Modo acessível: desativa a cor e desenha linhas de progresso simples e estáticas, sem animação de indicador giratório nem redesenho do cursor, mesmo num terminal. Destinado a leitores de ecrã |
--workspace-root | — | caminho absoluto a usar como raiz do espaço de trabalho (salta a descoberta) |