Mulakan

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.

6 MIN BACAAN

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

PerkhidmatanPemboleh ubah
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_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>_URL mereka 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 awamDalaman sahaja
Alamat di internet https://<name>.rivervo.appyatidak
Domain anda sendiriyatidak
Pratonton cawanganyatidak
Alamat dalaman untuk perkhidmatan lainyaya
Beberapa instans dan penskalaan automatik, log, pemantauan, semakan kesihatanyaya

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.

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.app yang 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 apps dan butiran perkhidmatan menunjukkan alamat dalaman setiap perkhidmatan web dan sama ada ia mempunyai alamat awam.
  • rivervo services set-public <service> on|off menukar 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.

Masih perlukan bantuan?

Bersembang dengan kami — AI menjawab serta-merta dan jurutera menyertai apabila perlu, pada bila-bila masa.

Hubungi sokongan