Skip to content

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 的软件源分支
dnfCentOS、Rocky、AlmaLinux、RHEL 系列
aptUbuntu、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 自己的仓库地址。

shell
git clone https://github.com/feiyuchuixue/sz-deploy-v3.git
cd sz-deploy-v3
shell
git 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,安装普通单实例后台;首次安装就使用蓝绿时,改为:

properties
USE_BLUE_GREEN_DEPLOY=true

修改的是准备上传到服务器、与 install.sh 放在同一目录的那份 .env。两种方式都执行 bash install.sh,脚本会选择对应的后台运行文件和前端 Nginx 代理配置,无需另外安装一遍蓝绿脚本。这个开关只选择 sz-service-admin 的发布方式,不会把其他组件改成多节点集群。

完成配置后,在服务器创建一个新的安装目录,例如:

shell
install -d -m 700 /opt/sz-install

把本地仓库中的 init/.env 和 init/install.sh 上传到这个目录,保留文件名:

text
/opt/sz-install/
├── .env
└── install.sh

服务器不需要提前上传完整源码,install.sh 会根据仓库地址和分支克隆代码。

3. 执行安装 ​

shell
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 同步。

安装后检查:

shell
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 的完整内容,再修改需要的项。

properties
# 服务器上的源码克隆目录、服务运行目录
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.ymlRedis 地址和密码
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 下生成服务目录:

text
/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/Sub6379
MySQL关系数据库3306
PostgreSQL可选关系数据库127.0.0.1:5432
MinIO / RustFSS3 兼容对象存储,二选一运行9000 / 9001
sz-service-admin后台管理 API 服务或蓝绿代理入口9991
sz-service-websocketWebSocket 独立服务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、对象、策略和完整应用配置。切换工具不迁移对象数据。 脚本会读取当前运行配置,识别源存储和后台的普通/蓝绿部署方式。源存储保持运行,目标应停止或尚未创建;其他场景仍引用源服务时,先处理这些依赖。

准备受限输入目录,每次使用新的文件,避免覆盖原切换材料:

shell
install -d -m 700 /opt/sz-change

在服务器上准备两个文件:--target-env 指定目标存储参数文件,填写镜像名称及标签、容器名、端口和存储账号;--oss-config 指定后台应用使用的完整 oss.yml,填写存储连接地址、bucket 和资源场景。

例如 MinIO 切到 RustFS,新建 /opt/sz-change/rustfs.env,将 REPLACE_ 值换成目标配置:

properties
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。保留实际网络、端口和自定义项目名。

shell
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 --check
shell
bash /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 时:

properties
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 时:

properties
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。以下命令先检查:

shell
bash /home/docker-compose/ops/switch-db-environment.sh \
  --to postgresql --profile prod \
  --admin-image "harbor.example.com/sz/sz-service-admin:postgresql" \
  --check
shell
bash /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. 使用官方公共镜像 ​

默认配置使用官方镜像仓库:

properties
IMAGE_MODE=registry
IMAGE_REGISTRY=registry.cn-beijing.aliyuncs.com
IMAGE_NAMESPACE=sz-dev
IMAGE_TAG=latest

官方镜像由源码仓库 CI 发布:后端发布管理服务和 WebSocket 镜像,前端发布 sz-admin 镜像。部署仓库负责消费镜像,不在服务器重新构建应用源码。

2. 使用自己的镜像仓库 ​

二开项目修改为自己的 CI/CD 镜像地址和标签,例如:

properties
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. 本地调试镜像 ​

使用提前导入的本地镜像时:

properties
IMAGE_MODE=local
IMAGE_TAG=test
IMAGE_PULL=false

同时检查实际镜像名称、命名空间和标签。IMAGE_PULL=false 只跳过脚本主动拉取,Docker 缺少镜像时仍可能尝试拉取,离线使用前应确认所需镜像都已缓存。

七、普通升级模式 ​

默认 USE_BLUE_GREEN_DEPLOY=false 时,后台以单实例运行。安装后的核心目录为:

text
/home/docker-compose/sz-service-admin/
├── .env
├── docker-compose.yml
├── upgrade.sh
├── lib/
└── config/
    └── prod/

先备份当前配置和旧镜像,编辑此目录 .env 中的 SZ_SERVICE_ADMIN_IMAGE,填写本次发布的完整地址。需要在线拉取时设置 IMAGE_PULL=true;使用已缓存镜像时设置 false。

shell
cd /home/docker-compose/sz-service-admin
docker compose --env-file .env -f docker-compose.yml config -q
bash upgrade.sh --no-prune

脚本按需拉取镜像并重建后台,不先 down。普通升级有中断窗口,不等待业务健康,也不会自动恢复。等待冷启动后检查:

shell
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,不能只看后来修改过的安装输入。蓝绿运行文件直接位于后台目录:

text
/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 的镜像和发布参数后,先生成并检查配置,再发布:

shell
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-prune

deploy.sh 会完成:

  1. 按配置准备镜像。
  2. 启动非活跃槽位。
  3. 等待新实例健康。
  4. 更新 Nginx upstream 并 reload。
  5. 停止旧槽位,写入当前状态。

默认健康路径为 /api/actuator/health。发布后检查当前槽位、代理和健康:

shell
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/health

IMPORTANT

普通/蓝绿开关只用于首次安装,已有环境不能修改开关后重跑 install 自动互转。蓝绿发布失败时会尝试保留或恢复旧路由,但不能保证数据库不兼容变更或外部代理故障下服务不中断。

旧环境更新脚本、迁移 IMAGE_NAME、SPRING_ACTIVE 等字段及失败恢复,见 旧环境升级指南。不要只复制单个 deploy.sh,运行目录内的模板、defaults、lib 和 Nginx 文件需要成套保留。

九、资源目录与 Nginx 静态访问 ​

RESOURCE_DATA_DIR 是 LOCAL 资源持久化目录:

properties
RESOURCE_DATA_DIR=/home/data/sz-resource

后台对该目录读写,nginx-static 只读挂载,由前端通过同源 /resource/ 提供访问。重建容器时保留资源目录,避免本地上传文件丢失。

如果主要使用 OSS,也应保留 LOCAL 场景需要的资源文件。选择 MinIO/RustFS 不会自动把 LOCAL 场景改成 OSS。

十、数据库备份 ​

首次安装通过以下参数配置所选数据库的备份任务:

properties
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

自动备份不能替代生产级灾备。上线前至少验证一次数据库、应用配置和资源目录的恢复,并保留服务器外备份。配置恢复不等于数据库或对象数据回滚。

十一、常用运维命令 ​

查看服务状态:

shell
cd /home/docker-compose/sz-service-admin
docker compose --env-file .env -f docker-compose.yml ps

蓝绿模式将文件参数改为 -f docker-compose.gen.yml。

查看普通后台日志:

shell
docker logs -f sz-service-admin

普通模式升级:

shell
cd /home/docker-compose/sz-service-admin
bash upgrade.sh --no-prune

蓝绿模式发布:

shell
cd /home/docker-compose/sz-service-admin
bash gen-conf.sh
bash deploy.sh --no-prune

WebSocket 服务升级:

shell
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. 蓝绿部署一直回滚 ​

先看脚本报错和新槽位日志:

shell
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 可以复用。

十三、相关文档 ​