Azure Blob Storage Entegrasyonu#

Azure Blob Storage entegrasyonu, depolama hesabındaki kapsayıcılarını Ultralytics Platform'a bağlar. Görüntülerin kapsayıcılarında kalır — Platform bunları yerinde indeksler; böylece bir kopya yüklemeden YOLO modellerine göz atabilir, açıklama ekleyebilir ve modelleri eğitebilirsin.

Bağlantı Dizesi Alma#

Platform depolama alanından yalnızca okuma yapar — blob'larına hiçbir zaman yazmaz, bunları değiştirmez veya silmez. Mevcut entegrasyon, hesap genelinde yetkiler veren bir hesap erişim anahtarı bağlantı dizesi gerektirir; Platform ise yalnızca listeleme ve okuma işlemlerini kullanır:

1. Azure portalında depolama hesabını aç.
2. Security + networking > Access keys bölümüne git.
3. Bir connection string kopyala.

Dize, Azure'ın Access keys altında sana sunduğu biçimde AccountName, AccountKey ve protokol olarak HTTPS içermelidir. AccountKey yerine SharedAccessSignature içeren SAS belirteci bağlantı dizeleri reddedilir.

Platform'a bağlanma#

1. Settings > Integrations bölümüne git ve entegrasyon listesinden Azure Blob Storage'ı seç.
2. Bağlantı dizesini yapıştır.
3. Find available containers düğmesine tıkla, ardından bağlanacak kapsayıcıları seç. Bir kapsayıcı adını manuel olarak da girebilirsin.
4. Connect düğmesine tıkla. Platform, herhangi bir şeyi kaydetmeden önce seçilen her kapsayıcıyı listeleyebildiğini ve okuyabildiğini doğrular.

Bulut depolamaya bağlanmak için çalışma alanı yöneticisi veya sahibi rolüne sahip olman gerekir. Bir bağlantı en fazla 50 kapsayıcı taşıyabilir ve keşif işlemi depolama hesabında en fazla 300 kapsayıcı listeler.

Aynı depolama hesabını daha sonra yeniden bağlamak, mevcut entegrasyona yeni kapsayıcılar ekler. Kaydedilmiş bir kimlik bilgisi, ancak yenisi daha önce bağladığın tüm kapsayıcıları okumaya devam edebiliyorsa değiştirilir.

Blob Kapsayıcısından Veri Kümesi Oluşturma#

1. Yeni Veri Kümesi seçeneğine tıkla ve Bulut sekmesini aç.
2. Bağlı bir kapsayıcı seç ve verilerini içeren klasöre git.
3. Klasörü onayla, veri kümesi adını düzenle ve veri kümesini oluştur.

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

• Görüntüler — .jpg, .jpeg, .png, .webp ve .avif blob'ları, boyutları sınırlandırılmış isteklerle okunarak indekslenir. Platform, kaynak görüntünün ikinci bir kopyasını kalıcı olarak saklamaz.
• Etiketler — YOLO .txt yan dosyaları Platform açıklamalarına ayrıştırılır ve standart images/ → labels/ düzenine veya aynı klasördeki eş nesnelere göre eşleştirilir.
• Meta veriler — Bir YAML dosyası, tıpkı bir arşiv yüklemesinde olduğu gibi sınıf adlarını ve poz anahtar noktası şeklini sağlar. Klasörde birden fazla dosya varsa data.yaml ve data.yml tercih edilir.
• Görev — Etiket dosyalarından alınan bir örnek görevi belirler; bu nedenle segment, poz ve OBB klasörleri, iletişim kutusunda seçtiğin göreve göre değil, etiket şekillerine göre tanınır.
• Bölmeler — blob yolundaki train, val ve test klasör adları, bölmeleri otomatik olarak atar.

Veri kümesi bundan sonra diğerleri gibi davranır: göz atabilir ve açıklama ekleyebilir, herkese açık veya özel olarak ayarlayabilir, ekibinle paylaşabilir ve yönetilen eğitim aracılığıyla üzerinde eğitim gerçekleştirebilirsin. Orijinal dosyalar isteğe bağlı olarak aktarılır ve indekslenmiş görseller Platform depolama kotanı tüketmez.

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

Bir içe aktarma işlemi başarısız olursa — boş bir klasör, yoldaki bir yazım hatası veya iptal edilmiş izinler nedeniyle — veri kümesi hatayı kendi sayfasında gösterir. Düzenleyiciler, depolanan kapsayıcı ve klasörle işlemi yeniden başlatmak için Retry import düğmesine tıklayabilir veya düzeltilmiş yolu gösteren yeni bir veri kümesi oluşturabilir.

Yeniden deneme işlemi kaldığı yerden devam etmek yerine klasörü yeniden listeler: ilk denemeden bu yana eklenen blob'lar alınır ve artık mevcut olmayan blob'lar veri kümesinden çıkarılır.

Eğitim#

Yönetilen eğitim normal eğitim akışı üzerinden çalışır. Eğitim, çalışmanın süresi boyunca sabitlenmiş görüntülerin Platform'a ait kopyalarını kullanır ve Azure kimlik bilgilerin eğitim iş yüklerine hiçbir zaman açığa çıkarılmaz.

Bağlantıyı Kesme#

Bağlantıyı kesmek, Azure'daki hiçbir şeye dokunmadan depolanan bağlantı dizesini siler. Bu kapsayıcılardan oluşturulan veri kümeleri sınıfları, etiketleri ve açıklamalarıyla birlikte çalışma alanında kalır; ancak aynı depolama hesabı yeniden bağlanana kadar görüntüleri yüklenemez, önizlenemez veya eğitimde kullanılamaz.

GET /api/integrations/buckets tarafından döndürülen entegrasyon kimliğiyle REST API'yi 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 kaynağında iptal etmek için Azure'da depolama hesabının erişim anahtarlarını yenile.

Mevcut Sınırlamalar#

Azure destekli veri kümelerinde şu anda görüntülerinin Platform'a ait kopyalarını gerektiren özellikler bulunmaz: otomatik açıklama ekleme, kümeleme analizi, veri kümesi klonlama ve değişmez sürüm anlık görüntüleri.

Azure destekli bir veri kümesini veya içindeki tek tek görüntüleri silmek yalnızca Platform'un referanslarını kaldırır — blob'larına hiçbir zaman dokunulmaz.

Ayrıca Google Cloud Storage ve Amazon S3 entegrasyonlarına da bakabilirsin.

SSS#