跳到內容
FortressFlag Docs

Go 快速入門

幾分鐘之內，你的 Go 服務就會在行程內評估 feature flags：每次檢查不走網路、你的請求路徑上沒有延遲，一次輪詢服務你的行程處理的每一個請求。

零執行期相依：SDK 的 require 區塊是空的，而且會一直保持這樣。

1. 安裝

Section titled “1. 安裝”

這個 SDK 放在 GitHub 上的公開儲存庫裡，直接從那裡安裝，並固定在發布版本：

Terminal window
go get github.com/FortressFlag/FortressFlag_SDK_go@v1.0.0

2. 伺服器金鑰：貨真價實的機密

Section titled “2. 伺服器金鑰：貨真價實的機密”

這個 SDK 使用伺服器金鑰（ffs_…），它和行動與 Web SDK 隨附出貨的用戶端金鑰正好相反：它可以下載你的完整 ruleset，包含鎖定規則。把它完全當成資料庫密碼來對待：環境變數或機密管理器，永遠不放進程式碼、永遠不放進儲存庫、永遠不放進日誌。兩類金鑰，並排比較。

3. 啟動用戶端

Section titled “3. 啟動用戶端”
package main


import (
  "context"
  "os"
  "time"


  fortressflag "github.com/FortressFlag/FortressFlag_SDK_go"
)


func main() {
  client, err := fortressflag.New(fortressflag.Configuration{
    Key: os.Getenv("FF_SERVER_KEY"),
  })
  if err != nil {
    // SDK 唯一可能出錯的地方：格式錯誤的設定，
    // 在任何東西開始提供之前。
    panic(err)
  }
  defer client.Close()


  startCtx, cancel := context.WithTimeout(context.Background(), 15*time.Second)
  client.Start(startCtx) // 阻塞直到第一份 ruleset 到達（或 context 結束）
  cancel()


  // ... 你的服務執行；flag 檢查現在是記憶體內的函式呼叫。
}

Start 永遠不會回傳致命錯誤：如果第一次抓取無法及時完成，用戶端會在背景持續重試，而你的呼叫者在此期間拿到他們的預設值。

4. 評估一個 flag

Section titled “4. 評估一個 flag”
enabled := client.Bool("new-checkout", fortressflag.Context{
  Key:  "user-42", // 你的穩定內容鍵：使用者 id、工作階段 id，由你決定
  Tags: map[string]string{"cohort": "beta"},
}, false) // flag 未知或從未抓取到任何東西時的回退值

client.String 和 client.Number 的用法一樣。內容 Key 是百分比發布分桶的依據：始終傳入同一個識別碼，每位使用者就會得到穩定的分群。那是你的資料：SDK 永遠不驗證、不儲存、也不記錄它。

就這樣，你的服務正在本地評估 flag。儀表板的變更會在大約一分鐘內送達每一個行程。

評估永遠不會失敗

Section titled “評估永遠不會失敗”

Bool、String 和 Number 永遠會回答，永遠不會 panic：flag 出問題絕不能拖垮你的服務。重新啟動的行程在第一次抓取完成之前提供你呼叫處的回退值（或者在設定裡指定 CachePath，把最後一份 ruleset 持久化到你選的檔案，重新啟動就會立即從它恢復）。就連被撤銷的金鑰也不會弄壞任何東西：SDK 會繼續用它最後下載的 ruleset 評估，直到你交給它一把新金鑰。

接下來

Section titled “接下來”