Granica obszaru roboczego
Obszar roboczy to drzewo katalogów wyznaczone przez katalog główny projektu — katalog, w którym znajduje się blok workspace:
konfiguracji, katalog wskazany przez --workspace-root, folder otwarty w edytorze lub katalog, nad którym uruchomiono
serwer asystenta. Wszystko, co Aggrega odczytuje i zapisuje z własnej inicjatywy, jest ograniczone do tego drzewa,
chyba że użytkownik lub konfiguracja obszaru roboczego wskaże miejsce poza nim. Dowiązanie symboliczne wewnątrz niego
może wskazywać dowolne miejsce na komputerze, dlatego dowiązanie nigdy nie jest uznawane za część obszaru roboczego tylko dlatego,
że się w nim znajduje: liczy się to, dokąd prowadzi.
Ta strona przedstawia regułę w całości. Strony poszczególnych interfejsów — wiersz poleceń, serwer języka i narzędzia asystenta — opisują, jak ich własne żądania się do niej stosują.
Co leży wewnątrz obszaru roboczego
Ścieżka leży wewnątrz obszaru roboczego, gdy jej najgłębsza istniejąca część, po rozwinięciu dowiązań, jest katalogiem głównym obszaru roboczego lub leży pod nim — przy czym dowiązania samego katalogu głównego rozwija się tak samo, więc obszar roboczy, do którego prowadzi jego własne dowiązanie, nadal obejmuje wszystko, co leży pod nim.
Katalog główny otwarty przez dowiązanie jest obszarem roboczym, do którego to dowiązanie prowadzi. Niezależnie od tego, czy otwierany folder
sam jest dowiązaniem, czy prowadzi do niego dowiązanie położone wyżej, Aggrega wylicza, odczytuje i zapisuje dokładnie to, co
w obszarze roboczym, do którego prowadzi dowiązanie — jego encje Releases, jego dokumenty, jego pliki blokad — i ocenia
każde dowiązanie wewnątrz niego w ten sam sposób. Każda ścieżka w odpowiedzi jest jednak nadal zapisywana względem katalogu głównego w postaci, w jakiej został
podany — folderu otwartego w edytorze, wpisanego --workspace-root, katalogu, który powłoka wskazuje
jako bieżący — dzięki czemu wyświetlane ścieżki odpowiadają tym, z którymi się pracuje.
Ta jedna zasada obejmuje każdy rodzaj ścieżki:
- O ścieżce decyduje to, dokąd prowadzi, a nie to, jak jest zapisana.
./shared/app.yamlleży na zewnątrz, gdysharedjest dowiązaniem do katalogu położonego gdzie indziej, choć każda jej część jest zapisana wewnątrz obszaru roboczego. Parametr żądania może nadal wymagać własnej postaci zapisu — na przykład ścieżki względnej wobec katalogu głównego — i mówi o tym jego własna strona; jest to zasada dotycząca parametru, a nie granicy. - Ścieżkę, która jeszcze nie istnieje, ocenia się według katalogów prowadzących do niej. Plik, który kompilacja
ma utworzyć pod katalogiem
distbędącym dowiązaniem prowadzącym na zewnątrz, leży na zewnątrz, zanim zostanie zapisany. - Dowiązanie, które prowadzi donikąd lub w pętlę, nie jest czymś, co istnieje. Ocenia się wówczas katalog, który je zawiera, i nie rozwija się niczego, aby ustalić, dokąd dowiązanie miało prowadzić. Gdy takie dowiązanie stoi dokładnie w miejscu, w którym ma zostać utworzony plik, sprawdza się również miejsce, na które wskazuje, ponieważ tam trafiłby plik.
- Dowiązanie do innego miejsca wewnątrz obszaru roboczego jest rozwijane jak zwykle. Zatrzymywane jest tylko dowiązanie prowadzące na zewnątrz.
Zasada ocenia wyłącznie to, dokąd ścieżka prowadzi na dysku. Nie odczytuje żadnej wartości i niczego nie wnioskuje z nazwy.
Co dzieje się z dowiązaniem prowadzącym na zewnątrz
To, co dzieje się ze ścieżką prowadzącą na zewnątrz, zależy od rodzaju ścieżki. Możliwe są trzy wyniki.
Wymienione jako nieodczytane
Tam, gdzie Aggrega wymienia zawartość obszaru roboczego, dowiązanie prowadzące na zewnątrz nie jest odczytywane, a lista to odnotowuje. Encje Releases, spośród których edytor pozwala wybierać, indeks encji oraz uzupełnienia i kandydaci, z których korzysta edytor, a także list-releases i list-entities asystenta nie przeszukują katalogu poza obszarem roboczym ani nie odczytują pliku spoza niego, niezależnie od tego, co ten plik deklaruje — dlatego encja, którą edytor pokazuje pod takim dowiązaniem, nie jest wymieniana jako należąca do obszaru roboczego. Listy encji Release i listy encji wskazują każde takie dowiązanie przez jego własne miejsce w obszarze roboczym, nigdy przez to, dokąd prowadzi: unreadLinkedDirs i unreadLinkedFiles w serwerze języka, unread_linked_dirs i unread_linked_files w narzędziach asystenta. Dowiązanie do katalogu wymienionego w konfiguracji pod catalog_dirs, do katalogu pod takim katalogiem lub do wskazanej w niej encji Release nie jest wymieniane: konfiguracja sięgnęła już tego miejsca — wymieniony katalog jest odczytywany wraz z całą zawartością — jak opisują wyjątki poniżej. Plik .gitignore będący dowiązaniem prowadzącym na zewnątrz również nie jest odczytywany, więc plik znajdujący się gdzie indziej na maszynie nigdy nie decyduje o tym, które dokumenty obszaru roboczego są przeszukiwane. Plik konfiguracji obszaru roboczego będący dowiązaniem prowadzącym na zewnątrz także jest wymieniany wśród plików nieodczytanych: te listy nadal odpowiadają dla tego obszaru roboczego, odczytanego bez żadnej konfiguracji, a każde żądanie zależne od konfiguracji zostaje zatrzymane, jak opisuje poniżej własna konfiguracja obszaru roboczego.
Odrzucone
Ścieżka wskazana w żądaniu, gdy wywołującym nie jest właściciel maszyny, który ją wpisuje, jest odrzucana. Poza wyjątkami opisanymi poniżej każda ścieżka, którą żądanie edytora do aggrega serve wskazuje serwerowi do odczytu lub zapisu, oraz każda ścieżka, którą asystent wskazuje serwerowi osiąganemu przez HTTP, musi prowadzić do wnętrza obszaru roboczego; ścieżka prowadząca na zewnątrz jest odrzucana bez żadnego odczytu ani zapisu, a odmowa wskazuje parametr, jak określa strona każdego interfejsu. Edycja dokumentu jest odrzucana w ten sposób w każdym interfejsie, łącznie z wierszem poleceń — zob. Edycja dokumentu pozostaje wewnątrz.
Zatrzymane
Gdy operacja z własnej inicjatywy odczytywałaby lub zapisywała przez dowiązanie prowadzące na zewnątrz, zostaje zatrzymana. Są to ścieżki, które produkt ustala sam, a nie ścieżki wskazane przez użytkownika, a pominięcie którejś z nich bez słowa mogłoby zmienić znaczenie kompilacji, dlatego każda z nich zatrzymuje operację, wskazuje dowiązanie i miejsce, do którego prowadzi, i pozostawia miejsce docelowe dowiązania dokładnie w niezmienionym stanie:
- To, co odczytuje wyszukiwanie — dokument pod katalogiem katalogu encji, obok encji Release wskazującej swoją encję Aggregate lub Manifest przez tożsamość albo obok encji Manifest wskazującej w ten sposób rozszerzaną encję Manifest. Encja Release lub Manifest, którą wskazano operacji, nie jest jednym z tych dokumentów: została odczytana tam, gdzie ją wskazano — zob. Release lub Manifest wskazane przez dowiązanie.
Wyszukiwanie, które pominęłoby takie dowiązanie, mogłoby w jego miejsce rozwiązać inną encję
o tej samej nazwie z dalszego katalogu, dlatego kompilacja, pobranie, walidacja, inspekcja
odczytująca katalog, lint jednej encji Release lub całego katalogu oraz żądania edytora i
asystenta, które kompilują, podglądają, tworzą graf, walidują, lintują lub opisują encję Release, zatrzymują się, zanim
cokolwiek zostanie rozwiązane lub sprawdzone:
E0321. - Plik blokady encji Release — odczytywany obok encji Release w celu uzyskania przypięć, względem których rozwiązują kompilacja, pobranie, walidacja, lint,
inspekcja,
aggrega cache pruneoraz żądania edytora i asystenta. Podlega on tym samym ograniczeniom przy odczycie co przy zapisie, więc plik blokady będący dowiązaniem prowadzącym na zewnątrz zatrzymuje każdą z tych operacji, zamiast podsuwać im przypięcia przechowywane gdzie indziej na maszynie:E0321. - Plik odczytywany obok encji — pozostałe dokumenty w katalogu przypinanej lub publikowanej encji,
odczytywane w celu ustalenia, czy ten katalog współdzieli inna encja, oraz zbudowany plik
.wasm, z którego ładowana jest encja Plugin w katalogu katalogu encji. Każdy z nich jest odczytywany wyłącznie z wnętrza katalogu, pod którym odczytano własny dokument encji: obszaru roboczego, wskazanego katalogu katalogu encji spoza niego lub katalogu wskazanego dokumentu spoza niego. Dlatego plik będący dowiązaniem prowadzącym na zewnątrz zatrzymujeaggrega pin,aggrega push(łącznie z przebiegiem próbnym), pobranie z przypięciem oraz przypięcie i publikację przez edytor i asystenta — nieodczytany dokument mógłby być encją, która stoi na przeszkodzie — i zatrzymuje kompilację lub pobranie ładujące plugin, zamiast uruchamiać bajty przechowywane gdzie indziej na maszynie:E0321. - Pamięć podręczna artefaktów — wszystko, co Aggrega odczytuje z pamięci podręcznej pod
artifact_cache_dir: encja, plugin lub biblioteka w pamięci podręcznej wraz z manifestem obok, archiwum źródłowe i jego metadane, przypięte wejście zewnętrzne, pakiet podpisu i lokalny indeks wyszukiwania rejestru oraz każdy wpis obszaru roboczego wymieniany przezaggrega cache status,aggrega cache pruneiaggrega cache clear. Pamięć podręczna jest odczytywana wyłącznie z wnętrza katalogu pamięci podręcznej, czyli miejsca, do którego jest zapisywana, więc wszystko, co jest w niej dowiązaniem prowadzącym poza ten katalog — zarówno w inne miejsce obszaru roboczego, jak i gdziekolwiek indziej — zatrzymuje kompilację, pobranie, walidację, wyszukiwanie, każde z trzech poleceń pamięci podręcznej oraz żądania edytora i asystenta odczytujące pamięć podręczną, zamiast przekazywać im bajty przechowywane w miejscu, które nie należy do pamięci podręcznej — łącznie z treścią sprawdzaną względem zapisanego skrótu, ponieważ skrót mówi, czym są bajty, a nie skąd wolno je odczytać. Pominięto komunikat o wycofaniu wypisywany przezaggrega inspect, który niczego nie rozstrzyga. Czyszczenie przez prune lub clear, napotykając jeden z własnych katalogów pamięci podręcznej będący takim dowiązaniem albo katalog pamięci podręcznej będący sam dowiązaniem prowadzącym poza obszar roboczy, traktuje to jako usunięcie, którym by było, z kodemE0320, zanim cokolwiek wymieni:E0321. - Repozytorium pobierane przez źródło — kopia robocza, którą pobranie archiwizuje dla źródła
git-repository. Kopia robocza jest odrębnym katalogiem, więc dowiązanie zawarte w repozytorium jest archiwizowane jako to, na co wskazuje, tylko wtedy, gdy cel leży wewnątrz repozytorium; dowiązanie prowadzące poza nie, które mogłoby sięgnąć dowolnego pliku na maszynie wykonującej pobranie, zatrzymuje pobranie ze wskazaniem dowiązania i miejsca, do którego prowadzi, bez zapisu czegokolwiek w pamięci podręcznej — łącznie z samymmodule_subdir, jeśli jest takim dowiązaniem:E0321. Po zatrzymaniu pobrania kopia robocza przestaje istnieć, dlatego komunikat wskazuje dowiązanie przez jego miejsce w repozytorium oraz repozytorium i rewizję wskazane przez źródło.module_subdir, który w zapisanej postaci wychodzi ponad repozytorium, jest odrzucany przed pobraniem repozytorium, więc nic obok kopii roboczej nie jest odczytywane:E0307. - Pliki importowanego katalogu —
aggrega import, narzędzie importu asystenta iaggrega/importsesji, gdy otrzymają katalog, odczytują te jego pliki, które wybierają wzorce plików importera. Katalog jest osobnym korzeniem, gdziekolwiek się znajduje — zob. Importowany katalog — więc dowiązanie wśród tych plików prowadzące poza niego lub dowiązanie do katalogu prowadzące poza niego zatrzymuje import, wskazując dowiązanie, zanim zostanie odczytany jakikolwiek plik katalogu:E0321. - Własna konfiguracja obszaru roboczego — każdy plik
.aggrega-config.yamlod korzenia aż do katalogu, w którym uruchomiono polecenie, oraz plik potoku.aggrega-config-append-ci.yamlobok dowolnego z nich. Każde polecenie, które odczytuje konfigurację, serwer języka i narzędzia asystenta odczytują ją przed czymkolwiek innym, więc jeden z tych plików będący dowiązaniem prowadzącym na zewnątrz zatrzymuje każde z nich w tym miejscu, zamiast pozwolić im działać na konfiguracji złożonej z tego, co pozostało:E0321. Poleceniaaggrega, które nigdy jej nie odczytują —version,help,completion,explain,get-schema,scaffoldtworzące szkic dokumentu startowego,skills list,plugin run-local,plugin sync,auth tokenilogout— działają jak zwykle, z ostrzeżeniem wskazującym dowiązanie.scaffold --exampleodczytuje ją ze względu na domyślny rejestr i politykę podpisów i zatrzymuje się w tym miejscu, tak jak każdy inny, kto ją odczytuje. Serwer języka oraz serwer asystenta komunikujący się przez własne strumienie nadal uruchamiają się w takim obszarze roboczym, aby można było wylistować jego zawartość: listy encji Release i encji odpowiadają, odczytane bez katalogu katalogowego i bez żadnej innej konfiguracji, i wymieniają ten plik wśród nieodczytanych dowiązań. Każde inne żądanie, o którym decyduje konfiguracja — kompilacja, podgląd, graf, walidacja, lint, opis, efektywna konfiguracja, domyślna encja Release — zatrzymuje się zE0321, wskazując dowiązanie, podobnie jak serwer asystenta, który ma nasłuchiwać przez HTTP i którego adres oraz autoryzację ustawiłaby konfiguracja. - To, co operacja zapisuje lub usuwa — katalog wyjściowy kompilacji, jego katalogi graniczne i
każdy zapisany tam plik, ślad; plik blokady encji Release i rekord zaufania wtyczek obok niego;
entity.lock; plik konfiguracji obszaru roboczego zapisywany przez polecenie; pamięć podręczna artefaktów i każda jej część, którą wypełnia pobieranie lub opróżniająaggrega cache cleariaggrega cache prune; szkice zapisywane przez import i encje Plugin zapisywane przezaggrega plugin gen-catalog; a także znacznik.aggrega/active-release, w którym edytor zapisuje domyślną encję Release i który zapisuje za niego serwer języka. Katalogdistbędący dowiązaniem zamieniłby w przeciwnym razie „przebudowanie wyniku” w usunięcie katalogu gdzieś indziej na maszynie:E0320. - To, co dokument wskazuje ścieżką — zob. Odwołanie zapisane w dokumencie:
E0324. - Treść deklarowana przez encję —
source:lub$import:, których ścieżka przechodzi przez katalog będący dowiązaniem prowadzącym poza własny katalog encji i które publikacja przeniosłaby w przeciwnym razie pod nazwą wewnątrz encji:E0304.
Obowiązuje to niezależnie od tego, kto rozpoczął operację — wiersz poleceń, edytor czy asystent w dowolnym z dwóch transportów — ponieważ ścieżka należy do obszaru roboczego i produktu, a nie do wywołującego.
Odwołanie zapisane w dokumencie
Encje Release i Manifest mogą wskazywać inny plik ścieżką: aggregate: i manifest: encji Release zapisane jako ./… lub ../…, jej extends:, extends: encji Manifest zapisane jako ścieżka oraz parameters: { $import: … } encji Release. Dokument w przestrzeni roboczej sięga w ten sposób wyłącznie do plików wewnątrz przestrzeni roboczej — ścieżka, która w zapisanej postaci wychodzi poza nią, jest odrzucana, podobnie jak ścieżka, która w zapisanej postaci pozostaje wewnątrz, ale po drodze napotyka dowiązanie prowadzące na zewnątrz. W żadnym z tych przypadków nic nie jest odczytywane ze wskazanego pliku.
Sklonowana przestrzeń robocza zawiera odwołania jej autora, więc ograniczanie tego, co wskazuje użytkownik, przy jednoczesnym podążaniu za wszystkim, do czego następnie prowadzi dokument, pozostawiłoby granicę o jedno ../ dalej. Gdy dokument potrzebuje encji przechowywanej gdzie indziej, wskazuje encję zamiast pliku — aggregate: payments — a konfiguracja przestrzeni roboczej wymienia katalog katalogu encji, który ją zawiera. Nazwa jest wyszukiwana, a nie śledzona, więc nigdy nie jest tu odrzucana.
Encja Release lub Manifest leżąca poza przestrzenią roboczą, dopuszczona dlatego, że została wskazana, sięga wyłącznie do plików we własnym katalogu — zob. Wyjątek sięga do wskazanego katalogu i nie dalej.
Wyjątki i uzasadnienie każdego z nich
Ścieżka należąca do jednej z tych klas jest respektowana tam, dokąd prowadzi, niezależnie od tego, czy leży w obszarze roboczym. Każda z nich to klasa ścieżek, a nie lista miejsc, i każda jest wyjątkiem z własnego powodu.
- To, co wskazuje konfiguracja obszaru roboczego. Jej katalogi katalogów encji —
catalog_dirsicatalog_dirs_append, dla obszaru roboczego lub dla encji Release wworkspace.releases— pliki encji Release podane jako klucze wworkspace.releases,build.authoring_release, lokalny plik.wasmdołączonej wtyczki i pliki w jejwith.sources,mcp.tls.cert_file,mcp.tls.key_file,mcp.authorization.jwks_file, przypięty korzeń zaufania rejestru orazartifact_cache_dir, który wychodzi poza korzeń obszaru roboczego. Wskazanie ścieżki w konfiguracji to zamierzony sposób, w jaki obszar roboczy sięga poza siebie: zapisuje się ją raz, jest przechowywana razem z projektem i może ją przeczytać każdy, kto go przegląda. Konwencjonalny katalogcatalogobszaru roboczego uznaje się za wskazany, gdy konfiguracja go wymienia lub przekaże się go przez--catalog— albo gdy konfiguracja wymienia lub przekaże się miejsce, do którego prowadzi, w dowolnym zapisie, lub katalog powyżej tego miejsca, który wtedy odczytuje to, co tam leży, jeden raz, poprzez wskazany katalog. Odczytywany tylko dlatego, że istnieje, stanowi własną treść obszaru roboczego, więccatalogbędący dowiązaniem wychodzącym poza obszar roboczy nie jest odczytywany, dopóki nie wskaże się jego samego lub miejsca, do którego prowadzi. - Ścieżka wpisana w wierszu poleceń.
aggrega build --release ../other/release.yaml,--catalog /srv/shared-catalog,--output-dir, plik do walidacji, lintowania, przypięcia lub publikacji: każda z nich jest używana tam, dokąd prowadzi — z wyjątkiem edycji dokumentu, opisanej niżej. Użytkownik jest właścicielem maszyny, na której działa polecenie, i może już odczytać i zapisać wszystko, co by wpisał, więc ograniczanie go do katalogu nic by nie dało. - Ścieżka wskazana przez asystenta za pośrednictwem własnych strumieni procesu. Klient, który uruchomił
aggrega mcpna maszynie użytkownika, działa jako ten użytkownik, a jego host zwykle udostępnia mu własne narzędzia do plików i powłoki, więc wskazana przez niego ścieżka jest respektowana tak, jakby wpisał ją użytkownik — zob. Dwa transporty asystenta. - Ogólnosystemowe magazyny produktu — globalny plik konfiguracyjny, magazyn skompilowanych modułów, pamięć podręczna deskryptorów wtyczek, pakiet dokumentacji i magazyn poświadczeń rejestru. Należą one do maszyny, a nie do żadnego obszaru roboczego, więc żaden obszar roboczy ich nie zawiera.
- Plik lub katalog wybrany w oknie dialogowym, odczytywany tam, gdzie się znajduje. Edytor przesyła plik klucza lub korzeń
zaufania rejestracji rejestru jako ścieżkę bezwzględną, opis konwertowany przez
aggrega/import— plik lub katalog, którego pliki odczytuje importer — oraz moduł, dla któregoaggrega/pluginGenCataloggeneruje encję, wraz z nakładką obok niego. Każdy z nich wybrał człowiek, niezależnie od tego, gdzie go przechowuje. Są one tylko odczytywane: nic, co zapisuje żądanie, nie trafia do ścieżki wybranej w ten sposób. Katalog wybrany w ten sposób jest ograniczony do samego siebie, tak jak każdy importowany katalog. - Dokument otwarty w edytorze. Walidacja, pobieranie lub usuwanie jego diagnostyk, podpowiedzi po najechaniu, uzupełnianie, rozwiązywanie oraz wyszukiwanie odwołań i implementacji w nim są obsługiwane na podstawie treści przesłanej przez edytor, więc żaden plik nie jest odczytywany ze ścieżki, która go wskazuje, a ścieżka nigdy nie jest odrzucana z powodu miejsca, do którego prowadzi. Żądanie, które odczytuje dokument z dysku, należy do odrzucanego rodzaju opisanego wyżej.
Ścieżki wpisane w wierszu poleceń i magazyny ogólnosystemowe w ogóle nie są oceniane; pozostałe są przepuszczane ze względu na swoją klasę, nigdy ze względu na żądanie, które akurat je zawiera.
Wyjątek sięga do wskazanego katalogu i nie dalej
Katalog wskazany poza obszarem roboczym jest osobnym korzeniem dla wszystkiego, co jest odczytywane lub zapisywane
pod nim. Sam katalog jest używany tak, jak go wskazano — katalog będący dowiązaniem jest śledzony do miejsca, na które
wskazuje — a dowiązanie pod nim wychodzące poza niego jest traktowane dokładnie tak jak dowiązanie w obszarze roboczym: nie jest
odczytywane w listingu i zatrzymuje wyszukiwanie lub zapis. Zatem katalog katalogów encji wymieniony poza
obszarem roboczym, katalog wyjściowy przekazany do aggrega plugin gen-catalog lub aggrega import oraz
artifact_cache_dir, który wychodzi poza obszar roboczy, ograniczają to, co leży pod nimi, do siebie. Gdy wskazany katalog leży w
obszarze roboczym, korzeniem jest obszar roboczy — z wyjątkiem importowanego katalogu, który jest
osobnym korzeniem niezależnie od położenia.
Wskazany katalog jest rozwiązywany względem folderu, w którym uruchomiono polecenie, zanim cokolwiek zostanie pod nim umieszczone.
Katalog wyjściowy przekazany do aggrega import, wpisany jako względny, to folder o tej nazwie w
folderze, w którym uruchomiono polecenie, a dysk podany w systemie Windows bez ścieżki — D: — to bieżący folder na
tym dysku. Katalog jest najpierw zamieniany na pełną ścieżkę i każdy plik jest umieszczany pod tą pełną ścieżką, więc
plik, którego nazwa zaczyna się od separatora, np. \notes.txt, trafia do wskazanego katalogu, a nie
na szczyt dysku, a katalog zgłaszany przez polecenie jest tym, do którego zapisano dane.
Encja Release lub Manifest wskazana poza obszarem roboczym podlega tej samej zasadzie odniesionej do pliku: jej własny
katalog jest korzeniem, więc to, co wskazuje przez ścieżkę — oraz to, co wskazuje każda encja Release, do której prowadzi jej łańcuch extends: — musi pozostać w tym katalogu. Encja Release przechowywana obok swoich encji Aggregate i Manifest buduje się
z dowolnego miejsca; encja w typowym układzie releases/, wskazująca ../aggregates/app.yaml, jest zamiast tego budowana ze swojego
własnego obszaru roboczego.
Encja Release lub Manifest wskazana przez dowiązanie
Encja Release wskazana przez dowiązanie jest odczytywana tam, dokąd prowadzi dowiązanie, a rozwiązywana tam, gdzie ją wskazano.
Gdy wpisano --release release.yaml, a release.yaml jest dowiązaniem do pliku przechowywanego gdzie indziej — lub wskazano ją
w ten sposób w workspace.releases albo jako build.authoring_release — encja Release jest odczytywana z
miejsca, do którego prowadzi dowiązanie. Wskazywane przez nią encje Aggregate i Manifest, przez tożsamość lub ścieżkę, są wyszukiwane
obok dowiązania, w katalogu, w którym ją wskazano, i ograniczone do korzenia tego katalogu: obszaru
roboczego lub samego katalogu, jeśli leży poza obszarem roboczym. Jej plik blokady również jest odczytywany i
zapisywany obok dowiązania, nigdy tam, dokąd prowadzi dowiązanie. Encja Release nie należy do dokumentów, które
napotyka jej własne wyszukiwanie obok niej, więc nigdy go nie zatrzymuje; inna encja Release przechowywana obok niej, będąca
dowiązaniem wychodzącym na zewnątrz, nadal je zatrzymuje. Encja Manifest sprawdzana samodzielnie przez dowiązanie jest odczytywana i rozwiązywana
w ten sam sposób.
Katalog pamięci podręcznej artefaktów jest osobnym korzeniem, niezależnie od położenia. Wszystko, co zawiera pamięć podręczna, jest
zapisywane, odczytywane i usuwane wyłącznie w katalogu pamięci podręcznej, więc jeden z własnych katalogów pamięci podręcznej lub
plik w nim, będący dowiązaniem wychodzącym poza katalog pamięci podręcznej, jest zatrzymywany — nawet jeśli prowadzi w inne miejsce
w obszarze roboczym — natomiast dowiązanie prowadzące w inne miejsce w katalogu pamięci podręcznej jest śledzone. Położenie samego
katalogu pamięci podręcznej wynika z zapisu jego wartości. Zapisany w obrębie korzenia obszaru roboczego —
łącznie z domyślnym .aggrega/cache — jest własnym katalogiem obszaru roboczego: katalog pamięci podręcznej będący
dowiązaniem do innego miejsca w obszarze roboczym jest śledzony, a prowadzący poza obszar roboczy jest odrzucany, zarówno
przy odczycie, jak i przy zapisie. Zapisany jako wychodzący na zewnątrz (../shared-cache), jest katalogiem wskazanym przez konfigurację,
odczytywanym i zapisywanym tam, dokąd prowadzi.
Importowany katalog
Importowany katalog jest osobnym korzeniem, gdziekolwiek się znajduje — zarówno wewnątrz obszaru roboczego, jak i poza nim, i tym właśnie różni się od każdego innego katalogu wskazanego wewnątrz obszaru roboczego.
aggrega import, narzędzie importu asystenta i aggrega/import sesji przekazują importerowi każdy
plik katalogu pod jego miejscem w tym katalogu, więc to, co mu przekazują, jest odczytywane wyłącznie z wnętrza
katalogu. Ocenie podlega to, z czego import coś by pobrał: dowiązanie do pliku wybieranego przez wzorzec
importera — dowolnego importera, gdy format jest rozpoznawany, a nie wskazany — oraz dowiązanie
do katalogu, do którego nigdy się nie wchodzi. Takie dowiązanie prowadzące poza katalog jest odrzucane, zanim zostanie odczytany jakikolwiek
plik, nawet gdy prowadzi w inne miejsce wewnątrz obszaru roboczego, natomiast wybrane dowiązanie do pliku
w innym miejscu wewnątrz katalogu jest odczytywane tam, dokąd wskazuje, pod własną nazwą dowiązania. Dowiązanie do pliku, którego nie wybiera żaden
wzorzec, nie jest ani oceniane, ani odczytywane. Sam katalog jest używany tak, jak go wskazano; katalog będący
dowiązaniem jest śledzony do miejsca, na które wskazuje.
Edycja dokumentu pozostaje wewnątrz
aggrega edit-document, edycja dokumentu i punkt wstawiania serwera języka oraz narzędzia asystenta
edit-document i insertion-point działają wyłącznie na dokumencie, który zawiera obszar roboczy. Dokument spoza
obszaru roboczego, czy to w zapisanej postaci, czy przez dowiązanie prowadzące poza niego, jest odrzucany na każdej powierzchni bez
odczytu ani zapisu czegokolwiek — także tam, gdzie wskazana ścieżka jest poza tym honorowana.
Dwa transporty asystenta
aggrega mcp udostępnia te same narzędzia na dwa sposoby, a granica różni się między nimi, ponieważ różni się wywołujący.
- Przez własne strumienie procesu klient uruchomił serwer na maszynie użytkownika, więc wywołanie odpowiada wpisywaniu polecenia w wierszu poleceń: argument ścieżki może być bezwzględny i może leżeć poza obszarem roboczym, wywołanie może podać własne
workspace_rooticatalog_dirs, a narzędzia uruchamiające polecenieaggregaw osobnym procesie są oferowane. Tylko ścieżka, którą podaje wywołanie, jest honorowana tak, jak została podana. To, co operacja następnie odczytuje i zapisuje na własny rachunek, podlega tym samym ograniczeniom co w terminalu: listowanie nie czyta przez dowiązanie prowadzące na zewnątrz, odwołanie zapisane w dokumencie nie opuszcza obszaru roboczego, a zapis nie przechodzi przez dowiązany katalog wyjściowy ani katalog pamięci podręcznej. Zawartość obszaru roboczego może wpływać na to, o co prosi asystent, więc na hoście, na którym te narzędzia są jego jedynym dostępem do plików użytkownika, dokument w sklonowanym obszarze roboczym nadal może skłonić go do podania ścieżki poza obszarem roboczym i jej odczytania lub zapisania; co asystent może zrobić bez pytania o zgodę to miejsce, w którym ustawia się, ile robi on bez polecenia. - Przez HTTP wywołujący nie jest właścicielem maszyny, na której działa serwer. Obszar roboczy to ten, nad którym serwer został uruchomiony, i pozostaje stały przez cały czas jego działania; każdy argument ścieżki jest utrzymywany wewnątrz niego i oceniany jak wyżej; wywołanie podające
workspace_rootlubcatalog_dirsalbo wybierające klucz podpisu przechowywany na hoście jest odrzucane; a narzędzia uruchamiające polecenieaggreganie są oferowane. Odmowa wskazuje argument i przytacza wartość względną tak, jak została wysłana, ale nie podaje ani katalogu głównego obszaru roboczego, ani miejsca, do którego prowadziłaby ścieżka.
Gdy coś zostaje odrzucone lub zatrzymane
| Co widać | Co zrobić |
|---|---|
| Listing wymienia dowiązanie wśród tych, których nie odczytał | Zastąpić dowiązanie kopią tego, do czego prowadzi; albo, dla encji przechowywanych gdzie indziej, wymienić katalog, do którego prowadzi dowiązanie, w catalog_dirs; dla encji Release przechowywanej gdzie indziej — wskazać ją w workspace.releases lub jako build.authoring_release. |
E0321, odczyt przez dowiązanie wychodzące z katalogu katalogowego lub z katalogu encji Release | Wymienić katalog, do którego prowadzi dowiązanie, jako katalog katalogowy lub przekazać go za pomocą --catalog, zamiast sięgać do niego przez dowiązanie znajdujące się pod jednym z nich; albo zastąpić dowiązanie kopią. Jeśli dowiązaniem jest sam konwencjonalny catalog, wymienić catalog lub katalog, do którego prowadzi, albo przekazać którykolwiek z nich za pomocą --catalog. |
E0321 dla pliku blokady encji Release | Usunąć dowiązanie i ponownie pobrać encję Release, co zapisze obok niej nowy plik blokady. Plik blokady nie ma innego miejsca. |
E0321 dla pliku obok encji | Zastąpić dowiązanie samym plikiem: dokument będący encją przenieść do osobnego katalogu, a zbudowany plik .wasm umieścić obok jego encji Plugin zamiast dowiązania do niego. |
E0321 dla pliku konfiguracyjnego | Zastąpić dowiązanie kopią przechowywaną w obszarze roboczym. Konfiguracja współdzielona przez obszary robocze jest odczytywana przez wskazanie jej jako globalnego pliku konfiguracyjnego, za pomocą --config lub AGGREGA_CONFIG, pod własnymi plikami każdego obszaru roboczego. |
E0321 dla pamięci podręcznej artefaktów | Usunąć dowiązanie; pobranie ponownie wypełni pamięć podręczną. Aby przechowywać pamięć podręczną gdzie indziej, należy ustawić artifact_cache_dir na ten katalog, zapisany względem katalogu głównego obszaru roboczego (../shared-cache), zamiast tworzyć do niego dowiązanie. |
E0321 dla dowiązania w pobranym repozytorium | Dowiązanie jest zatwierdzone w repozytorium, które wskazuje źródło — komunikat wskazuje je przez jego miejsce w tym repozytorium: należy je tam zmienić — skierować do wnętrza repozytorium lub zatwierdzić sam plik — i wskazać rewizję zawierającą tę zmianę. |
E0321 dla dowiązania w importowanym katalogu | Przechowywać w katalogu sam plik zamiast dowiązania do niego albo zaimportować katalog, do którego prowadzi dowiązanie. Importowany katalog jest odczytywany wyłącznie od wewnątrz, niezależnie od tego, gdzie się znajduje. |
E0307 dla module_subdir | Wskazać katalog wewnątrz repozytorium: wartość może schodzić poniżej najwyższego poziomu repozytorium, ale nie może wychodzić ponad niego. |
E0320, zapis lub usunięcie przez dowiązanie | Usunąć dowiązanie wskazane w komunikacie lub sprawić, by prowadziło do miejsca wewnątrz katalogu wskazanego w komunikacie, i ponownie uruchomić operację. Nic w plikach encji tego nie powoduje. |
E0324, odwołanie wychodzące na zewnątrz | Wskazać encję Aggregate przechowywaną gdzie indziej przez jej metadata.name i wymienić jej katalog katalogowy; encję Manifest, encję Release wskazaną przez extends: oraz plik parametrów przechowywać wewnątrz obszaru roboczego — lub, w przypadku dokumentu wskazanego z zewnątrz, w jego własnym katalogu; albo otworzyć obszar roboczy w katalogu zawierającym oba dokumenty. |
E0304, treść przez dowiązanie | Zastąpić dowiązanie kopią tego, do czego prowadzi, wewnątrz własnego katalogu encji. |
| Żądanie serwera języka odrzucone z powodu ścieżki wychodzącej na zewnątrz | Wysłać ścieżkę wewnątrz obszaru roboczego, względną wobec jego katalogu głównego. Do encji Release przechowywanej poza obszarem roboczym można dotrzeć, wskazując ją w konfiguracji, w workspace.releases lub jako build.authoring_release, i wskazując w żądaniu dowiązanie wewnątrz obszaru roboczego, które do niej prowadzi — miejsce, pod którym oferuje ją listing encji Release. |
| Wywołanie asystenta przez HTTP odrzucone z powodu ścieżki | Wysłać ścieżkę względną wobec katalogu głównego obszaru roboczego obsługiwanego przez serwer; jeśli odmowa podaje względny zapis ścieżki bezwzględnej, wysłać ten zapis. |
| Odrzucona edycja dokumentu | Edytować dokument, który zawiera obszar roboczy; przez dowiązanie do dokumentu znajdującego się gdzie indziej edycja nie jest wykonywana. |
Zobacz także
- Konfiguracja — gdzie zapisuje się każde z powyższych ustawień i jak rozwiązywana jest zawarta w nim ścieżka względna.
aggrega serveiaggrega mcp— każde żądanie i narzędzie oraz to, które z ich parametrów wskazują ścieżkę.- Błędy krytyczne — pełny opis każdego z powyższych przypadków.