Keycloak: 4. 建立服務

本文件是使用 CLI 自動化操作指南的一部分。請在此處查看完整指南:透過 Stackhero CLI 程式化啟動 Keycloak、取得其認證資訊並變更其設定

👋 歡迎來到 Stackhero 文件中心!

Stackhero 提供 Keycloak cloud 服務,讓您只需 2 分鐘即可輕鬆部署可用於生產環境的身分識別服務:

  • 無限制的使用者、realm 及 client 數量
  • 支援 OpenID ConnectOAuth 2.0SAML 2.0、社群登入、LDAP 及 Active Directory 聯邦整合
  • 自訂網域名稱,內建 HTTPS,確保安全存取(例如 https://login.your-company.com
  • 自訂主題:透過內建線上編輯器,輕鬆自訂登入頁面、帳號主控台及電子郵件的品牌風格
  • 專屬 Email 伺服器,支援 SPF、DKIM 及 DMARC,協助您自動處理帳號確認與密碼重設
  • 內建 PostgreSQL 資料庫,管理主控台可於獨立且可關閉的連接埠上存取
  • 一鍵更新,讓您的系統隨時保持最新,無需手動操作

專注於開發,而非設定:您可以在 5 分鐘內體驗 Stackhero 的 Keycloak cloud 解決方案

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

#!/bin/bash
set -e

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

serviceStore="keycloak"   # Keycloak 服務商店名稱(見步驟 2)
instance="..."                # 步驟 3 選擇的實例規格
region="europe"               # 步驟 3 選擇的區域名稱

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

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

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

# 取得服務設定,包含自動產生的認證資訊
stackhero service-configuration-get --service="keycloak" --format=json