เริ่มต้นใช้งาน

การสื่อสารระหว่างเซอร์วิส: ที่อยู่ภายในและเซอร์วิสภายในเท่านั้น

วิธีที่เซอร์วิสในแอปพลิเคชันเดียวกันเข้าถึงกันผ่านที่อยู่ภายใน, ตัวแปร RIVERVO_<NAME>_URL, เซอร์วิสที่ไม่มีที่อยู่สาธารณะ, หลายอินสแตนซ์ รวมถึง timeout และการลองซ้ำ พร้อมตัวอย่างสำหรับ Node.js, Laravel และ Python

3 นาทีในการอ่าน

เซอร์วิสในแอปพลิเคชันเดียวกันสื่อสารกันโดยตรงโดยไม่ผ่านอินเทอร์เน็ต เว็บไซต์เรียก API ของตัวเองได้ worker เรียกเซอร์วิสภายในได้ และทราฟฟิกนี้ ฟรี เพราะไม่นับเป็นทราฟฟิก

ตัวอย่างด้านล่างใช้เว็บเซอร์วิสสองตัว: web คือเว็บไซต์ที่ผู้เข้าชมเปิด ตั้งเป็น ที่อยู่สาธารณะ และ api ที่มีเพียง web และเซอร์วิสอื่นเรียกใช้ ตั้งเป็น ภายในเท่านั้น

ที่อยู่ภายใน

ทุกเว็บเซอร์วิส ไม่ว่าจะมีที่อยู่สาธารณะหรือใช้ภายในเท่านั้น มี ที่อยู่ภายใน ในรูปแบบ http://<service-name>:<port> เช่น http://api:8080 แสดงอยู่ในหน้าของเซอร์วิสและใน ภาพรวม ของแอปพลิเคชัน พร้อมปุ่มคัดลอกและคำอธิบาย “เซอร์วิสอื่นของแอปพลิเคชันนี้เข้าถึงได้ที่นี่ ไม่ผ่านอินเทอร์เน็ต และไม่มีค่าทราฟฟิก”

  • พอร์ตคือ 8080 สำหรับเซอร์วิสที่ build จากรีโพสิทอรี หรือ พอร์ต ที่คุณตั้งไว้สำหรับเซอร์วิสจากอิมเมจสำเร็จรูป
  • มีเพียงเซอร์วิสในแอปพลิเคชันเดียวกันที่เข้าถึงที่อยู่นี้ได้ เปิดจากอินเทอร์เน็ตหรือจากแอปพลิเคชันอื่นไม่ได้
  • ที่อยู่ใช้ http:// การเชื่อมต่ออยู่ภายในแอปพลิเคชัน จึงไม่ต้องตั้งค่าใบรับรอง

ตัวแปรที่มีที่อยู่

คุณไม่ต้องคัดลอกที่อยู่ไปใส่ในโค้ด ทุกเซอร์วิสโค้ดของแอปพลิเคชัน ทั้งเว็บเซอร์วิส background worker และงานตามกำหนดเวลา จะได้รับตัวแปรที่มีที่อยู่ภายในของ เว็บเซอร์วิสอื่นทุกตัว ในแอปพลิเคชัน:

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 ของตัวเองที่เป็นที่อยู่การเชื่อมต่อ ชื่อเซอร์วิสไม่ซ้ำกันภายในแอปพลิเคชัน ชื่อตัวแปรจึงไม่ชนกัน
  • ตัวแปรแสดงอยู่ที่แท็บ ตัวแปร ในกลุ่ม ตั้งค่าอัตโนมัติ เช่นเดียวกับตัวแปรอัตโนมัติอื่น ตัวแปรของคุณเอง (หรือตัวแปรที่ใช้ร่วมกัน) ที่มีชื่อเดียวกันจะใช้แทน ดูที่ ตัวแปรสภาพแวดล้อม
  • ตัวแปรจะถึงเซอร์วิส เมื่อ 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 และบรรทัดคำสั่ง

ยังติดปัญหาอยู่ใช่ไหม

แชทกับเรา AI ตอบทันที และวิศวกรจะเข้ามาช่วยเมื่อจำเป็น ได้ทุกเวลา

ติดต่อฝ่ายซัพพอร์ต