mu-cache

概述和主要用途

mu-cache是为JSONAPI类资源提供分布式缓存代理的服务。该服务可部署在任何理解缓存原语的微服务前端，通过缓存API请求减轻后端（如三元组存储）的负载，尤其适用于mu.semte.ch框架下的微服务架构。

核心功能与特性

• 分布式缓存协同：支持多微服务实例间的缓存状态同步，解决负载均衡场景下的缓存一致性问题
• 动态资源缓存：提供缓存键（cache keys）和清除键（clear keys）管理机制，应对JSONAPI动态URL资源的缓存挑战
• 低侵入集成：无需微服务内部实现缓存逻辑，通过独立代理服务统一管理缓存策略

使用场景和适用范围

适用于基于mu.semte.ch框架构建的微服务系统，特别是以下场景：

• 后端三元组存储面临高并发请求压力时
• 多实例负载均衡部署的微服务集群（需跨实例缓存同步）
• 提供JSONAPI风格接口的资源服务（如动态过滤、分页资源）

安装与配置

Docker Compose部署

将以下配置添加到docker-compose.yml以集成mu-cache：

yaml
services:
  cache:
    image: semtech/mu-cache:2.0.0
    links:
      - myservice:backend  # "myservice"需替换为实际后端微服务名称

兼容服务

目前已支持mu-cache的服务：

• mu-cl-resources

注：上述服务需额外配置以启用mu-cache支持，具体步骤请参考其***文档。

调试配置

通过以下环境变量可辅助调试缓存键管理：

• LOG_CACHE_KEYS：将接收到的缓存键记录到响应中
• LOG_CLEAR_KEYS：将接收到的清除键记录到响应中，或通过./mu/delta端点显式接收并记录

设计背景

在mu.semte.ch框架中，所有应用状态存储于三元组存储，虽保障了架构灵活性和微服务协作能力，但在高负载下易导致后端过载。此时缓存API请求成为关键优化手段。

由于JSONAPI接口的URL集合可能无限（如带动态参数的查询），基于URL的传统缓存清除机制难以适用，需专用缓存原语管理。此外，在多实例微服务集群（如负载均衡的mu-cl-resources）中，单实例数据更新需触发所有实例缓存清除，mu-cache作为独立缓存服务可统一处理此类跨实例缓存同步逻辑。