Prosedür
Repository oluşturun, paket yayınlayın ve yaşam döngüsünü doğrulayın
Hosted repository oluşturma, yetkili yayınlama, indirme ve silinmiş ya da arşivlenmiş içeriği yeniden yükleyerek geri getirme akışı.
Rol ve ön koşullar
Repository ayarları için ConfigureRepository, yayınlama için hedef repository üzerinde Upload, indirme için Download yetkisi gerekir.
- Aktif ve yazılabilir bir storage component ile repository sahibi olacak organization hazır olmalıdır.
- Formatın güncel Hosted destek düzeyini ve kullanılacak gerçek paket istemcisini doğrulayın.
- Repository adı küçük harfli, URL güvenli ve benzersiz olmalıdır; owner, format ve davranış tipi oluşturma sonrasında değişmez.
Uygulama adımları
Yönetim ekranı repository metadata'sını oluşturur; paket içeriği formatın paket API'si üzerinden akış halinde yazılır.
- Repositories sayfasında New Repository seçin; organization, format, Hosted tipi, storage ve gerekirse açıklama, paylaşım ve etiketleri girin.
- Repository oluşturulduktan sonra Copy URL ile paket taban adresini alın ve hedef ekip için Upload/Download erişim politikasını doğrulayın.
- Formatın native istemcisiyle tek bir test sürümü yayınlayın. Raw için doğrulanmış yol, kimliği doğrulanmış PUT isteğidir; Maven ve npm kendi publish/deploy protokollerini kullanır.
- Artifacts görünümünde mantıksal paket kaydını ve fiziksel dosyaları; ardından aynı kimlikle indirmeyi kontrol edin.
- Geri getirme testi gerekiyorsa yalnızca DELETED veya ARCHIVED durumdaki aynı yolu yeniden yükleyin; normal doğrulama ve overwrite kuralları uygulanarak kayıt ACTIVE olur.
Başarı ölçütleri
- Repository ACTIVE görünür; doğru organization, storage, format ve Hosted tipiyle kaydedilir.
- Sunucu SHA-256 ve boyutu hesaplar; Artifact Browse kaydı ile indirilen içerik eşleşir.
- REPOSITORY_CREATED, ARTIFACT_UPLOADED ve ilgili lifecycle/audit kayıtları oluşur; indirme Package Usage içinde görünür.
- Restore testi yapıldıysa yeni yükleme RESTORED yaşam döngüsü kanıtı üretir; arşiv metadata'sı doğrudan etkinleştirilmez.
Hata ve güvenlik sınırları
- Mevcut ACTIVE yola tekrar yükleme overwrite kapalıyken 409 ile reddedilir.
- Traversal içeren yollar, ayrılmış repository adları, pasif/yazılamaz storage ve yetkisiz istekler reddedilir.
- Storage object key istemci tarafından üretilmez ve arayüzde oluşturulmaz; backend tarafından belirlenir.
- Repository paylaşımı tek başına erişim vermez; eşleşen kullanıcı veya grup access policy ayrıca gerekli olmaya devam eder.