Plausible社区版PostgreSQL数据库升级指南

Plausible社区版PostgreSQL数据库升级指南

community-edition Example docker-compose setups for hosting Plausible Community Edition 项目地址: https://gitcode.com/gh_mirrors/comm/community-edition

前言

在维护Plausible社区版分析平台时，随着系统迭代升级，我们可能需要将PostgreSQL数据库从旧版本迁移到新版本。本文将详细介绍如何将PostgreSQL 12或更高版本升级到14版本，使用pg_dump和psql工具完成这一过程。

准备工作

在进行数据库升级前，请确保：

1. 已备份所有重要数据
2. 了解升级过程会导致Plausible服务暂时不可用
3. 确认当前数据库版本符合升级要求

升级方案概述

整个升级过程采用"导出-导入"策略，主要分为四个阶段：

1. 从旧版本PostgreSQL导出数据库内容到文件
2. 将导出文件复制到主机
3. 替换旧版本PostgreSQL为新版本
4. 将导出文件导入到新版本数据库

这种方案虽然需要短暂停机，但能确保数据迁移的安全性和可靠性。

详细升级步骤

第一步：停止相关服务

首先需要停止Plausible服务，避免在导出过程中有数据写入：

docker compose stop plausible

第二步：导出数据库

使用pg_dump工具导出当前数据库内容：

docker compose exec plausible_db sh -c "pg_dump -U postgres plausible_db > plausible_db.bak"

第三步：备份到主机

将数据库备份文件从容器复制到主机：

docker compose cp plausible_db:plausible_db.bak plausible_db.bak

建议检查备份文件头部信息，确认导出成功：

head plausible_db.bak

第四步：修改配置文件

编辑docker-compose.yml文件，将PostgreSQL镜像版本从12更新到14：

  plausible_db:
-   image: postgres:12
+   image: postgres:14-alpine

第五步：停止并移除旧容器

完全停止并移除旧数据库容器：

docker compose stop plausible plausible_db
docker compose rm plausible_db

第六步：清理旧数据卷

查找并移除旧的数据库数据卷：

docker volume ls
docker volume rm hosting_db-data

第七步：启动新版本数据库

使用新配置启动PostgreSQL 14容器：

docker compose up plausible_db -d

第八步：导入数据

创建新数据库并导入备份数据：

docker compose exec plausible_db createdb -U postgres plausible_db
docker compose cp plausible_db.bak plausible_db:plausible_db.bak
docker compose exec plausible_db sh -c "psql -U postgres -d plausible_db < plausible_db.bak"

第九步：恢复服务

启动所有容器，恢复服务运行：

docker compose up -d

第十步：清理备份文件（可选）

升级完成后，可删除临时备份文件：

rm plausible_db.bak
docker compose exec plausible_db rm plausible_db.bak

注意事项

1. 整个升级过程需要停机维护，建议在业务低峰期进行
2. 确保备份文件完整无误后再进行后续操作
3. 如果数据库较大，导出和导入过程可能需要较长时间
4. 升级后建议全面测试Plausible功能是否正常

常见问题解答

Q: 为什么需要删除旧的数据卷？ A: 不同主版本的PostgreSQL数据目录结构可能不兼容，直接使用可能导致启动失败。

Q: 可以使用其他升级方法吗？ A: 是的，PostgreSQL还提供pg_upgrade工具进行原地升级，但需要更复杂的操作和兼容性检查。

Q: 升级失败如何回退？ A: 保留好备份文件，可以重新部署旧版本PostgreSQL并恢复数据。

通过以上步骤，您应该能够顺利完成Plausible社区版的PostgreSQL数据库升级工作。如果在过程中遇到任何问题，建议查阅PostgreSQL官方文档获取更多帮助。

community-edition Example docker-compose setups for hosting Plausible Community Edition 项目地址: https://gitcode.com/gh_mirrors/comm/community-edition