Seata测试环境搭建：Docker Compose一键部署

Seata测试环境搭建：Docker Compose一键部署

【免费下载链接】incubator-seata 项目地址: https://gitcode.com/gh_mirrors/in/incubator-seata

你是否还在为分布式事务测试环境的繁琐配置而烦恼？手动安装数据库、配置服务参数、调试网络连接耗费大量时间？本文将带你使用Docker Compose实现Seata测试环境的一键部署，5分钟内完成从环境准备到服务验证的全流程。读完本文你将掌握：Docker Compose部署Seata的完整步骤、关键配置参数说明、服务健康检查方法以及常见问题排查技巧。

环境准备条件

部署Seata测试环境前需确保系统已安装以下组件：

• Docker Engine (20.10.0+)
• Docker Compose (v2.0+)
• Git (用于获取部署脚本)

可通过以下命令验证环境是否就绪：

docker --version
docker compose version
git --version

部署文件获取

Seata官方已提供Docker Compose部署模板，存放在项目的script/server/docker-compose目录下。通过以下命令克隆项目仓库并进入部署目录：

git clone https://gitcode.com/gh_mirrors/in/incubator-seata.git
cd incubator-seata/script/server/docker-compose

部署文件结构如下：

script/server/docker-compose/
└── docker-compose.yaml  # 主部署配置文件

核心配置解析

打开部署配置文件script/server/docker-compose/docker-compose.yaml，关键配置说明如下：

version: "3"
services:
  seata-server:
    image: seataio/seata-server  # 官方镜像
    hostname: seata-server       # 容器主机名
    ports:
      - "8091:8091"              # Seata服务端口映射
    environment:
      - SEATA_PORT=8091          # 服务监听端口
      - STORE_MODE=file          # 存储模式(文件存储适合测试环境)

主要环境变量说明：

• SEATA_PORT: Seata Server监听端口，默认8091
• STORE_MODE: 事务日志存储方式，可选file/db，测试环境推荐file模式

一键部署流程

在部署目录执行以下命令启动Seata服务：

# 后台模式启动
docker compose up -d

# 查看服务状态
docker compose ps

成功启动后将显示类似以下输出：

NAME                IMAGE                  COMMAND                  SERVICE             CREATED             STATUS              PORTS
docker-seata-server seataio/seata-server   "/bin/sh -c 'sh ./bi…"   seata-server        5 seconds ago       Up 4 seconds        0.0.0.0:8091->8091/tcp

服务验证方法

端口检查

通过netstat或ss命令验证8091端口是否正常监听：

netstat -tuln | grep 8091

日志验证

查看容器日志确认服务启动成功：

docker compose logs -f seata-server

成功启动日志特征：

2023-10-08 08:00:00.000 INFO  [main] io.seata.server.ServerRunner - Seata Server started successfully in file mode. port: 8091

健康检查

通过curl命令访问健康检查接口：

curl http://localhost:8091/health

正常响应：

{"status":"UP"}

服务管理命令

停止服务

docker compose down

重启服务

docker compose restart

查看详细日志

docker compose logs --tail=100 seata-server

常见问题排查

端口冲突

错误日志：Bind for 0.0.0.0:8091 failed: port is already allocated
解决方法：修改端口映射，如"8092:8091"并同步修改SEATA_PORT环境变量

存储模式配置错误

症状：服务启动后无法持久化事务日志
检查：确认STORE_MODE配置值是否为file或db，测试环境推荐使用file模式

网络访问问题

症状：外部应用无法连接Seata服务
检查：

1. 容器是否正常运行：docker compose ps
2. 宿主机防火墙配置：ufw status(Ubuntu)或firewall-cmd --list-ports(CentOS)

总结与扩展

本文介绍了基于Docker Compose的Seata测试环境一键部署方案，通过官方提供的script/server/docker-compose/docker-compose.yaml配置文件，可快速搭建功能完整的测试环境。该方案适合开发自测、功能验证和小规模团队协作测试。

如需构建生产环境，建议：

1. 将STORE_MODE改为db模式并配置高可用数据库
2. 添加数据卷挂载确保配置持久化
3. 配置服务监控和日志收集

关注项目README.md获取最新部署方案，如有部署问题可参考CONTRIBUTING_CN.md中的贡献指南提交issue。

如果你觉得本文有帮助，请点赞收藏，下期将介绍"Seata多节点集群部署与负载均衡配置"。

【免费下载链接】incubator-seata 项目地址: https://gitcode.com/gh_mirrors/in/incubator-seata