Mercure-Hub: 4. 建立服務

此文件屬於使用 CLI 自動化操作指南的一部分。請在此處查看完整指南:透過 Stackhero CLI 程式化啟動 Mercure Hub、取得其認證資料,以及變更其設定

👋 歡迎瀏覽 Stackhero 文件!

Stackhero 為您提供全託管的 Mercure-Hub cloud 服務,專為簡化和提升即時數據傳送的可靠性而設計。您將享有:

  • 無限請求及訊息大小,靈活度極高。
  • 內建 HTTPS 安全性的自訂網域(例如 https://real-time.your-company.com)。
  • 一鍵更新,輕鬆保持您的 hub 為最新狀態,無需額外操作。
  • 專屬私有基礎設施上提供高效能及強大安全性
  • 多個地區選擇:🇪🇺 歐洲🇺🇸 美國,確保低延遲傳送。

快速啟動:只需 5 分鐘即可部署您的 Mercure-Hub cloud hosting 環境,立即開始為您的應用程式推送即時更新。

以下是一個範例腳本,會建立一個 stack,將您的 Mercure Hub 服務加入其中,等待服務啟動,取得其設定(包括自動產生的認證資料),然後套用新的設定。

#!/bin/bash
set -e

export STACKHERO_TOKEN="usr-xxxxxx:your-token"

serviceStore="mercure-hub"   # Mercure Hub 服務 store 名稱(見步驟 2)
instance="..."                # 步驟 3 選擇的實例規格
region="europe"               # 步驟 3 選擇的地區名稱

# 建立服務專用的 stack(預設使用您的主要組織;如有需要可加 --organization)
stackId=$(stackhero --format=script stack-create \
  --name="My Mercure Hub stack")
echo "Stack created: ${stackId}"

# 將 Mercure Hub 加入 stack(名稱會自動解析)
serviceId=$(stackhero --format=script service-add \
  --stack="My Mercure Hub stack" \
  --service-store="${serviceStore}" \
  --instance="${instance}" \
  --region="${region}")
echo "Service added: mercure-hub"

# 等待服務完全啟動(可能需數分鐘)
stackhero service-wait-for --service="mercure-hub"

# 取得服務設定,包括自動產生的認證資料
stackhero service-configuration-get --service="mercure-hub" --format=json