Hemen başlayın

Servisler arası iletişim: dahili adresler ve yalnızca dahili servisler.

Bir uygulamanın servisleri dahili adres üzerinden birbirine nasıl ulaşır, RIVERVO_<NAME>_URL değişkenleri, herkese açık adresi olmayan servisler, birkaç örnek ve Node.js, Laravel ve Python örnekleriyle zaman aşımları ve yeniden denemeler.

5 DK OKUMA

Bir uygulamanın servisleri internetten geçmeden doğrudan birbiriyle konuşur. Bir site kendi API'sini, bir işçi dahili bir servisi çağırabilir — ve bu trafik ücretsizdir: trafik olarak sayılmaz.

Aşağıdaki örnekler iki web servisi kullanır: ziyaretçilerin açtığı, Herkese açık adresi olan web ve yalnızca web ile diğer servislerin çağırdığı, Yalnızca dahili olarak ayarlanmış api.

Dahili adres

Her web servisinin — herkese açık adresli veya yalnızca dahili — http://<service-name>:<port> biçiminde bir Dahili adresi vardır, örneğin http://api:8080. Servisin sayfasında ve uygulamanın Genel bakış bölümünde, bir kopyalama düğmesi ve «Bu uygulamanın diğer servisleri ona buradan ulaşır — internet yok, trafik ücreti yok.» ipucuyla gösterilir.

  • Port, bir depodan derlenen servis için 8080, hazır bir imajdan gelen servis için belirlediğiniz Port'tur.
  • Bu adrese yalnızca aynı uygulamanın servisleri ulaşabilir. İnternetten veya diğer uygulamalardan açılmaz.
  • Adres http:// kullanır. Bağlantı uygulamanın içinde kalır; bu yüzden kurulacak bir sertifika yoktur.

Adresleri içeren değişkenler

Adresleri kodunuza kopyalamanız gerekmez. Uygulamanın her kod servisi — web servisleri, arka plan işçileri ve zamanlanmış işler — uygulamanın diğer her web servisinin dahili adresini içeren bir değişken alır:

RIVERVO_<NAME>_URL=http://<name>:<port>

NAME, servisin büyük harflerle yazılmış, tireleri _ yapılmış adıdır:

ServisDeğişken
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_WEB_URL=http://web:8080
search (hazır bir imajdan, port 7700)RIVERVO_SEARCH_URL=http://search:7700
  • Bir servis kendisi için değişken almaz.
  • Veritabanları ve Valkey, bağlantı adresiyle kendi RIVERVO_<NAME>_URL değişkenlerini korur. Servis adları bir uygulama içinde benzersizdir; bu yüzden adlar asla çakışmaz.
  • Değişkenler Değişkenler sekmesinde Otomatik ayarlananlar arasında listelenir. Her otomatik değişkende olduğu gibi aynı adlı kendi değişkeniniz (veya ortak bir değişken) onun yerini alır — bkz. Ortam değişkenleri.
  • Değişkenler bir servise bir sonraki yayına almasıyla ulaşır. Yeni bir web servisi eklediğinizde veya birini yeniden adlandırdığınızda diğer servisler yeni veya değişen değişkeni bir sonraki yayına almalarında alır. Almaları için onları yeniden yayına alın, örneğin rivervo deploy <app> --no-build ile — çalışan sürümü yeni bir derleme yapmadan yeni değişkenlerle yeniden başlatır.

Yalnızca dahili servisler

Yalnızca uygulamanın diğer servislerinin çağırdığı bir web servisinin — sitenizin arkasındaki bir API, bir yönetim backend'i, bir arama motoru — internette olması gerekmez. Onu Yalnızca dahili olarak ayarlayın:

Herkese açık adresYalnızca dahili
İnternette adres https://<name>.rivervo.appevethayır
Kendi alan adlarınızevethayır
Dal önizlemelerievethayır
Diğer servisler için dahili adresevetevet
Birkaç örnek ve otomatik ölçeklendirme, loglar, izleme, sağlık kontrollerievetevet

Yalnızca dahili bir servis diğer servisler gibi çalışır; ona yalnızca aynı uygulamanın diğer servisleri ulaşabilir.

Bir servis oluştururken seçmek

Bir web servisi oluşturduğunuzda — bir depodan, bir şablondan veya hazır bir imajdan yeni bir uygulamanın ilk servisi dahil — Herkese açık adres veya Yalnızca dahili'yi seçin. Önceden hiçbir şey seçili değildir; bu yüzden seçim her zaman sizindir. Arka plan işçilerinin, zamanlanmış işlerin ve veritabanlarının asla herkese açık adresi olmaz; bu yüzden onlar için seçim yoktur.

Bu seçim var olmadan önce oluşturulan servisler herkese açık adreslerini korur.

Sonradan değiştirmek

Servis → Ayarlar → Herkese açık adres: anahtarı çevirin ve onaylayın. Bunu yalnızca uygulamanın bir Yöneticisi veya hesap sahibi değiştirebilir. Hiçbir şey yeniden başlamaz.

  • Servisin bağlı alan adları varken yalnızca dahiliye geçiş reddedilir — önce onları Alan adları sekmesinden kaldırın. Önizlemelerin de önce kapatılması gerekir.
  • Herkese açık adresi yeniden açmak, servise aynı https://<name>.rivervo.app adresini verir. Sertifika yaklaşık bir dakika sürebilir.
  • Yalnızca dahili bir servise alan adı eklemek reddedilir — önce herkese açık adresini açın.

Terminal sekmesi yalnızca dahili bir serviste diğerlerinde olduğu gibi çalışır.

Eşzamansız iletişim

Yukarıdaki çağrılar bir yanıt bekler. Bir servisin işi devredip devam etmesi gerektiğinde — arka plan işleri, birkaç servisin tepki verdiği olaylar — bunun yerine mesajları bir kuyruk veya bir mesaj aracısı üzerinden gönderin: Valkey, NATS veya RabbitMQ. Bkz. Olaylar ve kuyruklar.

Birkaç örnek

Çağırdığınız servis birkaç örnekle çalıştığında dahili adı tüm çalışan örneklerine çıkar ve bağlantılar aralarında dağıtılır.

Bağlantılarını açık tutup yeniden kullanan bir istemci (keep-alive bağlantı havuzu) isteklerini aynı örneğe göndermeye devam edebilir; yeni bağlantılar yeniden dağıtılır. Bu normaldir ve kurulum gerektirmez.

Zaman aşımları ve yeniden denemeler

Bir yayına alma sırasında ya da otomatik ölçeklendirme bir örneği durdurduğunda, devam eden bir istek başarısız olabilir. İki alışkanlık servisler arasındaki çağrıları güvenilir yapar:

  • Kısa bir zaman aşımı — birkaç saniye; böylece bir çağrı, gittiği örnek dururken asla takılı kalmaz.
  • Tekrarlanması güvenli istekler için — GET ile veri okumak — kısa bir duraklamayla bir iki yeniden deneme. API'niz tekrarlanan bir isteği yenisinden ayırt edemiyorsa veriyi değiştiren istekleri (ödemeler, siparişler) tekrarlamayın.

Örnek: Node.js

const api = process.env.RIVERVO_API_URL
 
async function getWithRetry(url, attempts = 3) {
  for (let i = 1; ; i++) {
    try {
      const res = await fetch(url, { signal: AbortSignal.timeout(5000) })
      if (res.status < 500 || i === attempts) return res
    } catch (err) {
      if (i === attempts) throw err
    }
    await new Promise((resolve) => setTimeout(resolve, 200 * i))
  }
}
 
const res = await getWithRetry(`${api}/orders`)
const orders = await res.json()

Örnek: Laravel

Adresi config/services.php dosyasına koyun:

'api' => [
    'url' => env('RIVERVO_API_URL'),
],

Ardından onu config() ile okuyun. Üretimde yapılandırma önbelleğe alınır ve yapılandırma dosyalarının dışında çağrılan env() hiçbir şey döndürmez:

use Illuminate\Support\Facades\Http;
 
$orders = Http::timeout(5)
    ->retry(2, 200)
    ->get(config('services.api.url').'/orders')
    ->json();

timeout(5) en fazla 5 saniye bekler; retry(2, 200) aralarında 200 ms olacak şekilde en fazla 2 deneme yapar.

Örnek: Python

import os
import requests
 
API = os.environ["RIVERVO_API_URL"]
 
orders = requests.get(f"{API}/orders", timeout=5).json()

GET için yeniden denemelerle:

import os
import requests
from requests.adapters import HTTPAdapter
from urllib3.util.retry import Retry
 
API = os.environ["RIVERVO_API_URL"]
 
session = requests.Session()
retry = Retry(total=2, backoff_factor=0.2, allowed_methods=["GET"], status_forcelist=[502, 503, 504])
session.mount("http://", HTTPAdapter(max_retries=retry))
 
orders = session.get(f"{API}/orders", timeout=5).json()

Başarısız bir GET — bir bağlantı hatası veya 502, 503 ya da 504 yanıtı — her seferinde uzayan kısa bir duraklamayla en fazla 2 kez tekrarlanır.

Komut satırından ve Rivervo MCP'den

  • rivervo apps ve servis ayrıntıları, her web servisinin dahili adresini ve herkese açık adresi olup olmadığını gösterir.
  • rivervo services set-public <service> on|off herkese açık adresi değiştirir. Yönetici rolü ve Tam erişim'li bir token gerektirir.
  • Rivervo MCP'de aynı anahtar set_public_address aracıdır.

Token'lar ve komut satırı için bkz. Geliştirici araçları.

Hâlâ takıldınız mı?

Bizimle sohbet edin — AI hemen yanıt verir, gerektiğinde günün her saati bir mühendis katılır.

Destekle iletişime geçin