Komunikasi antar-service: alamat internal dan service hanya internal.
Cara service dalam satu aplikasi saling menjangkau melalui alamat internal, variabel RIVERVO_<NAME>_URL, service tanpa alamat publik, beberapa instance, serta timeout dan retry dengan contoh untuk Node.js, Laravel, dan Python.
Service dalam satu aplikasi berkomunikasi langsung satu sama lain, tanpa melalui internet. Website dapat memanggil API-nya sendiri, worker dapat memanggil service internal — dan trafik ini gratis: tidak dihitung sebagai trafik.
Contoh di bawah menggunakan dua web service: web, website yang dibuka pengunjung, dengan Alamat publik, dan api, yang hanya dipanggil oleh web dan service lain, diatur ke Hanya internal.
Alamat internal
Setiap web service — dengan alamat publik maupun hanya internal — memiliki Alamat internal dalam format http://<service-name>:<port>, misalnya http://api:8080. Alamat ini ditampilkan di halaman service dan di Ringkasan aplikasi, dengan tombol salin dan petunjuk «Service lain dalam aplikasi ini menjangkaunya di sini — tanpa internet, tanpa biaya trafik.»
- Port-nya 8080 untuk service yang di-build dari repository, atau Port yang Anda atur untuk service dari image siap pakai.
- Hanya service dalam aplikasi yang sama yang dapat menjangkau alamat ini. Alamat ini tidak terbuka dari internet maupun dari aplikasi lain.
- Alamat menggunakan
http://. Koneksi tetap berada di dalam aplikasi, jadi tidak ada sertifikat yang perlu diatur.
Variabel berisi alamat
Anda tidak perlu menyalin alamat ke kode Anda. Setiap service kode dalam aplikasi — web service, background worker, dan scheduled job — mendapat variabel berisi alamat internal setiap web service lain dalam aplikasi:
RIVERVO_<NAME>_URL=http://<name>:<port>
NAME adalah nama service dalam huruf kapital, dengan tanda hubung diganti _:
| Service | Variabel |
|---|---|
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 (dari image siap pakai, port 7700) | RIVERVO_SEARCH_URL=http://search:7700 |
- Service tidak mendapat variabel untuk dirinya sendiri.
- Database dan Valkey tetap memiliki
RIVERVO_<NAME>_URLsendiri berisi alamat koneksi. Nama service unik dalam satu aplikasi, sehingga nama-nama ini tidak pernah bentrok. - Variabel tercantum di tab Variabel di antara variabel Diatur otomatis. Seperti semua variabel otomatis, variabel Anda sendiri (atau variabel bersama) dengan nama yang sama akan menggantikannya — lihat Variabel lingkungan.
- Variabel sampai ke service pada deploy berikutnya. Saat Anda menambahkan web service baru atau mengganti namanya, service lain mendapat variabel baru atau yang berubah pada deploy berikutnya. Deploy ulang service tersebut agar variabelnya terbaca, misalnya dengan
rivervo deploy <app> --no-build— perintah ini menjalankan ulang versi yang sedang berjalan dengan variabel baru, tanpa build baru.
Service hanya internal
Web service yang hanya dipanggil oleh service lain dalam aplikasi — API di belakang website Anda, backend admin, mesin pencari — tidak perlu berada di internet. Atur ke Hanya internal:
| Alamat publik | Hanya internal | |
|---|---|---|
Alamat di internet https://<name>.rivervo.app | ya | tidak |
| Domain Anda sendiri | ya | tidak |
| Preview branch | ya | tidak |
| Alamat internal untuk service lain | ya | ya |
| Beberapa instance dan penskalaan otomatis, log, monitoring, health check | ya | ya |
Service hanya internal berjalan seperti service lainnya; hanya service lain dalam aplikasi yang sama yang dapat menjangkaunya.
Memilih saat membuat service
Saat Anda membuat web service — termasuk service pertama aplikasi baru, dari repository, template, atau image siap pakai — pilih Alamat publik atau Hanya internal. Tidak ada yang dipilih sebelumnya, jadi pilihan selalu ada di tangan Anda. Background worker, scheduled job, dan database tidak pernah memiliki alamat publik, jadi tidak ada pilihan untuk mereka.
Service yang dibuat sebelum pilihan ini ada tetap memiliki alamat publiknya.
Mengubah nanti
Service → Pengaturan → Alamat publik: geser tombolnya dan konfirmasi. Hanya Administrator aplikasi atau pemilik akun yang dapat mengubahnya. Tidak ada yang restart.
- Beralih ke hanya internal ditolak selama service masih memiliki domain yang terhubung — hapus dulu di tab Domain-nya. Preview juga harus dimatikan lebih dulu.
- Mengaktifkan kembali alamat publik memberi service alamat
https://<name>.rivervo.appyang sama. Sertifikat bisa memerlukan sekitar satu menit. - Menambahkan domain ke service hanya internal akan ditolak — aktifkan alamat publiknya lebih dulu.
Tab Terminal berfungsi di service hanya internal sama seperti di service lainnya.
Komunikasi asinkron
Panggilan di atas menunggu jawaban. Jika service perlu menyerahkan pekerjaan lalu melanjutkan — background job, event yang ditanggapi beberapa service — kirim pesan melalui antrean atau message broker: Valkey, NATS, atau RabbitMQ. Lihat Event dan antrean.
Beberapa instance
Jika service yang Anda panggil menjalankan beberapa instance, nama internalnya mengarah ke semua instance yang berjalan, dan koneksi dibagi di antara instance tersebut.
Client yang menjaga koneksinya tetap terbuka dan menggunakannya ulang (keep-alive connection pool) bisa terus mengirim permintaan ke instance yang sama; koneksi baru akan dibagi lagi. Ini normal dan tidak perlu diatur.
Timeout dan retry
Saat deploy, atau saat penskalaan otomatis menghentikan instance, permintaan yang sedang berjalan bisa gagal. Dua kebiasaan membuat panggilan antar-service andal:
- Timeout singkat — beberapa detik, agar panggilan tidak pernah menggantung saat instance yang dituju sedang berhenti.
- Satu atau dua retry dengan jeda singkat, untuk permintaan yang aman diulang — membaca data dengan
GET. Jangan ulangi permintaan yang mengubah data (pembayaran, pesanan) kecuali API Anda dapat membedakan permintaan berulang dari permintaan baru.
Contoh: 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()Contoh: Laravel
Simpan alamat di config/services.php:
'api' => [
'url' => env('RIVERVO_API_URL'),
],Lalu baca dengan config(). Di production, konfigurasi di-cache, dan env() yang dipanggil di luar file konfigurasi tidak mengembalikan apa pun:
use Illuminate\Support\Facades\Http;
$orders = Http::timeout(5)
->retry(2, 200)
->get(config('services.api.url').'/orders')
->json();timeout(5) menunggu paling lama 5 detik; retry(2, 200) melakukan hingga 2 percobaan dengan jeda 200 ms di antaranya.
Contoh: Python
import os
import requests
API = os.environ["RIVERVO_API_URL"]
orders = requests.get(f"{API}/orders", timeout=5).json()Dengan retry untuk GET:
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()GET yang gagal — error koneksi atau jawaban 502, 503, atau 504 — diulang hingga 2 kali, dengan jeda singkat yang bertambah setiap kali.
Dari command line dan Rivervo MCP
rivervo appsdan detail service menampilkan alamat internal setiap web service dan apakah service memiliki alamat publik.rivervo services set-public <service> on|offmengubah alamat publik. Perintah ini memerlukan peran Administrator dan token dengan Akses penuh.- Di Rivervo MCP, pengaturan yang sama tersedia sebagai tool
set_public_address.
Lihat Alat developer untuk token dan command line.