《kami后端部署》 在进行kami后端部署时,需要按照一系列步骤进行操作。以下将详细阐述每个步骤、可能遇到的问题以及对应的解决方法。

一、检查内核。

  • 首先,我们要检查当前系统的内核版本,通过执行以下命令:

 uname -r

如果内核版本小于4.19,可能会引发兼容性问题。

针对这个情况,您有两种解决方案:要么将内核升级到合适的版本;要么使用最新版的Ubuntu或者Debian系统,因为它们通常配备较新的内核版本。

二、克隆项目

  • 克隆项目是部署kami后端的首要步骤。我们使用git命令从github仓库克隆项目:

 git clone https://github.com/mx-space/kami.git --depth=1

此命令会将kami项目克隆到本地,其中<u>--depth = 1</u>参数表示仅克隆最近一次的提交记录,这样可减少克隆的数据量,提高克隆速度。

  • 进入克隆后的项目目录,获取最新的标签(tag)版本并切换到该版本:

 cd kami && git fetch --tags && git checkout $(git rev-list --tags --max-count=1) 

三、安装依赖

(一)Git LF

  • 安装Git LFS

首先,我们需要安装Git LFS(Large File Storage),它用于处理大型文件的版本控制。

执行以下命令来添加Git LFS的安装脚本仓库:

curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh |sudo bash 

这个命令从指定网址获取安装脚本,并以sudo权限执行,从而将Git LFS的仓库添加到系统中。

  • 接着安装Git LFS:

sudo apt-get install git-lfs
  • 安装完成后,使用Git LFS拉取相关文件:

 git lfs fetch --all
 git lfs pull

(二)安装Node.js和npm

  • 添加NodeSource仓库 - Node.js

首先,我们要添加NodeSource仓库,以确保能够安装到最新版本的Node.js。

执行以下命令:

 curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -  

此命令从NodeSource官方网址获取适用于Node.js版本18.x的安装脚本,并以sudo -E权限执行(-E参数会保留当前环境变量)。

  • 安装Node.js - 执行以下命令来安装Node.js:

  sudo apt-get install -y nodejs  

这里的-y参数表示在安装过程中自动应答“yes”,避免手动确认安装提示。

  • 验证Node.js和npm安装

安装完成后,我们可以通过执行以下命令来验证Node.js和npm是否正确安装:

node -v && npm -v   

这将分别显示Node.js和npm的版本号,如果能正确显示,则表明安装成功。

  • 安装pnpm 使用npm安装pnpm

pnpm是一种快速且节省磁盘空间的包管理工具,我们使用npm来安装它。执行以下命令:

 sudo npm install -g pnpm    

这里的-g参数表示全局安装,这样就能在任何目录下使用pnpm命令。

  • 验证pnpm安装

    安装完成后,通过执行以下命令验证pnpm是否安装成功:

pnpm -v    

如果在拉取依赖时遇到问题,可能是网络原因导致的。此时可以尝试配置国内源来提高拉取速度。

  • 配置国内源(以淘宝NPM为例)

设置镜像源 - 执行以下命令将npm的镜像源设置为淘宝NPM:

npm config set registry https://registry.npmmirror.com    
  • 查看镜像使用状态

    • 若要查看当前npm正在使用的镜像源,执行:

  npm config get registry   

网络连通性测试

  • 为确保能够正常连接到镜像源,可使用ping命令进行测试:

ping registry.npmmirror.com    

清空缓存

  • 如果之前使用过其他镜像源或者在安装过程中出现问题,可以尝试清空npm缓存。执行以下命令:

   npm cache clean --force 

(三)安装依赖(使用pnpm)

运行pnpm i命令来安装package.json文件中列出的所有依赖:

 pnpm i 

如果在安装依赖时出现报错或者安装失败的情况,可以指定npm镜像源来安装依赖并且使用pnpm。操作步骤如下: 如果尚未全局安装pnpm,首先执行:

  npm install -g pnpm   

然后使用npm并指定镜像源来安装依赖:

  npm install pnpm i --registry=https://registry.npmmirror.com

四、配置 ENV

将 .env.example 改为 .env

编辑 .env 文件具体配置官方文档有详细写

Mix Space 文档

五、开始构建

使用pnpm进行构建:

 pnpm build 

如果构建过程中出现权限报错,可以尝试执行以下命令:

 chmod +x node_modules/.bin/cross - env 

此命令会给node_modules/.bin/cross - env文件添加可执行权限,可能解决构建过程中的权限问题。

六、启动前端

使用pnpm启动前端:

pnpm prod:pm2 

如果前端pm2报错,可以按照以下步骤操作:

  • 全局安装pm2

使用npm安装pm2:

  npm install -g pm2    

或者使用cnpm安装pm2:

  cnpm install -g pm2  
  • 验证pm2安装

安装完成后,验证pm2是否安装成功:

 pm2 --version   
  • 确认pm2的路径

执行以下命令来查看pm2的安装路径:

 which pm2 

七,总结

通过以上步骤,就可以完成kami后端的部署工作。在每个步骤中,如果遇到问题,请仔细查看报错信息,并根据上述提供的解决方法进行处理。希望这篇文章能够帮助您顺利部署kami后端项目。

八,参考资料

项目官方地址

瞄二大佬

配置npm


文章作者: Tmmmi
本文链接:
版权声明: 本站所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自 Tmmmi
网站搭建 博客搭建
喜欢就支持一下吧