Google Cloud Storage Entegrasyonu#

Google Cloud Storage entegrasyonu, GCS bucket'larını Ultralytics Platform ile bağlar. Resimlerin bucket'larında kalır — Platform bunları yerinde indeksler, böylece bir kopya yüklemeden YOLO modellerine göz atabilir, etiketleyebilir ve eğitebilirsin.

Pro özelliği

Google Cloud Storage veri setleri bir Pro veya Enterprise plan gerektirir. Ücretsiz çalışma alanları entegrasyonu görür ve bağlanırken yükseltme yapmaları istenir. Mevcut Google Cloud Storage veri setleri, bir abonelik sona ererse tamamen erişilebilir kalmaya devam eder; yalnızca yeni bağlantılar ve içe aktarmalar Pro gerektirir.

Salt Okunur Bir Hizmet Hesabı Oluştur#

Platform yalnızca depolama alanından okuma yapar; nesnelerini asla yazmaz, değiştirmez veya silmez. Yalnızca okuma erişimine sahip özel bir servis hesabı oluştur:

1. Google Cloud konsolunda, IAM & Admin > Service Accounts kısmına git ve bir hizmet hesabı oluştur.
2. Bağlamak istediğin bucket'lar üzerinde Storage Object Viewer (roles/storage.objectViewer) rolünü ata.
3. Hizmet hesabını aç, Keys > Add key > Create new key yolunu izle, JSON seçeneğini seç ve anahtar dosyasını indir.

Platform'a Bağlan#

1. Settings > Integrations bölümüne git ve entegrasyon listesinden Google Cloud Storage seçeneğini seç.
2. Servis hesabı JSON anahtarının içeriğini yapıştır.
3. Find available buckets öğesine tıkla, ardından bağlanılacak bucket'ları seç. Servis hesabı bucket'ları listeleyemiyorsa, bilinen bir bucket adını manuel olarak gir.
4. Connect düğmesine tıkla. Platform, herhangi bir şeyi kaydetmeden önce seçilen her depolama alanını listeleyip okuyabildiğini doğrular.

Aynı hizmet hesabını daha sonra yeniden bağlamak, mevcut entegrasyona yeni depolama alanları ekler. Kaydedilmiş bir kimlik bilgisi, yalnızca yerine gelen yeni kimlik bilgisi zaten bağladığın her depolama alanını okuyabiliyorsa değiştirilir.

Kimlik bilgisi güvenliği

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 dahil edilmez. Erişimi iptal etmek için Google Cloud içindeki hizmet hesabı anahtarını sil.

Bir GCS Depolama Alanından Veri Kümesi Oluştur#

1. Yeni Veri Kümesi'ne tıkla ve Bulut depolama sekmesini aç.
2. Bağlı bir depolama alanı seç ve verilerini içeren klasöre göz at.
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:

• Görseller — .jpg, .jpeg, .png, .webp ve .avif nesneleri, sınırlı istekler aracılığıyla okunan boyutlarla indekslenir. Platform, kaynak görselin 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.
• Meta Veriler — bir data.yaml/data.yml, tıpkı bir arşiv yüklemesi gibi sınıf adlarını, görev türünü ve pozhtar ana nokta şeklini sağlar.
• Bölmeler — nesne yolundaki train, val ve test klasör adları, bölmeleri 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.

Sınırlar

Tek bir içe aktarma işlemi 50.000'e kadar nesneyi ve her biri 1 MB'a kadar olan etiket veya YAML dosyalarını indeksler. Daha büyük depolama alanları birden fazla veri kümesine bölünmelidir.

İndekslenen nesneleri değiştirilemez (immutable) tut

İndekslenen her görsel, GCS nesne üretimine sabitlenir ve bir nesne altta değişirse Platform hata vererek işlemi durdurur. Mevcut olanların üzerine yazmak yerine yeni nesneler ekle.

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

Bir içe aktarma başarısız olursa (boş bir klasör, yolda yazım hatası veya iptal edilmiş izinler gibi), veri kümesi kendi sayfasında hatayı gösterir. Editörler, depolanan depolama alanı ve klasörle işlemi yeniden başlatmak için Retry import düğmesine tıklayabilir veya düzeltilmiş yolu işaret eden yeni bir veri kümesi oluşturabilir.

Eğitim#

Yönetilen eğitim, normal eğitim akışı üzerinden çalışır. İşçiler (workers), sabitlenmiş orijinal dosyaları çalışma için geçici iş depolama alanına indirir ve iş temizliği ile bunları kaldırır; Google Cloud kimlik bilgilerin işlem gücüne asla ulaşmaz.

Mevcut Sınırlamalar#

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

GCS destekli bir veri kümesini veya içindeki tek tek görselleri silmek, yalnızca Platform'un referanslarını kaldırır; nesnelerine asla dokunulmaz.

Ayrıca Amazon S3 ve Azure Blob Storage entegrasyonlarına da göz at.