Ana içeriğe atla

Yerel sunucuyu yönetme

Yerel Twenty konteynerini kontrol etmek için yarn twenty docker:* kullanın:
KomutNe yapar
yarn twenty docker:startSunucuyu başlatır (gerekirse imajı çeker)
yarn twenty docker:start 2.2.0Belirli bir sunucu sürümünü başlatın
yarn twenty docker:start --port 3030Özel bir portta başlatır
yarn twenty docker:stopSunucuyu durdurur (verileri korur)
yarn twenty docker:statusURL’yi, sürümü ve oturum açma kimlik bilgilerini gösterir
yarn twenty docker:logsSunucu günlüklerini akış olarak gösterir
yarn twenty docker:resetVerileri siler ve sıfırdan başlatır
yarn twenty docker:upgradeEn güncel twenty-app-dev imajını çeker
yarn twenty docker:upgrade 2.2.0Belirli bir sürüme yükseltir
Veriler, yeniden başlatmalar arasında iki Docker biriminde kalıcıdır (PostgreSQL için twenty-app-dev-data, dosyalar için twenty-app-dev-storage). Her şeyi silmek için reset kullanın.

Sunucu sürümünü sabitleme

Herhangi bir sürüm iletilmediğinde, docker:start sürümü uygulamanızın package.json içindeki engines.twenty aralığından çözümler — bu, uygulamanız yüklendiğinde sunucunun doğruladığı aralıkla aynıdır. Bu komut, aralığı karşılayan en yeni yayımlanmış twenty-app-dev imajını başlatır; alan yoksa veya hiçbir yayımlanmış sürüm eşleşmiyorsa latest değerine geri döner:
{
  "engines": {
    "twenty": ">=2.2.0"
  }
}
Aralığı tek bir çalıştırma için geçersiz kılmak amacıyla sürümü açıkça iletin: yarn twenty docker:start 2.3.0. Bir kapsayıcı zaten farklı bir sürümde mevcutsa, docker:start onu yerinde yükseltir (veri birimlerinizi korurken kapsayıcıyı yeniden oluşturarak).

Sunucu imajını yükseltme

yarn twenty docker:upgrade, en güncel imajı çeker, özetleri karşılaştırır ve yalnızca gerçekten bir şey değiştiyse konteyneri yeniden oluşturur. Birimler korunur — yalnızca konteyner değiştirilir. Yeni bir imaj çekildiyse ve konteyner çalışıyorsa, yükseltme otomatik olarak yeni bir konteyner başlatır; sağlıklı hale gelmesini beklemek için ardından yarn twenty docker:start çalıştırın.
yarn twenty docker:upgrade            # Latest
yarn twenty docker:upgrade 2.2.0      # Specific version
Çalışan sürümü yarn twenty docker:status ile doğrulayabilirsiniz (konteynere gömülü APP_VERSION değerini gösterir).

Paralel bir test örneği çalıştırma

Ana geliştirme verilerinize dokunmadan entegrasyon testlerini veya denemeleri yürütmek için, herhangi bir docker:* komutuna --test parametresini vererek ikinci, tamamen yalıtılmış bir örneği yönetebilirsiniz:
KomutNe yapar
yarn twenty docker:start --testTest örneğini başlatır (varsayılan bağlantı noktası 2021’dir)
yarn twenty docker:stop --testDurdurur
yarn twenty docker:status --testDurumunu gösterir
yarn twenty docker:logs --testGünlüklerini akış olarak gösterir
yarn twenty docker:reset --testVerilerini siler
yarn twenty docker:upgrade --testİmajını yükseltir
Test örneği, kendine ait bir Docker konteynerinde (twenty-app-dev-test), ayrılmış birimlerle (twenty-app-dev-test-data, twenty-app-dev-test-storage) ve yapılandırmayla çalışır; böylece ana örneğinizle çakışma olmadan paralel olarak çalışabilir. Varsayılan 2021’i geçersiz kılmak için --test ile --port’u birlikte kullanın.

Manuel kurulum (iskelet oluşturucu olmadan)

SDK’yı mevcut bir projeye ekliyorsanız iskelet oluşturma adımını atlayın:
yarn add twenty-sdk twenty-client-sdk
package.json dosyasına betiği ekleyin:
{
  "scripts": {
    "twenty": "twenty"
  }
}
Artık yarn twenty dev, yarn twenty docker:start ve diğerlerini çalıştırabilirsiniz.
twenty-sdk’yi global olarak kurmayın — her uygulama kendi sürümünü kullansın diye proje bazında sabitleyin.