Mulai sekarang

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.

6 MENIT BACA

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 _:

ServiceVariabel
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_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>_URL sendiri 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 publikHanya internal
Alamat di internet https://<name>.rivervo.appyatidak
Domain Anda sendiriyatidak
Preview branchyatidak
Alamat internal untuk service lainyaya
Beberapa instance dan penskalaan otomatis, log, monitoring, health checkyaya

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.app yang 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 apps dan detail service menampilkan alamat internal setiap web service dan apakah service memiliki alamat publik.
  • rivervo services set-public <service> on|off mengubah 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.

Masih ada kendala?

Chat dengan kami — AI langsung menjawab dan engineer bergabung bila diperlukan, kapan saja.

Hubungi dukungan