HarmonyOS Next ohpm-repo多实例部署与数据迁移（进阶）原创

SameX

发布于 2025-3-12 16:42

浏览

0收藏

在企业级开发环境中，随着业务规模的扩大和项目数量的增多，对ohpm-repo的性能和可靠性要求也越来越高。单点部署可能无法满足高并发、高可用性的需求，这时多实例部署就成为了一种更为合适的选择。今天，我们就来深入探讨ohpm-repo在企业级环境中的多实例部署方案，以及如何进行数据迁移。

单点部署vs多实例部署

本地单机模式（单点部署）

单点部署是ohpm-repo最简单的部署方式，它仅部署在一台机器上。这种模式就像是在一个小作坊里工作，所有的工具和材料都放在一个地方，适合小型团队或开发初期的项目。其优点是部署简单，配置方便，对于资源有限、并发需求不高的场景来说，成本较低。但是，单点部署存在明显的局限性，一旦这台机器出现故障，整个私有仓库服务就会中断，影响开发进度。而且，随着业务量的增加，单点部署的性能瓶颈也会逐渐显现，无法满足大量用户同时访问和操作的需求。

服务器集群模式（多实例部署）

多实例部署则是将ohpm-repo部署到多台机器中，这些机器具有相同的配置内容，并且共享数据存储空间。这就好比是一个大型工厂，有多个车间同时工作，每个车间都能独立完成任务，但又共享原材料和信息。多实例部署可以有效提高系统的并发处理能力和可用性。当某一个实例出现故障时，其他实例可以继续提供服务，保证私有仓库的正常运行。同时，通过合理的负载均衡配置，可以将用户的请求均匀分配到各个实例上，提升整体性能。不过，多实例部署的配置和管理相对复杂，需要考虑数据同步、负载均衡等多个方面的问题。

如何迁移已有数据到多实例部署？

export_pkginfo导出包数据

在进行数据迁移之前，我们需要先将单点部署中的包数据导出。ohpm-repo提供了export_pkginfo命令来实现这一功能。该命令可以将ohpm-repo或OpenHarmony三方库中心仓已上架的包列表导出到当前目录的pkgInfo_xxx.json文件。
在单点部署的机器上，打开终端，执行以下命令：

ohpm-repo export_pkginfo

如果要从OpenHarmony三方库中心仓导出包列表，还需要指定--public-registry参数：

ohpm-repo export_pkginfo --public-registry <OpenHarmony三方库中心仓registry地址>

导出的pkgInfo_xxx.json文件包含了所有已上架包的关键信息，这些信息在后续的多实例部署中会用到。

batch_publish批量上传

在多实例部署环境中，我们需要将导出的包数据重新上传到新的实例中。这时就要用到batch_publish命令。该命令可以根据提供的zip文件批量上传其中的包到ohpm-repo。
首先，我们需要将export_pkginfo导出的包数据打包成zip文件（如果有需要，可手动修改pkgInfo_xxx.json文件，指定要上传的部分包）。然后，在多实例部署的其中一台机器上，执行以下命令：

ohpm-repo batch_publish <zip_file>

如果在上传过程中，某个包的组织在ohpm-repo中不存在，可以使用--force参数，让系统选取一位管理员用户作为组织负责人自动创建组织：

ohpm-repo batch_publish <zip_file> --force

通过这两个步骤，我们就可以将单点部署中的包数据迁移到多实例部署环境中。

如何配置MySQL共享存储？

如何配置db: mysql及store: sftp进行数据共享

在多实例部署中，为了实现数据共享，我们通常会选择使用MySQL存储元数据，并结合sftp存储文件。

配置db为mysql：在ohpm-repo解压目录的conf目录下，打开config.yaml文件，找到db配置项，将其类型设置为mysql，并配置相应的数据库连接信息：

db:
  type: mysql
  config:
    host: "数据库主机地址"
    port: 3366 # 根据实际情况修改
    username: "数据库用户名"
    password: "数据库用户密码"
    database: "repo"

为了安全起见，建议使用非最高权限的数据库账户进行连接。
2. 配置store为sftp：在同一config.yaml文件中，找到store配置项，将其类型设置为sftp，并配置sftp服务的相关信息：

store:
  type: sftp
  config:
    location:
      - name: test_one_sftp
        host: "sftp服务主机地址"
        port: 22
        read_username: "有读权限的用户名"
        read_password: "有读权限的用户密码"
        write_username: "有写权限的用户名"
        write_password: "有写权限的用户密码"
        path: /source22
    server: http://<指定的地址> # 根据listen配置和实际网络情况修改

在配置sftp存储时，要注意server地址的配置。当listen的host不为0.0.0.0时，server默认取listen的完整格式；当listen的host为0.0.0.0时，需要根据本机网络接口情况进行配置，建议手动修改为指定的本机ip/域名。同时，如果使用反向代理，还需要配置use_reverse_proxy为true，并正确设置server为反向代理服务器的域名地址。