On Premise#

On Premise, Enterprise çalışma alanının Linux, macOS veya Windows bilgisayardaki veri kümelerini ve hesaplama kaynaklarını kullanmasını sağlar. Kaynak görüntüler ve videolar bilgisayarında kalır. Eğitim, diğer tüm uzaktan eğitim konumlarında olduğu gibi çalışır: metrikler Platform'a aktarılır ve tamamlanan model ağırlıkları indirme, tahmin, dışa aktarma ve dağıtım için yüklenir.

Kurulum tek bir komutla tamamlanır. Platform işletim sistemini algılar, uygun klasör konumlarını doldurur, gerekirse Docker'ı yükler ve canlı bağlantı ilerlemesini gösterir.

Nasıl Çalışır?#

flowchart LR
    A[Your browser] <-->|Interface, labels, and progress| B[Ultralytics Platform]
    A <-->|Dataset previews| C[Your On Premise computer]
    B <-->|Jobs, metrics, and model weights| C
    C --- D[(Dataset folder)]
    C --- E[(Models folder)]

Veri Sınırları#

Model ağırlıkları, etiketler, açıklamalar ve metrikler görüntülerinden öğrenilen bilgileri kodlayabilir. Kesin olarak yalnızca veri kümesi pikselleri yerel sınır içinde kalır. Bulut tahmini yalnızca ayrıca ilgili bulut iş akışına gönderdiğin görüntüleri işler; çalışan, bağlı veri kümesinden hiçbir görüntüyü iletmez.

Başlamadan Önce#

Veri kümelerine erişebilen ve Platform bunları kullanırken açık kalabilen bir bilgisayar seç:

GPU isteğe bağlıdır. Her bilgisayar veri kümelerini alabilir ve modelleri CPU'sunda eğitebilir. Uyumlu bir NVIDIA GPU, daha büyük eğitim işlerini hızlandırabilir.

Bilgisayarını Bağla#

1. Veri kümelerine erişebilen bilgisayarda Ultralytics Platform'u aç.
2. Settings > Integrations adresine git ve entegrasyon listesinden On Premise'i seç.
3. Önceden doldurulmuş Bu makinedeki veri kümesi klasörü ve Bu makinedeki modeller klasörü yollarını incele.
4. Kurulum komutu oluştur'u seç.
5. İletişim kutusunda belirtilen terminali aç, komutu kopyalayıp yapıştır ve Enter'a bas.
6. İlerleme göstergesinde Bağlandı görünene kadar Entegrasyonlar sayfasını açık tut.

Sayfa altı kurulum adımını canlı olarak izler — komutun çalıştırılması, çalışan dosyalarının indirilmesi, Docker görüntüsünün indirilmesi, çalışanın oluşturulması, başlatılması ve bağlantının onaylanması — böylece terminali okumadan ilerlemeyi takip edebilirsin. Bir ana bilgisayarı bağlamak için çalışma alanı düzenleyicisi rolü ve etkin bir Enterprise planı gerekir; başka bir plandaki çalışma alanlarında kurulum komutu yerine yönlendirmeli bir On Premise tanıtımı isteyen Devam et düğmesi görünür.

Platform, komutu kopyalamadan önce klasörleri ve tek kullanımlık bağlantı belirtecini doldurur. Oluşturulan komut aşağıdaki biçimi izler:

curl -fsSL 'https://platform.ultralytics.com/api/workers/install?os=linux' \
  | sudo sh -s -- \
    "/datasets" \
    "/models" \
    "YOUR_CONNECTION_TOKEN"

Varsayılanlar düzenleme yapılmadan çalışır:

Kurulum komutu bu klasörleri oluşturur, gerektiğinde Docker'ı yükleyip başlatır ve bağlantının bilgisayarınla birlikte yeniden başlamasını yapılandırır. Kurulum tamamlanmadan önce işletim sistemin yüklemeyi veya yeniden başlatmayı onaylamanı isteyebilir.

Docker Temel Görüntüleri#

Yükleyici bir kapsayıcı çalıştırır ve ana bilgisayar için resmî Ultralytics temel görüntüsünü seçer:

Yükleyici, ana bilgisayar için sürümü sabitlenmiş resmî bir görüntü seçer. Çalışan, Ultralytics'ı yeniden yüklemeden bağlantı bağımlılıklarını ekler. Kurulum sırasında CUDA'yı algıladığından NVIDIA kullanan bir ana bilgisayar ayrı CPU ve GPU çalışanları yerine tek bir kapsayıcı çalıştırır. En iyi kontrol noktası yüklendikten sonra model tahmini ve dışa aktarma işlemlerini Platform'un bulut hizmetleri yürütür.

Veri Kümesi Ekle#

1. Veri kümeni yapılandırılmış veri kümesi klasörünün içine yerleştir.
2. Platform'da Yeni Veri Kümesi > On Premise'i seç.
3. Bağlı bilgisayarı seç.
4. Veri kümesi klasörüne göz at, görevi seç ve Oluştur'u seç.

Platform veri kümesini yerel olarak indeksler ve onu yüklenen ve bulut depolama veri kümeleri için kullanılan galerinin aynısında açar. Pikselleri yüklemeden görüntüleri önizleyebilir, etiketleri inceleyebilir, veri kümesini filtreleyebilir ve açıklama ekleyebilirsin.

Desteklenen Veriler#

On Premise, yüklenen verilerle aynı alma biçimlerini ve bilgisayarlı görü görevlerini destekler:

• Görüntüler ve videolar
• ZIP, TAR, TAR.GZ ve TGZ arşivleri
• Ultralytics NDJSON ve COCO JSON
• YOLO veri kümeleri ve sınıflandırma klasörleri
• Algılama, segmentasyon, anlamsal, sınıflandırma, poz ve yönlendirilmiş sınırlayıcı kutu (OBB) görevleri

Platform yaygın veri kümesi düzenlerini, sınıfları, etiketleri ve eğitim/doğrulama/test bölümlerini otomatik olarak tanır. Veri kümesi klasörü salt okunur olarak bağlanır; bu nedenle Platform kaynak dosyalarını asla yeniden boyutlandırmaz, yeniden kodlamaz, düzenlemez veya silmez. Alma sırasında türetilen her şey — çıkarılan arşivler, indirilen NDJSON varlıkları ve video kareleri — aynı bilgisayardaki özel bir Docker birimine yazılır.

Önizleme ve Açıklama Ekleme#

Bir görüntüyü açtığında tarayıcın görüntüyü doğrudan bağlı bilgisayardan yükler. Sertifika, ana bilgisayar adı, VPN veya önizleme yapılandırması gerekmez.

Açıklamalar ve veri kümesi düzeni Platform çalışma alanına kaydedilir; ancak Platform'daki düzenlemeler kaynak görüntü veya etiket dosyalarını asla değiştirmez.

Model Eğit#

Normal Platform eğitim iletişim kutusunu kullanarak eğitimi başlat:

1. Bir proje aç ve Yeni Model'i seç.
2. On Premise veri kümesini seç.
3. Bir model ve eğitim ayarları seç.
4. Eğitimi başlat.

Platform işi bağlı bilgisayarda çalıştırır. Kullanılabilir bir NVIDIA GPU kullanır veya otomatik olarak CPU'ya geçer; böylece bir Mac, özel GPU donanımı olmadan COCO8 üzerinde YOLO26n gibi küçük bir modeli eğitebilir.

Eğitim dosyaları çalıştırma etkin olduğu sürece yapılandırılmış modeller klasörüne yazılır. Ultralytics paketi, müşteri tarafından yönetilen diğer makinelerle aynı uzaktan eğitim geri çağırmalarını kullanır: ilerleme ve metrikler Platform'a aktarılır, en iyi kontrol noktası Platform depolamasına yüklenir ve tamamlanan model mevcut indirme, tahmin, dışa aktarma ve dağıtım yollarıyla çalışır. Diğer eğitim yapıtları modeller klasöründe kalır. On Premise eğitimi Platform hesaplama kredilerini kullanmaz ve Platform eğitim işini hiçbir zaman bulut hesaplama kaynaklarına göndermez.

Bağlantıyı Yönet#

Bağlı her bilgisayarı, ana bilgisayar adını ve donanımını ve CPU ile GPU'sunun o anda çevrim içi olup olmadığını görmek için Settings > Integrations adresini aç. Ana bilgisayar sürekli durum bildirir; bu nedenle kapatılan veya bağlantısını kaybeden bir bilgisayar çevrim dışı görünür ve veri kümeleri bulut hesaplama kaynaklarına geçmek yerine geçici olarak kullanılamaz olur.

Yeniden bağlan, daha önce bağlantısını kestiğin bir ana bilgisayar için yeni bir kurulum komutu verir. Aynı ana bilgisayar kaydını yeniden kullanır; böylece mevcut veri kümeleri yeniden içe aktarılmadan çalışmaya devam eder.

Bağlantıyı kes, ana bilgisayarın erişimini hemen iptal eder. Buna bağlı kuyruğa alınmış, başlatılan ve çalışan işler (devam eden eğitim dahil) iptal edilir ve hâlâ içe aktarılmakta olan bir veri kümesi On Premise host disconnected during ingest. ile başarısız olur. İçe aktarmayı tamamlayan veri kümeleri sınıflarını, etiketlerini ve açıklamalarını korur; ancak yeniden bağlanana kadar önizlenemez veya üzerinde eğitim yapılamaz. Bilgisayardaki hiçbir şey silinmez ve Platform'a daha önce yüklenen modeller kullanılabilir durumda kalır.

Mevcut Sınırlamalar#

• Yeniden tarama yok. Bir veri kümesi oluşturduğunda bir kez indekslenir. Kaynak dosyalar bundan sonra değişirse Platform bunu fark etmez — değişiklikleri almak için yeni bir veri kümesi oluştur.
• Platform kopyası özellikleri kullanılamaz. On Premise veri kümelerinde, 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.
• Eğitim taşınmaz. Çalışan işlemi eğitim sırasında durursa çalışma başka bir yerde yeniden başlatılmak yerine başarısız olur.
• Model dosyaları ana bilgisayarda kalır. Platform'da bir modeli silmek veya çöp kutusuna taşımak, onu Platform'dan kaldırır; modeller klasöründen kaldırmaz — bir çalıştırmaya artık gerek kalmadığında bu klasörü kendin temizle.

Bir On Premise veri kümesini veya içindeki tek tek görüntüleri silmek yalnızca Platform'un başvurularını ve açıklamalarını kaldırır. Dosyalarına asla dokunulmaz.

Kurulum Tamamlanmazsa#

• Docker izin istiyor: İstemi onayla ve Docker'ın başlamasını bekle. Kurulum otomatik olarak devam eder.
• Windows yeniden başlatma istiyor: Bilgisayarı yeniden başlat, Settings > Integrations konumuna geri dön ve yeni bir kurulum komutu oluştur.
• Kurulum komutunun süresi doldu: Yeni bir kurulum komutu oluştur. Her komut geçicidir ve bir kez çalışır.
• Bağlantı çevrimdışı kalıyor: Docker Desktop'ı aç, yeni oluşturulmuş bir komutu yeniden çalıştır ve On Premise'ın çalıştığını bildirene kadar terminali açık tut.
• Önizlemeler yüklenmiyor: Bağlı bilgisayarda bir tarayıcıda Platform'u aç. Veri kümesi önizlemeleri doğrudan bu bilgisayardan gelir.
• Worker günlüklerine ihtiyacın var: Yükleyici, Linux'ta /opt/ultralytics-worker konumuna, macOS ve Windows'ta ise ~/.ultralytics/worker konumuna yazar. Worker'ı takip etmek için bu klasörden docker compose logs -f komutunu çalıştır.

Ayrıca Veri Kümeleri, Anotasyon ve Eğitim sayfalarına da bak.

SSS#