server

temporalio/server Docker Image

temporalio

以工作流即代码方式构建和运行弹性应用程序的Docker镜像

23 次收藏下载次数: 0状态:社区镜像维护者:temporalio仓库类型:镜像最近更新:

Temporal Server Docker 镜像文档

镜像概述和主要用途

Temporal Server 镜像是用于生产环境部署的核心组件,需连接外部数据库(支持 Cassandra、MySQL 或 PostgreSQL,默认 Cassandra)。若需部署包含预配置数据库的 Temporal,可参考 https://hub.docker.com/r/temporalio/auto-setup 镜像。此外,Temporal 可选支持 Elasticsearch 以实现可见性功能。更多 docker-compose 示例可参考 https://github.com/temporalio/docker-compose GitHub 仓库。

核心功能和特性

  • 多数据库支持:兼容 Cassandra、MySQL 8、PostgreSQL 12 作为后端存储
  • Elasticsearch 集成:可选配置 Elasticsearch 实现工作流可见性,支持主/ secondary 索引
  • 灵活的网络配置:支持绑定 IP、广播地址设置,适配代理或多网络环境
  • 安全增强:全面的 TLS 配置(证书刷新、过期检查、客户端认证),支持 JWT 权限控制
  • 监控集成:支持 statsd 和 Prometheus 指标导出,便于 observability
  • 动态配置:通过 YAML 文件自定义服务参数,支持运行时调整
  • 多服务端口管理:独立配置前端、匹配、历史、工作器服务的网络端口

使用场景和适用范围

  • 生产环境部署:适用于需要稳定运行工作流引擎的企业级应用
  • 复杂工作流管理:支持长期运行、状态ful的工作流编排,如微服务协调、数据处理管道
  • 多数据库环境:可适配现有 Cassandra、MySQL 或 PostgreSQL 集群
  • 可见性需求:需通过 Elasticsearch 实现工作流实例搜索、过滤和监控的场景
  • 高可用架构:支持多节点部署,配合外部数据库实现数据持久化和故障恢复

详细使用方法和配置说明

环境变量配置

通用环境变量

名称描述默认值
DB指定连接的数据库类型,允许值:cassandra、mysql8、postgres12cassandra

Cassandra 环境变量

名称描述默认值
KEYSPACECassandra 键空间名称temporal
CASSANDRA_SEEDSCassandra 主机名未设置
CASSANDRA_PORTCassandra 连接端口9042
CASSANDRA_USERCassandra 用户名未设置
CASSANDRA_PASSWORDCassandra 密码未设置
CASSANDRA_TLS_ENABLED是否启用 TLS 连接 Cassandrafalse
CASSANDRA_CERTTLS 证书文件路径(若启用 TLS)未设置
CASSANDRA_CERT_DATA以数据形式传入 TLS 证书(替代文件路径)未设置
CASSANDRA_CERT_KEYTLS 证书密钥文件路径(若启用 TLS)未设置
CASSANDRA_CERT_KEY_DATA以数据形式传入 TLS 证书密钥(替代文件路径)未设置
CASSANDRA_CACA 证书文件路径(若需要)未设置
CASSANDRA_CA_DATA以数据形式传入 CA 证书(替代文件路径)未设置
CASSANDRA_HOST_VERIFICATION是否启用 Cassandra 主机验证false
CASSANDRA_HOST_NAMECassandra 数据库主机名未设置
CASSANDRA_ADDRESS_TRANSLATOR地址转换器接口,用于将 Cassandra 节点 IP 转换为本地可访问地址未设置
CASSANDRA_ADDRESS_TRANSLATOR_OPTIONS地址转换器选项,参考 https://github.com/pingidentity/cassandra-spring-boot-starter/blob/master/README.md未设置

MySQL/PostgreSQL 环境变量

名称描述默认值
DBNAME主数据库名称temporal
VISIBILITY_DBNAME可见性数据库名称(独立于主数据库)temporal_visibility
VISIBILITY_DB_PORT可见性数据库连接端口MySQL: 3306,PostgreSQL: 5432
VISIBILITY_MYSQL_SEEDSMySQL 可见性数据库主机名未设置
VISIBILITY_MYSQL_USERMySQL 可见性数据库用户名未设置
VISIBILITY_MYSQL_PWDMySQL 可见性数据库密码未设置
VISIBILITY_POSTGRES_SEEDSPostgreSQL 可见性数据库主机名未设置
VISIBILITY_POSTGRES_USERPostgreSQL 可见性数据库用户名未设置
VISIBILITY_POSTGRES_PWDPostgreSQL 可见性数据库密码未设置
DB_PORT主数据库连接端口MySQL: 3306,PostgreSQL: 5432
MYSQL_SEEDSMySQL 主机名未设置
MYSQL_USERMySQL 用户名未设置
MYSQL_PWDMySQL 密码未设置
MYSQL_TX_ISOLATION_COMPAT启用 MySQL 5.7.20 之前版本兼容性false
SQL_VIS_MAX_CONNS可见性数据库最大活跃连接数10
SQL_VIS_MAX_IDLE_CONNS可见性数据库最大空闲连接数10
SQL_VIS_MAX_CONN_TIME可见性数据库连接最大存活时间1h
SQL_MAX_CONNS主数据库最大活跃连接数20
SQL_MAX_IDLE_CONNS主数据库最大空闲连接数20
SQL_MAX_CONN_TIME主数据库连接最大存活时间1h
SQL_TLS_ENABLED是否启用 SQL 数据库 TLS 连接false
SQL_CASQL 数据库 CA 证书路径未设置
SQL_CERTSQL 数据库证书路径未设置
SQL_CERT_KEYSQL 数据库证书密钥路径未设置
SQL_HOST_VERIFICATION是否启用 SQL 主机验证false
SQL_HOST_NAMETLS 连接时验证的主机名未设置
POSTGRES_SEEDSPostgreSQL 主机名未设置
POSTGRES_USERPostgreSQL 用户名未设置
POSTGRES_PWDPostgreSQL 密码未设置
POSTGRES_TLS_ENABLED是否启用 PostgreSQL TLS 连接false
POSTGRES_TLS_DISABLE_HOST_VERIFICATION是否跳过 PostgreSQL 主机验证(如 Amazon RDS 环境)false
POSTGRES_TLS_CERT_FILEPostgreSQL TLS 证书文件路径未设置
POSTGRES_TLS_KEY_FILEPostgreSQL TLS 证书密钥文件路径未设置
POSTGRES_TLS_CA_FILEPostgreSQL TLS CA 证书文件路径未设置
POSTGRES_TLS_SERVER_NAMEPostgreSQL TLS 服务器主机名未设置

Elasticsearch 环境变量

名称描述默认值
ENABLE_ES是否启用 Elasticsearchfalse
ES_SCHEMEElasticsearch 连接协议,允许值:http、httpshttp
ES_SEEDSElasticsearch 节点列表(逗号分隔)未设置
ES_PORTElasticsearch 连接端口9200
ES_USERElasticsearch 用户名未设置
ES_PWDElasticsearch 密码未设置
ES_VERSIONElasticsearch 版本v7
ES_VIS_INDEX可见性索引名称temporal_visibility_v1_dev
ES_SEC_VIS_INDEXsecondary 可见性 索引名称未设置

服务器配置环境变量

名称描述默认值
BIND_ON_IP前端服务绑定 IP 地址127.0.0.1(本地主机)
TEMPORAL_BROADCAST_ADDRESS客户端连接 IP 与 BIND_ON_IP 不同时需指定(如监听 0.0.0.0 或使用代理)未设置
PPROF_PORT启用 https://github.com/google/pprof 调试的端口0(禁用)
TEMPORAL_TLS_REFRESH_INTERVALTLS 证书刷新间隔0s(不刷新)
TEMPORAL_TLS_EXPIRATION_CHECKS_CHECK_INTERVALTLS 证书过期检查间隔0s(不检查)
TEMPORAL_TLS_EXPIRATION_CHECKS_WARNING_WINDOW证书过期警告窗口时间0s
TEMPORAL_TLS_EXPIRATION_CHECKS_ERROR_WINDOW证书过期错误窗口时间0s
TEMPORAL_TLS_REQUIRE_CLIENT_AUTH是否要求客户端(Worker、CLI、SDK)通过 TLS 认证false
TEMPORAL_TLS_SERVER_CERT服务器 TLS 证书路径未设置
TEMPORAL_TLS_SERVER_CERT_DATA服务器 TLS 证书数据(替代文件路径)未设置
TEMPORAL_TLS_SERVER_KEY服务器 TLS 证书密钥路径未设置
TEMPORAL_TLS_SERVER_KEY_DATA服务器 TLS 证书密钥数据(替代文件路径)未设置
TEMPORAL_TLS_SERVER_CA_CERT服务器 CA 证书路径未设置
TEMPORAL_TLS_SERVER_CA_CERT_DATA服务器 CA 证书数据(替代文件路径)未设置
TEMPORAL_TLS_INTERNODE_DISABLE_HOST_VERIFICATION是否跳过节点间(历史/匹配服务)主机验证false
TEMPORAL_TLS_INTERNODE_SERVER_NAME节点间 TLS 验证的主机名未设置
TEMPORAL_TLS_FRONTEND_CERT前端服务 TLS 证书路径未设置
TEMPORAL_TLS_FRONTEND_CERT_DATA前端服务 TLS 证书数据(替代文件路径)未设置
TEMPORAL_TLS_FRONTEND_KEY前端服务 TLS 证书密钥路径未设置
TEMPORAL_TLS_FRONTEND_KEY_DATA前端服务 TLS 证书密钥数据(替代文件路径)未设置
TEMPORAL_TLS_FRONTEND_DISABLE_HOST_VERIFICATION前端服务是否跳过主机验证false
TEMPORAL_TLS_FRONTEND_SERVER_NAME前端服务 TLS 验证的主机名未设置
TEMPORAL_TLS_CLIENT1_CA_CERT前端服务向外部客户端展示的 TLS 证书未设置
TEMPORAL_TLS_CLIENT1_CA_CERT_DATA客户端 TLS 证书数据(替代文件路径)未设置
TEMPORAL_TLS_CLIENT2_CA_CERT额外客户端 TLS 证书未设置
TEMPORAL_TLS_CLIENT2_CA_CERT_DATA额外客户端 TLS 证书数据(替代文件路径)未设置
STATSD_ENDPOINThttps://github.com/statsd/statsd 监控端点未设置
PROMETHEUS_ENDPOINTPrometheus 指标暴露端点(用于数据采集)未设置
PROMETHEUS_TIMER_TYPEPrometheus 计时器指标类型,参考 https://prometheus.io/docs/concepts/metric_types/histogram
TEMPORAL_AUTH_AUTHORIZER授权插件 配置未设置
TEMPORAL_AUTH_CLAIM_MAPPERClaimMapper 插件 配置未设置
TEMPORAL_JWT_KEY_SOURCE1ClaimMapper JWT 密钥源未设置
TEMPORAL_JWT_KEY_SOURCE2额外 JWT 密钥源未设置
TEMPORAL_JWT_KEY_REFRESHJWT 密钥刷新间隔1m
TEMPORAL_JWT_PERMISSIONS_CLAIMJWT 权限声明属性名permissions
FRONTEND_GRPC_PORT前端服务 GRPC 端口7233
FRONTEND_HTTP_PORT前端服务 HTTP 端口7243
FRONTEND_MEMBERSHIP_PORT前端服务成员端口6933
INTERNAL_FRONTEND_GRPC_PORT内部前端服务 GRPC 端口7236
INTERNAL_FRONTEND_MEMBERSHIP_PORT内部前端服务成员端口6936
MATCHING_GRPC_PORT匹配服务 GRPC 端口7235
MATCHING_MEMBERSHIP_PORT匹配服务成员端口6935
HISTORY_GRPC_PORT历史服务 GRPC 端口7234
HISTORY_MEMBERSHIP_PORT历史服务成员端口6934
WORKER_GRPC_PORT工作器服务 GRPC 端口7239
WORKER_MEMBERSHIP_PORT工作器服务成员端口6939
USE_INTERNAL_FRONTEND是否部署 https://github.com/temporalio/temporal/releases/tag/v1.20.0(部分认证配置需要)未设置
PUBLIC_FRONTEND_ADDRESS覆盖从 BIND_ON_IP 和 FRONTEND_GRPC_PORT 推导的公网前端地址未设置
DYNAMIC_CONFIG_FILE_PATH动态配置 YAML 文件路径/etc/temporal/config/dynamicconfig/docker.yaml

部署示例

1. Docker Run 命令(连接 PostgreSQL)

bash
docker run -d \
  --name temporal-server \
  -p 7233:7233 \
  -e DB=postgres12 \
  -e POSTGRES_SEEDS=postgres-host \
  -e POSTGRES_USER=temporal \
  -e POSTGRES_PWD=temporal-password \
  -e DBNAME=temporal \
  -e VISIBILITY_DBNAME=temporal_visibility \
  -e BIND_ON_IP=0.0.0.0 \
  docker.xuanyuan.run/temporalio/server:latest

2. Docker Compose

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 server 镜像标签

docker pull docker.xuanyuan.run/temporalio/server:<标签>

DockerHub 原生拉取命令

docker pull temporalio/server:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告