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

aggrega deprecate

Önceden yayımlanmış bir yapıta imzalı bir kullanımdan kaldırma işareti ekler

Kullanım

aggrega deprecate <reference> [flags]

Açıklama

Deprecate amends an already-published artifact by attaching a deprecation marker to it as an OCI referrer, then signing that marker. It does not re-push, re-tag, or otherwise mutate the published bytes — the artifact is immutable; the marker is a sibling manifest pointing back at it, so a marker can be attached retroactively. The marker records a severity (warning, error, or retracted), a reason, an optional replacement reference, and the timestamp it was issued. Run it three ways: pass the content as flags; omit the content flags at an interactive terminal to be prompted for severity, reason, and replacement; or pass --from <file> to attach one marker per entry from a batch file, whose entries carry their own content, so a content flag passed beside --from is refused rather than ignored. The marker itself is signed the same way artifacts are: its manifest digest is signed and the signature is attached as a referrer of the marker, so the marker is verifiable the same way artifact signatures are. With --key the signature is produced offline from a held ECDSA P-256 key; without --key the keyless flow is used, which requires a live identity provider, Fulcio, and Rekor. Every marker of one --from batch is signed with one credential: where the configuration names a held key (signing.key_path) for one entry's registry and none for another's, or two different keys, no marker is attached and the command says to run one batch per credential.

Bayraklar

BayrakVarsayılanAçıklama
--from—Üst düzey listesi her girdi için bir işaret ekleyen toplu iş dosyası (YAML veya bunun bir alt kümesi olarak JSON). Her girdi reference, severity ve reason değerlerini, ayrıca isteğe bağlı replacement ve message değerlerini taşır. Konumsal bir başvuruyla ve —severity, —reason, —replacement ve —message ile birlikte kullanılamaz.
--fulcio-url—Anahtarsız imzalama için Fulcio sertifika yetkilisi URL’si. Belirtilmediğinde kamuya açık Fulcio örneği kullanılır.
--identity-token—Anahtarsız imzalama için OIDC kimlik belirteci. Etkileşimli bir terminalde (bir tarayıcı akışı belirteci edinir) ve GitHub Actions üzerinde (iş akışının OIDC belirteci otomatik olarak üretilir) isteğe bağlıdır; diğer etkileşimsiz/CI kullanımlarında zorunludur ve bu durumlarda bunun yerine AGGREGA_IDENTITY_TOKEN veya SIGSTORE_ID_TOKEN olarak dışa aktarılabilir.
--key—Çevrimdışı anahtarlı imzalama için elde tutulan ECDSA P-256 özel anahtar PEM dosyasının yolu. Belirtilmediğinde anahtarsız imzalama kullanılır.
--message—Denetim ve kaydedilen derleme zamanı tanılaması için saklanan isteğe bağlı ileti; ayarlanmadığında varsayılan olarak —reason değerini alır. Girdileri kendi iletisini taşıyan —from ile birlikte reddedilir.
--reason—Kullanımdan kaldırmanın insan tarafından okunabilir gerekçesi — neden kullanımdan kaldırıldığı ve bunun yerine ne yapılması gerektiği. Konumsal bir başvuruyla birlikte, etkileşimli bir istem bunu sağlamadıkça zorunludur; girdileri kendi gerekçesini taşıyan —from ile birlikte reddedilir.
--rekor-url—Anahtarsız imzalama için Rekor şeffaflık günlüğü URL’si. Belirtilmediğinde kamuya açık Rekor örneği kullanılır.
--replacement—Kullanımdan kaldırılanın yerini alan isteğe bağlı yapıt başvurusu. Girdileri kendi değerini taşıyan —from ile birlikte reddedilir.
--severity—Kullanımdan kaldırma önem düzeyi: warning, error, retracted değerlerinden biri. Konumsal bir başvuruyla birlikte, etkileşimli bir istem bunu sağlamadıkça zorunludur; girdileri kendi önem düzeyini taşıyan —from ile birlikte reddedilir.
--timestamp-url—Anahtarsız imzalama için isteğe bağlı RFC3161 zaman damgası yetkilisi URL’si.

İmzalama uç noktalarının kaynağı

Anahtarsız imzalama için Fulcio ve Rekor URL’leri ile anahtarlı imzalama için anahtar yolu, .aggrega-config.yaml dosyasının signing: bloğundan da gelebilir (genel ve kayıt defteri başına; yapıtın kayıt defteri için ayarlanan bir değer, alan alan genel değerden önceliklidir); bir bayrak yapılandırmayı geçersiz kılar, yapılandırma da kamuya açık varsayılanı geçersiz kılar. Dolayısıyla bayrak tablosunda adı geçen kamuya açık örnekler yalnızca ne bir bayrak ne de çalışma alanı yapılandırmanız bir uç nokta belirttiğinde kullanılır. İşaretçi, tam olarak aggrega sign komutunun bir yapıtı imzaladığı şekilde imzalanır.

Kayıt defteri bir yazmayı başarısız kıldığında

Bir yapıtı kullanımdan kaldırmak kayıt defterine iki kez yazar: önce yapıtın bir referrer’ı olarak eklenen işaret, ardından işaretin bir referrer’ı olarak eklenen işaret imzası. Kayıt defteri veya ağ bir yazmayı, sonraki bir denemenin başarılı olabileceği bir şekilde başarısız kıldığında, örneğin bir sunucu hatası, bir zaman aşımı veya sıfırlanan bir bağlantıda, yazma yeniden denenir; bu hatalar aggrega push sayfasında listelenir. Bir yazma en fazla üç kez, önce yarım saniye sonra bir saniye arayla denenir ve her deneme, başarısız olan isteğin yeniden gönderilmesi değil, aynı baytların yeni bir yüklemesidir. İşaretin zaman damgası ilk denemeden önce bir kez basılır; böylece yeniden denenen bir yazma iki değil, bir işaret ve bir imza bırakır.

İki yazma arasında yapılan işaret imzalama işlemi bir bütün olarak yeniden denenmez; anahtarsız bir imzalamanın içinde, sertifika yetkilisinin, şeffaflık günlüğünün veya zaman damgası yetkilisinin 429 Too Many Requests ya da bir sunucu hatasıyla yanıtladığı bir istek, aggrega sign belgesinde açıklandığı gibi o hizmete yeniden gönderilir. Son denemesinden sonra hâlâ başarısız olan bir yazma veya başarısız olan bir imzalama komutu durdurur ve ilgili adımı adlandırır; o ana kadar eklenmiş bir işaret, imzası olmadan ekli kalır. --from ile, başarısız olandan önce eklenen girdiler ekli kalır.

Toplu iş dosyası her işaretin içeriğini taşır

--from ile her işaretin önem düzeyi, gerekçesi, yerine geçeni ve iletisi, toplu iş dosyasındaki kendi girdisinden gelir. Bu nedenle --from ile birlikte verilen bir --severity, --reason, --replacement veya --message yok sayılmak yerine reddedilir: komut verilen her birini adlandırır ve toplu iş dosyası okunmadan önce durur; böylece hiçbir işaret eklenmez. İçeriği dosyanın girdilerine koyun ya da tek bir başvuruyu içerik bayraklarıyla kullanımdan kaldırın.

Bir toplu iş tek bir kimlik bilgisiyle imzalanır

--from ile toplu iş dosyasındaki her işaretçi aynı kimlik bilgisiyle imzalanır: tek bir saklanan anahtar ya da tüm dosya için bir kez istenen tek bir anahtarsız kimlik. Bir girdinin hangisine ihtiyaç duyduğuna, başvurusunun ait olduğu kayıt defterine ilişkin yapılandırma karar verir — o kayıt defterine uygulanan bir signing.key_path adlandırdığı anahtarı seçer, hiçbiri uygulanmadığında ise işaretçi anahtarsız imzalanır. Girdiler farklı kimlik bilgileri gerektirecekse — yapılandırma bir kayıt defteri için bir anahtar adlandırıp başka biri için hiçbirini adlandırmıyorsa ya da iki farklı anahtar adlandırıyorsa — hiçbir işaretçi eklenmez ve komut her iki taraftaki kayıt defterlerini adlandırır. Bunu, herhangi bir kimlik istenmeden ve herhangi bir kayıt defteri okunmadan önce yapar.

Dosyayı kimlik bilgisi başına bir toplu işe bölün ya da --key ile tek bir anahtar verin; bu anahtar, yapılandırma her kayıt defteri için ne derse desin her girdiye uygulanır. İleti şurada açıklanmıştır: References signed together need different signing credentials (Birlikte imzalanan başvurular farklı imzalama kimlik bilgileri gerektiriyor).

Her girdinin imzalayıcısı da ilk işaretçi eklenmeden önce hazırlanır; bu nedenle okunamayan bir anahtar ya da kullanılabilir bir özne taşımayan, sağlanmış bir kimlik belirteci, hiçbir şey eklenmeden toplu işi durdurur.

Her önem düzeyi ne yapar

Üç önem düzeyi sıralı bir küme oluşturur — önce warning, sonra error, sonra retracted — ve ne zaman etki ettikleri bakımından farklılaşan iki katmana ayrılır.

warning ve error tavsiye niteliğindeki katmanlardır. Bu önem düzeylerinden herhangi birindeki bir işaret, bir referansın hangi sürüme çözümlendiğini hiçbir zaman değiştirmez. İşaret, aggrega pull çalıştırdığınızda kaydedilir ve lockfile’ı okuyan her yüzey onu raporlar.

Bu yüzeylerin her biri, lockfile’ın sabitlediği kullanımdan kaldırılmış her referansı, önem düzeyi ne olursa olsun raporlar; referansı, önem düzeyini, mesajını ve kaydın ne zaman gözlemlendiğini belirtir:

YüzeyKaydedilmiş bir işaretle ne yapar
aggrega buildRaporlar ve o önem düzeyinde bir durdurma yapılandırdıysanız durur.
aggrega validate --releaseRaporlar. Karar değişmez.
aggrega lint --releaseRaporlar. Karar değişmez.
aggrega serveAggregate açıkken bunu düzenleyicinize bir uyarı olarak yayımlar. Bir işaretçi, çalışma alanınızdaki bir belgeyi değil, bir başvuruyu ya da bir eklentiyi adlandırır, bu nedenle Aggregate üzerinde kalır; Manifest üzerinde yalnızca bir Manifest’in kendi eşleme hataları gösterilir.
Yapay zekâya özgü build aracıRaporlar ve o önem düzeyinde bir durdurma yapılandırdıysanız reddeder.
Yapay zekâya özgü describe ve validate araçlarıKendi çıktılarıyla birlikte raporlar.

Bir işaretin bir derlemeyi ayrıca durdurup durdurmadığı ayrı bir ayardır: build.halt_on_deprecated_severity varsayılan olarak ayarlanmamıştır, dolayısıyla hiçbir şey durmaz; bir önem düzeyine ayarlandığında o önem düzeyinde ve üzerinde durdurur. Bu ayar derlemeyi yönetir — aggrega build ve aynı işlem olan yapay zekâya özgü build aracı — ve başka hiçbir şeyi yönetmez: raporlama yüzeyleri her iki durumda da işareti belirtip devam eder. Eşiği yükseltmek, hiçbir yüzeyde size bildirilenleri azaltmaz — eşiğin altındaki her şey ve durdurmanın kapsamadığı her şey için bildirimi yine alırsınız.

Bazı eklentiler başka bir yerde kaydedilir ve işaretleri oradan gelir. Bir plugins.linter eki ve bir ir-verdict ya da render-verdict rolündeki bir plugins.governance eki, işlenen çıktının hiçbir kısmını şekillendirmez; bu yüzden lockfile’ın kendisinde değil, lockfile’ın yanındaki plugins-trust.yaml dosyasında sabitlenir. Oradaki her kayıt, belirttiği eklenti için keşfedilen işareti kimliğiyle birlikte taşır ve aggrega pull, bir lockfile satırındaki işareti kaydettiği şekilde bunu da kaydeder.

aggrega build, aggrega lint --release ve aggrega validate --release her iki kaydı da okur; bu nedenle kullanımdan kaldırılmış bir eklenti, kullanımdan kaldırılmış bir referans gibi orada belirtilir ve build.halt_on_deprecated_severity ikisini de aynı şekilde yönetir. Bilinmesi gereken iki fark vardır. Böyle bir eklentiye ilişkin bildirim, kaydın ne zaman gözlemlendiğini söylemez — o dosya hiç zaman damgası taşımaz; bayt bayt yeniden üretilebilmesini sağlayan da budur — bu yüzden bunun yerine bilginin nereden geldiğini ve onu yenileyen komutu belirtir. Ayrıca oradaki bir girdi sıradan bir pull ile asla yeniden yazılmaz: yeni yayımlanan bir işaret, eklentinin zaten sahip olduğu kayda eklenir; bağlı tutulduğu kimlik ise aggrega pull --upgrade ile değiştirilmesini isteyene kadar yerinde kalır.

retracted geri çekme katmanıdır ve daha erken de etki eder. Geri çekilmiş olarak kaydedilen bir sürüm, aggrega pull sürüm belirtmeyen bir referans için sürüm seçerken değerlendirme dışı bırakılır. Yayımlanmış başka bir sürüm referansı karşılıyorsa o sürüm alınır ve pull bunu belirtir; atladığı sürümü, ona karşı kaydedilen nedeni ve bunun yerine aldığı sürümü adlandırır. Referansı karşılayacak yayımlanmış sürüm kalmamışsa pull durur ve tüm adayların geri çekildiğini söyler — varlığı eksik olarak raporlamaz ve hiçbir zaman sessizce bir geri dönüş yapmaz.

Bir sürümü açıkça belirtmek geri çekmeyi geçersiz kılar

Tam bir sürümü belirten bir başvuru, geri çekilmiş olsun ya da olmasın, her zaman o sürüme çözümlenir. Sürümü belirtmenin kendisi geçersiz kılmadır; bu nedenle dışlamayı kapatmak için ayrı bir ayar yoktur — ve önceki bir aggrega pull ile sabitlenmiş bir sürüm de tam olarak aynı nedenle çözümlenmeye devam eder.

Belirttiğiniz sürüm geri çekilmişse pull bunu açıkça bildirir; böylece o sürüme zaten bağlanmış olan derleme çalışmaya devam ederken siz de neden geçiş yapmak isteyebileceğinizi görmeye devam edersiniz.

Geri çekme kayıtları canlı bir yanıt değil, bir anlık görüntüdür

Yayımlanmış bir yapıt değiştirilemez, ancak bir geri çekme değiştirilebilir: bir sürüm, sizin son baktığınız andan sonra geri çekilmiş olabilir. Dışlama, çalışma alanınızın yerel kayıt defteri dizinini son oluşturduğunda kaydettiği bilgiyi okur; bu nedenle sizi geri çekildiği bilinen bir sürümü seçmekten korur. Bir sürümün şu anda geri çekilmiş olmadığını size söyleyemez.

Daha önce kaydedilmiş bir işaretçiye ilişkin her rapor, o kaydın ne zaman gözlemlendiğini belirtir; böylece bayat bir kayıt yeni bir kayıttan ayırt edilebilir ve her rapor, kaydı yenileyen komutu adlandırır. İki kayıt tutulur ve bunlar ayrı ayrı yenilenir: sürüm dışlaması ve aggrega inspect, aggrega registry update komutunun yenilediği yerel kayıt defteri dizininizi okur; aggrega build ise kilit dosyasına kaydedilmiş, aggrega pull komutunun yenilediği işaretçiyi okur. aggrega pull komutunun arama sırasında yazdırdıkları böyle bir an taşımaz — o anda bulduğunu bildirmektedir.

Aynı nedenle, bir geri çekmenin bulunmaması, hiçbir geri çekme olmadığının kanıtı değildir — yalnızca son yenilemenizde hiçbirinin kaydedilmemiş olduğunu gösterir.

Nerede bilgilendirilirsiniz

Bir geri çekme hakkında sizi hangi komutun bilgilendireceği, o komutun hangi kaydı okuduğuna bağlıdır. Yukarıdaki tablo, lockfile’ınızda kaydedilen işaretçiyi, yani bu Release’in sabitlediğini kapsar. Bu tablo ise yerel kayıt defteri dizinini, yani bir kayıt defterinin yayımladığını kapsar; sürüm dışlamasının okuduğu kayıt budur.

KomutKaydedilmiş bir geri çekme hakkında size ne söyler
aggrega registry updateKayıt defterini dolaşırken karşılaştığı her işaretçiyi adlandırır: depo, işaretçinin kaydedildiği sürüm, önem derecesi ve işaretçinin kaydedilip kaydedilmediği. Ardından her kayıt defteri, dizininin artık kaç işaretçi içerdiğini bildirir.
aggrega searchGeri çekilmiş bir sürüm yerine bir çözümlemenin alacağı sürümü bildirir ve geri çekilmiş sürümleri bir NOTES sütununda adlandırır. --include-retracted bunun yerine yayımlanmış en yüksek sürümü bildirir.
aggrega inspectKaydedilmiş önem derecesini varlığın altında; kaydedildiği sürüm, gerekçe, adlandırılmışsa yerine geçen ve yayımlandığı tarihle birlikte yazdırır; bunu adla çözümlediği her tür için yapar.
aggrega pullAtladığı her sürümü, o sürüme karşı kaydedilen gerekçeyi ve onun yerine aldığı sürümü adlandırır. Açıkça adlandırdığınız bir sürüm yine de çözümlenir ve geri çekme uygulanmak yerine duyurulur.
aggrega plugin addAynısı: seçtiği bir sürüm, sürüm çözümlediği her iki yolda da taranır ve <name>:<version> olarak adlandırdığınız bir sürüm, geri çekme duyurularak yine de çözümlenir. İşaretçiler okunamadığında bunu belirtir ve yayımlanmış sürümlerin taranmadığını bildirir.
aggrega buildBu kayıttan hiçbir şey. Yalnızca lockfile’ınızı okur, dizini asla okumaz; bu nedenle bildirdiği, sabitlediğiniz sürüme karşı kaydedilen işaretçidir.
aggrega serveBu kayıttan hiçbir şey. Kendi çözümlemesi geri çekme kayıtlarına başvurmaz, bu nedenle orada geri çekilmiş bir sürüm yine de seçilebilir; lockfile’ın işaretçisini editörünüze yayımlar.

Son iki satırı diğerleriyle birlikte okuyun: bir komut sizi bir geri çekme hakkında yalnızca geri çekmenin ilgili olduğu bir şey yaptığında bilgilendirir: bir sürüm seçerken ya da bir yayımcının söylediğini size gösterirken. Bunların hiçbirini yapmayan bir komutun sessizliği, hiçbir şeyin kaydedilmediğinin kanıtı değildir.

Bir bildirim, yayımcının kaydettiği önem derecesini adlandırır. Geri çekilmiş bir yapıt retracted olarak bildirilir; iki tavsiye niteliğindeki önem derecesi ise hangisi olduğu adlandırılarak kullanımdan kaldırılmış olarak bildirilir. Böylece geri okuduğunuz, yazılan değerle ve bir durdurma eşiğini yapılandırırken kullanacağınız değerle eşleşir.

İki tür bildirim, farklı olayları bildirdikleri için ayrı tutulur. Bir deprecation: satırı size bir yapıt hakkında bir şey söyler. Bir retraction: satırı ise size neyi almadığınızı söyler: atlanan bir sürümü ya da gerçekleştirilemeyen bir taramayı. Bir komut aynı yapıt hakkında ikisini birden yayımladığında, bunlar iki kez yapılmış tek bir açıklama değil, iki ayrı olgudur.

Dışlamanın kapsadığı çözümlemeler

Dışlama, bir komutun sizin için bir sürüm seçtiği her yerde devreye girer. Kural budur ve herhangi bir çözümlemenin kapsanıp kapsanmadığını bu belirler.

aggrega pull, sürüm belirtmeyen bir başvuru için sürüm seçtiği her yerde bunu uygular; başvurunun neyi adlandırdığı fark etmez: bir katalog varlığı, bir kitaplık, yayımlanmış bir Aggregate. Hepsini tek bir kural yönetir; bu nedenle bir başvurunun çözümlendiği sürüm, onu hangi tür başvurunun istediğine bağlı değildir.

aggrega plugin add, sabitlenmemiş bir plugin başvurusunu çözümlediği her yolda bunu uygular: yerel kayıt dizininizin zaten taşıdığı yayımlanmış sürümlere karşı ve bu dizin depoyu taşımadığında başvurduğu canlı sürüm listesine karşı. Geri çekilmiş bir sürüm, onu hangi yol çözümlemiş olursa olsun atlanır ve yerine geçen sürüm duyurulur.

Düzenleyiciye yönelik arka plan hizmeti istisnadır. Bir düzenleyiciye hizmet verirken başvuruları istek üzerine çözümler ve bu çözümleme sürümleri geri çekme kayıtlarına başvurmadan seçer; bu nedenle orada geri çekilmiş olarak kaydedilmiş bir sürüm yine de seçilebilir.

Hiçbir şeyin seçilmediği yerde dışlamanın etki edeceği bir şey de yoktur: tam bir sürümü adlandıran bir başvuru o sürüme çözümlenir ve geri çekme uygulanmak yerine duyurulur. Bunların hiçbiri derleme zamanında size bildirilenleri de değiştirmez — aggrega build, sürümü hangi yol sabitlemiş olursa olsun, kilit dosyasının kaydettiği her işaretleyiciyi raporlar.

Ayrıca bakınız

  • ./aggrega-sign.md — bir işaretleyici kendi özetiyle imzalanır; bu nedenle imzalama kipleri ve her birinin gerektirdiği kimlik bilgileri orada açıklananlardır.
  • ./aggrega-serve.md — daemon aynı işaretleyiciyi aggrega/deprecateArtifact üzerinden ekler. Terminalde istenen içerik oradaki bir istekte zorunludur, çünkü o yüzeyde onu isteyebilecek hiçbir şey yoktur.
  • ./aggrega-mcp.md — bir asistanın çağırabileceği deprecate-artifact aracıyla aynı yetenek. Buna izin vermeden önce o sayfanın bu konuda söylediklerini okuyun: bir geri çekme, o kayıt defterinin her tüketicisinin neyi çözümlediğini değiştirir.