从 Easypanel 迁移
将服务从 Easypanel 逐个迁移到 sh0,在每个服务验证完成之前保持 Easypanel 在线。
开始之前
本指南沿用了我们自己做过的迁移:来自多个项目的约二十个生产服务,从 Easypanel 迁到 sh0,并逐一与生产环境比对。方法刻意采用顺序方式:在 sh0 上部署一个服务,与 Easypanel 提供的内容比对,然后再处理下一个。
1. 列出正在运行的服务
对每个 Easypanel 服务,记录:
- 其来源:Git 仓库和分支;如果应用位于子目录,记下构建路径;如果 Dockerfile 名称不是默认值,也要记下。
- 其环境变量,包括仅在构建时使用的变量。
- 其域名以及应用监听的端口。
- 其数据:使用的数据库,以及写入文件的卷或挂载点。
- 它是否监听端口。队列消费者和调度器不监听端口,在 sh0 上的创建方式也不同。
2. 准备 sh0 服务器
请将 sh0 安装在另一台服务器上,而不是 Easypanel 所在的机器:两者都需要 80 和 443 端口。按照安装操作,然后创建所有者账户。
迁移任何内容之前,先检查主机。该命令会检查 Docker、端口、磁盘空间、证书和时钟,没有阻塞问题时以 0 退出:
sudo sh0 doctor报告示例及每一行的含义见更新与诊断。
3. 重新创建每个应用
在 sh0 上使用与 Easypanel 相同的来源创建每个应用:
- 从您自己的机器,无需 Git 托管:sh0 push 会上传项目目录并构建,有 Dockerfile 时使用它,没有时自动检测技术栈。
- 从相同的 Git 仓库和分支部署:参见 Git 部署。私有仓库、非默认分支以及其他组织的仓库在我们的迁移中均可正常使用。
- Monorepo:将构建路径设为应用所在的子目录;如果文件名不是 Dockerfile,请填写其名称。自定义名称的 Dockerfile 相对于构建路径解析。
- 没有端口的服务(Celery、BullMQ、调度器):请以 Worker(无端口)类型创建。sh0 会检查进程是否持续运行,而不是等待端口。
在首次部署之前复制环境变量,然后将新应用与生产环境比对:相同路径返回相同状态码、相同页面标题、相同健康检查响应。
4. 迁移数据库
在 sh0 上创建与源数据库相同引擎、相同主版本的数据库服务器,然后使用该引擎自带的转储与恢复工具复制数据。以下示例为 PostgreSQL。
将 EASYPANEL_DB 替换为 Easypanel 数据库所在的容器(用 docker ps 查找),将 sh0-dbsrv-<name> 替换为 sh0 数据库服务器的容器。数据库名和用户请使用服务器连接信息中显示的值。
docker exec EASYPANEL_DB pg_dump -U app -d app -Fc > app.dumpdocker exec -i sh0-dbsrv-NAME pg_restore -U app -d app --no-owner --no-privileges < app.dump
docker exec sh0-dbsrv-NAME psql -U app -d app -tAc "select count(*) from orders"用 scp 或 rsync 在两台服务器之间复制转储文件。然后将应用的 DATABASE_URL(或等效配置)指向 sh0 数据库服务器,并重新部署应用。
5. 迁移文件和卷
应用写入的文件(上传文件、生成的文档)存放在 Docker 卷中。通过 tar 归档复制卷内容,然后在 sh0 上为应用添加一个挂载路径相同的卷:
docker run --rm -v SOURCE_VOLUME:/data alpine:3.19 tar -czf - -C /data . > uploads.tgzdocker run --rm -i -v TARGET_VOLUME:/data alpine:3.19 tar -xzf - -C /data < uploads.tgz
docker run --rm -v TARGET_VOLUME:/data alpine:3.19 find /data -type f在每台服务器上用 docker volume ls 查找卷名。在 sh0 上,卷名以 sh0- 加应用名开头。
行为差异
- 内存:Easypanel 默认不设限制;sh0 默认将每个应用限制为 512 MB,除非您调高。在我们的迁移中,一个四 worker 的 Python 后端需要更多内存,在调高之前一直被该限制终止。
- 服务名称:在同一项目中,一个应用可以通过另一个应用的名称或
<app>.internal访问它,该名称在多次部署之间保持不变。请更新原先指向 Easypanel 服务名的主机名。 - 构建上下文:sh0 按照 Docker 的规则读取 .dockerignore,因此能在 Easypanel 上构建的项目在 sh0 上也能以相同方式构建。
- 全新数据库会暴露旧数据库掩盖的问题:在我们的迁移中,有一条迁移链无法在空库上重放,还有一个应用由四个 worker 同时建表。这些是项目自身的缺陷,与平台无关;先恢复数据即可避免。
6. 切换域名
- 提前一天调低要迁移的每条 DNS 记录的 TTL,以便切换迅速生效。
- 在 sh0 上为应用添加该域名。
- 将 DNS 记录指向 sh0 服务器的 IP 地址。记录解析到该服务器后,sh0 会自动获取证书。
- 将线上域名与 Easypanel 之前提供的内容进行比对。
- 确认无误后再停止 Easypanel 上的服务。在确定不需要回退之前,请保留其数据。