Azure Blob Storage Entegrasyonu#
Azure Blob Storage entegrasyonu, depolama hesabı konteynerlerini Ultralytics Platform ile bağlar. Görsellerin kendi konteynerlerinde kalır; Platform bunları yerinde indeksler, böylece bir kopyasını yüklemek zorunda kalmadan YOLO modellerine göz atabilir, etiketleyebilir ve eğitebilirsin.
Azure Blob Storage veri kümeleri bir Pro veya Enterprise planı gerektirir. Ücretsiz çalışma alanları entegrasyonu görür ancak bağlantı kurarken yükseltme yapmaları istenir. Abonelik sona ererse mevcut Azure Blob Storage veri kümeleri tamamen erişilebilir kalır; yalnızca yeni bağlantılar ve içe aktarmalar Pro gerektirir.
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:
- Azure portalında depolama hesabını aç.
- Security + networking > Access keys (Güvenlik + ağ > Erişim anahtarları) bölümüne git.
- Bir connection string (bağlantı dizesi) kopyala.
Bağlantılar standart blob.core.windows.net uç noktasını kullanır. Egemen bulutlar (Azure China, Azure Government) ve özel blob uç noktaları desteklenmez.
Platform'a Bağlan#
- Settings > Integrations bölümüne git ve entegrasyon listesinden Microsoft Azure seçeneğini seç.
- Bağlantı dizesini yapıştır.
- 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.
- Connect (Bağlan) düğmesine tıkla. Platform, herhangi bir şeyi kaydetmeden önce seçilen her konteyneri listeleyip okuyabildiğini doğrular.
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 hesap anahtarı, Platform dışında ifşa edilirse yazma ve silme işlemlerini yetkilendirebilir veya SAS belirteçleri oluşturabilir. Kimlik bilgileri AES-256-GCM ile şifrelenmiş olarak saklanır, tarayıcıya asla geri gönderilmez ve eğitim işi yüklerine asla girmez. Mümkün olduğunda özel bir depolama hesabı kullan. Erişimi iptal etmek için Azure'daki depolama hesabı erişim anahtarlarını döndür.
Bir Blob Konteynerinden Veri Kümesi Oluştur#
- Yeni Veri Kümesi'ne tıkla ve Bulut depolama sekmesini aç.
- Bağlı bir konteyner seç ve verilerinin bulunduğu klasöre git.
- 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:
- Görseller —
.jpg,.jpeg,.png,.webpve.avifblob'ları, sınırlı istekler aracılığıyla okunan boyutlarla indekslenir. Platform, kaynak görselin ikinci bir kopyasını saklamaz. - Etiketler — YOLO
.txtyardımcı dosyaları, standartimages/→labels/düzeniyle veya aynı klasördeki kardeş dosyalar olarak eşleşecek şekilde Platform ek açıklamalarına ayrıştırılır. - Meta veriler — bir
data.yaml/data.ymldosyası, tıpkı bir arşiv yüklemesinde olduğu gibi sınıf isimlerini, görev türünü ve poz anahtar noktası şeklini sağlar. - Bölümler (Splits) — Blob yolundaki
train,valvetestklasör adları, bölümleri otomatik olarak atar.
Veri kümesi daha sonra diğerleri gibi davranır: ona göz atabilir ve etiketleyebilir, genel veya özel olarak ayarlayabilir, ekibinle paylaşabilir ve yönetilen eğitim yoluyla eğitebilirsin. Orijinal dosyalar talep üzerine aktarılır ve indekslenen görseller Platform depolama kotanı tüketmez.
Tek bir içe aktarma işlemi 50.000'e kadar blobu ve her biri 1 MB'a kadar olan etiket veya YAML dosyalarını indeksler. Daha büyük konteynerler birden fazla veri kümesine bölünmelidir.
Her indekslenen görsel, kendi blob ETag'ine sabitlenir ve eğer bir blob kendiliğinden değişirse Platform hata verir. Mevcut olanların üzerine yazmak yerine yeni blob'lar ekle.
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.
Eğitim#
Yönetilen eğitim, normal eğitim akışı üzerinden çalışır. İşçiler (Workers), sabitlenmiş orijinalleri çalıştırma için geçici iş depolama alanına indirir ve iş temizliği ile bunları kaldırır; Azure kimlik bilgilerin asla hesaplama birimine ulaşmaz.
Mevcut Sınırlamalar#
Azure destekli veri kümeleri şu anda Platform'a ait görsel kopyalarını gerektiren özellikleri içermez: otomatik etiketleme, kümeleme analizi, veri kümesi 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.