简介
rishiqing-deploy 是一款基于 Node.js 的 npm 包,它可以帮助前端开发者在开发完成后,轻松将代码部署到目标服务器上,达到简化部署流程的效果。rishiqing-deploy 包含以下特性:
- 支持 SSH 账号登录
- 支持 SVN 和 Git 代码托管
- 支持 Webhooks 自动化部署
- 支持自定义脚本
安装
要使用 rishiqing-deploy,你必须先安装 Node.js 和 npm。接下来,在项目根目录下执行以下命令:
npm install rishiqing-deploy
npm 会自动从 npm 软件库中下载 rishiqing-deploy 包,并安装到你的本地环境中。
使用指南
配置文件
rishiqing-deploy 需要在项目根目录创建一个名为 deploy.config.js
的配置文件,并在其中添加以下字段:
-- -------------------- ---- ------- -------------- - - -- ------- --- -- ------- - ----- ------------------ -- -- -- ----- --- -- --- --- --------- --------- -- --- -- --------- ---------- -- --- -- -- -- -------- -------- - ----- --------------- -- --- ----------- ----------------------------------------- -- --------- --- - --- ------- ------------- -- ------ --------- ---------------- -- ---------- ------- --------------------- -- -------- - --
部署命令
在配置文件中添加好配置信息后,在项目根目录下执行以下命令:
npx rishiqing-deploy
如果执行成功,rishiqing-deploy 会在目标服务器上自动拉取代码,执行部署脚本并完成部署。
Webhooks 部署
如果你使用 GitHub 或 Gitlab 进行代码托管,你可以使用 Webhooks 实现自动化部署。操作步骤如下:
在项目仓库中添加 Webhooks 配置,设置 Webhooks URL 为
http://yourserver:port/deploy
,其中yourserver:port
是你的目标服务器地址和端口号,如:http://123.456.789.0:3000/deploy
在目标服务器上运行以下命令开启 Webhooks 服务:
npx rishiqing-deploy --webhooks --port 3000
如果执行成功,rishiqing-deploy 会在本地 3000 端口启动 Webhooks 服务器。
安装 pm2 和 pm2-logrotate
npm install pm2 pm2-logrotate -g
在目标服务器上运行以下命令开启 rishiqing-deploy 持久化进程:
pm2 start /path/to/node_modules/rishiqing-deploy/app.js --name deploy-server -- -w -p 3000
如果执行成功,rishiqing-deploy 会在指定端口开启 Webhooks 服务,并启动一个名为 deploy-server 的持久化进程,保证 Webhooks 服务和部署脚本的正常运行。
示例代码
下面是一个 rishiqing-deploy 的配置文件示例:
-- -------------------- ---- ------- -- ---------------- -------------- - - ------- - ----- ---------------- -- ----- -- -- ----- --- -- --- --- --------- --------- -- --- --- --------- ---------- -- --- -- -- -------- - ----- ------------- -- ---- ----------- ----------------------------------- -- --- ------ ------- ------------- -- ------ --------- ---------- -- ------------ ------- -------------- -- -------- - -
这是一个简单的部署脚本示例,当执行 npx rishiqing-deploy
命令时,rishiqing-deploy 会自动运行该脚本:
-- -------------------- ---- ------- - --------- ----------- -- ------------------- - ------ --- ----- ------ --- ----- ------ ----------------- - ---- --- ------- - -- --- -- --- ------- ----
总结
rishiqing-deploy 是一款方便前端开发者进行快速部署的工具。本文介绍了 rishiqing-deploy 的安装和使用方法,并且提供了详细的配置文件示例和部署脚本示例。如果你有自己的部署需求,可以通过自定义脚本来满足。通过学习本文,你不仅能够用 rishiqing-deploy 简化部署流程,还能够了解到如何使用 Webhooks 实现自动化部署。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60067368890c4f7277584048