伺服器
原始碼:github.com/tuist/tuist/tree/main/server
用途#
此伺服器驅動 Tuist 的伺服器端功能,包括身分驗證、帳號與專案管理、快取儲存、分析洞察、預覽、套件註冊中心,以及整合服務(GitHub、Slack 與 SSO)。它是一個基於 Phoenix/Elixir 的應用程式,搭配 Postgres 與 ClickHouse。
如何貢獻#
對伺服器的貢獻需要簽署 CLA(server/CLA.md)。
本機設定#
bash
cd server
mise install
# Dependencies
brew services start postgresql@16
mise run clickhouse:start
# Install dependencies + set up the database
mise run install
# Run the server
mise run dev
在瀏覽器中開啟 http://localhost:8080。在開發環境中,登入頁面包含一個 以測試使用者身分登入 按鈕,可讓你使用預先建立的帳號登入([email protected] / tuistrocks)。
Note
內部開發人員透過 fnox 從 1Password 載入開發密鑰 — mise run dev 會將伺服器包裝在 fnox exec 中(請參閱 server/fnox.toml)。外部貢獻者不需要存取 1Password;伺服器可以在沒有它的情況下於本機執行。OAuth、Stripe 與其他第三方整合將會停用,但核心功能仍可正常運作。
本機 Helm 測試#
你可以使用 kind 與內建的 mise 工作,在本機啟動完整堆疊。這會在本機建置 Docker 映像、建立 kind 叢集、安裝 Helm chart,並自動轉發所有服務的連接埠:
bash
# Deploy everything (builds images from source)
mise run helm:up --license "YOUR_LICENSE_KEY"
# Include the observability stack (Grafana, Prometheus, Loki, Tempo)
mise run helm:up --license "YOUR_LICENSE_KEY" --observability
# Check status
mise run helm:status
# Tear down
mise run helm:down
必要條件: docker、kind、helm 與 kubectl。
測試與格式化#
- 測試:
mix test - 格式化:
mise run format