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.

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.

Bulut depolama alanını bağlamak için çalışma alanı yöneticisi veya sahibi rolüne ihtiyacın var. Tek bir bağlantı en fazla 50 bucket taşır ve keşif, hizmet hesabının görebileceği bucket'lardan en fazla 300 tanesini listeler.

Tarayıcın yapıştırılan anahtar dosyasını okur ve yalnızca Platform'un ihtiyaç duyduğu üç alanı (client_email, private_key ve project_id) gönderir. JSON'un geri kalanı sayfadan asla ayrılmaz.

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.

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

1. New Dataset öğesine tıkla ve Cloud 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.
• 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.
• 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.

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.

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

Eğitim#

Yönetilen eğitim normal eğitim akışı üzerinden çalışır. Eğitim, çalıştırma süresi boyunca sabitlenmiş görsellerin Platform'un kendi kopyalarını kullanır ve Google Cloud kimlik bilgilerin asla eğitim iş yüklerine maruz bırakılmaz.

Bağlantıyı Kes#

Bağlantıyı kesmek, Google Cloud'daki hiçbir şeye dokunmadan depolanan kimlik bilgilerini siler. Bu bucket'lardan oluşturulan veri kümeleri sınıfları, etiketleri ve açıklamalarıyla birlikte çalışma alanında kalır, ancak aynı hizmet hesabı yeniden bağlanana kadar görselleri yüklenemez, önizlenemez veya üzerinde 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 Google Cloud'da hizmet hesabı anahtarını sil.

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.