Komunikasi antara perkhidmatan: alamat dalaman dan perkhidmatan dalaman sahaja.
Cara perkhidmatan dalam satu aplikasi menghubungi satu sama lain melalui alamat dalaman, pemboleh ubah RIVERVO_<NAME>_URL, perkhidmatan tanpa alamat awam, beberapa instans, serta had masa dan cubaan semula dengan contoh untuk Node.js, Laravel dan Python.
Perkhidmatan dalam satu aplikasi berkomunikasi secara terus, tanpa melalui internet. Laman web boleh memanggil API sendiri, pekerja boleh memanggil perkhidmatan dalaman — dan trafik ini percuma: ia tidak dikira sebagai trafik.
Contoh di bawah menggunakan dua perkhidmatan web: web, laman yang dibuka oleh pelawat, dengan Alamat awam, dan api, yang hanya dipanggil oleh web dan perkhidmatan lain, ditetapkan kepada Dalaman sahaja.
Alamat dalaman
Setiap perkhidmatan web — dengan alamat awam atau dalaman sahaja — mempunyai Alamat dalaman dalam bentuk http://<service-name>:<port>, contohnya http://api:8080. Ia ditunjukkan pada halaman perkhidmatan dan pada Gambaran keseluruhan aplikasi, dengan butang salin dan petunjuk «Perkhidmatan lain dalam aplikasi ini menghubunginya di sini — tanpa internet, tanpa caj trafik.»
- Port ialah 8080 untuk perkhidmatan yang dibina daripada repositori, atau Port yang anda tetapkan untuk perkhidmatan daripada imej sedia.
- Hanya perkhidmatan dalam aplikasi yang sama boleh menghubungi alamat ini. Ia tidak boleh dibuka dari internet atau daripada aplikasi lain.
- Alamat menggunakan
http://. Sambungan kekal di dalam aplikasi, jadi tiada sijil yang perlu disediakan.
Pemboleh ubah dengan alamat
Anda tidak perlu menyalin alamat ke dalam kod anda. Setiap perkhidmatan kod dalam aplikasi — perkhidmatan web, pekerja latar belakang dan tugas berjadual — mendapat pemboleh ubah dengan alamat dalaman setiap perkhidmatan web lain dalam aplikasi:
RIVERVO_<NAME>_URL=http://<name>:<port>
NAME ialah nama perkhidmatan dalam huruf besar, dengan sengkang ditukar kepada _:
| Perkhidmatan | Pemboleh ubah |
|---|---|
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 (daripada imej sedia, port 7700) | RIVERVO_SEARCH_URL=http://search:7700 |
- Perkhidmatan tidak mendapat pemboleh ubah untuk dirinya sendiri.
- Pangkalan data dan Valkey mengekalkan
RIVERVO_<NAME>_URLmereka sendiri dengan alamat sambungan. Nama perkhidmatan adalah unik dalam aplikasi, jadi nama tidak pernah bertembung. - Pemboleh ubah disenaraikan pada tab Pemboleh ubah dalam kalangan pemboleh ubah Ditetapkan secara automatik. Seperti setiap pemboleh ubah automatik, pemboleh ubah anda sendiri (atau pemboleh ubah kongsi) dengan nama yang sama akan menggantikannya — lihat Pemboleh ubah persekitaran.
- Pemboleh ubah sampai ke perkhidmatan pada deploy seterusnya. Apabila anda menambah perkhidmatan web baharu atau menamakan semula satu, perkhidmatan lain mendapat pemboleh ubah baharu atau yang diubah pada deploy seterusnya. Deploy semula perkhidmatan tersebut supaya ia menerimanya, contohnya dengan
rivervo deploy <app> --no-build— ia memulakan semula versi yang sedang berjalan dengan pemboleh ubah baharu, tanpa binaan baharu.
Perkhidmatan dalaman sahaja
Perkhidmatan web yang hanya dipanggil oleh perkhidmatan lain dalam aplikasi — API di belakang laman web anda, backend pentadbir, enjin carian — tidak perlu berada di internet. Tetapkannya kepada Dalaman sahaja:
| Alamat awam | Dalaman sahaja | |
|---|---|---|
Alamat di internet https://<name>.rivervo.app | ya | tidak |
| Domain anda sendiri | ya | tidak |
| Pratonton cawangan | ya | tidak |
| Alamat dalaman untuk perkhidmatan lain | ya | ya |
| Beberapa instans dan penskalaan automatik, log, pemantauan, semakan kesihatan | ya | ya |
Perkhidmatan dalaman sahaja berjalan seperti perkhidmatan lain; hanya perkhidmatan lain dalam aplikasi yang sama boleh menghubunginya.
Memilih semasa mencipta perkhidmatan
Apabila anda mencipta perkhidmatan web — termasuk perkhidmatan pertama aplikasi baharu, daripada repositori, templat atau imej sedia — pilih Alamat awam atau Dalaman sahaja. Tiada apa-apa yang dipilih terlebih dahulu, jadi pilihan sentiasa di tangan anda. Pekerja latar belakang, tugas berjadual dan pangkalan data tidak pernah mempunyai alamat awam, jadi tiada pilihan untuknya.
Perkhidmatan yang dicipta sebelum pilihan ini wujud mengekalkan alamat awamnya.
Menukar kemudian
Perkhidmatan → Tetapan → Alamat awam: tukar suis dan sahkan. Hanya Pentadbir aplikasi atau pemilik akaun boleh menukarnya. Tiada apa-apa dimulakan semula.
- Menukar kepada dalaman sahaja ditolak selagi perkhidmatan mempunyai domain yang disambungkan — buang domain itu pada tab Domain perkhidmatan dahulu. Pratonton juga mesti dimatikan dahulu.
- Menghidupkan semula alamat awam memberi perkhidmatan alamat
https://<name>.rivervo.appyang sama. Sijil mungkin mengambil masa kira-kira seminit. - Menambah domain pada perkhidmatan dalaman sahaja ditolak — hidupkan alamat awamnya dahulu.
Tab Terminal berfungsi dalam perkhidmatan dalaman sahaja sama seperti dalam perkhidmatan lain.
Komunikasi tak segerak
Panggilan di atas menunggu jawapan. Apabila perkhidmatan perlu menyerahkan kerja dan meneruskan tugasnya — tugas latar belakang, peristiwa yang ditindak balas oleh beberapa perkhidmatan — hantar mesej melalui baris gilir atau broker mesej: Valkey, NATS atau RabbitMQ. Lihat Peristiwa dan baris gilir.
Beberapa instans
Apabila perkhidmatan yang anda panggil menjalankan beberapa instans, nama dalamannya membawa kepada semua instans yang sedang berjalan, dan sambungan diagihkan antara instans tersebut.
Klien yang mengekalkan sambungan terbuka dan menggunakannya semula (keep-alive connection pool) mungkin terus menghantar permintaannya ke instans yang sama; sambungan baharu diagihkan semula. Ini normal dan tidak memerlukan sebarang tetapan.
Had masa dan cubaan semula
Semasa deploy, atau apabila penskalaan automatik menghentikan instans, permintaan yang sedang berjalan boleh gagal. Dua amalan menjadikan panggilan antara perkhidmatan boleh dipercayai:
- Had masa yang singkat — beberapa saat, supaya panggilan tidak tergantung semasa instans yang dituju sedang berhenti.
- Satu atau dua cubaan semula dengan jeda singkat, untuk permintaan yang selamat diulang — membaca data dengan
GET. Jangan ulang permintaan yang mengubah data (bayaran, pesanan) melainkan API anda boleh membezakan permintaan berulang daripada permintaan baharu.
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
Letakkan alamat dalam config/services.php:
'api' => [
'url' => env('RIVERVO_API_URL'),
],Kemudian bacanya dengan config(). Dalam produksi, konfigurasi di-cache, dan env() yang dipanggil di luar fail konfigurasi tidak memulangkan apa-apa:
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 saat; retry(2, 200) membuat sehingga 2 percubaan dengan 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 cubaan semula 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 — ralat sambungan atau jawapan 502, 503 atau 504 — diulang sehingga 2 kali, dengan jeda singkat yang semakin panjang setiap kali.
Daripada baris arahan dan Rivervo MCP
rivervo appsdan butiran perkhidmatan menunjukkan alamat dalaman setiap perkhidmatan web dan sama ada ia mempunyai alamat awam.rivervo services set-public <service> on|offmenukar alamat awam. Ia memerlukan peranan Pentadbir dan token dengan Akses penuh.- Dalam Rivervo MCP, suis yang sama ialah alat
set_public_address.
Lihat Alat pembangun untuk token dan baris arahan.