Konsol

Build

Gönderdiğiniz işin kendiliğinden derlenip çalıştırılması, Unreal ve Unity şablonları, kendi build bilgisayarınızı bağlamak ve sonuçları konsolda izlemek.

PVersion gönderdiğiniz işi kendiliğinden derleyip çalıştırabilir. Bunun için projede bir servis tanımlanır: projenin hangi klasörü, nasıl derlenecek ve çıktısı nasıl çalıştırılacak. O klasöre her gönderim geldiğinde PVersion build alır ve yeni sürümü yayına koyar. Örneğin Atlas oyununun dedicated server'ı: Can kodu gönderir, birkaç dakika sonra sunucu yeni sürümle açılır.

Web siteleri de aynı yoldan yayına çıkar; onlar için Web yayını sayfasına bakın.

Servisi kim kurar

Servis tanımlarını PVersion ekibi yapar. Konsolda Destek sayfasından bir talep açın ve şunları yazın: hangi proje ve klasör, hangi motor (Unreal, Unity ya da başka), build nerede alınsın (aşağıya bakın) ve çıktı nasıl çalıştırılsın. Talep açmak için Destek ve asistan.

Bu izin açıksa stüdyonun yöneticileri projenin sayfasındaki Yeni servis ile servisi kendileri de tanımlayabilir. Her servis paketinizin servis sınırına sayılır (bkz. Paketler ve ödeme).

Servis bir kez kurulduktan sonra ekipten kimsenin bir şey yapması gerekmez: işinizi her zamanki gibi gönderirsiniz (bkz. Göndermek), build kendiliğinden başlar.

Build nerede alınır

Yer	Ne zaman
PVersion sunucusunda, bir build komutuyla	Web uygulamaları, araçlar, motor gerektirmeyen projeler
PVersion sunucusunda, Docker ile	Projede bir `Dockerfile` varsa; çıktı container olarak çalışır
Sizin build bilgisayarınızda	Unreal ve Unity gibi motorun kurulu olması gereken buildler

Build sizin bilgisayarınızda alındığında bilgisayar işi sıradan alır, projenin o sürümünü kendisi indirir, build komutunu çalıştırır, kaydını satır satır konsola gönderir ve çıktı klasörünü PVersion sunucusuna yükler. Çıktı orada çalışır; örneğin oyun sunucusu belirtilen portta açılır.

Unreal ve Unity şablonları

Servis tanımlanırken build bilgisayarı seçilince üç hazır şablon çıkar. Şablon build komutunu, çıktı klasörünü, çalıştırma komutunu ve portu (7777) doldurur:

Unreal dedicated server (Win64): projeyi Windows sunucusu olarak paketler; çıktı Saved/StagedBuilds/WindowsServer.
Unreal dedicated server (Linux, Docker'sız): aynısını Linux için yapar; çıktı Saved/StagedBuilds/LinuxServer.
Unity headless server: Unity'yi ekransız çalıştırır; çıktı Builds/Server.

Şablondaki MyGame ve MyGameServer yer tutucudur; kendi projenizin ve sunucu programınızın adıyla değiştirilir.

Kendi build bilgisayarınızı bağlamak

Kaç build bilgisayarı bağlayabileceğiniz pakete göre değişir. Bağlamak için:

Destek sayfasından talep açın ve bir build bilgisayarı bağlamak istediğinizi yazın. PVersion ekibi bu bilgisayara özel bir anahtar oluşturur.
Build programını bilgisayara kurun; konsolun adresini ve anahtarı programın ayarlarına yazın. Windows'ta program bir hizmet olarak kurulur ve bilgisayar açılınca kendiliğinden başlar.
Bilgisayarda build komutunun kullandığı motor kurulu olmalıdır (ör. Unreal ya da Unity).

Her bilgisayarın bir adı ve isteğe bağlı etiketleri olur (ör. unreal, windows). Servis hangi bilgisayarda çalışacağını bu ad ya da etiketle seçer; boş bırakılırsa bağlı bilgisayarlardan herhangi biri işi alır.

Sonuçları izlemek

Konsolda Servisler & deployment'lar sayfası stüdyonuzun bütün servislerini ve son durumlarını, altında da Son deployment'lar listesini gösterir. Bir servise tıklayınca sayfasında Deployment'lar listesi açılır: her satırda durum, gönderimin numarası, varsa not ve zaman.

Durum	Anlamı
sırada	Build sırasını bekliyor
senkronlanıyor	Projenin o sürümü indiriliyor
build ediliyor	Build komutu çalışıyor
başlıyor	Çıktı yerine konuyor, program açılıyor
çalışıyor	Yeni sürüm yayında
başarısız	Bir adım hata verdi
durduruldu	Eski bir sürüm ya da elle durdurulan servis

Bir satıra tıklayınca ayrıntısı açılır. Hata varsa en üstte kırmızı kutuda yazar. Adımlar build kaydının tamamıdır ve build sürerken canlı olarak akar; Süreç çıktısı çalışan programın kendi çıktısıdır (ör. oyun sunucusunun kaydı). Build neden başarısız olduysa genellikle Adımlar'ın son satırlarında görünür.

Elle build almak ve eski sürüme dönmek

Yeniden build almak: servis sayfasının sağ üstündeki düğme en son gönderimi yeniden derleyip yayına alır. Sağdaki son gönderimler listesinde her birinin yanındaki Deploy ile belirli bir gönderimi seçebilirsiniz. Açılan pencerede isterseniz bir Not yazın (ör. "QA onayı"); not geçmişte görünür. Deploy et ile başlatın.
Başarısız bir build'i tekrarlamak: satırın sağındaki Yeniden dene.
Eski bir sürüme dönmek: eski bir satırın sağındaki geri dönüş düğmesi o sürümü yeniden derler ve çalışan sürümün yerine koyar. Kısa bir kesinti olur.
Durdurmak: Durdur çalışan programı kapatır. Bir sonraki gönderim ya da elle build yeniden başlatır.

Elle build'i ekipteki herkes başlatabilir; servisi silmek için Yönetici rolü gerekir (bkz. Ekip ve yetkiler).

Aradığınızı bulamadınız mı?

Sitedeki asistana sorun ya da [email protected] adresine yazın.