Bir projenin servisleri: web servisleri, işçiler ve zamanlanmış işler.
Bir projeye arka plan işçileri, zamanlanmış işler, ek web servisleri, veritabanları ve Valkey ekleyin — kendi kodundan, başka bir depodan veya hazır bir imajdan — adlarıyla erişilebilir ve tek faturada.
Bir proje tek bir süreçten fazlasıdır. Ana uygulamanın yanında bir kuyruk işçisi, gece çalışan bir iş, ayrı bir API, bir veritabanı çalıştırabilirsiniz — her biri kendi kaynaklarıyla bir servis olarak, hepsi tek faturada.
Servisler uygulamanın Genel bakış → Servisler → Servis ekle bölümünde listelenir. Bir projede en fazla 10 servis olabilir. Önce ana servisin başlatılmış olması ve projenin aboneliğinin aktif olması gerekir (deneme de sayılır).
Servis türleri
| Tür | Ne olduğu |
|---|---|
| Web servisi | başka bir site veya API — herkese açık adresli ya da yalnızca dahili |
| Arka plan işçisi | sürekli çalışır: kuyruklar, Horizon, Celery, tüketiciler |
| Zamanlanmış iş | bir zamanlamaya göre başlar (cron biçimi, UTC), işini yapar ve durur |
| PostgreSQL, MySQL, Valkey | yönetilen veritabanları — bkz. Veritabanları |
| NATS, RabbitMQ | olaylar ve kuyruklar için mesaj aracıları, yalnızca dahili — bkz. Olaylar ve kuyruklar |
Herkese açık adres veya yalnızca dahili
Bir web servisi eklediğinizde ona nasıl ulaşılabileceğini seçin — önceden hiçbir şey seçili değildir:
- Herkese açık adres — internetten
https://<name>.rivervo.appadresinde açık; kendi alan adlarınız olabilir. - Yalnızca dahili — internette adresi ve alan adı yok; ona yalnızca uygulamanın diğer servisleri ulaşır. Sitenizin arkasındaki bir API, bir yönetim backend'i veya bir arama motoru için doğrusu budur.
Arka plan işçileri, zamanlanmış işler ve veritabanları asla herkese açık değildir; bu yüzden onlar için seçim yoktur. Bunu daha sonra servisin Ayarlar → Herkese açık adres bölümünden değiştirebilirsiniz — bkz. Servisler arası iletişim.
Kod nereden gelir
Bu projenin kodu
Aynı kod başka bir şekilde başlatılır: bir kuyruk işçisi, bir zamanlayıcı, bir WebSocket sunucusu (örneğin Laravel Reverb), bir monorepo klasörü, ayrı bir API.
- Komut zorunludur — servisin çalıştırdığı şey, örneğin
php artisan queue:workveyanode worker.js. - Bir web servisi
$PORTiçindeki portta dinlemelidir. - Bir zamanlanmış iş ayrıca cron biçiminde (UTC) bir Zamanlama gerektirir, örneğin
*/5 * * * *. - Ana servisin her yeni sürümü bu servislere de yayına alınır; böylece hep aynı kodu çalıştırırlar.
Başka bir depo
Bağlı Git hesabınızın farklı bir deposundan, kendi dalı ve gerekirse Proje klasörü ile Derleme ve başlatma komutları olan bir web servisi veya arka plan işçisi (algıladığımızı kullanmak için bir alanı boş bırakın). Kendi yayına almalarını ve sürümlerini alır ve dalına yapılan her push'u yayına alır. Servisler için henüz dal önizlemeleri yapılmaz.
Hazır bir imaj
Docker Hub, GitHub Container Registry veya başka herhangi bir kayıt deposundaki hazır bir imajdan (Docker imajı) bir web servisi veya arka plan işçisi — örneğin nginx:1.27 veya ghcr.io/org/app:tag.
- Port — imajın dinlediği port; onu
$PORTiçinde de iletiriz. - Komut — isteğe bağlı; boş bırakılırsa imaj, derlendiği şekliyle başlar.
- Özel kayıt deposu — bir kullanıcı adı ve bir şifre veya erişim token'ı. Şifrelenmiş olarak saklanır, yalnızca imajı indirmek için kullanılır ve bir daha asla gösterilmez.
- Otomatik yayına almalar açıkken etiketin daha yeni bir sürümü gösterip göstermediğini günde bir kez kontrol eder ve onu yayına alırız. Yayına almalar sekmesindeki İmajı yeniden indir bunu hemen yapar.
Kafka (şablon)
Servis ekle içindeki Kafka, tek tıklık bir hazır ayardır: resmî Apache Kafka imajından (3.9) bir servis oluşturur — ZooKeeper olmadan, KRaft modunda tek bir broker. Geliştirme ve orta düzey yükler için uygundur.
- Yalnızca dahili — herkese açık adresi ve dışarıdan erişimi yok; ona yalnızca uygulamanın servisleri ulaşır.
- Uygulamanın diğer kod servisleri
KAFKA_BROKERS=<service name>:9092veRIVERVO_<NAME>_URL=<service name>:9092alır. - Konular (topic) ilk kullanıldıklarında otomatik olarak oluşturulur.
- 1 GB bellek · 1 CPU çekirdeği · 10 GB diskle başlar. Hazır bir imajdan gelen her servis gibi kaynaklarını ve değişkenlerini değiştirebilirsiniz.
- Verileri servisin diskindeki veri klasöründe tutulur.
Neleri yoktur:
- Tek broker — replikasyon yok; her konunun replikasyon faktörü 1'dir.
- Yönetilen Kafka yedekleri yok. Günlük yedek, Kafka çalışırken veri klasörünü dosyalar olarak kopyalar. Bu tutarlı bir Kafka yedeği değildir: bir geri yüklemeden sonra son mesajlar eksik olabilir ya da Kafka başlarken loglarını kurtarması gerekebilir.
- Bakım zamanı yok, dışarıdan erişim yok ve Kafka arayüzü yok.
- Kafka'yı yükseltmek size kalmıştır: imajı servisin Ayarlar bölümünden değiştirin.
Yedekleri ve bağlantı değişkenleri sizin için ayarlanan kuyruklar ve olaylar için bkz. Olaylar ve kuyruklar — NATS ve RabbitMQ.
Birbirine adıyla ulaşmak
Bir projenin servisleri özel bir ağ üzerinden adlarıyla konuşur: api adlı bir servise diğerlerinden api olarak, db adlı bir veritabanına db olarak ve ana servise web olarak ulaşılır. Bir projenin servisleri arasındaki trafik trafik olarak sayılmaz.
Her web servisi kendi Dahili adresini gösterir — örneğin http://api:8080 — ve diğer servisler onu bir değişkende, RIVERVO_API_URL olarak alır. Nasıl çalıştığı, yalnızca dahili servisler, birkaç örnek ve zaman aşımları: Servisler arası iletişim.
Her servis projenin değişkenlerini — veritabanı bağlantısı dahil — artı projeninkilerden önce gelen kendi değişkenlerini alır. Bkz. Ortam değişkenleri.
Kaynaklar ve fiyat
Her servisin kendi Belleği, CPU'su ve Diski vardır; herhangi bir uygulama gibi fiyatlandırılır: aylık bellek GB başına ₺363,00 ve CPU çekirdeği başına ₺242,00, bellek GB'ı başına 10 GB disk dahil, sonrası GB başına ₺9,07. Bir servisin en fazla 8 GB belleği olabilir.
Bir servis eklediğinizde fiyatı projenin faturasına eklenir — içinde bulunulan ay için yalnızca kalan kısmı. Proje ücretsiz denemedeyken yeni servisler deneme bitene kadar ücretsizdir.
Genel bakış, Proje toplamını — projenin tüm servislerinin birlikte aylık maliyetini — gösterir.
Uygulamanın kendi içindeki işçiler
Her zaman ayrı bir servise ihtiyacınız olmaz. Ana uygulamanın Süreçler sekmesinde şunlar vardır:
- Arka plan işçileri — sitenin yanında en fazla 5 uzun süre çalışan süreç, örneğin bir kuyruk işçisi. Uygulamanın kaynaklarını paylaşırlar ve her yayına almada yeniden başlarlar.
- Zamanlanmış komutlar — bir zamanlamaya göre (cron biçimi, UTC) en fazla 10 komut. Çıktıları logda Zamanlama altındadır.
- Konsol — çalışan uygulamanın içinde, değişkenleri ve veritabanıyla tek seferlik bir komut çalıştırın. Bir komut en fazla 15 dakika çalışabilir; etkileşimli komutlar (tinker, bir kabuk) burada desteklenmez.
Bir işçinin kendi kaynaklarına ihtiyacı olduğunda ayrı bir servis daha iyi bir seçimdir; böylece ağır bir kuyruk siteyi asla yavaşlatmaz.
Bir servisi değiştirmek
Servisi Servisler listesinden açın. Ayarlar bölümü komutu, zamanlamayı, imajı veya dalı ve kaynaklarını içerir; değişiklikler kaydedilir ve servis onlarla yeniden başlar. Her servisin ayrıca kendi Logları ve İzlemesi vardır.