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 服務商店名稱(見步驟 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