kami后端部署
《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 文件具体配置官方文档有详细写
五、开始构建
使用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后端项目。