This commit is contained in:
gitadmin
2026-10-19 22:15:06 +08:00
parent e6f2969f56
commit 9e8b25abe9
2 changed files with 592 additions and 0 deletions
@@ -0,0 +1,121 @@
# Docker Compose 文件版本定义
# 3.7 版本支持丰富的部署配置和资源限制功能
version: '3.7'
# 服务定义块,包含所有需要部署的容器服务
services:
# 后端服务 - 小蚂蚁管理系统后端
easygoadmin-admin:
# 镜像地址:从私有Harbor仓库拉取镜像
# ${VERSION:-latest} 表示使用VERSION环境变量,如果未设置则使用latest标签
image: manage.harbor.djangoadmin.cn/${DOCKER_REGISTRYURL_NAMESPACE}/${SERVER_NAME}:${VERSION:-latest}
# 容器名称:指定容器的名称,便于管理和识别
container_name: ${SERVER_NAME}
# 重启策略:always表示容器退出时总是自动重启
# 确保服务在异常退出后能够自动恢复
restart: always
# 网络模式:host表示使用主机网络模式
# 容器直接使用宿主机的网络栈,性能更好,端口直接暴露在主机上
network_mode: host
# 端口映射:将容器内的8081端口映射到主机的8081端口
# 格式:主机端口:容器端口
ports:
- 8081:8081
# 数据卷挂载:将主机文件或目录挂载到容器内
volumes:
# 挂载主机hosts文件到容器内(只读模式)
# 用于容器内的域名解析,与主机保持一致
- /etc/hosts:/etc/hosts:ro
# 挂载上传目录:将当前目录下的upload目录挂载到容器的/opt/apps/upload
# 用于持久化存储上传的文件
- $PWD/upload:/opt/apps/upload
# 挂载包目录:将当前目录下的package目录挂载到容器的/opt/apps/package
# 用于存储应用程序包或其他资源文件
- $PWD/package:/opt/apps/package
# 部署配置:定义资源限制和预留(Docker Swarm模式下的配置)
# 在单机Docker Compose中也会被部分支持
deploy:
resources:
# 资源限制:容器最多可以使用的资源量
limits:
cpus: '2' # 最多使用2个CPU核心
memory: 1.5G # 最多使用1.5GB内存
# 资源预留:保证容器至少获得的资源量
reservations:
cpus: '0.25' # 至少保留0.25个CPU核心
memory: 500M # 至少保留500MB内存
# 前端服务 - 小蚂蚁管理系统前端
easygoadmin-web:
# 镜像地址:前端服务的Docker镜像
image: manage.harbor.djangoadmin.cn/${DOCKER_REGISTRYURL_NAMESPACE}/${SERVER_NAME}:${VERSION:-latest}
# 容器名称:前端服务容器名称
container_name: ${SERVER_NAME}
# 重启策略:总是自动重启
restart: always
# 网络模式:使用主机网络模式
network_mode: host
# 端口映射:前端服务监听8082端口
ports:
- 8082:8082
# 数据卷挂载
volumes:
# 挂载主机hosts文件(只读)
- /etc/hosts:/etc/hosts:ro
# 挂载上传目录(读写模式)
# :rw 表示读写权限(默认模式,显式声明更清晰)
- $PWD/upload:/opt/apps/upload:rw
# 挂载包目录(读写模式)
- $PWD/package:/opt/apps/package:rw
# 环境变量:设置容器内的环境变量
environment:
# 语言设置:设置为英文UTF-8编码
- LANG=en_US.UTF-8
# 本地化设置:全部使用英文UTF-8
- LC_ALL=en_US.UTF-8
# Java虚拟机参数:设置文件编码为UTF-8
# 确保中文等特殊字符正确处理
- JAVA_OPTS=-Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8
# 部署配置:资源限制和预留
deploy:
resources:
# 资源上限
limits:
cpus: '2' # 最多2个CPU核心
memory: 1.5G # 最多1.5GB内存
# 资源保障
reservations:
cpus: '0.25' # 至少0.25个CPU核心
memory: 500M # 至少500MB内存
# 注意:该配置文件中使用了以下特殊配置:
# 1. network_mode: host - 主机网络模式,容器直接使用主机网络
# 2. ${VERSION:-latest} - 环境变量替换,支持动态版本控制
# 3. deploy.resources - Docker Swarm模式的资源管理,在单机模式下也有部分效果
# 4. 多目录挂载 - 实现数据持久化和主机-容器文件共享
# 5. 环境变量设置 - 确保应用程序的编码和语言环境正确
# 使用说明:
# 1. 部署命令:VERSION=1.2.0 docker-compose up -d
# 2. 查看日志:docker-compose logs -f
# 3. 停止服务:docker-compose down
# 4. 更新服务:VERSION=1.2.1 docker-compose up -d
+471
View File
@@ -0,0 +1,471 @@
# ==============================================================================
# 通用配置块 - 包含所有环境共享的配置项
# ==============================================================================
common:
# 镜像仓库配置 - 定义不同的容器镜像仓库
registrys:
# 默认仓库配置 - 内部私有仓库
default:
# 内部私有仓库地址 - 企业内部部署的Harbor或Registry地址
registry: "192.168.10.102:8001"
# Jenkins凭证ID - 用于仓库认证的凭据ID
registryCredential: "xiaomayi-hub-credentials"
# 仓库中的项目/命名空间名称 - 镜像存放的项目空间
registryProject: "xiaomayi"
# 仓库类型 - 仓库的技术类型(harbor、acr、dockerhub等)
registryType: "harbor"
# 应用部署基础镜像
registryImage: "jdk:17.0.16-ubuntu22-dos"
# 阿里云ACR仓库配置 - 云上仓库,用于生产环境或特定场景
aliyun:
# 阿里云VPC内网地址 - 阿里云容器镜像服务的VPC内网地址,网络性能更优
registry: "registry-vpc.cn-hangzhou.aliyuncs.com"
# 阿里云仓库认证凭证 - 阿里云访问凭据的Jenkins ID
registryCredential: "aliyun-hub-credentials"
# 阿里云仓库项目名称 - 阿里云ACR中的命名空间
registryProject: "xiaomayi-base"
# 仓库类型 - 阿里云容器镜像服务
registryType: "acr"
# 应用部署基础镜像
registryImage: "jdk:17.0.16-ubuntu22-dos"
# Docker Hub配置 - 官方Docker仓库,用于公开镜像
dockerhub:
# Docker Hub地址 - 官方Docker仓库地址
registry: "index.docker.io"
# Docker Hub认证凭证 - Docker Hub账号的Jenkins凭据ID
registryCredential: "dockerhub-credentials"
# Docker Hub项目名称 - 用户名或组织名
registryProject: "xiaomayi-base"
# 仓库类型 - 官方Docker仓库
registryType: "dockerhub"
# 应用部署基础镜像
registryImage: "jdk:17.0.16-ubuntu22-dos"
# 钉钉消息
dingtalk:
# 凭证ID - Jenkins中存储的DingTalk认证凭据ID
credentialsId: "jenkins-dingtalk-robot"
# 通知配置 - 构建结果通知设置
notification:
# 构建成功通知配置
success:
# 通知渠道
channels:
# 邮件通知
email: ["xiaomayicloud@163.com"]
# 短信通知
#sms: ["15295504151"]
# 钉钉通知
dingtalk: true
# Slack通知
slack: false
# 构建失败通知配置
failure:
# 通知渠道
channels:
# 邮件通知
email: ["xiaomayicloud@163.com"]
# 短信通知
# sms: ["15295504151"]
# 钉钉通知
dingtalk: true
# Slack通知
slack: false
# 构建被中止通知
aborted:
# 通知渠道
channels:
# 邮件通知
email: ["xiaomayicloud@163.com"]
# 短信通知
#sms: ["15295504151"]
# 钉钉通知
dingtalk: true
# Slack通知
slack: false
# 构建不稳定通知配置
unstable:
# 通知渠道
channels:
# 邮件通知
email: ["xiaomayicloud@163.com"]
# 钉钉通知
dingtalk: true
# 构建策略 - 构建过程的策略配置
buildStrategy:
retryCount: 3 # 构建失败重试次数
timeoutMinutes: 60 # 构建超时时间(分钟)
cleanupWorkspace: true # 构建完成后是否清理工作空间
enableCaching: true # 是否启用Docker构建缓存
# 部署相关配置
deployScript: "deploy_env.sh" # 部署执行的shell脚本文件名
deployPath: "/usr/local/docker/easygoadmin-web" # 目标服务器上的应用部署根路径
# ==============================================================================
# 短信服务配置
# 描述: 定义短信通知服务的相关配置,支持多种短信服务商和模板配置
# ==============================================================================
# 短信服务提供商配置
sms:
# 短信服务商 - 指定使用的短信服务平台
# 可选值:
# - 'aliyun': 阿里云短信服务(推荐)
# - 'tencent': 腾讯云短信服务
# - 'yunpian': 云片短信服务
provider: 'aliyun'
# Jenkins凭据ID - 存储短信服务认证信息的Jenkins凭据标识
# 凭据内容格式建议为JSON或key=value格式,包含accessKeyId/accessKeySecret等认证信息
credentialsId: 'jenkins-aliyun-credentials'
# 默认短信签名 - 在短信开头显示的签名内容
# 需要先在短信服务平台申请并通过审核的签名
signName: '小蚂蚁云'
# ==============================================================================
# 短信模板配置 - 定义不同场景下的短信模板
# 每个模板需要先在短信服务平台创建并通过审核
# ==============================================================================
templates:
# --------------------------------------------------------------------------
# 构建成功短信模板配置
# 用途: 当构建任务成功完成时发送的通知短信
# --------------------------------------------------------------------------
build_success:
# 模板代码 - 短信服务平台审核通过的模板ID
# 阿里云: SMS_开头的一串数字字母组合
# 腾讯云: 纯数字模板ID
# 云片: 长整型数字模板ID
templateCode: 'SMS_231440070'
# 模板签名 - 可覆盖默认签名,使用特定的签名
# 如果未设置,则使用顶层的默认签名
signName: '小蚂蚁云'
# 模板变量说明(在短信平台配置时定义):
# 通常包含: project, branch, status, duration, time 等变量
# 示例模板内容: "您的项目${project}构建${status},耗时${duration},时间${time}"
# --------------------------------------------------------------------------
# 构建失败短信模板配置
# 用途: 当构建任务失败时发送的告警短信
# --------------------------------------------------------------------------
build_failure:
# 模板代码 - 失败通知的专用模板ID
templateCode: 'SMS_231440070'
# 模板签名 - 失败通知使用的签名
signName: '小蚂蚁云'
# 模板变量说明:
# 通常包含: project, branch, status, duration, error, time 等变量
# 示例模板内容: "警告:项目${project}构建${status},错误:${error},时间${time}"
# --------------------------------------------------------------------------
# 部署通知短信模板(示例配置,可根据需要启用)
# 用途: 当应用部署完成时发送的通知短信
# --------------------------------------------------------------------------
# deployment:
# templateCode: 'SMS_DEPLOY_001'
# signName: '小蚂蚁云'
# --------------------------------------------------------------------------
# 系统告警短信模板(示例配置,可根据需要启用)
# 用途: 当系统发生异常或达到告警阈值时发送的短信
# --------------------------------------------------------------------------
# alert:
# templateCode: 'SMS_ALERT_001'
# signName: '小蚂蚁云'
# 环境配置文件 - 定义不同环境的特定配置
profiles:
# --------------------------------------------------------------------------
# 开发环境配置 - 用于开发测试,部署频率高,配置相对宽松
# --------------------------------------------------------------------------
dev:
# 容器镜像
registry: "default"
# 服务器列表 - 部署目标服务器
servers:
- serverIP: "esxi@192.168.10.201" # 服务器SSH连接地址(用户名@IP)
serverPort: 22 # SSH端口号
serverName: "S201服务器" # 服务器标识名称,用于日志和通知
sshKey: "jenkins-ssh-207" # Jenkins SSH密钥凭证ID
weight: 50 # 负载权重(0-100),用于流量控制
isPrimary: true # 主节点标识,优先部署
priority: 1 # 部署优先级(数字越小优先级越高)
- serverIP: "esxi@192.168.10.202" # 服务器SSH连接地址(用户名@IP)
serverPort: 22 # SSH端口号
serverName: "S202服务器" # 服务器标识名称,用于日志和通知
sshKey: "jenkins-ssh-207" # Jenkins SSH密钥凭证ID
weight: 50 # 负载权重(0-100),用于流量控制
isPrimary: false # 主节点标识,优先部署
priority: 2 # 部署优先级(数字越小优先级越高)
# 环境变量 - 部署时注入到容器中的环境变量
envVars:
SPRING_PROFILES_ACTIVE: "dev" # Spring Boot激活的配置文件环境
JAVA_OPTS: "-Xms512m -Xmx512m" # JVM内存参数:初始堆512MB,最大堆512MB
LOG_LEVEL: "INFO" # 日志级别:INFO
TZ: "Asia/Shanghai" # 时区设置:亚洲/上海
# 部署策略配置
deploymentStrategy: "rolling" # 部署策略:rolling-滚动部署
deploymentTimeout: 3600 # 整体部署超时时间(3600秒=1小时)
maxParallel: 2 # 最大并行部署服务器数量
retryAttempts: 3 # 部署失败重试次数
# 健康检查配置
healthCheckPath: "/actuator/health" # 健康检查端点
healthCheckTimeout: 180 # 健康检查超时时间(180秒=3分钟)
healthCheckInterval: 10 # 健康检查间隔(10秒)
successThreshold: 3 # 成功阈值(连续3次检查成功才算健康)
# --------------------------------------------------------------------------
# 测试环境配置 - 用于集成测试,配置接近生产环境
# --------------------------------------------------------------------------
test:
# 容器镜像
registry: "default"
# 服务器列表 - 部署目标服务器
servers:
- serverIP: "esxi@192.168.10.201" # 服务器SSH连接地址(用户名@IP)
serverPort: 22 # SSH端口号
serverName: "S201服务器" # 服务器标识名称,用于日志和通知
sshKey: "jenkins-ssh-207" # Jenkins SSH密钥凭证ID
weight: 50 # 负载权重(0-100),用于流量控制
isPrimary: true # 主节点标识,优先部署
priority: 1 # 部署优先级(数字越小优先级越高)
- serverIP: "esxi@192.168.10.202" # 服务器SSH连接地址(用户名@IP)
serverPort: 22 # SSH端口号
serverName: "S201服务器" # 服务器标识名称,用于日志和通知
sshKey: "jenkins-ssh-207" # Jenkins SSH密钥凭证ID
weight: 50 # 负载权重(0-100),用于流量控制
isPrimary: false # 主节点标识,优先部署
priority: 2 # 部署优先级(数字越小优先级越高)
# 环境变量 - 部署时注入到容器中的环境变量
envVars:
SPRING_PROFILES_ACTIVE: "test" # 测试环境配置文件
JAVA_OPTS: "-Xms1g -Xmx1g" # JVM内存:1GB堆内存
LOG_LEVEL: "INFO"
TZ: "Asia/Shanghai"
# 部署策略配置
deploymentStrategy: "rolling"
deploymentTimeout: 3600 # 整体部署超时时间(3600秒=1小时)
maxParallel: 1 # 测试环境串行部署,便于问题排查
retryAttempts: 2
# 健康检查配置
healthCheckPath: "/actuator/health" # 健康检查端点
healthCheckTimeout: 180 # 健康检查超时时间(180秒=3分钟)
healthCheckInterval: 10 # 健康检查间隔(10秒)
successThreshold: 3 # 成功阈值(连续3次检查成功才算健康)
# --------------------------------------------------------------------------
# 用户验收测试环境配置 - 模拟生产环境,用于最终验收测试
# --------------------------------------------------------------------------
uat:
# 容器镜像
registry: "default"
# 服务器列表 - 部署目标服务器
servers:
- serverIP: "esxi@192.168.10.201" # 服务器SSH连接地址(用户名@IP)
serverPort: 22 # SSH端口号
serverName: "S201服务器" # 服务器标识名称,用于日志和通知
sshKey: "jenkins-ssh-207" # Jenkins SSH密钥凭证ID
weight: 50 # 负载权重(0-100),用于流量控制
isPrimary: true # 主节点标识,优先部署
priority: 1 # 部署优先级(数字越小优先级越高)
- serverIP: "esxi@192.168.10.202" # 服务器SSH连接地址(用户名@IP)
serverPort: 22 # SSH端口号
serverName: "S201服务器" # 服务器标识名称,用于日志和通知
sshKey: "jenkins-ssh-207" # Jenkins SSH密钥凭证ID
weight: 50 # 负载权重(0-100),用于流量控制
isPrimary: false # 主节点标识,优先部署
priority: 2 # 部署优先级(数字越小优先级越高)
# 环境变量 - 部署时注入到容器中的环境变量
envVars:
SPRING_PROFILES_ACTIVE: "uat" # UAT环境配置文件
JAVA_OPTS: "-Xms2g -Xmx2g" # JVM内存:2GB堆内存
LOG_LEVEL: "INFO"
TZ: "Asia/Shanghai"
# 部署策略配置
deploymentStrategy: "blue-green" # 蓝绿部署策略,减少停机时间
deploymentTimeout: 3600 # 整体部署超时时间(3600秒=1小时)
maxParallel: 1
retryAttempts: 1 # UAT环境不重试,立即反馈问题
# 健康检查配置
healthCheckPath: "/actuator/health" # 健康检查端点
healthCheckTimeout: 180 # 健康检查超时时间(180秒=3分钟)
healthCheckInterval: 10 # 健康检查间隔(10秒)
successThreshold: 3 # 成功阈值(连续3次检查成功才算健康)
# --------------------------------------------------------------------------
# 生产环境配置 - 线上真实环境,配置最为严格
# --------------------------------------------------------------------------
prod:
# 容器镜像
registry: "default"
# 服务器列表 - 部署目标服务器
servers:
- serverIP: "esxi@47.103.201.89" # 服务器SSH连接地址(用户名@IP)
serverPort: 18922 # SSH端口号
serverName: "S210服务器" # 服务器标识名称,用于日志和通知
sshKey: "jenkins-ssh-207" # Jenkins SSH密钥凭证ID
weight: 50 # 负载权重(0-100),用于流量控制
isPrimary: true # 主节点标识,优先部署
priority: 1 # 部署优先级(数字越小优先级越高)
- serverIP: "esxi@47.103.201.89" # 服务器SSH连接地址(用户名@IP)
serverPort: 18922 # SSH端口号
serverName: "S220服务器" # 服务器标识名称,用于日志和通知
sshKey: "jenkins-ssh-207" # Jenkins SSH密钥凭证ID
weight: 50 # 负载权重(0-100),用于流量控制
isPrimary: false # 主节点标识,优先部署
priority: 2 # 部署优先级(数字越小优先级越高)
# 环境变量 - 部署时注入到容器中的环境变量
envVars:
SPRING_PROFILES_ACTIVE: "prod" # 生产环境配置文件
JAVA_OPTS: "-Xms4g -Xmx4g" # JVM内存:4GB堆内存
LOG_LEVEL: "WARN" # 生产环境使用WARN级别日志,减少日志量
TZ: "Asia/Shanghai"
GC_OPTS: "-XX:+UseG1GC -XX:MaxGCPauseMillis=200" # GC调优参数:使用G1垃圾回收器
# 部署策略配置
deploymentStrategy: "canary" # 金丝雀部署策略,逐步发布降低风险
deploymentTimeout: 3600 # 整体部署超时时间(3600秒=1小时)
maxParallel: 1 # 生产环境单台串行部署,确保稳定性
retryAttempts: 3 # 部署失败重试次数
canaryPercentage: 25 # 首批金丝雀发布比例(25%)
# 健康检查配置
healthCheckEnabled: true # 启用健康检查
healthCheckPath: "/actuator/health" # 健康检查端点
healthCheckTimeout: 180 # 健康检查超时时间(180秒=3分钟)
healthCheckRetries: 5 # 健康检查5次重试
healthCheckInterval: 10 # 健康检查间隔(10秒)
successThreshold: 3 # 成功阈值(连续3次检查成功才算健康)
# 回滚配置
rollbackEnabled: true # 启用自动回滚
rollbackOnFailure: true # 部署失败时自动回滚
rollbackTimeout: 300 # 回滚操作超时时间(300秒=5分钟)
# # 通知配置 - 生产环境部署状态通知
# notifications:
# slackChannel: "#prod-deployments" # Slack通知频道
# email: "xiaomayicloud@163.com" # 主要邮件通知地址
# onSuccess: true # 成功时发送通知
# onFailure: true # 失败时发送通知
# onStart: true # 开始部署时发送通知
# recipients: # 额外通知人员邮件列表
# - "devops@xiaomayi.com"
# - "product-manager@xiaomayi.com"
# ==============================================================================
# 分支构建配置 - 定义不同Git分支的构建参数
# ==============================================================================
branchConfig:
# 开发分支配置
dev:
# Jenkins代理
jenkinsAgent: "S205-docker"
# Maven构建配置 - Java应用编译和打包
maven:
mavenSet: "nexus-maven-dev" # Maven配置集名称
skipTests: true # 生产构建不跳过测试
goals: "clean package" # Maven执行目标
options: "" # Maven选项参数
# Docker镜像构建配置
docker:
dockerFile: ".jenkins/Dockerfile" # 使用的Dockerfile文件
buildOptions: "--no-cache --pull" # Docker构建选项:禁用缓存、总是拉取最新基础镜像
# 测试分支配置
test:
# Jenkins代理
jenkinsAgent: "S205-docker"
# Maven构建配置 - Java应用编译和打包
maven:
mavenSet: "nexus-maven-test" # Maven配置集名称
skipTests: true # 生产构建不跳过测试
goals: "clean package" # Maven执行目标
options: "" # Maven选项参数
# Docker镜像构建配置
docker:
dockerFile: ".jenkins/Dockerfile" # 使用的Dockerfile文件
buildOptions: "--no-cache --pull" # Docker构建选项:禁用缓存、总是拉取最新基础镜像
# 主分支配置(生产环境)
master:
# Jenkins代理
jenkinsAgent: "S205-docker"
# Maven构建配置 - Java应用编译和打包
maven:
mavenSet: "nexus-maven-dev" # Maven配置集名称
skipTests: false # 生产构建不跳过测试
goals: "clean package" # Maven执行目标
options: "" # Maven选项参数
# Docker镜像构建配置
docker:
dockerFile: ".jenkins/Dockerfile" # 使用的Dockerfile文件
buildOptions: "--no-cache --pull" # Docker构建选项:禁用缓存、总是拉取最新基础镜像
# ==============================================================================
# 服务配置 - 定义每个微服务的特定配置
# ==============================================================================
serviceConfig:
# 后台系统
easygoadmin-admin:
programLang: "java"
programLangVersion: "17.0.16"
containerName: "easygoadmin-admin"
pomFilePath: "pom.xml"
servicePath: "xiaomayi-modules/xiaomayi-admin"
jarName: "xiaomayi-admin.jar"
port: "8081"
javaOpts: "-server -Xms256m -Xmx2g -Xss1m"
deployServer: "servers[0]"
composeFile: "easygoadmin-web-docker-compose"
easygoadmin-admin-ui:
programLang: "nodejs"
programLangVersion: "22.19.0"
deployMethod: "static"
projectName: "easygoadmin-admin-ui"
packageName: "easygoadmin-admin-ui.tar.gz"
servicePath: "xiaomayi-ui"
containerName: "easygoadmin-admin-ui"
port: "8001"
deployServer: "servers[0]"
composeFile: "easygoadmin-web-docker-compose"
# 前台网站
easygoadmin-web:
programLang: "java"
programLangVersion: "17.0.16"
containerName: "easygoadmin-web"
pomFilePath: "pom.xml"
servicePath: "xiaomayi-modules/xiaomayi-web"
jarName: "xiaomayi-web.jar"
port: "8082"
javaOpts: "-server -Xms256m -Xmx2g -Xss1m"
deployServer: "servers[0]"
composeFile: "easygoadmin-web-docker-compose"