การสื่อสารระหว่างเซอร์วิส: ที่อยู่ภายในและเซอร์วิสภายในเท่านั้น
วิธีที่เซอร์วิสในแอปพลิเคชันเดียวกันเข้าถึงกันผ่านที่อยู่ภายใน, ตัวแปร RIVERVO_<NAME>_URL, เซอร์วิสที่ไม่มีที่อยู่สาธารณะ, หลายอินสแตนซ์ รวมถึง timeout และการลองซ้ำ พร้อมตัวอย่างสำหรับ Node.js, Laravel และ Python
เซอร์วิสในแอปพลิเคชันเดียวกันสื่อสารกันโดยตรงโดยไม่ผ่านอินเทอร์เน็ต เว็บไซต์เรียก API ของตัวเองได้ worker เรียกเซอร์วิสภายในได้ และทราฟฟิกนี้ ฟรี เพราะไม่นับเป็นทราฟฟิก
ตัวอย่างด้านล่างใช้เว็บเซอร์วิสสองตัว: web คือเว็บไซต์ที่ผู้เข้าชมเปิด ตั้งเป็น ที่อยู่สาธารณะ และ api ที่มีเพียง web และเซอร์วิสอื่นเรียกใช้ ตั้งเป็น ภายในเท่านั้น
ที่อยู่ภายใน
ทุกเว็บเซอร์วิส ไม่ว่าจะมีที่อยู่สาธารณะหรือใช้ภายในเท่านั้น มี ที่อยู่ภายใน ในรูปแบบ http://<service-name>:<port> เช่น http://api:8080 แสดงอยู่ในหน้าของเซอร์วิสและใน ภาพรวม ของแอปพลิเคชัน พร้อมปุ่มคัดลอกและคำอธิบาย “เซอร์วิสอื่นของแอปพลิเคชันนี้เข้าถึงได้ที่นี่ ไม่ผ่านอินเทอร์เน็ต และไม่มีค่าทราฟฟิก”
- พอร์ตคือ 8080 สำหรับเซอร์วิสที่ build จากรีโพสิทอรี หรือ พอร์ต ที่คุณตั้งไว้สำหรับเซอร์วิสจากอิมเมจสำเร็จรูป
- มีเพียงเซอร์วิสในแอปพลิเคชันเดียวกันที่เข้าถึงที่อยู่นี้ได้ เปิดจากอินเทอร์เน็ตหรือจากแอปพลิเคชันอื่นไม่ได้
- ที่อยู่ใช้
http://การเชื่อมต่ออยู่ภายในแอปพลิเคชัน จึงไม่ต้องตั้งค่าใบรับรอง
ตัวแปรที่มีที่อยู่
คุณไม่ต้องคัดลอกที่อยู่ไปใส่ในโค้ด ทุกเซอร์วิสโค้ดของแอปพลิเคชัน ทั้งเว็บเซอร์วิส background worker และงานตามกำหนดเวลา จะได้รับตัวแปรที่มีที่อยู่ภายในของ เว็บเซอร์วิสอื่นทุกตัว ในแอปพลิเคชัน:
RIVERVO_<NAME>_URL=http://<name>:<port>
NAME คือชื่อเซอร์วิสเป็นตัวพิมพ์ใหญ่ โดยเปลี่ยนขีดกลางเป็น _:
| เซอร์วิส | ตัวแปร |
|---|---|
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 (จากอิมเมจสำเร็จรูป พอร์ต 7700) | RIVERVO_SEARCH_URL=http://search:7700 |
- เซอร์วิสจะไม่ได้รับตัวแปรของตัวเอง
- ฐานข้อมูลและ Valkey มี
RIVERVO_<NAME>_URLของตัวเองที่เป็นที่อยู่การเชื่อมต่อ ชื่อเซอร์วิสไม่ซ้ำกันภายในแอปพลิเคชัน ชื่อตัวแปรจึงไม่ชนกัน - ตัวแปรแสดงอยู่ที่แท็บ ตัวแปร ในกลุ่ม ตั้งค่าอัตโนมัติ เช่นเดียวกับตัวแปรอัตโนมัติอื่น ตัวแปรของคุณเอง (หรือตัวแปรที่ใช้ร่วมกัน) ที่มีชื่อเดียวกันจะใช้แทน ดูที่ ตัวแปรสภาพแวดล้อม
- ตัวแปรจะถึงเซอร์วิส เมื่อ deploy ครั้งถัดไป เมื่อคุณเพิ่มเว็บเซอร์วิสใหม่หรือเปลี่ยนชื่อ เซอร์วิสอื่นจะได้รับตัวแปรใหม่หรือที่เปลี่ยนแปลงเมื่อ deploy ครั้งถัดไป ให้ deploy อีกครั้งเพื่อให้ได้รับค่าใหม่ เช่น
rivervo deploy <app> --no-buildซึ่งเริ่มเวอร์ชันที่กำลังทำงานใหม่ด้วยตัวแปรใหม่โดยไม่ build ใหม่
เซอร์วิสภายในเท่านั้น
เว็บเซอร์วิสที่มีเพียงเซอร์วิสอื่นของแอปพลิเคชันเรียกใช้ เช่น API เบื้องหลังเว็บไซต์ ระบบหลังบ้านของผู้ดูแล หรือ search engine ไม่จำเป็นต้องอยู่บนอินเทอร์เน็ต ให้ตั้งเป็น ภายในเท่านั้น:
| ที่อยู่สาธารณะ | ภายในเท่านั้น | |
|---|---|---|
ที่อยู่บนอินเทอร์เน็ต https://<name>.rivervo.app | มี | ไม่มี |
| โดเมนของคุณเอง | มี | ไม่มี |
| Branch preview | มี | ไม่มี |
| ที่อยู่ภายในสำหรับเซอร์วิสอื่น | มี | มี |
| หลายอินสแตนซ์และการปรับขนาดอัตโนมัติ ล็อก การมอนิเตอร์ health check | มี | มี |
เซอร์วิสภายในเท่านั้นทำงานเหมือนเซอร์วิสอื่นทุกประการ เพียงแต่มีเฉพาะเซอร์วิสอื่นในแอปพลิเคชันเดียวกันที่เข้าถึงได้
เลือกตอนสร้างเซอร์วิส
เมื่อสร้าง เว็บเซอร์วิส รวมถึงเซอร์วิสแรกของแอปพลิเคชันใหม่ ไม่ว่าจากรีโพสิทอรี เทมเพลต หรืออิมเมจสำเร็จรูป ให้เลือก ที่อยู่สาธารณะ หรือ ภายในเท่านั้น ระบบไม่ได้เลือกไว้ล่วงหน้า คุณจึงเป็นผู้เลือกเสมอ background worker งานตามกำหนดเวลา และฐานข้อมูลไม่มีที่อยู่สาธารณะ จึงไม่มีให้เลือก
เซอร์วิสที่สร้างก่อนมีตัวเลือกนี้จะยังคงมีที่อยู่สาธารณะ
เปลี่ยนภายหลัง
เซอร์วิส → การตั้งค่า → ที่อยู่สาธารณะ: กดสวิตช์แล้วยืนยัน มีเพียง ผู้ดูแล ของแอปพลิเคชันหรือเจ้าของบัญชีที่เปลี่ยนได้ ไม่มีอะไรรีสตาร์ท
- การเปลี่ยนเป็นภายในเท่านั้น จะถูกปฏิเสธหากเซอร์วิสยังเชื่อมต่อโดเมนอยู่ ให้ลบโดเมนที่แท็บ โดเมน ก่อน และต้องปิด preview ก่อนด้วย
- การเปิดที่อยู่สาธารณะอีกครั้ง จะให้เซอร์วิสได้ที่อยู่
https://<name>.rivervo.appเดิม ใบรับรองอาจใช้เวลาประมาณหนึ่งนาที - การเพิ่มโดเมนให้เซอร์วิสภายในเท่านั้นจะถูกปฏิเสธ ให้เปิดที่อยู่สาธารณะก่อน
แท็บ เทอร์มินัล ในเซอร์วิสภายในเท่านั้นทำงานเหมือนในเซอร์วิสอื่นทุกประการ
การสื่อสารแบบอะซิงโครนัส
การเรียกข้างต้นรอคำตอบ เมื่อเซอร์วิสควรส่งงานต่อแล้วทำงานอื่นต่อไป เช่น งานเบื้องหลัง หรือ event ที่หลายเซอร์วิสต้องตอบสนอง ให้ส่งข้อความผ่านคิวหรือ message broker แทน ได้แก่ Valkey, NATS หรือ RabbitMQ ดูที่ Event และคิว
หลายอินสแตนซ์
เมื่อเซอร์วิสที่คุณเรียกทำงานหลาย อินสแตนซ์ ชื่อภายในจะชี้ไปยังทุกอินสแตนซ์ที่กำลังทำงาน และการเชื่อมต่อจะถูกกระจายไปยังอินสแตนซ์เหล่านั้น
client ที่เปิดการเชื่อมต่อค้างไว้และใช้ซ้ำ (keep-alive connection pool) อาจส่งคำขอไปยังอินสแตนซ์เดิมต่อไป การเชื่อมต่อใหม่จะถูกกระจายอีกครั้ง ซึ่งเป็นเรื่องปกติและไม่ต้องตั้งค่าใด ๆ
Timeout และการลองซ้ำ
ระหว่างการ deploy หรือเมื่อการปรับขนาดอัตโนมัติหยุดอินสแตนซ์ คำขอที่กำลังดำเนินอยู่อาจล้มเหลวได้ สองแนวทางนี้ช่วยให้การเรียกระหว่างเซอร์วิสเชื่อถือได้:
- Timeout สั้น ๆ — ไม่กี่วินาที เพื่อไม่ให้การเรียกค้างอยู่ขณะที่อินสแตนซ์ปลายทางกำลังหยุด
- ลองซ้ำหนึ่งหรือสองครั้ง โดยเว้นช่วงสั้น ๆ สำหรับคำขอที่ทำซ้ำได้อย่างปลอดภัย คือการอ่านข้อมูลด้วย
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() ใน production การตั้งค่าจะถูกแคชไว้ และ 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 ms
ตัวอย่าง: 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เปิดหรือปิดที่อยู่สาธารณะ ต้องมีบทบาทผู้ดูแลและ token ระดับ เข้าถึงเต็มรูปแบบ- ใน Rivervo MCP สวิตช์เดียวกันนี้คือเครื่องมือ
set_public_address
ดูที่ เครื่องมือสำหรับนักพัฒนา สำหรับ token และบรรทัดคำสั่ง