Prosedür

Artifact retention politikasını dry-run, yürütme ve restore kanıtıyla yönetin

Repository kapsamı, retention, pattern, keep-last, schedule ve archive-on-delete kurallarını güvenli bir cleanup akışında uygulayın.

Bu içerik nasıl kullanılmalı?Doğrulanmış ürün davranışıDokümantasyon sürümüLatest

Bu sayfadaki davranışlar, belirtilen kaynak snapshot'ında uygulama veya kabul kanıtıyla eşleştirildi.

Smart Kubaba Cleanup Policies ekranında kapsam, retention, keep-last ve schedule değerleri
Cleanup Policies görünümü dry-run veya gerçek çalıştırma öncesinde scope, retention, archive ve schedule kurallarını doğrulamak için kullanılır.

Rol ve ön koşullar

Politika oluşturma/değiştirme ManageCleanupPolicy, dry-run veya çalıştırma RunCleanup yetkisi gerektirir.

  • Politika tüm repository'ler, tek repository veya Hosted/Proxy/Group tipi kapsamlarından yalnız birini seçmelidir.
  • En az retentionDays, matchPattern veya keepLastVersions kuralından biri tanımlanmalıdır; archive açıksa archiveTarget zorunludur.
  • Hedef artifact'ların checksum, kullanım ve geri yükleme kanıtı için test paketi önceden kaydedilmelidir.

Uygulama adımları

  1. Cleanup Policies içinde scope, retention, keep-last, match/exclude, schedule ve archive ayarlarını girin; Affected Repositories önizlemesini inceleyin.
  2. Desteklenen dry-run API'sini çalıştırın; task tamamlanınca candidateCount değerini ve hedef örneklerini politika beklentinizle karşılaştırın. Dry-run storage veya metadata değiştirmemelidir.
  3. Kapsam doğruysa Run now işlemini onaylayın. Aynı policy için yalnız bir PENDING/RUNNING run oluştuğunu kontrol edin.
  4. Tasks > Cleanup & Storage üzerinde processed, deleted metadata/storage, archived ve failed sayaçlarını takip edin.
  5. Archive kapalıysa metadata DELETED ve active object silinmiş; archive açıksa metadata ARCHIVED ve object archive namespace'e taşınmış olmalıdır.
  6. Restore doğrulaması için aynı paketi normal publish/upload yoluyla yeniden sağlayın; permission, format, checksum ve overwrite kontrollerinden sonra ACTIVE ve RESTORED olduğunu doğrulayın.

Başarı ölçütleri

  • Run COMPLETED olur; candidateCount, processedCount ve sonuç sayaçları tutarlıdır.
  • Her işlenen artifact için cleanup_run_item ve CLEANUP_DELETE veya CLEANUP_ARCHIVE lifecycle kaydı bulunur.
  • CLEANUP_RUN_STARTED/COMPLETED audit ve CLEANUP operation log kayıtları job id ile ilişkilidir.
  • Node kaybı testi yapılırsa cursor ve PostgreSQL lease sayesinde kalan iş başka replica tarafından sürdürülebilir.

Hata ve güvenlik sınırları

  • Disabled politika ve eşzamanlı ikinci run reddedilir; tek aktif run kuralı veritabanı tarafından da korunur.
  • Item hatası tüm run'ı durdurmaz; hata kaydedilir ve artifact önceki durumunda kalır.
  • Arşiv nesnesi aktif package endpoint'inden sunulmaz; yalnız dosyanın archive dizininde bulunması metadata'yı etkinleştirmez.
  • SQL LIKE pattern ve keep-last davranışı örnek veriyle doğrulanmadan geniş scope'lu gerçek run başlatılmamalıdır.