Genel bayraklar
Her aggrega alt komutunda kullanılabilen bayraklar.
--workspace-root <path>
Keşfi tamamen atlayarak <path> değerini çalışma alanı kökü olarak kullanır. Bayrak verilmediğinde aggrega, kökü geçerli dizinden yukarı doğru ilerleyerek keşfeder — ya da bu ilerleme hiçbir şey bulamazsa ve komut Release’ini veya belgesini mutlak bir yolla adlandırıyorsa, bunun yerine o dosyanın klasöründen yukarı doğru ilerleyerek; bir kökü neyin sabitlediği, hangi sırayla sabitlediği ve hangi komutların böyle bir dosyayı adlandırdığı için Yapılandırma sayfasına bakın.
AGGREGA_WORKSPACE_ROOT bunun ortam değişkeni karşılığıdır: --workspace-root verilmediğinde kökü bu değişken sağlar. Bayrak ayarlandığında bayrak geçerli olur.
Kök, nerede verilirse verilsin köktür, sunucular da buna dahildir: aggrega mcp komutuna gelen ve kendine ait bir çalışma alanı adlandırmayan bir istek bu kökte yanıtlanır ve kökün üstünde hiçbir yer aranmaz. Var olan bir klasör olmayan bir kök — hiçbir şeyi adlandırmayan ya da bir dosyayı adlandıran bir yol — çalışma alanını okuyan her komut tarafından, komut başka bir şey yapmadan önce reddedilir; aggrega serve ve bir aggrega mcp dinleyicisi böyle bir kökle başlamayı reddeder, standart girdi ve çıktı üzerinden çalışan aggrega mcp ise yine de başlar ve o çalışma alanında işlem yapan her çağrıyı bu retle yanıtlar. Ret iletisi, kökü ikisinden hangisi sağladıysa onu, --workspace-root ya da AGGREGA_WORKSPACE_ROOT, değeri tam olarak verildiği haliyle adlandırır. aggrega version gibi hiçbir çalışma alanı okumayan bir komut kökü de okumaz ve bu nedenle reddedilmez.
İkisi de verilmediğinde ve keşif hiçbir şeyi sabitlemediğinde, komutun çalıştığı klasör kök olur ve çalışma alanını okuyan bir komut, o klasörü ve bu bayrağı adlandırarak bunu standart hataya tek satırla bildirir; Yapılandırma sayfasına bakın; bu sayfa böyle bir klasörde neden bir yapıt önbelleğine hiçbir şey yazılmadığını da açıklar.
Genel yapılandırma dosyası
--config <path>, tek bir çağrı için genel yapılandırma dosyasını açıkça belirtir. AGGREGA_CONFIG ortam değişkenine göre önceliklidir; bu değişken de varsayılan konuma göre önceliklidir. Her ikisi de bir dosyayı bilinçli olarak belirttiği için, var olmayan bir yol sessiz bir geri dönüş yerine açık bir hatadır. AGGREGA_* ayar değişkenlerinin aksine, hiçbiri tek bir ayarı geçersiz kılmaz; hangi dosyanın uygulanacağını seçer. Hangi dosya çözümlenirse çözümlensin, projenin kendi yapılandırma dosyaları yine onun üzerine katman olarak eklenir. Çözümleme sırası ve bu dosyaya nelerin ait olduğu Yapılandırma sayfasında yer alır.
--config ve AGGREGA_CONFIG ortam değişkeni, okuma kaynağının yanı sıra yazma hedefini de seçer: --config <path> ile çalıştırılan bir komut yapılandırmasını o dosyadan okur ve değişikliğini aynı dosyaya uygular; böylece bir komutun yazdığı, aynı çağrı biçimindeki bir sonraki komutun geri okuduğu şeydir.
Yapılandırmayı değiştiren komutlar, hangi dosyaya yazacaklarını ayarın niteliğine göre seçer: makine genelindeki araç yapılandırması (bir kayıt defteri) varsayılan olarak genel dosyaya yazılır; derlemeye katılan yapılandırma (bir provider bağlaması ya da bir yönetişim/linter/içe aktarıcı soket eklemesi) ise varsayılan olarak commit edilmiş proje dosyasına yazılır. Bunu geçersiz kılmak için --global ya da --workspace verin; komut nereye yazdığını yazdırır.
Yeni bir makinede genel bir yapılandırma oluşturmak için (imzalı yapıtların YAML elle düzenlenmeden çekilip doğrulanabilmesi amacıyla bir kayıt defterini ve onun imza güven ilkesini kaydederek) aggrega config init komutunu çalıştırın. Şu anda neyin uygulandığını ve --origin ile her ayara hangi katmanın karar verdiğini görmek için aggrega config show komutunu çalıştırın.
--offline
Bu tek çalıştırma için her türlü ağ erişimini reddeder.
Çevrimdışı olmak, tek bir komutun modu değil, bir çalışma alanı duruşudur ve üç yerden etkinleştirilebilir: bu bayrak, AGGREGA_OFFLINE ve bir yapılandırma dosyasındaki üst düzey offline anahtarı. Üçü de aynı anlama gelir ve olağan sırayı izler: bayrak değişkene, değişken de dosyaya üstün gelir.
Duruşu kapatmak da, açmak kadar bayrağın işidir. --offline=false, commit edilmiş bir yapılandırma dosyasının veya dışa aktarılmış bir değişkenin duruşu açtığı durumda tek bir komut için ağa izin verir. Bu, dosyayı düzenlemek size düşmediğinde önem taşır: .aggrega-config.yaml dosyası offline: true içeren bir proje, onu klonlayan herkes için yayınlamayı reddeder ve --offline=false geçirmek, commit ya da dışa aktarılmış değişken gerektirmeyen tek çözümdür.
Neler reddedilir, neler reddedilmez
Sınırı, hangi komutun yazıldığı değil, işin neye ihtiyaç duyduğu belirler.
Reddedilenler, çünkü bir kayıt defterine erişmeden doğru olamazlar:
--upgrade, nerede görünürse görünsün. Her bağımlılığı yeniden çözümler ve her birini bir kayıt defterinin o anda sunduğu en yüksek sürüme yükseltir; “mevcut en yüksek” ise bir kayıt defterinin şu anda sunduğu şey hakkında bir iddiadır. Bunu dolu bir önbelleğe karşı çalıştırmak, en yeniye yükseltildiğini bildirirken önbellekte o an ne varsa onu sabitler; bu da durmaktan daha kötüdür.- Kendi işi bir ağ gidiş-dönüşü olan komutlar:
aggrega push,aggrega push-artifactveaggrega registry update. Bunlar, varlığınızı okumadan veya depolarınızı dolaşmadan önce bunu belirtir ve ret mesajı, duruşu üç yerden hangisinin ayarladığını adlandırır; böylece hiç bayrak yazmamış biri nereye bakacağını bilir.
Reddedilmeyenler, çünkü makine bunları zaten karşılayabiliyor olabilir:
- Sıradan bir
aggrega pullveaggrega build --auto-pull. İkisi de önceden kaydedilmiş sabitlemelere uyar ve yalnızca sabitlemesi olmayanları çözümler; bu nedenle tüm başvuruları önbellekte olan veya bircatalog_dirskataloğunda bulunan bir çalışma alanı, dışarıya hiç erişmeden tamamlanır. Böyle bir çalıştırmanın gerçekten bir şey getirmesi gerektiğinde, o noktada reddedilir ve hangi başvuruyu karşılayamadığı bildirilir. - Tüm kapanışını önbellekten okuyan, dolu bir kilit dosyasına karşı
aggrega build. Sahip olduğu tek erişim bir onarımdır: deponun sabitlenmiş bir harici girdi kopyası kaybolduğunda, bu girdi kilit dosyasının zaten kaydettiği özet ile yeniden getirilir. Bu duruşta bunun için bile bir aktarım yoktur; bu yüzden eksik kopya, duruşu adlandırarak derlemeyi durdurur. - Bir
--dry-runyayını. Tüm davranışı, neyi yayınlayacağını bildirmek ve hiçbir şey çağırmamaktır; bu da onu duruşla çelişen değil, yayınlamanın çevrimdışı güvenli biçimi yapar.
Kataloğunun ve yapıtlarının yerel bir kopyasını tutan, ağdan yalıtılmış bir makine, bu ayrımın çalışır tutmak için var olduğu durumdur: böyle bir çalışma alanı çevrimdışıdır ve yaptığı neredeyse her şey hâlâ karşılanabilir.
Yapılandırma önceliği
Bir bayrak her şeye üstün gelir: bir ortam değişkenine, yapılandırma dosyalarına ve yerleşik varsayılana. Yapılandırma sayfası tüm sıralamayı, environment-variables.md ise AGGREGA_ önekli değişkenlerin listesini içerir.
aggrega config show --origin, her ayarı bu katmanlardan hangisinin belirlediğini bildirir ve sizin yazdığınız bir bayrak, bayrak olarak bildirilir; dolayısıyla bir reddetme beklemediğiniz bir katmanı adlandırdığında, bunu doğrulayacağınız yer bu komuttur.
Ayrıca bakınız
- configuration.md — bir ayarın hangi dosyaya ait olduğu ve tam öncelik modeli.
- environment-variables.md —
AGGREGA_*değişkenlerinin tam başvurusu. - aggrega-serve.md — arka plan hizmeti, çalışma alanını aynı kök bulma yolu üzerinden çözümler.
| Bayrak | Varsayılan | Açıklama |
|---|---|---|
--config | — | genel yapılandırma dosyasının yolu; AGGREGA_CONFIG ortam değişkenini ve varsayılan konumu geçersiz kılar. Çalışma alanı ağacındaki yapılandırma dosyaları yine bunun üzerine katmanlanır |
--no-color | false | Tüm çıktılarda ANSI rengini devre dışı bırakır. NO_COLOR ortam değişkeni aracılığıyla da dikkate alınır |
--offline | false | Yalnızca bu çalıştırma için her ağ erişimini reddeder: yapılandırma düzenlenmeden açılan çevrimdışı duruş. Yapılandırma dosyası veya AGGREGA_OFFLINE bunu zaten açıyorsa, tek bir çalıştırma için kapatmak üzere —offline=false geçirin. Reddedilenler, bir kayıt defteri olmadan gerçekleşemeyen şeylerdir: tüm işi her bağımlılığı bir kayıt defterinin o anda sunduğu en yüksek sürüme yükseltmek olan —upgrade ve kendi işi bir ağ gidiş-dönüşü olan komutlar — push, push-artifact ve registry update. Çalışmaya devam edenler ise makinenin zaten karşılayabildiği her şeydir: dolu bir kilit dosyasına karşı derleme, zaten önbelleğe alınmış veya yerel bir katalogda bulunan başvurular üzerinde —auto-pull ve neyi yayımlayacağını bildiren ve hiçbir şeyi çağırmayan bir deneme çalıştırması |
--plain | false | Erişilebilir mod: bir terminalde bile rengi devre dışı bırakır ve döner animasyon veya imleç yeniden çizimi olmadan düz, statik ilerleme satırları çizer. Ekran okuyucular için tasarlanmıştır |
--workspace-root | — | çalışma alanı kökü olarak kullanılacak mutlak yol (bulma adımını atlar) |