Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

O limite do workspace

Um workspace é a árvore de diretórios que a raiz de um projeto marca — a raiz em que fica o bloco workspace: da sua configuração, a que --workspace-root indica, a pasta que um editor abriu ou aquela sobre a qual o servidor de um assistente foi iniciado. Tudo o que o Aggrega lê e grava por conta própria fica restrito a essa árvore, exceto onde você, ou a configuração do workspace, indicar um lugar fora dela. Um link simbólico dentro dela pode apontar para qualquer lugar da máquina, então um link nunca é tomado como parte do workspace só porque está ali: o que conta é para onde ele leva.

Esta página apresenta a regra por inteiro. As páginas de cada superfície — a linha de comando, o language server e as ferramentas do assistente — dizem como as suas próprias requisições se deparam com ela.

O que fica dentro do workspace

Um caminho está dentro do workspace quando a sua parte existente mais profunda, com os links seguidos, é a raiz do workspace ou fica abaixo dela — com os links da própria raiz seguidos da mesma forma, então um workspace que você alcança por um link próprio ainda contém tudo o que está abaixo dele.

Uma raiz que você abre por um link é o workspace para o qual o link leva. Seja a pasta que você abre ela própria um link, seja ela alcançada por um link mais acima, o Aggrega lista, lê e grava exatamente o que faria no workspace para o qual o link leva — suas Releases, seus documentos, seus lockfiles — e julga da mesma forma cada link dentro dele. Cada caminho em uma resposta ainda é escrito a partir da raiz como ela foi dada — a pasta que um editor abriu, o --workspace-root que você digitou, o diretório em que seu shell diz que você está trabalhando —, então o que é mostrado a você corresponde aos caminhos com que você trabalha.

Essa única leitura cobre todo tipo de caminho:

  • O que decide é para onde um caminho leva, não como ele é escrito. ./shared/app.yaml está fora quando shared é um link para um diretório em outro lugar, embora cada parte dele esteja escrita dentro do workspace. Um parâmetro de requisição ainda pode exigir uma escrita própria — um caminho relativo à raiz, por exemplo — e a página dele diz isso; essa é uma regra sobre o parâmetro, não sobre o limite.
  • Um caminho que ainda não existe é julgado pelos diretórios no caminho até ele. Um arquivo que um build está prestes a criar sob um dist que é um link que leva para fora está fora antes de ser gravado.
  • Um link que não leva a lugar nenhum, ou que dá voltas em um ciclo, não é algo que existe. Em vez disso, o diretório que o contém é julgado, e nada é seguido para descobrir para onde o link deveria levar. Onde um link assim está exatamente onde um arquivo está prestes a ser criado, o lugar para o qual ele aponta também é verificado, já que é ali que o arquivo iria parar.
  • Um link para outro lugar dentro do workspace é seguido normalmente. Apenas um link que leva para fora é retido.

A regra julga para onde um caminho leva no disco e nada mais. Ela não lê nenhum valor e não deduz nada de um nome.

O que acontece com um caminho que leva para fora depende do tipo de caminho. Há três resultados.

Listado como não lido

Onde o Aggrega lista o que o workspace contém, um link que leva para fora não é lido, e a listagem informa isso. As Releases que um editor oferece para escolha, o índice de entidades e os completamentos e candidatos que um editor extrai dele, e list-releases e list-entities de um assistente não pesquisam um diretório fora do workspace nem leem um arquivo fora dele, seja o que for que esse arquivo declare — de modo que uma entidade que seu editor mostra sob um link desses não é listada como própria do workspace. As listagens de Release e as listagens de entidades nomeiam cada link desses por seu próprio lugar no workspace, nunca pelo lugar para onde ele leva: unreadLinkedDirs e unreadLinkedFiles no language server, unread_linked_dirs e unread_linked_files nas ferramentas do assistente. Um link para um diretório que sua configuração lista em catalog_dirs, ou para um diretório abaixo de um deles, ou para uma Release que ela nomeia, não é nomeado: a configuração alcançou esse lugar — um diretório listado é lido com tudo o que está abaixo dele — como descrevem as exceções abaixo. Um .gitignore que seja um link que leva para fora também não é lido, de modo que um arquivo em outro lugar da máquina nunca decide quais documentos do workspace são pesquisados. Um arquivo de configuração do workspace que seja um link que leva para fora também é nomeado entre os arquivos não lidos: essas listagens continuam respondendo por esse workspace, lido sem nada configurado, enquanto toda solicitação que a configuração decide é interrompida, como descreve a própria configuração do workspace abaixo.

Recusado

Um caminho que uma solicitação nomeia, quando quem chama não é o dono da máquina digitando-o, é recusado. Afora as exceções abaixo, todo caminho que uma solicitação de um editor a aggrega serve nomeia para o servidor ler ou escrever, e todo caminho que um assistente nomeia a um servidor alcançado via HTTP, precisa levar para dentro do workspace; um que leva para fora é recusado sem que nada seja lido ou escrito, e a recusa nomeia o parâmetro, como a página de cada superfície expõe. A edição de documento é recusada dessa forma em todas as superfícies, inclusive na linha de comando — veja A edição de documento fica dentro.

Interrompido

Quando uma operação leria ou escreveria por conta própria através de um link que leva para fora, ela é interrompida. Esses são os caminhos que o produto determina por si mesmo, e não caminhos que você nomeou, e ignorar um deles em silêncio poderia mudar o que um build significa; por isso cada um interrompe a operação, nomeia o link e para onde ele leva, e deixa o lugar para onde o link aponta exatamente como estava:

  • O que uma busca lê — um documento abaixo de um diretório de catálogo, ou ao lado de uma Release que nomeia seu Aggregate ou seu Manifest por identidade, ou ao lado de um Manifest que nomeia dessa forma o Manifest que ele estende. A Release ou o Manifest nomeado para a operação não está entre esses documentos: foi lido onde foi nomeado — veja Uma Release ou um Manifest nomeado através de um link. Uma busca que pulasse um link desses poderia resolver em seu lugar outra entidade com o mesmo nome a partir de um diretório posterior, então um build, um pull, uma validação, uma inspeção que lê o catálogo, um lint de uma única Release ou do catálogo inteiro, e as solicitações do editor e de um assistente que compilam, visualizam, montam o grafo, validam, fazem lint ou descrevem uma Release são todos interrompidos antes que qualquer coisa seja resolvida ou verificada: E0321.
  • O lockfile de uma Release — lido ao lado da Release para os pins em relação aos quais um build, um pull, uma validação, um lint, uma inspeção, aggrega cache prune e as solicitações do editor e de um assistente são resolvidos. Ele está sujeito à mesma regra onde é lido exatamente como onde é escrito, então um lockfile que seja um link que leva para fora interrompe cada um deles em vez de lhes emprestar pins mantidos em outro lugar da máquina: E0321.
  • Um arquivo lido ao lado de uma entidade — os outros documentos no diretório de uma entidade que você fixa ou publica, lidos para saber se outra entidade compartilha esse diretório, e o .wasm compilado a partir do qual uma entidade Plugin em um diretório de catálogo é carregada. Cada um é lido somente de dentro do diretório sob o qual o próprio documento da entidade foi lido: o workspace, um diretório de catálogo que você nomeou fora dele, ou o diretório de um documento que você nomeou fora dele. Então um que seja um link que leva para fora interrompe aggrega pin, aggrega push (inclusive um dry run), um pull que fixa e a fixação e a publicação pelo editor e por um assistente — um documento deixado sem ler poderia ser a entidade no caminho — e interrompe um build ou um pull que carrega o plugin em vez de executar bytes mantidos em outro lugar da máquina: E0321.
  • O cache de artefatos — tudo o que o Aggrega lê do cache em artifact_cache_dir: uma entidade, um plugin ou uma biblioteca em cache e o manifesto ao lado, um arquivo de origem e seus metadados, uma entrada externa fixada, um pacote de assinatura e o índice de busca local de um registry, e toda entrada de workspace que aggrega cache status, aggrega cache prune e aggrega cache clear listam. O cache é lido somente de dentro do diretório de cache, o lugar em que ele é escrito, então qualquer coisa nele que seja um link que leva para fora desse diretório — para outro lugar do workspace tanto quanto para qualquer outro lugar — interrompe um build, um pull, uma validação, uma busca, cada um dos três comandos de cache, e as solicitações do editor e de um assistente que leem o cache, em vez de lhes entregar bytes mantidos em um lugar que não pertence ao cache — incluindo conteúdo verificado em relação a um digest registrado, já que um digest diz o que os bytes são, não de onde podem ser lidos. O aviso de descontinuação que aggrega inspect imprime, que não decide nada, fica de fora. Um prune ou um clear trata um dos próprios diretórios do cache que seja um link desses, ou um diretório de cache que seja ele mesmo um link que leva para fora do workspace, como a remoção que seria, com E0320, antes de listar qualquer coisa: E0321.
  • Um repositório que uma fonte busca — o checkout que um pull arquiva para uma fonte git-repository. O checkout é um diretório próprio, então um link que o repositório contém é arquivado como aquilo para que aponta somente quando isso está dentro do repositório; um que leva para fora dele, que poderia alcançar qualquer arquivo da máquina que executa o pull, interrompe o pull nomeando o link e para onde ele leva, sem nada em cache — incluindo o próprio module_subdir, quando ele é um link desses: E0321. O checkout desaparece assim que o pull é interrompido, então a mensagem nomeia o link por seu lugar no repositório, e o repositório e a revisão que a fonte nomeia. Um module_subdir que, tal como escrito, sobe acima do repositório é recusado antes que o repositório seja buscado, então nada ao lado do checkout é lido: E0307.
  • Os arquivos de um diretório que você importa — aggrega import, a ferramenta de importação do assistente e o aggrega/import da sessão, ao receberem um diretório, leem os arquivos dele que os padrões de arquivo do importador selecionam. O diretório é uma raiz própria onde quer que esteja — veja Um diretório que você importa — de modo que um link entre esses arquivos que leva para fora dele, ou um link para um diretório que leva para fora dele, interrompe a importação nomeando o link antes que qualquer arquivo do diretório seja lido: E0321.
  • A própria configuração do espaço de trabalho — cada .aggrega-config.yaml da raiz até o diretório em que um comando é executado, e o .aggrega-config-append-ci.yaml de um pipeline ao lado de qualquer um deles. Todo comando que lê a configuração, o servidor de linguagem e as ferramentas de um assistente a leem antes de qualquer outra coisa, de modo que um desses arquivos que seja um link que leva para fora interrompe cada um deles ali, em vez de deixá-los rodar com uma configuração feita do que restou: E0321. Os comandos do aggrega que nunca a leem — version, help, completion, explain, get-schema, scaffold ao rascunhar um documento inicial, skills list, plugin run-local, plugin sync, auth token e logout — são executados normalmente, com um aviso que nomeia o link. scaffold --example a lê, para o registro padrão e a política de assinatura, e é interrompido ali como qualquer outro leitor. O servidor de linguagem, e o servidor de um assistente que se comunica pelos próprios fluxos, ainda iniciam sobre um espaço de trabalho assim, para que o que ele contém possa ser listado: as listagens de Release e de entidades respondem, lidas sem nenhum diretório de catálogo e nada mais configurado, e nomeiam o arquivo entre os links não lidos. Toda outra solicitação que a configuração decide — uma compilação, uma pré-visualização, um grafo, uma validação, um lint, uma descrição, a configuração efetiva, a Release padrão — é interrompida com E0321 nomeando o link, assim como o servidor de um assistente solicitado a escutar por HTTP, cujo endereço e autorização a configuração teria definido.
  • O que uma operação grava ou remove — o diretório de saída de uma compilação, seus diretórios de fronteira e cada arquivo gravado ali, o trace; o lockfile de uma Release e o registro de confiança de plugins ao lado dele; um entity.lock; o arquivo de configuração do espaço de trabalho que um comando grava; o cache de artefatos e cada parte dele que um pull preenche ou que aggrega cache clear e aggrega cache prune esvaziam; os rascunhos que uma importação grava e as entidades Plugin que aggrega plugin gen-catalog grava; e o marcador .aggrega/active-release em que um editor registra uma Release padrão, que o servidor de linguagem grava por ele. Um dist que seja um link transformaria, de outro modo, “recompilar a saída” na exclusão de um diretório em outro lugar da máquina: E0320.
  • O que um documento nomeia por um caminho — veja Uma referência que um documento escreve: E0324.
  • O conteúdo que uma entidade declara — um source: ou um $import: cujo caminho passa por um diretório que é um link que leva para fora do diretório da própria entidade, e que uma publicação, de outro modo, carregaria sob um nome dentro da entidade: E0304.

Isso vale independentemente de quem iniciou a operação — a linha de comando, um editor ou um assistente em qualquer um dos dois transportes — porque o caminho pertence ao espaço de trabalho e ao produto, não a quem chama.

Uma referência que um documento escreve

Uma Release e um Manifest podem nomear outro arquivo por um caminho: os aggregate: e manifest: de uma Release escritos como ./… ou ../…, seu extends:, o extends: de um Manifest escrito como caminho e o parameters: { $import: … } de uma Release. Um documento no espaço de trabalho só alcança dessa forma arquivos dentro do espaço de trabalho — um caminho que sobe para fora tal como está escrito é recusado, e também um que fica dentro tal como está escrito, mas encontra no caminho um link que leva para fora. Nada é lido do arquivo que qualquer um deles nomeia.

Um espaço de trabalho que você clonou carrega as referências do autor, então restringir o que você nomeia enquanto se segue tudo aquilo a que um documento leva deixaria a fronteira a um único ../ de distância. Quando um documento precisa de uma entidade mantida em outro lugar, ele nomeia a entidade em vez de um arquivo — aggregate: payments — e a configuração do espaço de trabalho lista o diretório de catálogo que a contém. Um nome é procurado, não seguido, então nunca é recusado aqui.

Uma Release ou um Manifest que fica fora do espaço de trabalho, admitido porque você o nomeou, só alcança arquivos do próprio diretório — veja Uma exceção alcança o diretório que nomeia, e nada além.

As exceções, e por que cada uma é uma

Um caminho de uma destas classes é respeitado onde leva, dentro do espaço de trabalho ou não. Cada uma é uma classe de caminho, e não uma lista de lugares, e cada uma é uma exceção por um motivo próprio.

  • O que a configuração do espaço de trabalho nomeia. Seus diretórios de catálogo — catalog_dirs e catalog_dirs_append, para o espaço de trabalho ou para uma Release sob workspace.releases — os arquivos de Release registrados como chaves sob workspace.releases, build.authoring_release, o .wasm local de um plugin anexado e os arquivos sob o seu with.sources, mcp.tls.cert_file, mcp.tls.key_file, mcp.authorization.jwks_file, a raiz de confiança fixada de um registry, e um artifact_cache_dir que sobe para fora da raiz do espaço de trabalho. Nomear um caminho na configuração é a maneira deliberada pela qual um espaço de trabalho alcança fora de si mesmo: ele é escrito uma vez, mantido com o projeto e lido por quem o revisar. O diretório catalog convencional do espaço de trabalho conta como nomeado quando a configuração o lista ou você o passa com --catalog — ou quando a configuração lista, ou você passa, o lugar para onde ele leva, em qualquer grafia, ou um diretório acima desse lugar, que então lê uma única vez o que está ali, através do diretório que você nomeou. Lido apenas porque está ali, ele é conteúdo do próprio espaço de trabalho, de modo que um catalog que seja um link que leva para fora do espaço de trabalho não é lido até que você o nomeie ou nomeie o lugar para onde ele leva.
  • Um caminho que você digita na linha de comando. aggrega build --release ../other/release.yaml, --catalog /srv/shared-catalog, --output-dir, um arquivo para validar, passar pelo lint, fixar ou publicar: cada um é usado onde leva — exceto a edição de documentos, abaixo. Você é dono da máquina em que o comando roda e já pode ler e gravar qualquer coisa que digitaria, então restringi-lo a um diretório não traria nada.
  • Um caminho que um assistente nomeia pelos fluxos do próprio processo. Um cliente que iniciou aggrega mcp na sua máquina roda como você, e o host dele geralmente lhe dá ferramentas próprias de arquivo e de shell, então um caminho que ele nomeia é respeitado como se você o tivesse digitado — veja Os dois transportes do assistente.
  • Os armazenamentos do produto no nível da máquina — o arquivo de configuração global, o armazenamento de módulos compilados, o cache de descritores de plugins, o pacote de documentação e o armazenamento de credenciais de registry. Eles pertencem à máquina, e não a um espaço de trabalho, então nenhum espaço de trabalho os contém.
  • Um arquivo ou um diretório escolhido em uma caixa de diálogo, lido onde está. Um editor envia como caminho absoluto o arquivo de chave ou a raiz de confiança do cadastro de um registry, a descrição que aggrega/import converte — um arquivo, ou um diretório cujos arquivos o importador lê — e o módulo para o qual aggrega/pluginGenCatalog gera uma entidade, com o overlay ao lado dele. Uma pessoa escolheu cada um, onde quer que o guarde. Eles são apenas lidos: nada do que uma solicitação grava vai para um caminho escolhido dessa forma. Um diretório escolhido dessa forma fica restrito a si mesmo, como todo diretório que você importa.
  • Um documento que seu editor mantém aberto. Validá-lo, pedir ou descartar seus diagnósticos, o hover, o autocompletar, a resolução e a busca de referências e implementações nele são respondidos a partir do conteúdo que o editor enviou, então nenhum arquivo é lido no caminho que o nomeia, e o caminho nunca é recusado pelo lugar para onde leva. Uma solicitação que de fato lê o documento do disco é do tipo recusado descrito acima.

Os caminhos digitados na linha de comando e os armazenamentos no nível da máquina nunca são avaliados; os demais são deixados passar pela sua classe, nunca pela solicitação que por acaso os carrega.

Uma exceção alcança o diretório que nomeia, e nada além

Um diretório que você nomeou fora do espaço de trabalho é uma raiz própria para tudo o que é lido ou gravado sob ele. O próprio diretório é usado como você o nomeou — se for um link, ele é seguido até onde aponta — e um link sob ele que leva para fora dele é tratado exatamente como um link dentro do espaço de trabalho: não é lido em uma listagem e interrompe uma busca ou uma gravação. Assim, um diretório de catálogo que você lista fora do espaço de trabalho, um diretório de saída que você passa para aggrega plugin gen-catalog ou aggrega import, e um artifact_cache_dir que sobe para fora do espaço de trabalho mantêm, cada um, para si o que está sob eles. Quando um diretório que você nomeou fica dentro do espaço de trabalho, a raiz é o espaço de trabalho — exceto um diretório que você importa, que é uma raiz própria onde quer que esteja.

Um diretório que você nomeia é resolvido em relação à pasta em que você executa o comando antes que qualquer coisa seja colocada sob ele. Um diretório de saída que você passa para aggrega import, digitado como relativo, é a pasta com esse nome na pasta em que você executa o comando, e uma unidade que você nomeia sozinha no Windows — D: — é a pasta atual dessa unidade. O diretório é primeiro transformado em um caminho completo e cada arquivo é colocado sob esse caminho completo, de modo que um arquivo cujo nome começa com um separador, por exemplo \notes.txt, vai parar dentro do diretório que você nomeou, e não na raiz da unidade, e o diretório que o comando informa é aquele em que se gravou.

Uma Release ou um Manifest que você nomeou fora do espaço de trabalho é a mesma regra aplicada a um arquivo: o próprio diretório é a raiz, então o que ele nomeia por um caminho — e o que nomeia cada Release a que sua cadeia extends: leva — deve ficar dentro desse diretório. Uma Release mantida ao lado do seu Aggregate e do seu Manifest compila de qualquer lugar; uma no layout usual releases/, que nomeia ../aggregates/app.yaml, é compilada a partir do próprio espaço de trabalho.

Uma Release que você nomeia por um link é lida onde o link leva e resolvida onde você a nomeou. Digitada como --release release.yaml, em que release.yaml é um link para um arquivo mantido em outro lugar — ou nomeada assim sob workspace.releases, ou como build.authoring_release — a Release é lida do lugar para onde o link leva. O Aggregate e o Manifest que ela nomeia, por identidade ou por um caminho, são procurados ao lado do link, no diretório em que você a nomeou, e restritos à raiz desse diretório: o espaço de trabalho, ou o próprio diretório quando ele fica fora do espaço de trabalho. Seu lockfile também é lido e gravado ao lado do link, nunca onde o link leva. A Release não é um dos documentos que sua própria busca encontra ao lado dela, então ela nunca interrompe essa busca; outra Release mantida ao lado dela que seja um link que leva para fora ainda a interrompe. Um Manifest que você inspeciona sozinho por um link é lido e resolvido da mesma forma.

O diretório do cache de artefatos é uma raiz própria, onde quer que esteja. Tudo o que o cache contém é gravado, lido e removido apenas dentro do diretório do cache, de modo que um dos diretórios do próprio cache, ou um arquivo em um deles, que seja um link que leva para fora do diretório do cache é barrado — mesmo quando leva a outro lugar dentro do espaço de trabalho — enquanto um que leva a outro lugar dentro do diretório do cache é seguido. Onde o próprio diretório do cache fica é deduzido da forma como seu valor está escrito. Escrito dentro da raiz do espaço de trabalho — incluindo o padrão .aggrega/cache — ele é um diretório do próprio espaço de trabalho: um diretório de cache que seja um link para outro lugar dentro do espaço de trabalho é seguido, e um que leva para fora do espaço de trabalho é recusado, tanto para leitura quanto para gravação. Escrito subindo para fora (../shared-cache), ele é um diretório que a configuração nomeia, lido e gravado onde leva.

Um diretório que você importa

Um diretório que você importa é uma raiz própria, onde quer que esteja — dentro do espaço de trabalho tanto quanto fora dele, e é nisso que ele difere de todo outro diretório que você nomeia dentro do espaço de trabalho. aggrega import, a ferramenta de importação do assistente e o aggrega/import da sessão entregam ao importador cada arquivo do diretório sob o seu lugar nesse diretório, de modo que o que lhe entregam é lido apenas de dentro do diretório. O que é avaliado é aquilo de que a importação tiraria algo: um link para um arquivo que um padrão do importador seleciona — de qualquer importador, quando o formato é reconhecido em vez de nomeado — e um link para um diretório, no qual nunca se entra. Um desses que leve para fora do diretório é recusado antes que qualquer arquivo seja lido, mesmo quando leva a outro lugar dentro do espaço de trabalho, enquanto um link selecionado para um arquivo em outro lugar dentro do diretório é lido onde aponta, sob o próprio nome do link. Um link para um arquivo que nenhum padrão seleciona não é avaliado nem lido. O próprio diretório é usado como você o nomeou; se for um link, ele é seguido até onde aponta.

A edição de documentos fica dentro

aggrega edit-document, a edição de documentos e o ponto de inserção do servidor de linguagem, e edit-document e insertion-point do assistente atuam apenas sobre um documento que o espaço de trabalho contém. Um documento fora do espaço de trabalho, tal como está escrito ou por um link que leva para fora dele, é recusado em todas as superfícies sem que nada seja lido ou gravado — inclusive onde um caminho que você nomeia é, nos demais casos, respeitado.

Os dois transportes do assistente

aggrega mcp serve as mesmas ferramentas de duas maneiras, e a fronteira difere entre elas porque quem chama difere.

  • Pelos fluxos do próprio processo, o cliente iniciou o servidor na sua máquina, então uma chamada equivale a você digitando na linha de comando: um argumento de caminho pode ser absoluto e pode ficar fora do espaço de trabalho, uma chamada pode nomear seu próprio workspace_root e seus próprios catalog_dirs, e as ferramentas que executam um comando aggrega em um processo separado são oferecidas. Somente o caminho que uma chamada nomeia é respeitado como nomeado. O que a operação depois lê e grava por conta própria é tratado como em um terminal: uma listagem não lê através de um link que leva para fora, uma referência que um documento escreve não sai do espaço de trabalho e uma gravação não passa por um diretório de saída ou de cache vinculado. O conteúdo do espaço de trabalho pode orientar o que um assistente pede, então, em um host onde essas ferramentas são seu único acesso aos seus arquivos, um documento em um espaço de trabalho que você clonou ainda pode levá-lo a nomear um caminho fora do espaço de trabalho e fazer com que seja lido ou gravado; o que um assistente pode fazer sem perguntar a você antes é onde você define quanto ele faz sem ser solicitado.
  • Por HTTP, quem chama não é dono da máquina em que o servidor roda. O espaço de trabalho é aquele sobre o qual o servidor foi iniciado e permanece fixo durante toda a sua vida; todo argumento de caminho é mantido dentro dele, avaliado como acima; uma chamada que nomeia workspace_root ou catalog_dirs, ou que seleciona uma chave de assinatura mantida no host, é recusada; e as ferramentas que executam um comando aggrega não são oferecidas. Uma recusa nomeia o argumento e cita um valor relativo como enviado, mas não nomeia nem a raiz do espaço de trabalho nem o lugar para onde um caminho teria levado.

Quando algo é recusado ou interrompido

O que você vêO que fazer
Uma listagem nomeia um link entre os que ela não leuSubstitua o link por uma cópia daquilo a que ele leva; ou, para entidades mantidas em outro lugar, liste o diretório a que o link leva em catalog_dirs; para uma Release mantida em outro lugar, nomeie-a em workspace.releases ou como build.authoring_release.
E0321, uma leitura por meio de um link que sai de um diretório de catálogo ou do diretório de uma ReleaseListe o diretório a que o link leva como diretório de catálogo, ou passe-o com --catalog, em vez de alcançá-lo por meio de um link abaixo de um deles; ou substitua o link por uma cópia. Quando o link é o próprio catalog convencional, liste catalog ou o diretório a que ele leva, ou passe qualquer um dos dois com --catalog.
E0321 no arquivo de lock de uma ReleaseRemova o link e faça o pull da Release novamente, o que grava um novo arquivo de lock ao lado dela. Um arquivo de lock não tem outro lugar.
E0321 em um arquivo ao lado de uma entidadeSubstitua o link pelo próprio arquivo: mova um documento que é uma entidade para um diretório próprio, e coloque o .wasm compilado ao lado de sua entidade Plugin em vez de um link para ele.
E0321 em um arquivo de configuraçãoSubstitua o link por uma cópia mantida no workspace. Uma configuração compartilhada entre workspaces é lida nomeando-a como arquivo de configuração global, com --config ou AGGREGA_CONFIG, abaixo dos arquivos próprios de cada workspace.
E0321 no cache de artefatosRemova o link; um pull preenche o cache novamente. Para manter o cache em outro lugar, defina artifact_cache_dir com esse diretório, escrito de forma relativa à raiz do workspace (../shared-cache), em vez de criar um link para ele.
E0321 em um link de um repositório obtidoO link está commitado no repositório que a origem nomeia — a mensagem o nomeia por sua posição lá: altere-o lá — faça-o apontar para dentro do repositório, ou faça commit do próprio arquivo — e nomeie a revisão que contém a alteração.
E0321 em um link em um diretório que você importaMantenha o próprio arquivo no diretório em vez de um link para ele, ou importe o diretório a que o link leva. Um diretório que você importa é lido apenas a partir de seu próprio interior, onde quer que esteja.
E0307 em um module_subdirNomeie um diretório dentro do repositório: o valor pode descer abaixo do topo do repositório, mas não pode subir acima dele.
E0320, uma gravação ou remoção por meio de um linkRemova o link que a mensagem nomeia, ou faça-o levar a algum lugar dentro do diretório que a mensagem nomeia, e execute a operação novamente. Nada em seus arquivos de entidade causa isso.
E0324, uma referência que leva para foraNomeie um Aggregate mantido em outro lugar pelo seu metadata.name e liste seu diretório de catálogo; mantenha um Manifest, uma Release que um extends: nomeia e um arquivo de parâmetros dentro do workspace — ou, para um documento que você nomeou de fora, em seu próprio diretório; ou abra o workspace em um diretório que contenha ambos os documentos.
E0304, conteúdo por meio de um linkSubstitua o link por uma cópia daquilo a que ele leva, dentro do próprio diretório da entidade.
Uma requisição do servidor de linguagem recusada por um caminho que leva para foraEnvie um caminho dentro do workspace, relativo à sua raiz. Uma Release mantida fora do workspace é alcançada nomeando-a na configuração, em workspace.releases ou como build.authoring_release, e nomeando na requisição o link dentro do workspace que leva a ela — o lugar em que a listagem de Release a oferece.
Uma chamada de assistente via HTTP recusada por um caminhoEnvie um caminho relativo à raiz do workspace que o servidor atende; quando a recusa oferecer a grafia relativa de um caminho absoluto, envie essa.
Uma edição de documento recusadaEdite um documento que o workspace contém; um link para um documento em outro lugar não é seguido para a edição.

Veja também

  • Configuração — onde cada uma das configurações acima é escrita e como um caminho relativo nela é resolvido.
  • aggrega serve e aggrega mcp — cada requisição e ferramenta, e quais de seus parâmetros nomeiam um caminho.
  • Interrupções fatais — a entrada completa de cada condição acima.