apache/seata-controller

Apache Seata Controller Docker镜像文档

镜像概述和主要用途

Apache Seata Controller是分布式事务解决方案Apache Seata的核心控制组件，负责协调分布式事务的全生命周期，包括全局事务的开启、分支事务的注册与提交/回滚、事务状态的管理等。该镜像提供了Seata Controller的容器化部署方式，简化了分布式事务协调服务的搭建流程，支持与主流配置中心、注册中心集成，适用于微服务架构中跨服务、跨数据源的事务一致性保障。

核心功能和特性

• 多事务模式支持：兼容AT（自动事务）、TCC（编程式事务）、SAGA（长事务）和XA（分布式事务协议）四种事务模式，满足不同业务场景需求。
• 高可用部署：支持集群模式部署，通过注册中心实现服务发现与负载均衡，避免单点故障。
• 配置与注册中心集成：无缝集成Nacos、Apollo、Eureka、Zookeeper等主流配置中心和注册中心，便于配置管理和服务发现。
• 灵活的存储方案：支持文件存储、关系型数据库（MySQL、PostgreSQL等）、Redis等多种事务日志持久化方式，适应不同数据可靠性需求。
• 监控与可观测性：暴露Prometheus监控指标，支持与Grafana等监控平台集成，便于事务状态和性能监控。
• 轻量级设计：基于Netty实现高性能通信，资源占用低，可快速启动和扩展。

使用场景和适用范围

• 微服务架构分布式事务：适用于Spring Cloud、Dubbo等微服务架构中，解决跨多个微服务的事务一致性问题。
• 跨数据源事务：支持单个应用操作多个数据库或数据库与消息队列等资源的事务协调。
• 高一致性业务场景：***支付、电商订单、物流调度等对数据一致性要求高的业务系统。
• 混合事务模式需求：同一系统中需要同时使用多种事务模式（如部分服务用AT，部分用TCC）的场景。

使用方法和配置说明

前提条件

• Docker引擎版本19.03+
• 若使用集群模式，需提前部署注册中心（如Nacos）和配置中心
• 持久化存储（如数据库）需提前创建并配置权限

Docker Run示例

基本单机部署（默认配置）

bash
docker run -d \
  --name seata-controller \
  -p 8091:8091 \
  seataio/seata-controller:latest

自定义配置文件部署

bash
docker run -d \
  --name seata-controller \
  -p 8091:8091 \
  -v /host/path/to/seata-config:/seata-server/resources \
  -e SEATA_CONFIG_NAME=file:/seata-server/resources/application.yml \
  seataio/seata-controller:latest

集成Nacos注册中心和配置中心

bash
docker run -d \
  --name seata-controller \
  -p 8091:8091 \
  -e SEATA_REGISTRY_TYPE=nacos \
  -e SEATA_REGISTRY_NACOS_SERVER_ADDR=192.168.1.100:8848 \
  -e SEATA_REGISTRY_NACOS_GROUP=SEATA_GROUP \
  -e SEATA_CONFIG_TYPE=nacos \
  -e SEATA_CONFIG_NACOS_SERVER_ADDR=192.168.1.100:8848 \
  seataio/seata-controller:latest

Docker Compose示例（集群部署）

yaml
version: '3.8'
services:
  seata-controller-1:
    image: seataio/seata-controller:latest
    container_name: seata-controller-1
    ports:
      - "8091:8091"
    environment:
      - SEATA_SERVER_PORT=8091
      - SEATA_REGISTRY_TYPE=nacos
      - SEATA_REGISTRY_NACOS_SERVER_ADDR=nacos:8848
      - SEATA_REGISTRY_NACOS_GROUP=SEATA_GROUP
      - SEATA_REGISTRY_NACOS_SERVICE=seata-controller
      - SEATA_CONFIG_TYPE=nacos
      - SEATA_CONFIG_NACOS_SERVER_ADDR=nacos:8848
      - SEATA_STORE_MODE=db
      - SEATA_STORE_DB_URL=jdbc:mysql://mysql:3306/seata
      - SEATA_STORE_DB_USERNAME=root
      - SEATA_STORE_DB_PASSWORD=password
    depends_on:
      - nacos
      - mysql

  seata-controller-2:
    image: seataio/seata-controller:latest
    container_name: seata-controller-2
    ports:
      - "8092:8091"
    environment:
      - SEATA_SERVER_PORT=8091
      - SEATA_REGISTRY_TYPE=nacos
      - SEATA_REGISTRY_NACOS_SERVER_ADDR=nacos:8848
      - SEATA_REGISTRY_NACOS_GROUP=SEATA_GROUP
      - SEATA_REGISTRY_NACOS_SERVICE=seata-controller
      - SEATA_CONFIG_TYPE=nacos
      - SEATA_CONFIG_NACOS_SERVER_ADDR=nacos:8848
      - SEATA_STORE_MODE=db
      - SEATA_STORE_DB_URL=jdbc:mysql://mysql:3306/seata
      - SEATA_STORE_DB_USERNAME=root
      - SEATA_STORE_DB_PASSWORD=password
    depends_on:
      - nacos
      - mysql

  nacos:
    image: nacos/nacos-server:latest
    container_name: nacos
    ports:
      - "8848:8848"
    environment:
      - MODE=standalone

  mysql:
    image: mysql:8.0
    container_name: mysql
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=password
      - MYSQL_DATABASE=seata
    volumes:
      - ./sql:/docker-entrypoint-initdb.d

配置参数说明

核心环境变量

配置文件挂载

推荐通过挂载配置文件（如application.yml、registry.conf）自定义配置，挂载路径为容器内/seata-server/resources目录。配置文件示例可参考Seata官方文档。

验证部署

1. 访问健康检查接口：http://localhost:8091/health，返回{"status":"UP"}表示服务正常
2. 在注册中心控制台查看seata-controller服务注册状态
3. 通过Seata客户端连接并执行分布式事务测试

使用场景和适用范围

• 微服务架构分布式事务：Spring Cloud/Dubbo等微服务架构中跨服务事务协调
• 跨数据源事务：单个应用操作多数据库或混合数据源（数据库+消息队列）场景
• 高一致性业务系统：***支付、电商订单、物流调度等对数据一致性要求高的领域
• 混合事务模式需求：同一系统需同时使用AT/TCC/SAGA/XA多种事务模式的场景