İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

Ortam değişkenleri

aggrega CLI, AGGREGA_ önekli sabit bir ortam değişkenleri kümesini okur. Her biri, çalışma zamanında karşılık gelen .aggrega-config.yaml ayarını geçersiz kılar — bu, bir CI işinin veya gizli bilgi enjekte eden bir orkestratörün izlenen dosyaları düzenlemeden denetlediği katmandır — ancak bir komut satırı bayrağı yine de her şeyin önüne geçer.

Öncelik

Bir ortam değişkeni commit edilmiş yapılandırma dosyalarının üstünde yer alır (bir pipeline’ın veya gizli bilgi enjekte eden bir orkestratörün, izlenen bir dosyayı düzenlemeden uyguladığı bir çalışma zamanı geçersiz kılmasıdır) ve bir komut satırı bayrağının altında kalır; böylece komut satırına açıkça yazılan bir değer, ortamdaki değerler tarafından hiçbir zaman sessizce geçersiz kılınmaz. Yapılandırma sayfası, öncelik sıralamasının tamamını ve altındaki dosyaların katmanlanmasını içerir.

Tanımlanmamış (veya boş) bir değişken alttaki katmana düşer; yapılandırılmış bir değerin üzerine hiçbir zaman boş bir değer yazmaz. Şu anda geçerli olan yapılandırmayı ve her ayara hangi katmanın karar verdiğini görmek için aggrega config show --origin komutunu çalıştırın.

Adlandırma

Bir değişken adı, AGGREGA_ ön ekinin ardından yapılandırma yolunun büyük harfli snake case biçiminden (noktalar alt çizgiye dönüşür) oluşur: signing.fulcio_url, AGGREGA_SIGNING_FULCIO_URL olur. Kullanım kolaylığı için bir ad kısaltılmıştır: workspace.catalog_dirs, PATH’e benzer biçimde AGGREGA_CATALOG_DIRS’e bağlanır.

Kayıt defterine özgü ayarların (registries[].*) ortam değişkeni yoktur: ana bilgisayara özgü ilke bloklarından oluşan bir liste tek bir değişkenle ifade edilemez ve bir kayıt defterinin güven ve imzalama ilkesi, ortamdan gelen bir geçersiz kılma değil, işlenmiş (commit edilmiş) yapılandırmadır. Duruma bağlı, tek seferlik ve konumsal bayrakların (--dry-run, --trace, --detail, --output, --skip-verify, --release, --entity ve lint --allow-*/--no-allow-* ailesi) da ortam değişkeni yoktur; bunlar her çalıştırmaya özgü kararlardır.

Yapılandırma destekli ayarlar

DeğişkenYapılandırma yoluNotlar
AGGREGA_DEFAULT_REGISTRYdefault_registryHedef/kayıt defteri ana makinesi (varsayılan olarak hub.aggrega.ai). Bir dosyada default_registry nasıl yazılıyorsa öyle yazılır — bkz. bir kayıt defteri ana makinesi nasıl yazılır — ve öyle yazılmamış bir değer, yapılandırma çözümlenirken bu değişkeni adlandırarak reddedilir.
AGGREGA_OFFLINEofflineBoolean. Tüm ağ çıkışını yasaklar: getirme, çekme, edinme, gönderme, imzalama veya bir kayıt defteriyle iletişim kurma yapacak her komut bağlanmak yerine açıkça reddeder ve bir derleme yalnızca makinenin zaten sahip olduklarını kullanır — kilit dosyası, önbelleği ve yerel katalog dizinleri; --auto-pull bir kilit dosyasının katalog varlıklarını bunlardan, bir kayıt defterine ulaşmadan doldurur (grafiği uzak bir kaynaktan getirilen bir Recipe çevrimdışıyken yine durur). Keşif bu durumda yerel dizini okur — kullanımdan kaldırma uyarısı canlı yoklanmak yerine oluşturulmuş dizinden sunulur ve uzak kayıt defteri katalog çözümleme katmanı atlanır; tanınmayan bir komutun yazdırdığı eklenti ipucu, bu ayar ne olursa olsun yalnızca yerel dizini okur. Önceden önbelleğe alınmış veya sabitlenmiş materyalin doğrulaması yine çalışır — çevrimdışı mod getirmeyi yasaklar, yerel denetimi değil. --offline her iki yönde de bunun üstündeki bayraktır: duruşu tek bir çalıştırma için ayarlar ve --offline=false, bu değişkenin veya bir yapılandırma dosyasının ayarladığı yerde tek bir çalıştırma için ağa izin verir.
AGGREGA_AUTO_PULLauto_pullBoolean. Eksik bağımlılıkları derleme zamanında otomatik olarak getirir.
AGGREGA_ARTIFACT_CACHE_DIRartifact_cache_dirDisk üzerindeki içerik önbelleği dizini; komut nerede çalışırsa çalışsın aynı dizini adlandırması için çalışma alanı köküne göreli yazılır. Mutlak bir değer reddedilir, çalışma alanı kökünün kendisini adlandıran bir değer de öyle — önbelleğe kendi alt dizinini verin.
AGGREGA_CATALOG_DIRSworkspace.catalog_dirsİşletim sistemi yol listesi ayırıcısıyla ayrılır (Unix’te :). Mutlak yollar verin. Yapılandırılmış listenin yerini alır; workspace.releases altında kendi listesi verilmiş bir Release o listeyi korur.
AGGREGA_SIGNING_FULCIO_URLsigning.fulcio_urlAnahtarsız Fulcio CA URL’si.
AGGREGA_SIGNING_REKOR_URLsigning.rekor_urlAnahtarsız Rekor şeffaflık günlüğü URL’si.
AGGREGA_SIGNING_TIMESTAMP_URLsigning.timestamp_urlAnahtarsız RFC3161 zaman damgası yetkilisi URL’si.
AGGREGA_SIGNING_KEY_PATHsigning.key_pathAnahtarlı imzalama için tutulan bir ECDSA P-256 anahtar PEM dosyasının yolu. Yalnızca bir yol işaretçisidir — asla anahtar materyali değildir.
AGGREGA_SIGNING_REQUIREDsigning.requiredBoolean. signing.kinds’ın kapsadığı türleri yayımlamak ve tüketmek için imza gerektirir. Gereksinimi yalnızca açar, hiçbir zaman kapatmaz: onu ayarlayan bir yapılandırma dosyası onu açık tutar.
AGGREGA_SIGNING_KINDSsigning.kindsİşletim sistemi yol listesi ayırıcısıyla ayrılır (Unix’te :); her girdi, kind: alanında yazıldığı haliyle bir tür ya da all olur. Gereksinimin kapsadığı türleri genişletir, hiçbir zaman daraltmaz; imzalanabilir bir tür olmayan bir değer, bu değişken adlandırılarak reddedilir.
AGGREGA_SKIP_SIGNATURE_VERIFICATIONskip_signature_verificationBoolean. İmza doğrulamasını genel olarak devre dışı bırakır — açıkça: her çekme bir uyarı günlüğe yazar.
AGGREGA_WORKSPACE_ROOT(--workspace-root ile eşleşir)Keşfi atlayan mutlak çalışma alanı kökü — her komutta ve aggrega mcp’ye yapılan, kendine ait bir çalışma alanı adlandırmayan her istekte. Bir yapılandırma alanı değildir; ayarlandığında bayrak kazanır. Boş ayarlanırsa ayarlanmamış olarak okunur — ancak AGGREGA_BUNDLE_VERSION taşıyan ve --workspace-root verilmemiş, standart giriş ve çıkış üzerinden çalışan aggrega mcp hariç; bu, masaüstü paketinin Workspace folder ayarı boşken yaptığı başlatmadır ve kendine ait bir çalışma alanı adlandırmayan her çağrıyı o ayarı adlandıran bir retle yanıtlar. Var olan bir klasörü adlandırmadığında, çalışma alanını okuyan her komut başka bir şey yapmadan önce reddeder, aggrega serve ve bir aggrega mcp dinleyicisi başlamayı reddeder, standart giriş ve çıkış üzerinden çalışan aggrega mcp ise yine başlar ve o çalışma alanında işlem yapan her çağrıyı bu retle yanıtlar — her biri bu değişkeni, onu ayarlayan masaüstü uygulamasının Workspace folder ayarıyla birlikte adlandırır ve değeri verildiği gibi alıntılar.
AGGREGA_BUNDLE_VERSION(masaüstü paketi tarafından ayarlanır)aggrega mcp’yi başlatan masaüstü paketinin sürümü; paket bunu sunucunun ortamında ayarlar. Bir yapılandırma alanı değildir. Sunucu bunu başladığında bir kez okur ve argümansız çağrılan describe-capabilities üzerinde kendi sürümünün yanında bildirir, ikisi farklı sürümlerden geldiğinde bunu belirtir; bir farklılık nedeniyle hiçbir şey reddedilmez. Varlığı ayrıca paketin başlatmasını işaretler; bu nedenle yanındaki boş bir AGGREGA_WORKSPACE_ROOT, yukarıdaki satırda açıklandığı gibi ayarlanmamış olarak okunmak yerine reddedilir. Boş ayarlanırsa ayarlanmamış olarak okunur.

AGGREGA_CONFIG, projenin kendi dosyalarının altında yüklenecek açık bir genel yapılandırma dosyasını gösterir; tek bir ayarı geçersiz kılmak yerine hangi dosyanın uygulanacağını seçer. Ayarlanmamışsa bu katman platformun varsayılan konumundan otomatik olarak yüklenir — Windows’ta APPDATA ortam değişkeninin adlandırdığı dizin içindeki aggrega\config.yaml, diğer platformlarda XDG_CONFIG_HOME’un adlandırdığı dizin içindeki aggrega/config.yaml, yedek olarak da ~/.config/aggrega/config.yaml. Bkz. Yapılandırma.

Makinenin kendi dosyalarının bulunduğu yer

Genel yapılandırma dosyası ve makine genelindeki önbellekler, her platformun bir kullanıcının kendi dosyalarını tuttuğu yerde bulunur; bu nedenle aggrega bu yerleri adlandıran değişkenleri de okur. Bunların hiçbiri bir AGGREGA_ değişkeni değildir ve hiçbiri bir ayarı geçersiz kılmaz: her biri, hiçbir şey adlandırmadığında bir dosyanın nerede aranacağını söyler.

DeğişkenOkunduğu yerNeyi konumlandırdığı
APPDATAWindowsGenel yapılandırma dosyası; APPDATA’nın adlandırdığı dizin içinde aggrega\config.yaml konumunda.
LOCALAPPDATAWindowsMakine genelindeki önbellekler; LOCALAPPDATA’nın adlandırdığı dizin içinde aggrega\cache altında.
XDG_CONFIG_HOME, ardından HOMELinux, macOS ve diğer Unix sistemleriGenel yapılandırma dosyası; XDG_CONFIG_HOME’un adlandırdığı dizin içinde aggrega/config.yaml konumunda veya XDG_CONFIG_HOME ayarlanmamışsa ~/.config/aggrega/config.yaml konumunda.
XDG_CACHE_HOME, ardından HOMELinux ve diğer Unix sistemleriMakine genelindeki önbellekler; XDG_CACHE_HOME’un adlandırdığı dizin içindeki bir aggrega dizini altında veya XDG_CACHE_HOME ayarlanmamışsa ~/.cache/aggrega altında. Mutlak yol olmayan bir XDG_CACHE_HOME hiçbir önbellek konumlandırmaz ve derlenmiş eklentiler bu durumda yalnızca çalıştırma süresince tutulur.
HOMEmacOSMakine genelindeki önbellekler; ~/Library/Caches/aggrega altında.

AGGREGA_CONFIG veya --config, her platformda genel dosyayı doğrudan adlandırır ve bunlara karşı kazanır. Bir projenin kendi önbellekleri bunların hiçbiri tarafından konumlandırılmaz: proje içinde, artifact_cache_dir altında bulunurlar. aggrega config init, çalıştığı makinede hem genel dosyanın hem de makine genelindeki önbelleklerin nerede olduğunu söyler.

Boolean değerler

Boolean bir değişken true, false, 1 veya 0 kabul eder (büyük/küçük harf duyarsız). Boş olmayan diğer herhangi bir değer sessiz bir tahmin yerine açık bir hatadır — YAML’ın aksine yes/no/on/off kabul edilmez.

Gizli bilgiler

Gizli bilgiler ortam değişkeni veya bayrakla sağlanır ve asla yapılandırma alanı değildir.

DeğişkenAmaçÖncelik
AGGREGA_IDENTITY_TOKENAnahtarsız OIDC kimlik belirteci.--identity-token bayrağı > AGGREGA_IDENTITY_TOKEN > ortamdaki GitHub Actions OIDC > SIGSTORE_ID_TOKEN.
AGGREGA_REGISTRY_PASSWORDEtkileşimsiz aggrega login için kayıt defteri parolası.--password-stdin > AGGREGA_REGISTRY_PASSWORD > etkileşimli istem.

SIGSTORE_ID_TOKEN, kimlik belirteci için sigstore ekosistemiyle birlikte çalışabilirlik takma adı olarak kabul edilir; önceliği AGGREGA_IDENTITY_TOKEN ve ortamdaki GitHub Actions uç noktasının altındadır. Daha geniş sigstore araçlarının zaten ayarladığı değişken budur.

Aynı kimlik çözümlemesi üç imzalama fiilinin üçüne de hizmet eder: aggrega push --sign, aggrega sign ve aggrega deprecate. Etkileşimli bir terminalde her biri, hiçbir bayrak gerektirmeden bir tarayıcı akışıyla kısa ömürlü bir belirteç edinir. GitHub Actions üzerinde her biri, çalıştırıcının ortamdaki uç noktasından otomatik olarak yeni bir iş akışı OIDC belirteci üretir; bu nedenle belirteç dışa aktarmaya gerek yoktur. Diğer tüm etkileşimsiz çalıştırmaların ne terminali ne de ortamda bir uç noktası vardır; bu yüzden belirteci açıkça sağlamaları gerekir (AGGREGA_IDENTITY_TOKEN değişkenini dışa aktarın veya --identity-token verin). Sağlanmış bir belirteç, ortamda bir uç nokta ve terminal yoksa anahtarsız imzalama askıda bırakılmak yerine reddedilir.

CI rehberi (GitHub Actions)

GitHub Actions üzerinde CLI, çalıştırıcının ortamdaki OIDC uç noktasını algılar ve her imza için otomatik olarak yeni bir iş akışı belirteci üretir. İşe belirteç üretme izni verin ve belirteç dışa aktarmadan imzalayın:

permissions:
id-token: write # allow the job to mint a workflow OIDC token
# ...
- run: aggrega push <entity> --sign

Aynısı aggrega sign ve aggrega deprecate için de geçerlidir. Otomatik üretilen kimlik yerine belirli bir kimliği sabitlemek için AGGREGA_IDENTITY_TOKEN değişkenini açıkça dışa aktarın; açıkça verilen bir belirteç (veya --identity-token) her zaman ortamdaki uç noktaya üstün gelir:

- run: |
AGGREGA_IDENTITY_TOKEN=$(curl -s -H "Authorization: bearer $ACTIONS_ID_TOKEN_REQUEST_TOKEN" \
"$ACTIONS_ID_TOKEN_REQUEST_URL&audience=sigstore" | jq -r .value)
export AGGREGA_IDENTITY_TOKEN
aggrega push <entity> --sign

GitHub Actions olmayan CI’ın ortamda bir uç noktası yoktur: AGGREGA_IDENTITY_TOKEN değişkenini o sağlayıcının OIDC mekanizmasından dışa aktarın veya --identity-token verin.

Etkileşimli bir toplu iş için karşılığı aggrega auth token komutudur; tarayıcı OIDC akışını bir kez çalıştırır ve kimlik belirtecini aynı şekilde dışa aktarılabilmesi için stdout’a yazdırır:

Terminal window
export AGGREGA_IDENTITY_TOKEN=$(aggrega auth token)

Bkz. aggrega-auth.md. Her iki yol da bir dizi aggrega sign çağrısının, yapıt başına tarayıcı gidiş dönüşü olmadan tek bir kimliği yeniden kullanmasını sağlar.

AGGREGA_REGISTRY_PASSWORD yerine --password-stdin tercih edin. Bir ortam değişkeni alt süreçler tarafından okunabilir ve bir kabukta kalıcı olabilir; parola için stdin daha güvenli yoldur. Ortam değişkeni CI kolaylığı olarak vardır.

Ayrıca bakınız