v1.0.0

快速開始

最後更新


本頁說明安裝 go-redis-fallback、建立第一個實例,並完成一次讀寫。

前置需求


項目需求
Go1.24.3 或以上(依 go.mod)
Redis任一可連線的 Redis 伺服器;執行期間可以失聯
檔案系統對 Options.DBPath(預設 ./files/redisFallback/db)與 Log.Path(預設 ./logs/redisFallback)具寫入權限

安裝


  1. go get github.com/pardnchiu/go-redis-fallback

套件名稱為 redisFallback,import 路徑為 github.com/pardnchiu/go-redis-fallback。

第一次執行


  1. package main
  2. import (
  3. "fmt"
  4. "log"
  5. "os"
  6. "path/filepath"
  7. "strconv"
  8. "time"
  9. redisFallback "github.com/pardnchiu/go-redis-fallback"
  10. )
  11. func main() {
  12. dbPath := "./files/redisFallback/db"
  13. db := 0
  14. // 首次啟動必須先建立 {DBPath}/{DB},否則實例不會進入正常模式
  15. if err := os.MkdirAll(filepath.Join(dbPath, strconv.Itoa(db)), 0755); err != nil {
  16. log.Fatal(err)
  17. }
  18. rf, err := redisFallback.New(redisFallback.Config{
  19. Redis: &redisFallback.Redis{Host: "localhost", Port: 6379, DB: db},
  20. Option: &redisFallback.Options{DBPath: dbPath},
  21. })
  22. if err != nil {
  23. log.Fatal(err)
  24. }
  25. defer rf.Close()
  26. if err := rf.Set("greeting", "hello", 10*time.Minute); err != nil {
  27. log.Fatal(err)
  28. }
  29. value, err := rf.Get("greeting")
  30. if err != nil {
  31. log.Fatal(err)
  32. }
  33. fmt.Println(value) // hello
  34. }

確認目前模式


函式庫沒有公開查詢模式的 API,模式切換記錄在日誌中:
日誌({Log.Path}/output.log)意義
Starting normal mode啟動時 Ping 成功,開始恢復流程
[getFromRedis] Switching to fallback mode讀取重試用盡,切入 fallback 模式
[setToRedis] Switching to fallback mode寫入重試用盡,切入 fallback 模式

啟動時 Ping 失敗則記錄在 error.log:Failed to connect, Starting fallback mode。

下一步


EN