SpiceDB Docker镜像（serve-testing入口点）

镜像概述

本镜像基于SpiceDB权限系统构建，专为测试环境设计，默认使用"serve-testing"作为入口点。SpiceDB是一个开源的分布式权限系统，基于Google Zanzibar模型，用于管理和评估权限关系。该镜像针对测试场景优化，提供简化的配置和启动流程，支持快速部署以验证权限模型设计。

核心功能与特性

测试环境优化

• 入口点"serve-testing"针对测试场景定制，默认配置简化，减少外部依赖（如默认使用内存数据存储），适合临时测试环境。
• 启动流程精简，无需复杂的持久化配置，降低测试环境部署门槛。

权限模型验证支持

• 完整兼容SpiceDB核心功能，包括关系定义（Schema）、权限查询（CheckPermission）、关系写入（WriteRelationships）等API。
• 支持实时验证权限逻辑，可直接对接测试用例或客户端工具（如zed命令行工具）。

开发测试效率提升

• 快速启动特性，缩短从部署到验证的周期，适合开发迭代和自动化测试流程。
• 与SpiceDB生态工具兼容，支持无缝集成到CI/CD管道或本地开发环境。

使用场景

开发阶段权限验证

• 开发者本地验证权限模型设计，通过启动镜像快速测试Schema定义、关系数据及权限规则的正确性。

自动化测试环境

• 作为集成测试或单元测试的依赖服务，提供临时权限服务实例，验证业务系统与权限系统的交互逻辑。

权限模型原型验证

• 在早期设计阶段，快速部署镜像并模拟不同权限场景，验证权限模型的合理性和完整性。

使用方法与配置说明

基本部署命令

通过docker run快速启动镜像，默认暴露gRPC端口50051（SpiceDB标准端口）：

docker run -p 50051:50051 spicedb:latest

参数说明

• -p 50051:50051：端口映射，将容器内50051端口（gRPC服务）映射到主机，允许外部客户端访问。

自定义配置

可通过环境变量调整服务行为，常用配置如下：

示例：自定义日志级别与端口

docker run -p 50052:50052 \
  -e LOG_LEVEL=debug \
  -e GRPC_PORT=50052 \
  spicedb:latest

数据持久化（测试场景可选）

默认使用内存存储，容器重启后数据丢失。如需保留测试数据，可挂载本地目录到容器内数据路径（默认/var/lib/spicedb）：

docker run -p 50051:50051 \
  -v ./spicedb-test-data:/var/lib/spicedb \
  spicedb:latest

注意事项

• 环境限制：本镜像仅适用于测试环境，生产环境需使用SpiceDB***生产镜像并配置持久化存储、集群等生产级参数。
• 版本兼容性："serve-testing"入口点的行为可能随SpiceDB版本变化，建议通过docker run spicedb:latest --help查看具体版本的参数说明。
• 客户端工具：可配合SpiceDB***客户端工具zed进行交互，例如验证权限：zed check "user:alice" "view" "doc:123" --endpoint localhost:50051。