piku配置迁移工具：轻松实现服务器间应用移植
项目地址: https://gitcode.com/GitHub_Trending/pi/piku 痛点与解决方案
你是否在迁移服务器时遭遇过配置丢失、数据损坏或服务中断？作为一款轻量级PaaS（Platform as a Service，平台即服务）工具，piku通过git push即可实现应用部署，但跨服务器迁移仍需手动处理配置、代码和数据。本文将系统介绍如何通过piku原生命令与自定义脚本实现零停机迁移，涵盖环境变量、依赖项、数据库和Nginx配置的完整移植方案。
读完本文你将掌握：
- 3步快速迁移流程（备份→传输→恢复）
- 环境变量与配置项的无缝移植技巧
- 数据库与静态资源的增量迁移方案
- 迁移后验证与故障回滚策略
迁移前准备
环境检查清单
| 检查项 | 源服务器要求 | 目标服务器要求 |
|---|---|---|
| piku版本 | ≥v1.0.0 | ≥v1.0.0（建议与源服务器版本一致） |
| Python版本 | 3.8+ | 3.8+ |
| 依赖组件 | uwsgi、nginx、git | uwsgi、nginx、git |
| 权限 | sudo或root访问 | sudo或root访问 |
| 网络 | SSH互通（建议配置免密登录） | SSH互通（建议配置免密登录） |
验证命令（在源/目标服务器执行）：
# 检查piku版本
piku --version
# 检查依赖组件
dpkg -l | grep -E "uwsgi|nginx|git|python3"
迁移风险评估
| 风险类型 | 影响程度 | 缓解措施 |
|---|---|---|
| 配置文件格式差异 | 高 | 使用config:export生成标准化JSON |
| 数据传输中断 | 中 | 采用rsync增量传输 |
| 权限不一致 | 中 | 迁移后执行chown -R piku:piku |
| 端口冲突 | 低 | 提前检查NGINX_SERVER_NAME配置 |
核心迁移流程
1. 源服务器：完整备份
1.1 导出应用配置
piku的环境变量和运行时配置存储在ENV文件和config命令中，通过以下步骤导出：
# 列出所有应用
piku apps
# 导出单个应用配置（如myapp）
piku config:export myapp > myapp_config.json
# 导出全部应用配置（批量迁移）
for app in $(piku apps); do
piku config:export $app > ${app}_config.json
done
配置文件结构（myapp_config.json示例）：
{
"NGINX_SERVER_NAME": "app.example.com",
"UWSGI_PROCESSES": "4",
"DATABASE_URL": "postgres://user:pass@localhost/db"
}
1.2 备份代码与数据
# 1. 备份Git仓库（含完整提交历史）
sudo cp -r /home/piku/.piku/repos/myapp.git /backup/
# 2. 备份应用数据（如数据库、上传文件）
sudo rsync -avz /home/piku/.piku/data/myapp /backup/data/
# 3. 备份Nginx配置
sudo cp /home/piku/.piku/nginx/myapp.conf /backup/nginx/
1.3 数据库迁移准备
根据应用使用的数据库类型选择迁移方案：
| 数据库类型 | 备份命令 | 恢复命令 |
|---|---|---|
| SQLite | sqlite3 /path/db.sqlite3 .dump > backup.sql | sqlite3 /path/db.sqlite3 < backup.sql |
| PostgreSQL | pg_dump -U user dbname > backup.sql | psql -U user dbname < backup.sql |
| MySQL | mysqldump -u user -p dbname > backup.sql | mysql -u user -p dbname < backup.sql |
2. 目标服务器：环境初始化
2.1 基础环境部署
# 安装piku（使用官方脚本）
curl https://piku.github.io/get | sh
# 验证服务状态
systemctl status piku-nginx
systemctl status uwsgi-piku
2.2 创建应用骨架
# 创建与源服务器同名的应用
piku apps:create myapp
# 设置运行时环境（如Python版本）
piku config:set myapp PYTHON_VERSION=3.9
3. 数据传输与恢复
3.1 配置导入
# 导入应用配置
piku config:import myapp < myapp_config.json
# 验证配置
piku config myapp
3.2 代码部署
# 1. 传输Git仓库
scp -r /backup/myapp.git piku@target-server:/home/piku/.piku/repos/
# 2. 强制同步代码（保留历史提交）
ssh piku@target-server "cd /home/piku/.piku/repos/myapp.git && git reset --hard origin/master"
# 3. 触发部署
ssh piku@target-server "piku deploy myapp"
3.3 数据恢复
# 1. 恢复应用数据
sudo rsync -avz /backup/data/myapp piku@target-server:/home/piku/.piku/data/
# 2. 恢复数据库
cat backup.sql | ssh piku@target-server "psql -U user dbname"
# 3. 修复权限
ssh piku@target-server "sudo chown -R piku:piku /home/piku/.piku"
高级迁移技巧
增量迁移方案
对于大型应用（如10GB+数据），可采用增量迁移减少停机时间：
# 首次全量同步（低峰期执行）
rsync -avz --delete /home/piku/.piku/data/myapp piku@target-server:/home/piku/.piku/data/
# 第二次增量同步（切换前执行，仅传输变更文件）
rsync -avz --delete /home/piku/.piku/data/myapp piku@target-server:/home/piku/.piku/data/
多应用批量迁移脚本
创建migrate_all.sh实现批量迁移：
#!/bin/bash
SOURCE_SERVER="piku@source.example.com"
TARGET_SERVER="piku@target.example.com"
# 导出所有应用配置
ssh $SOURCE_SERVER "for app in \$(piku apps); do piku config:export \$app > /tmp/\${app}_config.json; done"
# 传输配置文件
scp $SOURCE_SERVER:/tmp/*.json /tmp/
# 在目标服务器创建应用并导入配置
for file in /tmp/*_config.json; do
app=$(basename $file _config.json)
ssh $TARGET_SERVER "piku apps:create $app"
scp $file $TARGET_SERVER:/tmp/
ssh $TARGET_SERVER "piku config:import $app < /tmp/$file"
done
迁移后验证清单
| 验证项 | 命令 | 预期结果 |
|---|---|---|
| 应用状态 | piku ps myapp | 所有worker状态为RUNNING |
| 配置一致性 | diff myapp_config.json <(ssh target piku config:export myapp) | 无输出（配置一致） |
| 访问测试 | curl -I http://app.example.com | HTTP 200 OK |
| 日志完整性 | piku logs myapp web.1 | 无ERROR级日志 |
故障处理与回滚
常见问题排查
问题1：导入配置后应用无法启动
原因：目标服务器缺少依赖组件
解决：
# 查看部署日志
piku logs myapp deploy
# 安装缺失依赖（以Python为例）
ssh piku@target-server "source /home/piku/.piku/envs/myapp/bin/activate && pip install -r requirements.txt"
问题2：Nginx 502错误
原因：uWSGI进程未启动或端口冲突
解决：
# 检查uWSGI状态
systemctl status uwsgi-piku
# 查看端口占用
sudo lsof -i :8000
紧急回滚策略
# 1. 在目标服务器停止应用
ssh piku@target-server "piku stop myapp"
# 2. 恢复源服务器DNS解析（如修改域名A记录）
# 3. 在源服务器重启应用
piku restart myapp
总结与最佳实践
piku应用迁移的核心在于配置标准化与数据一致性。通过config:export/config:import命令实现环境变量无缝迁移，结合rsync增量传输和Git仓库同步，可将迁移 downtime 控制在5分钟内。建议迁移前进行完整备份，并在非高峰时段执行操作。
最佳实践清单：
- 始终使用
piku config:export而非手动复制ENV文件 - 数据库迁移前启用读写锁定（如PostgreSQL的
pg_dump --lock-wait-timeout） - 迁移后执行
piku config:live myapp验证运行时配置 - 保留7天迁移备份，防止数据回滚需求
通过本文方法，你可以轻松实现piku应用在物理机、虚拟机或云服务器间的迁移，为服务器升级、灾备或负载均衡提供可靠支持。
附录：迁移工具脚本
config-export插件
将以下代码保存为/home/piku/.piku/plugins/config_export.py：
import json
from piku import parse_settings
def cmd_config_export(app):
config = parse_settings(f"/home/piku/.piku/envs/{app}/ENV")
print(json.dumps(config, indent=2))
# 在piku.py中注册命令（略）
使用：piku config:export myapp
迁移状态检查工具
#!/bin/bash
# migrate-check.sh
app=$1
source_config=$2
target_server=$3
# 对比配置差异
diff <(jq -S . $source_config) <(ssh $target_server "piku config:export $app | jq -S .")
# 检查数据文件MD5
ssh $target_server "find /home/piku/.piku/data/$app -type f -exec md5sum {} \;" > target_md5.txt
find /backup/data/$app -type f -exec md5sum {} \; > source_md5.txt
diff source_md5.txt target_md5.txt
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
