Azure Blob Storage Entegrasyonu#

Azure Blob Storage entegrasyonu, depolama hesabı kapsayıcılarını Ultralytics Platform ile bağlar. Resimlerin kapsayıcılarında kalır — Platform bunları yerinde indeksler; böylece bir kopya yüklemeden YOLO modellerine göz atabilir, etiketleyebilir ve eğitebilirsin.

Bir Bağlantı Dizesi (Connection String) Al#

Platform depolama alanından yalnızca okuma yapar; hiçbir blobu asla yazmaz, değiştirmez veya silmez. Mevcut entegrasyon, Platform yalnızca listeleme ve okuma işlemleri kullansa bile hesap genelinde ayrıcalıklar sağlayan bir hesap erişim anahtarı bağlantı dizesi gerektirir:

1. Azure portalında depolama hesabını aç.
2. Security + networking > Access keys (Güvenlik + ağ > Erişim anahtarları) bölümüne git.
3. Bir connection string (bağlantı dizesi) kopyala.

Dize, protokol olarak AccountName, AccountKey ve HTTPS içermelidir; bu, Azure'ın size Access keys altında verdiği formattır. AccountKey yerine SharedAccessSignature içeren SAS token bağlantı dizeleri reddedilir.

Platform'a Bağlan#

1. Settings > Integrations adresine git ve entegrasyon listesinden Azure Blob Storage seçeneğini seç.
2. Bağlantı dizesini yapıştır.
3. Find available containers seçeneğine tıkla, ardından bağlanmak istediğin kapsayıcıları seç. Ayrıca manuel olarak bir kapsayıcı adı da girebilirsin.
4. Connect (Bağlan) düğmesine tıkla. Platform, herhangi bir şeyi kaydetmeden önce seçilen her konteyneri listeleyip okuyabildiğini doğrular.

Bulut depolama alanını bağlamak için çalışma alanı yöneticisi veya sahibi role gereklidir. Tek bir bağlantı 50'ye kadar kapsayıcı taşır ve bulma işlemi depolama hesabında 300'e kadar kapsayıcıyı listeler.

Aynı depolama hesabını daha sonra yeniden bağlamak, mevcut entegrasyona yeni konteynerler ekler. Kaydedilen bir kimlik bilgisi, ancak yerine gelen kimlik bilgisi zaten bağladığın her konteyneri okuyabiliyorsa değiştirilir.

Bir Blob Konteynerinden Veri Kümesi Oluştur#

1. New Dataset öğesine tıkla ve Cloud sekmesini aç.
2. Bağlı bir konteyner seç ve verilerinin bulunduğu klasöre git.
3. Klasörü onayla, veri kümesi adını ayarla ve veri kümesini oluştur.

Platform klasörü bir kez listeler ve bulduklarını indeksler:

• Images — .jpg, .jpeg, .png, .webp ve .avif blobları, sınırlı istekler aracılığıyla okunan boyutlarla indekslenir. Platform, kaynak görüntünün ikinci bir kopyasını kalıcı olarak saklamaz.
• Etiketler — YOLO .txt yan dosyaları, standart images/ → labels/ düzeniyle veya aynı klasördeki kardeşler olarak eşleştirilerek Platform etiketlerine ayrıştırılır.
• Metadata — bir YAML dosyası, tıpkı bir arşiv yüklemesinde olduğu gibi sınıf adlarını ve pozhtar noktası şeklini sağlar. Klasör birden fazla barındırdığında data.yaml ve data.yml tercih edilir.
• Task — etiket dosyalarının bir örneği göreve karar verir; bu nedenle segment, poz ve OBB klasörleri, diyalogda seçtiğin görevden ziyade etiket şekillerinden tanınır.
• Splits — Blob yolundaki train, val ve test klasör adları bölümleri otomatik olarak atar.

Veri seti daha sonra diğerleri gibi davranır: ona göz at ve etiketle, onu herkese açık veya özel yap, ekibinle paylaş ve yönetilen eğitim aracılığıyla onun üzerinde eğitim gerçekleştir. Orijinaller talep üzerine akışa alınır ve indekslenen görseller Platform depolama kotanı tüketmez.

Başarısız İçe Aktarmalar#

Bir içe aktarma başarısız olursa (boş bir klasör, yolda bir yazım hatası veya iptal edilmiş izinler gibi), veri kümesi kendi sayfasında hatayı gösterir. Editörler, depolanmış konteyner ve klasör ile yeniden başlatmak için Retry import (İçe aktarmayı yeniden dene) düğmesine tıklayabilir veya düzeltilmiş yolu gösteren yeni bir veri kümesi oluşturabilirler.

Yeniden deneme, devam etmek yerine klasörü yeniden listeler: ilk denemeden bu yana eklenen blob'lar alınır ve artık orada olmayan blob'lar veri setinden çıkarılır.

Eğitim#

Yönetilen eğitim, normal eğitim akışı üzerinden çalışır. Eğitim, çalıştırma süresi boyunca sabitlenen görsellerin Platform'un kendi kopyalarını kullanır ve Azure kimlik bilgilerin asla eğitim iş yüklerine ifşa edilmez.

Bağlantıyı Kes#

Bağlantıyı kesmek, Azure'daki hiçbir şeye dokunmadan saklanan bağlantı dizesini siler. Bu kapsayıcılardan oluşturulan veri setleri sınıfları, etiketleri ve açıklamalarıyla çalışma alanında kalır, ancak aynı depolama hesabı yeniden bağlanana kadar görselleri yüklenemez, önizlenemez veya bunlarla eğitim yapılamaz.

GET /api/integrations/buckets tarafından döndürülen entegrasyon kimliğiyle REST API kullan:

curl -X DELETE \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://platform.ultralytics.com/api/integrations/buckets/INTEGRATION_ID

from ultralytics_platform import Platform

client = Platform()  # reads ULTRALYTICS_API_KEY
integrations = client.storage_integrations.list()
client.storage_integrations.delete("INTEGRATION_ID")

Bunun yerine erişimi kaynaktan iptal etmek için Azure'daki depolama hesabı erişim anahtarlarını yenile.

Mevcut Sınırlamalar#

Azure destekli veri setleri şu anda Platform'a ait görüntü kopyalarını gerektiren özellikleri hariç tutar: otomatik etiketleme, kümeleme analizi, veri seti klonlama ve değiştirilemez sürüm anlık görüntüleri.

Azure destekli bir veri kümesini veya ondaki bireysel görselleri silmek, yalnızca Platform'un referanslarını kaldırır; blob'larına asla dokunulmaz.

Ayrıca Google Cloud Storage ve Amazon S3 entegrasyonlarına da göz at.