test: Redis CI bootstrap (#751)

Signed-off-by: cryo <[email protected]>

Author: cryo-zd

.github/workflows/test-and-build.yml

@@ -113,6 +113,11 @@ jobs:
 
           echo "Milvus is ready at localhost:19530"
           docker ps --filter "name=milvus-semantic-cache"
+      
+      - name: Start Redis service
+        run: |
+          echo "Starting Redis Stack..."
+          make start-redis
 
       - name: Run semantic router tests
         run: make test
@@ -123,6 +128,13 @@ jobs:
           LD_LIBRARY_PATH: ${{ github.workspace }}/candle-binding/target/release
           MILVUS_URI: localhost:19530
           SKIP_MILVUS_TESTS: false
+          SKIP_REDIS_TESTS: false
+
+      - name: Clean Redis service
+        if: always()
+        run: |
+          echo "Stopping Redis container and cleaning data..."
+          make clean-redis
 
       - name: Stop Milvus service
         if: always()

src/semantic-router/pkg/cache/cache_test.go

@@ -189,6 +189,94 @@ development:
 				})
 			})
 
+			Context("with Redis backend", func() {
+				var redisConfigPath string
+
+				BeforeEach(func() {
+					if os.Getenv("SKIP_REDIS_TESTS") == "true" {
+						Skip("Redis tests skipped due to SKIP_REDIS_TESTS=true")
+					}
+
+					redisConfigPath = filepath.Join(tempDir, "redis.yaml")
+					redisConfig := `
+connection:
+  host: "localhost"
+  port: 6379
+  database: 0
+  timeout: 30
+
+index:
+  name: "test_semantic_cache"
+  prefix: "doc:"
+  vector_field:
+    name: "embedding"
+    dimension: 384
+    metric_type: "COSINE"
+  index_type: "HNSW"
+  params:
+    M: 16
+    efConstruction: 64
+
+search:
+  topk: 1
+
+logging:
+  enable_query_log: false
+  enable_metrics: false
+
+development:
+  drop_index_on_startup: true
+  auto_create_index: true
+  verbose_errors: true
+`
+					err := os.WriteFile(redisConfigPath, []byte(redisConfig), 0o644)
+					Expect(err).NotTo(HaveOccurred())
+				})
+
+				It("should create Redis cache backend successfully with valid config", func() {
+					config := CacheConfig{
+						BackendType:         RedisCacheType,
+						Enabled:             true,
+						SimilarityThreshold: 0.8,
+						TTLSeconds:          3600,
+						BackendConfigPath:   redisConfigPath,
+						EmbeddingModel:      "bert",
+					}
+
+					backend, err := NewCacheBackend(config)
+
+					if err != nil {
+						if strings.Contains(err.Error(), "failed to connect to Redis") ||
+							strings.Contains(err.Error(), "connection refused") ||
+							strings.Contains(err.Error(), "failed to initialize index") {
+							Skip("Redis server not available: " + err.Error())
+						}
+						Expect(err).NotTo(HaveOccurred())
+					} else {
+						Expect(backend).NotTo(BeNil())
+						Expect(backend.IsEnabled()).To(BeTrue())
+						Expect(backend.Close()).To(Succeed())
+					}
+				})
+
+				It("should handle disabled Redis cache", func() {
+					config := CacheConfig{
+						BackendType:         RedisCacheType,
+						Enabled:             false,
+						SimilarityThreshold: 0.8,
+						TTLSeconds:          3600,
+						BackendConfigPath:   redisConfigPath,
+						EmbeddingModel:      "bert",
+					}
+
+					backend, err := NewCacheBackend(config)
+					Expect(err).NotTo(HaveOccurred())
+					Expect(backend).NotTo(BeNil())
+					Expect(backend.IsEnabled()).To(BeFalse())
+					Expect(backend.Close()).To(Succeed())
+				})
+			})
+
 			Context("Milvus connection timeouts", func() {
 				It("should respect connection timeout when endpoint is unreachable", func() {
 					unreachableConfigPath := filepath.Join(tempDir, "milvus-unreachable.yaml")

tools/make/build-run-test.mk

@@ -30,13 +30,14 @@ run-router-e2e: build-router download-models
 		./bin/router -config=config/testing/config.e2e.yaml
 
 # Unit test semantic-router
-# By default, Milvus tests are skipped. To enable them, set SKIP_MILVUS_TESTS=false
+# By default, Milvus and Redis tests are skipped. To enable them, set SKIP_MILVUS_TESTS=false and/or SKIP_REDIS_TESTS=false
 # Example: make test-semantic-router SKIP_MILVUS_TESTS=false
 test-semantic-router: ## Run unit tests for semantic-router (set SKIP_MILVUS_TESTS=false to enable Milvus tests)
 test-semantic-router: build-router
 	@$(LOG_TARGET)
 	@export LD_LIBRARY_PATH=${PWD}/candle-binding/target/release && \
 	export SKIP_MILVUS_TESTS=$${SKIP_MILVUS_TESTS:-true} && \
+	export SKIP_REDIS_TESTS=$${SKIP_REDIS_TESTS:-true} && \
 	export SR_TEST_MODE=true && \
 		cd src/semantic-router && CGO_ENABLED=1 go test -v ./...