Dolittle Runtime Docker镜像文档

镜像概述和主要用途

本镜像包含从 Dolittle Runtime 仓库构建的Dolittle Runtime组件。Dolittle是一个去中心化、分布式、事件驱动的微服务平台，旨在利用事件的力量构建灵活的应用系统。

Runtime是Dolittle系统的核心后端组件，主要负责管理来自SDK（软件开发工具包）和其他Runtime实例的连接，使其与Event Store（事件存储）进行交互。作为系统的运行时引擎，Runtime为SDK提供底层支持，是确保事件驱动架构正常运行的关键组件。

核心功能和特性

• 事件存储管理：作为Event Store的连接中枢，处理来自SDK和其他Runtime的事件存储访问请求
• 多SDK支持：为Dolittle生态系统中的各类SDK提供运行时环境和通信支持
• 分布式架构适配：支持去中心化部署模式，可与其他Runtime实例协同工作
• 轻量级设计：Production版本仅包含核心Runtime组件，适合生产环境部署

使用场景和适用范围

开发环境

推荐使用Development类型镜像，内置MongoDB实例（默认端口27017），无需额外配置外部数据库，简化本地开发和测试流程。

生产环境

推荐使用Production类型镜像，仅包含Runtime核心组件，需配合外部MongoDB实例使用，适合大规模部署和生产环境运行。

镜像类型与版本

Dolittle Runtime提供两种镜像类型，分别针对开发和生产场景，并支持多架构（amd64/arm64）。

使用方法和配置说明

快速开始

• 参考官方教程
• 查阅完整官方文档

运行Production镜像（生产环境）

基本命令

Production镜像需连接外部MongoDB实例，通过环境变量或配置文件指定数据库连接信息（具体参数见官方配置文档）：

docker run -d \
  --name dolittle-runtime \
  -p 50051:50051 \  # Runtime默认通信端口
  -e MONGODB_CONNECTION_STRING="mongodb://external-mongodb:27017" \
  dolittle/runtime:latest

运行Development镜像（开发环境）

基本命令

Development镜像内置MongoDB，可直接启动并暴露MongoDB端口（27017）供本地开发使用：

docker run -d \
  --name dolittle-runtime-dev \
  -p 50051:50051 \  # Runtime通信端口
  -p 27017:27017 \  # 内置MongoDB端口
  dolittle/runtime:latest-development

Docker Compose配置示例

创建docker-compose.yml文件，集成Runtime与应用服务：

version: '3.8'
services:
  runtime:
    image: dolittle/runtime:latest-development
    ports:
      - "50051:50051"
      - "27017:27017"
    restart: unless-stopped

  app:
    build: ./your-app
    depends_on:
      - runtime
    environment:
      - DOLITTLE_RUNTIME_HOST=runtime:50051

配置参数说明

Runtime支持通过环境变量或配置文件进行自定义配置，核心参数（详细列表见官方文档）包括：

• MONGODB_CONNECTION_STRING：MongoDB连接字符串（Production环境必填）
• RUNTIME_PORT：Runtime服务端口（默认50051）
• LOG_LEVEL：日志级别（可选：trace/debug/info/warn/error，默认info）

相关资源

• Dolittle官方文档
• Runtime GitHub仓库
• Docker Hub镜像仓库