Docker 快速部署(sz-deploy-v3)
sz-deploy-v3 是当前推荐的服务器侧部署仓库。它负责安装基础环境、创建 Docker 网络、生成服务目录,启动 Redis、数据库、MinIO/RustFS、后端、WebSocket、前端和代理服务。
TIP
Docker Compose 快速部署并没有改变后端服务的运行模型:sz-service-admin 仍然依赖 /config、/data、/logs 三类目录。首次部署前建议先阅读 部署总览,了解配置、资源和日志的持久化方式。
一、适用场景
| 场景 | 是否推荐 |
|---|---|
| 全新服务器快速安装一套 sz-admin | 推荐 |
| 希望用 Docker Compose 管理数据库、Redis、后端、前端和代理 | 推荐 |
| 二开项目需要使用自己的镜像、配置和部署脚本 | Fork 仓库后按项目调整 |
| 已有自己的运维平台,只想参考 Compose 目录和脚本 | 可参考 |
| 只想理解 jar 如何启动 | 先看 部署总览 |
PKG_MGR 由用户在安装 .env 中手动选择,默认 dnf:
| 参数 | 新装 Docker 的软件源分支 |
|---|---|
dnf | CentOS、Rocky、AlmaLinux、RHEL 系列 |
apt | Ubuntu、Debian |
yum | 提供 yum 的上述 RPM 系列,使用 yum-utils/yum-config-manager |
脚本不会自动更换包管理器。新装 Docker 时读取 /etc/os-release,选择对应的软件源;发行版不支持或缺少 APT codename 时会停止。请使用 Docker 上游仍维护的系统版本。
以下命令以 root 执行,服务器需提供 sudo 命令。普通维护账号还需具备 sudo、Docker 和运行目录权限。示例使用默认运行目录和 prod;已有环境使用其他路径、端口或 profile 时,请改为实际值。
数据库和 OSS 切换命令均在部署服务器的 Linux 终端执行,无需修改切换脚本。若运行目录不是 /home/docker-compose,替换脚本路径,并在切换命令中增加 --runtime-root /实际运行目录;--profile 填当前使用的配置名。
WARNING
首次安装会停止并禁用已安装的 firewalld;没有安装时跳过,不修改 UFW 等其他防火墙。脚本还会安装、启用 chrony,启用数据库备份时准备 cron/crond。执行前请确认服务器允许这些变更。FAST_DEPLOY=true 只跳过系统软件更新。
二、部署入口
1. Clone 或 Fork 仓库
先在开发电脑上取得部署代码。需要二开时,先 Fork 到自己的仓库,再 clone 自己的仓库地址。
git clone https://github.com/feiyuchuixue/sz-deploy-v3.git
cd sz-deploy-v3git clone https://gitee.com/feiyuchuixue/sz-deploy-v3.git
cd sz-deploy-v3根据项目情况修改 init/.env、应用 YAML、镜像和脚本。自定义内容需要已发布到 .env 指定的仓库分支,服务器才能拉取;仅修改本地文件不会改变服务器下载的代码。
2. 上传两个安装文件
上传前,在 init/.env 中选择后台部署方式。默认 USE_BLUE_GREEN_DEPLOY=false,安装普通单实例后台;首次安装就使用蓝绿时,改为:
USE_BLUE_GREEN_DEPLOY=true修改的是准备上传到服务器、与 install.sh 放在同一目录的那份 .env。两种方式都执行 bash install.sh,脚本会选择对应的后台运行文件和前端 Nginx 代理配置,无需另外安装一遍蓝绿脚本。这个开关只选择 sz-service-admin 的发布方式,不会把其他组件改成多节点集群。
完成配置后,在服务器创建一个新的安装目录,例如:
install -d -m 700 /opt/sz-install把本地仓库中的 init/.env 和 init/install.sh 上传到这个目录,保留文件名:
/opt/sz-install/
├── .env
└── install.sh服务器不需要提前上传完整源码,install.sh 会根据仓库地址和分支克隆代码。
3. 执行安装
cd /opt/sz-install
chmod 600 .env
bash install.sh入口会读取同目录 .env,安装必要工具,克隆代码到 SCRIPT_DIR,再执行 sz-base.sh 和 sz-service.sh。默认源码目录为 /opt/sz-install/sz-deploy,服务运行目录为 /home/docker-compose。
SCRIPT_DIR 已存在时会直接复用,不会自动 git pull。安装入口、输入和仓库代码应使用同一版本;已有应用升版使用后文的普通或蓝绿发布命令,不通过重跑 install 同步。
安装后检查:
docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'
curl -fsS http://127.0.0.1:9991/api/actuator/health
curl -fsS http://127.0.0.1:9800/api/actuator/health等待后台冷启动完成,两个接口返回 UP 后,通过 http://服务器IP:9800 检查登录、WebSocket、上传和下载。域名和 HTTPS 按服务器网关或 Nginx Proxy Manager 的配置使用。
三、核心参数
下面是部署前最常修改的参数。请保留随包 init/.env 的完整内容,再修改需要的项。
# 服务器上的源码克隆目录、服务运行目录
SCRIPT_DIR=sz-deploy
DEPLOY_ROOT=/home/docker-compose
# 包管理器,由用户手动选择:dnf / apt / yum
PKG_MGR=dnf
FAST_DEPLOY=true
# 仓库来源:github / gitee / gitlab / gitea
GIT_REPO_PLATFORM=github
GIT_REPO_URL_GITHUB=github.com/feiyuchuixue/sz-deploy-v3.git
GIT_BRANCH=main
# 数据库与对象存储
# DB_TYPE mysql、postgresql
DB_TYPE=mysql
# OSS_PROVIDER RUSTFS、MINIO
OSS_PROVIDER=RUSTFS
# 后台部署方式和 Spring profile
USE_BLUE_GREEN_DEPLOY=false
SPRING_PROFILES_ACTIVE=prod
# 镜像来源
IMAGE_MODE=registry
IMAGE_REGISTRY=registry.cn-beijing.aliyuncs.com
IMAGE_NAMESPACE=sz-dev
IMAGE_TAG=latest
IMAGE_PULL=true
# LOCAL 资源持久化目录
RESOURCE_DATA_DIR=/home/data/sz-resource
# 数据库备份
BACKUP_ENABLED=true
BACKUP_RETENTION_DAYS=90
MYSQL_BACKUP_ROOT=/home/data/mysql_backups
POSTGRES_BACKUP_ROOT=/home/data/postgres_backups使用自己的 Fork 时,修改对应的仓库地址和 GIT_BRANCH。Gitee 使用 GIT_REPO_PLATFORM=gitee 和 GIT_REPO_URL_GITEE;GitLab/Gitea 使用各自对应字段。私有仓库配置有读取权限的 GIT_USERNAME、GIT_PASSWORD,不要把令牌提交到公开仓库。
应用连接配置
安装 .env 与应用 YAML 需要分别维护。安装前,在自己的仓库中准备 sz-service-admin/config/:
| 文件 | 配置内容 |
|---|---|
mysql.yml / postgresql.yml | 数据库地址、内部端口、库名、账号和密码 |
redis.yml | Redis 地址和密码 |
oss.yml | 存储连接、bucket、region、对外访问地址和资源场景 |
sa-token.yml 等 | 鉴权密钥和其他业务配置 |
资源大小上限 max-size 使用字节整数填写,例如 5MiB 为 5242880,以兼容不同版本的后台镜像。
使用 RustFS 前,后台镜像必须包含 RUSTFS 支持;旧版本需先升级。切换脚本的 --check 不验证镜像中的存储驱动。
默认内部地址为 mysql8:3306、postgres18:5432、redis-server:6379、http://minio:9000 或 http://rustfs:9000,不要填写宿主机映射端口或 localhost。
Redis 密码还需同步修改 redis/docker-compose.yml 中的 --requirepass,当前没有 REDIS_PASSWORD 安装参数。直接写 Compose 时注意 $ 的转义,也可使用较长的随机字母数字密码。
IMPORTANT
只修改安装 .env 中的密码,不会自动改写 Java YAML。两文件安装要求仓库里的应用配置已经准备好,并与安装输入一致。配置复制到 config/prod/ 后,后台会立即启动,中间没有编辑暂停。
真实密钥不要提交到公开仓库。不放进仓库的应用配置,应在安装前另行预置到服务器的 /home/docker-compose/sz-service-admin/config/prod/;已有文件会保留,缺失文件才从仓库复制。RESOURCE_CONFIG_FILE 可指定服务器上已准备的完整 oss.yml,但不会覆盖原来已有的 oss.yml。
WARNING
不要沿用示例密码。安装输入由 Bash 读取,含 $、# 的值使用单引号包裹,避免单引号和换行。将运行 .env、config/{profile} 和资源目录纳入备份,妥善保管安装材料。
四、服务组成
初始化后,默认在 /home/docker-compose 下生成服务目录:
/home/docker-compose/
├── redis/
├── mysql/ 或 postgres/
├── minio/
├── rustFS/
├── sz-service-admin/
├── sz-service-websocket/
├── sz-admin/
├── sz-nginx-static/
├── nginx-proxy-manager-zh/
└── ops/MySQL/PostgreSQL 首次只安装选中的一种。MinIO 和 RustFS 目录会准备好,但只启动所选 provider。
| 服务 | 作用 | 默认宿主端口 |
|---|---|---|
| Redis | 缓存、登录态、WebSocket Pub/Sub | 6379 |
| MySQL | 关系数据库 | 3306 |
| PostgreSQL | 可选关系数据库 | 127.0.0.1:5432 |
| MinIO / RustFS | S3 兼容对象存储,二选一运行 | 9000 / 9001 |
sz-service-admin | 后台管理 API 服务或蓝绿代理入口 | 9991 |
sz-service-websocket | WebSocket 独立服务 | 9993 |
sz-admin | 前端静态服务 | 9800 |
| 静态资源服务 | LOCAL 资源同源访问 | 不发布宿主端口 |
| Nginx Proxy Manager | 统一代理与证书管理 | 80 / 81 / 443 |
所有服务默认加入一个外部 sz-network 网络。单套部署无需增加网络或容器名前缀。
对象存储选择与切换
首次安装通过 OSS_PROVIDER=MINIO|RUSTFS 选择,并设置 OSS_ACCESS_KEY、OSS_SECRET_KEY、OSS_REGION。应用 oss.yml 需要同步填写;业务 bucket 和权限由用户另外准备。
安装后切换前,先暂停业务写入,准备目标 bucket、对象、策略和完整应用配置。切换工具不迁移对象数据。 脚本会读取当前运行配置,识别源存储和后台的普通/蓝绿部署方式。源存储保持运行,目标应停止或尚未创建;其他场景仍引用源服务时,先处理这些依赖。
准备受限输入目录,每次使用新的文件,避免覆盖原切换材料:
install -d -m 700 /opt/sz-change在服务器上准备两个文件:--target-env 指定目标存储参数文件,填写镜像名称及标签、容器名、端口和存储账号;--oss-config 指定后台应用使用的完整 oss.yml,填写存储连接地址、bucket 和资源场景。
例如 MinIO 切到 RustFS,新建 /opt/sz-change/rustfs.env,将 REPLACE_ 值换成目标配置:
OSS_PROVIDER='RUSTFS'
RUSTFS_IMAGE='REPLACE_WITH_COMPLETE_IMAGE_REFERENCE'
DOCKER_NETWORK_NAME='sz-network'
OSS_ACCESS_KEY='REPLACE_WITH_TARGET_ACCESS_KEY'
OSS_SECRET_KEY='REPLACE_WITH_TARGET_SECRET_KEY'
OSS_REGION='us-east-1'
OSS_SERVER_DOMAINS=''
RUSTFS_CONTAINER='rustfs'
OSS_API_PORT='9000'
OSS_CONSOLE_PORT='9001'
IMAGE_PULL='false'
PRUNE_IMAGES='false'目标存储镜像填在上面 .env 的 RUSTFS_IMAGE 中,格式为 镜像仓库/命名空间/镜像名:标签。从当前 config/prod/oss.yml 复制一份完整文件,保存为 /opt/sz-change/rustfs-oss.yml,编辑目标连接和各资源场景。oss.yml 的 endpoint 填后台访问存储的地址,默认是 http://rustfs:9000,不要填写镜像名称。给两个输入文件设置 0600 权限,镜像提前拉取或导入服务器。
反向切到 MinIO 时,准备 minio.env 和 minio-oss.yml。环境输入改为 OSS_PROVIDER=MINIO,镜像和容器字段使用 MINIO_IMAGE、MINIO_CONTAINER,默认 endpoint 为 http://minio:9000。保留实际网络、端口和自定义项目名。
bash /home/docker-compose/ops/switch-oss-environment.sh \
--to RUSTFS --profile prod \
--target-env /opt/sz-change/rustfs.env \
--oss-config /opt/sz-change/rustfs-oss.yml --checkbash /home/docker-compose/ops/switch-oss-environment.sh \
--to MINIO --profile prod \
--target-env /opt/sz-change/minio.env \
--oss-config /opt/sz-change/minio-oss.yml --check--check 只检查本地镜像、输入文件、容器、网络、端口和数据目录等条件,不改配置、不拉取镜像、不启停容器,也不会连接目标存储验证账号、bucket 或对象数据。检查失败时先修正,再重新检查。
检查通过且目标数据准备完成后,把同一条命令末尾的 --check 改为 --apply 才会执行切换。脚本会备份配置,停止源存储、启动目标,安装提供的完整 YAML,再按现有普通/蓝绿方式发布后台。源数据目录会保留,失败时尝试恢复原存储、配置和后台。
请在维护时段执行环境切换。失败恢复可能重建后台和内部代理,期间会短暂中断。
IMPORTANT
源存储不要提前手动停止,也不要让两个 provider 同时运行进入切换。目标使用独立的标准 ./data 目录;CHECK 不创建缺失目标目录。RustFS 非空 OSS_SERVER_DOMAINS 还需配相同的 RUSTFS_SERVER_DOMAINS,空域名时省略后者。详细准备步骤见 README 的对象存储切换说明。
切换后检查健康接口,并实际验证上传、下载和历史对象读取。配置恢复不会合并两边新增的数据。
五、数据库选择
MySQL
使用 MySQL 时:
DB_TYPE=mysql
MYSQL_DATABASE=sz_admin_prod
MYSQL_CONTAINER=mysql8
MYSQL_PASSWORD='REPLACE_WITH_PRIVATE_PASSWORD'
ADMIN_MYSQL_IMAGE_TAG=latest对应的后台连接配置为 config/prod/mysql.yml。库名、账号和密码要与数据库一致。
PostgreSQL
使用 PostgreSQL 时:
DB_TYPE=postgresql
PG_MODE=internal
PG_CONTAINER_NAME=postgres18
PG_DB_NAME=sz_admin_prod
PG_SUPER_PASSWORD='REPLACE_WITH_PRIVATE_SUPER_PASSWORD'
PG_INTERNAL_USER=sz_admin_prod_user_in
PG_INTERNAL_PASSWORD='REPLACE_WITH_PRIVATE_APP_PASSWORD'
PG_EXTERNAL_USER=sz_admin_prod_user_out
PG_EXTERNAL_PASSWORD='REPLACE_WITH_ANOTHER_PRIVATE_PASSWORD'
ADMIN_POSTGRESQL_IMAGE_TAG=latest-postgresql对应的后台连接配置为 config/prod/postgresql.yml。仅内部使用时保留 PG_MODE=internal,外部访问需另行设置允许网段和账号权限。
IMPORTANT
数据库类型也影响后台镜像的构建依赖。自行构建镜像时,确保 CI 的数据库构建与 DB_TYPE 一致,不能只修改运行参数而继续使用另一种数据库的镜像。
运行后切换数据库
先准备本机目标数据库,让它与后台使用同一网络;准备账号、业务表和数据,并修改当前 profile 下对应 YAML。工具支持明确的本机 JDBC 连接,不用于外部数据库或多个不明确连接的配置。脚本读取运行目录中的 .env、Compose 和应用配置,按现有普通/蓝绿方式发布后台,无需重新填写当前部署参数。
将 --admin-image 后的示例值替换为已准备好的目标数据库后台镜像名称及标签,格式为 镜像仓库/命名空间/镜像名:标签,不要加 https://。这也是 docker pull 使用的镜像引用,不是数据库连接地址;连接信息仍在当前 profile 的 mysql.yml 或 postgresql.yml 中配置。
目标镜像须提前拉取或导入服务器,脚本会检查本地是否存在,无需另外执行 docker image inspect。以下命令先检查:
bash /home/docker-compose/ops/switch-db-environment.sh \
--to postgresql --profile prod \
--admin-image "harbor.example.com/sz/sz-service-admin:postgresql" \
--checkbash /home/docker-compose/ops/switch-db-environment.sh \
--to mysql --profile prod \
--admin-image "harbor.example.com/sz/sz-service-admin:mysql" \
--check--check 只检查本地镜像、配置、目标数据库容器、网络绑定和服务就绪状态,不改配置、不拉取镜像、不启停容器;省略动作参数时同样只检查。检查失败时,按提示修正后重新检查,不要继续执行 --apply。
确认目标库已准备完成后,将命令末尾的 --check 改为 --apply 才会执行切换,其余参数保持不变。脚本备份配置,只更新后台运行 .env 的 DB_TYPE 和 SZ_SERVICE_ADMIN_IMAGE,保留连接 YAML,按现有部署方式发布后台。
请在维护时段执行环境切换。失败恢复可能重建后台和内部代理,期间会短暂中断。
WARNING
数据库切换不迁移数据,源数据库不会停止。CHECK 通过不代表账号认证、表结构或业务数据已就绪,空业务库也可能通过。应用启动仍可能执行正常的 Liquibase 变更,切换前请备份并核对版本;切换后的写入不会自动同步回源库。
尚未安装第二种数据库时,按 README 的目标准备步骤操作。不要重跑整套安装链来准备目标库。
六、镜像模式
1. 使用官方公共镜像
默认配置使用官方镜像仓库:
IMAGE_MODE=registry
IMAGE_REGISTRY=registry.cn-beijing.aliyuncs.com
IMAGE_NAMESPACE=sz-dev
IMAGE_TAG=latest官方镜像由源码仓库 CI 发布:后端发布管理服务和 WebSocket 镜像,前端发布 sz-admin 镜像。部署仓库负责消费镜像,不在服务器重新构建应用源码。
2. 使用自己的镜像仓库
二开项目修改为自己的 CI/CD 镜像地址和标签,例如:
IMAGE_MODE=registry
IMAGE_REGISTRY=registry.example.com
IMAGE_NAMESPACE=my-project
IMAGE_TAG=v1.0.0
ADMIN_MYSQL_IMAGE_TAG=v1.0.0
ADMIN_POSTGRESQL_IMAGE_TAG=v1.0.0-postgresql将示例改成实际发布的地址。也可以通过 SZ_SERVICE_ADMIN_IMAGE_MYSQL、SZ_SERVICE_ADMIN_IMAGE_POSTGRESQL 指定首次安装使用的完整后台镜像。
对应的自动化构建流程见 GitHub Actions CI/CD。
3. 本地调试镜像
使用提前导入的本地镜像时:
IMAGE_MODE=local
IMAGE_TAG=test
IMAGE_PULL=false同时检查实际镜像名称、命名空间和标签。IMAGE_PULL=false 只跳过脚本主动拉取,Docker 缺少镜像时仍可能尝试拉取,离线使用前应确认所需镜像都已缓存。
七、普通升级模式
默认 USE_BLUE_GREEN_DEPLOY=false 时,后台以单实例运行。安装后的核心目录为:
/home/docker-compose/sz-service-admin/
├── .env
├── docker-compose.yml
├── upgrade.sh
├── lib/
└── config/
└── prod/先备份当前配置和旧镜像,编辑此目录 .env 中的 SZ_SERVICE_ADMIN_IMAGE,填写本次发布的完整地址。需要在线拉取时设置 IMAGE_PULL=true;使用已缓存镜像时设置 false。
cd /home/docker-compose/sz-service-admin
docker compose --env-file .env -f docker-compose.yml config -q
bash upgrade.sh --no-prune脚本按需拉取镜像并重建后台,不先 down。普通升级有中断窗口,不等待业务健康,也不会自动恢复。等待冷启动后检查:
curl -fsS http://127.0.0.1:9991/api/actuator/health
curl -fsS http://127.0.0.1:9800/api/actuator/health--no-prune 保留旧镜像。升级失败时先看日志,确认数据库与旧版兼容后,恢复配置和旧镜像再发布。
八、蓝绿部署模式
首次安装时,在准备上传的 init/.env 中设置 USE_BLUE_GREEN_DEPLOY=true;保留默认的 false 则安装普通后台。安装完成后,仅修改这个开关并重跑安装不会转换已有部署。
普通与蓝绿默认都部署在同一台 Linux 服务器上。蓝绿只为 sz-service-admin 提供发布槽位,不是两台服务器的容灾部署;数据库、Redis、对象存储、前端和 WebSocket 仍按原来的方式部署。
后台维护 sz-service-admin-green、sz-service-admin-blue 两个槽位,通过同机的 sz-service-nginx 对内代理。平时只运行一个活跃槽位,发布期间新旧后台会同时运行,待新实例健康并切换流量后停止旧实例。服务器需要留出同时运行两个后台实例的资源,不能把它当作常驻双实例集群。
确认已有环境的模式时,普通后台运行目录有 docker-compose.yml、upgrade.sh;蓝绿目录有 deploy.sh、docker-compose.gen.yml 和 .deploy_state,不能只看后来修改过的安装输入。蓝绿运行文件直接位于后台目录:
/home/docker-compose/sz-service-admin/
├── .env
├── lib/
├── runtime-config.sh
├── migrate-env.sh
├── docker-compose.yml.template
├── gen-conf.sh
├── docker-compose.gen.yml
├── deploy.sh
├── config/
├── nginx/
└── .deploy_state编辑运行 .env 的镜像和发布参数后,先生成并检查配置,再发布:
cd /home/docker-compose/sz-service-admin
bash gen-conf.sh
docker compose --env-file .env -f docker-compose.gen.yml config -q
bash deploy.sh --no-prunedeploy.sh 会完成:
- 按配置准备镜像。
- 启动非活跃槽位。
- 等待新实例健康。
- 更新 Nginx upstream 并 reload。
- 停止旧槽位,写入当前状态。
默认健康路径为 /api/actuator/health。发布后检查当前槽位、代理和健康:
cd /home/docker-compose/sz-service-admin
grep '^ACTIVE_SLOT=' .deploy_state
docker exec sz-service-nginx nginx -t
curl -fsS http://127.0.0.1:9991/api/actuator/health
curl -fsS http://127.0.0.1:9800/api/actuator/healthIMPORTANT
普通/蓝绿开关只用于首次安装,已有环境不能修改开关后重跑 install 自动互转。蓝绿发布失败时会尝试保留或恢复旧路由,但不能保证数据库不兼容变更或外部代理故障下服务不中断。
旧环境更新脚本、迁移 IMAGE_NAME、SPRING_ACTIVE 等字段及失败恢复,见 旧环境升级指南。不要只复制单个 deploy.sh,运行目录内的模板、defaults、lib 和 Nginx 文件需要成套保留。
九、资源目录与 Nginx 静态访问
RESOURCE_DATA_DIR 是 LOCAL 资源持久化目录:
RESOURCE_DATA_DIR=/home/data/sz-resource后台对该目录读写,nginx-static 只读挂载,由前端通过同源 /resource/ 提供访问。重建容器时保留资源目录,避免本地上传文件丢失。
如果主要使用 OSS,也应保留 LOCAL 场景需要的资源文件。选择 MinIO/RustFS 不会自动把 LOCAL 场景改成 OSS。
十、数据库备份
首次安装通过以下参数配置所选数据库的备份任务:
BACKUP_ENABLED=true
BACKUP_RETENTION_DAYS=90
MYSQL_BACKUP_ROOT=/home/data/mysql_backups
POSTGRES_BACKUP_ROOT=/home/data/postgres_backups启用备份时,apt 准备 cron 服务,dnf/yum 准备 crond 服务。安装后检查 crontab、实际备份文件和保留周期。手工准备第二数据库的步骤不会自动创建备份任务,需要另外安排。
WARNING
自动备份不能替代生产级灾备。上线前至少验证一次数据库、应用配置和资源目录的恢复,并保留服务器外备份。配置恢复不等于数据库或对象数据回滚。
十一、常用运维命令
查看服务状态:
cd /home/docker-compose/sz-service-admin
docker compose --env-file .env -f docker-compose.yml ps蓝绿模式将文件参数改为 -f docker-compose.gen.yml。
查看普通后台日志:
docker logs -f sz-service-admin普通模式升级:
cd /home/docker-compose/sz-service-admin
bash upgrade.sh --no-prune蓝绿模式发布:
cd /home/docker-compose/sz-service-admin
bash gen-conf.sh
bash deploy.sh --no-pruneWebSocket 服务升级:
cd /home/docker-compose/sz-service-websocket
bash upgrade.sh --no-prune升级或发布前,先修改对应服务运行 .env 的镜像字段并备份配置,完成后检查业务。
十二、常见问题
1. 修改根目录 .env 后服务没有变化
安装入口的 .env 只用于首次初始化。安装后修改服务运行目录的 .env 和当前 profile YAML,再执行对应发布命令。仅 docker restart 不会应用新的容器环境变量,不重跑 install 同步已有环境。
2. 切换 PostgreSQL 后启动失败
检查以下内容:
- 本机 PostgreSQL 容器和目标业务库是否已准备。
config/prod/postgresql.yml中的地址、内部端口、库名和账号密码是否正确。- 应用账号是否能实际登录,业务表和数据是否齐全。
- 后台镜像是否为 PostgreSQL 构建,是否与目标 Liquibase 状态兼容。
3. 蓝绿部署一直回滚
先看脚本报错和新槽位日志:
docker logs --tail 200 sz-service-admin-green
docker logs --tail 200 sz-service-admin-blue常见原因包括配置无法读取、数据库或 Redis 不可达、Liquibase 执行失败、健康接口不可用。确认旧槽和路由是否恢复,再处理故障;不要手改 state 强制切槽。
4. CI/CD 推送了镜像但服务器没有拉到
检查后台运行 .env 中的 SZ_SERVICE_ADMIN_IMAGE 和 IMAGE_PULL,确认完整地址与 CI 发布结果一致,再执行普通或蓝绿发布。修改安装输入的 IMAGE_TAG 不会自动改变已有运行配置。
5. 服务器已有 Docker,却提示缺少 Compose 插件
后续脚本统一使用 docker compose。只有旧 docker-compose 命令不能继续,请先按 Docker 官方插件说明准备插件。安装脚本不会为补插件重装或重启已有 Docker Engine。
6. 安装提示已有 Docker APT 源
脚本不会覆盖已有 docker.list、不同内容的 docker.sources 或符号链接。先备份并核对软件源,整理为一套与发行版和签名密钥一致的 Docker 源后再继续。本脚本生成且内容相同的 docker.sources 可以复用。
