Link to this sectionAmazon S3 Entegrasyonu#

Amazon S3 entegrasyonu, S3 bucket'larını Ultralytics Platform ile bağlar. Görüntülerin bucket'larında kalır; Platform bunları yerinde indeksler, böylece bir kopyasını yüklemeden YOLO modellerine göz atabilir, etiketleyebilir ve eğitebilirsin.

Link to this sectionSalt Okunur IAM Kullanıcısı Oluştur#

Platform depolama alanından yalnızca okuma yapar; nesnelerini asla yazmaz, değiştirmez veya silmez. Yalnızca listeleme ve okuma erişimine sahip özel bir IAM kullanıcısı kullan, asla kök kimlik bilgilerini kullanma:

1. AWS konsolunda IAM > Users kısmına git ve konsol erişimi olmayan bir kullanıcı oluştur.

2. Bağlamak istediğin bucket'lara yalnızca listeleme ve okuma erişimi veren bir politika ekle:

   {
       "Version": "2012-10-17",
       "Statement": [
           { "Effect": "Allow", "Action": "s3:ListAllMyBuckets", "Resource": "*" },
           {
               "Effect": "Allow",
               "Action": ["s3:ListBucket", "s3:GetObject"],
               "Resource": ["arn:aws:s3:::my-bucket", "arn:aws:s3:::my-bucket/*"]
           }
       ]
   }

   s3:ListAllMyBuckets isteğe bağlıdır; Platform'un bucket'larını keşfetmesini sağlar, böylece adlarını yazmak zorunda kalmazsın.

3. Kullanıcının Security credentials sekmesini aç, bir access key oluştur ve access key ID ile secret access key değerlerini kopyala.

Link to this sectionPlatform'a Bağlan#

1. Settings > Integrations kısmına git ve Amazon S3 kartını bul.
2. Connect düğmesine tıkla ve access key ID, secret access key ve bucket bölgesini (örneğin us-east-1) gir.
3. Platform, kimlik bilgilerinin okuyabildiği bucket'ları listeler. Bağlanacak olanları seç veya politika keşfe izin vermiyorsa 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ı IAM kullanıcısını daha sonra yeniden bağlamak, mevcut entegrasyona yeni bucket'lar ekler. Kayıtlı bir kimlik bilgisi, ancak yerine geçecek olan yeni kimlik bilgisi zaten bağladığın her bucket'ı okuyabiliyorsa değiştirilir.

Link to this sectionS3 Bucket'ı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:

• Images — .jpg, .jpeg, .png, .webp ve .avif nesneleri, sınırlandırılmış başlık isteklerinden okunan boyutlarla indekslenir. Kaynak pikseller depolama alanından asla kopyalanmaz.
• Etiketler — YOLO .txt yardımcı dosyaları, standart images/ → 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.yml dosyası, 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.
• Splits — Nesne anahtarındaki train, val ve test klasö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.

Link to this sectionBaş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.

Link to this sectionEğitim#

Yönetilen eğitim, normal eğitim akışı üzerinden çalışır. İşçiler (workers), sabitlenmiş orijinalleri çalışma için geçici iş depolama alanına indirir ve iş temizliği ile bunları kaldırır; AWS kimlik bilgilerin hiçbir zaman hesaplama birimine ulaşmaz.

Link to this sectionMevcut Sınırlamalar#

S3 destekli veri kümeleri, şu anda görüntülerin Platforma ait kopyalarını gerektiren özellikleri hariç tutar: otomatik etiketleme, kümeleme analizi, veri kümesi klonlama ve değiştirilemez sürüm anlık görüntüleri.

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

Ayrıca Google Cloud Storage ve Azure Blob Storage entegrasyonlarına göz at.