立即開始

服務之間的通訊:內部網址與僅限內部的服務。

同一應用程式的服務如何透過內部網址互相連線、RIVERVO_<NAME>_URL 變數、沒有公開網址的服務、多個執行個體,以及逾時與重試,附 Node.js、Laravel 與 Python 範例。

2 分鐘閱讀

同一應用程式的服務會直接互相通訊,不經過網際網路。網站可以呼叫自己的 API,工作程序可以呼叫內部服務——這些流量免費:不計入流量。

以下範例使用兩個網頁服務:web 是訪客開啟的網站,設為公開網址;api 只由 web 與其他服務呼叫,設為僅限內部。

內部網址

每個網頁服務——無論擁有公開網址或僅限內部——都有格式為 http://<service-name>:<port> 的內部網址,例如 http://api:8080。它會顯示在服務頁面與應用程式的總覽中,附有複製按鈕與提示「此應用程式的其他服務可透過這裡連線——不經網際網路,不收流量費用。」

  • 從儲存庫建置的服務,連接埠為 8080;來自現成映像檔的服務,則為您設定的連接埠。
  • 只有同一應用程式的服務能連到這個網址。它無法從網際網路或其他應用程式開啟。
  • 網址使用 http://。連線保持在應用程式內部,因此不需要設定憑證。

包含網址的變數

您不需要將網址複製到程式碼中。應用程式的每個程式碼服務——網頁服務、背景工作程序與排程工作——都會取得一個變數,包含應用程式中其他每個網頁服務的內部網址:

RIVERVO_<NAME>_URL=http://<name>:<port>

NAME 是服務名稱的大寫形式,連字號會轉換為 _:

服務變數
apiRIVERVO_API_URL=http://api:8080
admin-apiRIVERVO_ADMIN_API_URL=http://admin-api:8080
webRIVERVO_WEB_URL=http://web:8080
search(來自現成映像檔,連接埠 7700)RIVERVO_SEARCH_URL=http://search:7700
  • 服務不會取得指向自己的變數。
  • 資料庫與 Valkey 保有自己的 RIVERVO_<NAME>_URL,內容為連線網址。服務名稱在應用程式內是唯一的,因此名稱永遠不會衝突。
  • 這些變數列在變數分頁的自動設定變數中。與所有自動變數一樣,您自己同名的變數(或共用變數)會取代它——請參閱環境變數。
  • 變數會在服務下次部署時生效。新增或重新命名網頁服務時,其他服務會在下次部署時取得新的或變更後的變數。請重新部署它們以套用,例如使用 rivervo deploy <app> --no-build——它會以新變數重新啟動執行中的版本,不進行新的建置。

僅限內部的服務

只由應用程式其他服務呼叫的網頁服務——網站背後的 API、管理後端、搜尋引擎——不需要放在網際網路上。請將它設為僅限內部:

公開網址僅限內部
網際網路網址 https://<name>.rivervo.app是否
您自己的網域是否
分支預覽是否
供其他服務使用的內部網址是是
多個執行個體與自動擴展、日誌、監控、健康檢查是是

僅限內部的服務與其他服務一樣執行;只有同一應用程式的其他服務能連到它。

建立服務時選擇

建立網頁服務時——包括新應用程式的第一個服務,無論來自儲存庫、範本或現成映像檔——請選擇公開網址或僅限內部。預設不會選取任何選項,因此選擇權始終在您。背景工作程序、排程工作與資料庫永遠沒有公開網址,因此不需要選擇。

在這個選項推出前建立的服務會保留其公開網址。

之後切換

服務 → 設定 → 公開網址:切換開關並確認。只有應用程式的管理員或帳戶擁有者能變更。不會有任何服務重新啟動。

  • 服務仍連接網域時,切換為僅限內部會被拒絕——請先在其網域分頁移除網域。預覽也必須先關閉。
  • 重新開啟公開網址時,服務會取得相同的 https://<name>.rivervo.app 網址。憑證可能需要約一分鐘。
  • 為僅限內部的服務新增網域會被拒絕——請先開啟其公開網址。

終端機分頁在僅限內部的服務中與其他服務一樣運作。

非同步通訊

上述呼叫都會等待回應。當服務需要交出工作後繼續進行——背景工作、多個服務都要回應的事件——請改為透過佇列或訊息代理傳送訊息:Valkey、NATS 或 RabbitMQ。請參閱事件與佇列。

多個執行個體

當您呼叫的服務執行多個執行個體時,其內部名稱會指向所有執行中的執行個體,連線會分散到各個執行個體。

保持連線開啟並重複使用的用戶端(keep-alive 連線池)可能會持續將請求送到同一個執行個體;新的連線則會重新分散。這是正常現象,不需要任何設定。

逾時與重試

在部署期間,或自動擴展停止某個執行個體時,進行中的請求可能會失敗。兩個習慣能讓服務之間的呼叫更可靠:

  • 較短的逾時——幾秒鐘,讓呼叫不會在目標執行個體停止時卡住。
  • 對可安全重複的請求——以 GET 讀取資料——重試一到兩次,並短暫暫停。除非您的 API 能區分重複請求與新請求,否則不要重複會變更資料的請求(付款、訂單)。

範例: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()

範例:Laravel

將網址放在 config/services.php 中:

'api' => [
    'url' => env('RIVERVO_API_URL'),
],

接著以 config() 讀取。在正式環境中,設定會被快取,在設定檔之外呼叫 env() 不會傳回任何值:

use Illuminate\Support\Facades\Http;
 
$orders = Http::timeout(5)
    ->retry(2, 200)
    ->get(config('services.api.url').'/orders')
    ->json();

timeout(5) 最多等待 5 秒;retry(2, 200) 最多嘗試 2 次,每次間隔 200 毫秒。

範例:Python

import os
import requests
 
API = os.environ["RIVERVO_API_URL"]
 
orders = requests.get(f"{API}/orders", timeout=5).json()

針對 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——連線錯誤或 502、503、504 回應——最多會重複 2 次,每次的暫停時間會逐漸增加。

從命令列與 Rivervo MCP

  • rivervo apps 與服務詳細資料會顯示每個網頁服務的內部網址,以及是否擁有公開網址。
  • rivervo services set-public <service> on|off 可切換公開網址。需要管理員角色與具備完整存取的權杖。
  • 在 Rivervo MCP 中,同樣的切換是 set_public_address 工具。

關於權杖與命令列,請參閱開發人員工具。

還有問題嗎?

和我們對談——AI 會立即回覆,需要時由工程師加入,全天候服務。

聯絡客服