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.
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:
| Servis | Değişken |
|---|---|
api | RIVERVO_API_URL=http://api:8080 |
admin-api | RIVERVO_ADMIN_API_URL=http://admin-api:8080 |
web | RIVERVO_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>_URLdeğ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-buildile — ç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 adres | Yalnızca dahili | |
|---|---|---|
İnternette adres https://<name>.rivervo.app | evet | hayır |
| Kendi alan adlarınız | evet | hayır |
| Dal önizlemeleri | evet | hayır |
| Diğer servisler için dahili adres | evet | evet |
| Birkaç örnek ve otomatik ölçeklendirme, loglar, izleme, sağlık kontrolleri | evet | evet |
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.appadresini 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 —
GETile 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 appsve 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|offherkese açık adresi değiştirir. Yönetici rolü ve Tam erişim'li bir token gerektirir.- Rivervo MCP'de aynı anahtar
set_public_addressaracıdır.
Token'lar ve komut satırı için bkz. Geliştirici araçları.