Repovio品牌升级
移动到 Repovio 名称时保留数据库数据和凭据。
此重命名是一项重大配置更改。将每个以前以产品为前缀的环境变量更新为 REPOVIO_ 前缀,包括
REPOVIO_ENV_FILE、REPOVIO_VERSION、REPOVIO_API_PORT 和
REPOVIO_WEB_PORT。使用ghcr.io/repovio/repovio-api和ghcr.io/repovio/repovio-web下的API和Web图像。
先在之前的 PostgreSQL 17 版本上完成品牌更名。当前 Compose 配置使用 PostgreSQL
18;使用前请完成独立的 PostgreSQL 18 升级。绝不要将 PostgreSQL
17 文件挂载到 PostgreSQL 18 服务。以下步骤使用保留的 PostgreSQL 17 配置,包括其 compose.yml 和
compose.upgrade.yml。品牌更名本身无需数据转换;PostgreSQL 主版本升级是另一项操作。
保留PostgreSQL数据
- 更改部署之前,备份现有数据库并确认备份可以恢复。
- 使用
docker inspect <postgres-container>检查正在运行的 PostgreSQL 容器,并记录在/var/lib/postgresql/data上安装的确切命名卷。停止旧应用程序和 PostgreSQL 容器而不删除卷。 - 将新部署环境中的
REPOVIO_POSTGRES_VOLUME设置为该确切的卷名称。使用docker volume inspect <recorded-volume>确认其存在。新安装默认为repovio-postgres;它不能意外地替换现有安装的卷。4、保留POSTGRES_DB、POSTGRES_USER、POSTGRES_PASSWORD、TOKEN_ENCRYPTION_KEY、AUTH_JWT_SECRET不变。 使 PostgreSQL 保持相同的主要版本。开始前请私下查看docker compose config;它的输出包含已解析的秘密,并且绝不能共享或提交。5、使用docker compose -f compose.yml -f compose.upgrade.yml进行升级。此覆盖要求指定的卷存在,因此拼写错误的卷无法静默初始化空替换。首先启动PostgreSQL并验证现有数据库,然后启动迁移服务和应用程序。切勿在此重命名过程中运行docker compose down --volumes、删除旧卷或初始化空白数据库。
品牌不需要进行数据转换。数据库凭据和加密密钥对于读取现有数据仍然至关重要。可以使用其配置和保留卷来恢复以前的部署;避免并发作家。
身份验证和浏览器状态
默认的 JWT 颁发者现在是
repovio;升级后重新登录。还必须刻意更新显式配置的发行者。不会导入现有的浏览器首选项、通知状态、cookie 和存储密钥。再次选择您的语言/主题,如有必要,重新安装 PWA,然后重新启用浏览器通知。在适当的情况下更新身份提供商的显示名称和外部应用程序配置;回调路线不变。仅在确认新安装有效后才清除过时的站点数据。
撤销以前的 MCP 令牌并创建替换:故意不接受重命名的令牌前缀作为别名。