鸿蒙私仓服务器部署教程

注意：

  • 项目全程指令使用新创建账号来使用，因为root权限太大私仓不支持

  • 每次修改config.yaml参数时要更新项目配置文件使用，install指令进行更新

一、环境要求

由于鸿蒙私仓是基于nodejs进行开发的。

  • 要求node.js 16.x 及以上版本
  • 要求使用安装pm2守护进程管理器

  1. 安装可以在 宝塔面板=> 软件商店 =>nodejs版本管理器

    nodejs版本管理器自带node版本下载控制和自带pm2

安装1.png

  1. 安装下载ohpm-repo私仓压缩包私仓压缩包下载地址

下载2.png

  1. 上传文件到www=>wwwroot=>ohpm-repo（创建文件夹）中，进行解压。

    安装2.png

二、全局环境变量配置

注意：服务器部署中不能使用root权限用户进行启动项目，否则启动失败

创建新用户

sudo useradd [名称]   // 创建新用户（root）
passwd [名称] // 给新用户设置密码（root）
su [名称] // 切换用户

创建新用户1.png

环境变量ohpm-repo 指令全局配置

在服务器 根目录=>etc=>profile文件中配置环境变量（最后一行添加以下内容）

PATH=/www/wwwroot/ohpm-repo/bin:$PATH # OHPM_REPO
export PATH # OHPM_REPO

注意：PATH地址为你的服务器下载压缩项目的地址的bin目录

三、部署项目

下载依赖

使用ohpm-repo指令来对项目进行初始化操作

ohpm-repo install

注意：使用指令初始化请在项目中的bin目录使用以上指令进行初始化

使用指令，就可以看到依赖成功的信息

依赖成功.png

项目要求环境变量配置

根据上面依赖成功的信息中有相对应的部署信息进行复制下来

根据前面的全局环境变量配置一样进行配置，在etc=>profile最后一行加入

OHPM_REPO_DEPLOY_ROOT = /home/xiaopan/ohpm-repo
export OHPM_REPO_DEPLOY_ROOT

参数修改

进入项目中的conf目录中config.yaml文件中可以进行修改来配置服务启动

配置参数.png

项目启动

使用ohpm-repo start指令进行启动项目，会发生问题：

项目启动1.png

解决方式：

问题的产生是由于使用全局指令进行配置倒是使用satrt指令的时候install依赖丢失问题的发生

在项目依赖生成的目录中编写一个sh脚本，使install 指令和start指令一起执行

脚本创建.png

# start_ohpm_repo.sh
ohpm-repo install
ohpm-repo start

脚本编写.png

将项目地址/www/wwwroot/ohpm-repo中的config目录中的config.yaml的server配置为0.0.0.0:8088地址。

注意：服务器记得防火墙释放8088端口

通过在/home/xiaopan/ohpm-repo的目录下使用终端固定目前的项目地址，然后通过pm2指令来启动项目

pm2 start start_ohpm_repo.sh --name="ohpm-repo"
pm2 stop ohpm-repo // 进行停止项目
pm2 delete ohpm-repo // 进行删除项目

通过pm2 日志指令来查看项目的启动情况

pm2 logs ohpm-repo // 查看项目日志

显示这个表示启动成功，可以通过服务器ip地址和端口8088可以进行访问了

启动完成.png

项目成功显示界面.png

私仓登录账号

ohpm-repo 首次启动时，默认创建一个管理员账号，账号名称：admin，密码：12345Qq! 。该账号在首次登录时，需要修改其密码，请修改密码后，重新登录该账号。

四、编辑器连接私仓地址

配置编辑器私仓连接

通过在文件=>设置=>构建、执行、部署=>Ohpm=>优化配置中进行私仓连接

私仓连接.png

通过命名行生成公、密钥

使用ssh-keygen命令工具来生成对应的公、密钥：

ssh-keygen -m PEM -t RSA -b 4096 -f <your_key_path>
  • ： 配置公钥和私钥的名称和存放路径，仅包含名称时，以当前命令行工作路径为存储目录。
  • OHPM 包管理器只支持加密密钥认证，请在生成公私钥时输入密码。

示例：

ssh-keygen -m PEM -t RSA -b 4096 -f E:\Program_Files\deveco5\project\Test1\yourkey\key

先创建yourkey目录

使用命令成功后为：

密钥生成.png

生成后在yourkey目录下就会有两个文件：

  • key.pub 为公钥
  • key 为私钥

私仓配置公钥

通过管理员登录后认证管理=>新增=>添加公钥中来进行添加使用命令行生成的公钥复制到这里来。

私仓公钥配置.png

ohpm配置私钥

使用命令行来配置私钥地址

ohpm config set key_path <your_key_path>

示例：

ohpm配置私钥.png

登录私仓地址，复制发布码

复制发布码.png

将发布码配置到 .ohpmrc 文件中

ohpm config set publish_id <your_publish_id>

执行发布码命令.png

使用命令行发布包

通过命名行设置公共仓库地址

ohpm config set publish_registry <ohpm-repo私仓管理地址>/repos/ohpm

通过命令行发布har包

ohpm publish [har包的地址]

私仓地址配置.png

下载第三方包

通过ohpm指令进行下载

ohpm i [包名]

下载第三方包.png