gomomento/momento-local Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

momento-local 镜像文档

概述

momento-local是一个本地模拟服务器，用于测试Momento Cache和Momento Topics服务。它允许开发者在CI流程或单元测试中模拟Momento服务的行为，无需连接实际云服务，支持测试正常流程和错误场景。

核心功能与特性

• 模拟Momento Cache和Topics服务的核心功能
• 支持配置错误返回（如指定RPC方法返回错误）
• 支持配置响应延迟（模拟网络延迟）
• 提供测试管理接口，可控制Topics订阅保活机制
• 轻量级本地部署，适合CI/CD流程集成
• 支持amd64和arm64架构

使用场景

• Momento客户端SDK的单元测试
• CI/CD流程中的集成测试
• 客户端错误处理逻辑验证
• 网络延迟和重试机制测试
• Topics订阅稳定性测试

使用方法

基本启动

默认端口（8080）启动服务：

bash
docker run -p 8080:8080 gomomento/momento-local

指定平台（如在Apple Silicon上运行amd64架构）：

bash
docker run --platform=linux/amd64 -p 8080:8080 gomomento/momento-local

测试客户端配置

在测试中，配置CacheClient和TopicClient使用本地端点：

javascript
const cacheClient = await CacheClient.create({
    credentialProvider: CredentialProvider.forMomentoLocal({
      port: 8080,
    }),
    defaultTtlSeconds: 60,
});

const topicClient = await TopicClient.create({
    credentialProvider: CredentialProvider.forMomentoLocal({
      port: 8080,
    }),
});

注意：CredentialProvider.forMomentoLocal()方法目前在Node.js、Go和Java SDK中可用，其他SDK即将支持。

高级测试配置

非成功路径测试

momento-local支持模拟错误场景和网络延迟，可通过两种方式配置：

1. 命令行参数配置

启动时通过命令行参数设置全局行为：

bash
docker run -p <port>:<port> gomomento/momento-local \
    --port <port> \                      # 服务端口
    --hostname <hostname> \              # 主机名
    --error-rpcs <RPC方法列表> \          # 要返回错误的RPC方法（空格分隔）
    --return-error <错误名称> \           # 返回的错误类型
    --error-count <错误次数> \            # 错误返回次数
    --delay-rpcs <RPC方法列表> \          # 要延迟的RPC方法（空格分隔）
    --delay-ms <延迟毫秒> \               # 延迟时长
    --delay-count <延迟次数> \            # 延迟次数
    --stream-error-rpcs topic-subscribe \ # 流错误的RPC方法
    --stream-error <错误名称> \           # 流错误类型
    --stream-error-message-limit <消息数> # 流返回错误前的消息数量

所有参数均为可选，未指定时使用默认值。

2. 中间件配置（按测试隔离）

通过中间件为每个测试设置独立错误行为，需提供唯一"request-id"确保隔离。目前仅Node.js SDK提供ExperimentalMomentoLocalTestConfigMiddleware。

Topics订阅保活测试

启动带测试管理服务的实例

bash
docker run --cap-add=NET_ADMIN --rm -p 8080:8080 -p 9090:9090 -e LOG_LEVEL=debug gomomento/momento-local --enable-test-admin

控制保活机制

通过测试管理接口阻塞/解除阻塞端口，模拟保活中断：

bash
# 阻塞端口，中断保活 ping，破坏 Topics 订阅
curl [***]

# 解除阻塞，恢复保活 ping，允许订阅恢复
curl [***]

了解更多

• 问题或反馈：通过***联系
• 更多信息：访问官方网站[***]