npm 包 rishiqing-deploy 使用教程

阅读时长 5 分钟读完

简介

rishiqing-deploy 是一款基于 Node.js 的 npm 包,它可以帮助前端开发者在开发完成后,轻松将代码部署到目标服务器上,达到简化部署流程的效果。rishiqing-deploy 包含以下特性:

  • 支持 SSH 账号登录
  • 支持 SVN 和 Git 代码托管
  • 支持 Webhooks 自动化部署
  • 支持自定义脚本

安装

要使用 rishiqing-deploy,你必须先安装 Node.js 和 npm。接下来,在项目根目录下执行以下命令:

npm 会自动从 npm 软件库中下载 rishiqing-deploy 包,并安装到你的本地环境中。

使用指南

配置文件

rishiqing-deploy 需要在项目根目录创建一个名为 deploy.config.js 的配置文件,并在其中添加以下字段:

-- -------------------- ---- -------
-------------- - -
  -- ------- --- --
  ------- -
    ----- ------------------ -- -- --
    ----- --- -- --- ---
    --------- --------- -- --- --
    --------- ---------- -- --- --
  --

  -- --------
  -------- -
    ----- --------------- -- ---
    ----------- ----------------------------------------- -- --------- --- - ---
    ------- ------------- -- ------
    --------- ---------------- -- ----------
    ------- --------------------- -- --------
  -
--

部署命令

在配置文件中添加好配置信息后,在项目根目录下执行以下命令:

如果执行成功,rishiqing-deploy 会在目标服务器上自动拉取代码,执行部署脚本并完成部署。

Webhooks 部署

如果你使用 GitHub 或 Gitlab 进行代码托管,你可以使用 Webhooks 实现自动化部署。操作步骤如下:

  1. 在项目仓库中添加 Webhooks 配置,设置 Webhooks URL 为 http://yourserver:port/deploy,其中 yourserver:port 是你的目标服务器地址和端口号,如:http://123.456.789.0:3000/deploy

  2. 在目标服务器上运行以下命令开启 Webhooks 服务:

    如果执行成功,rishiqing-deploy 会在本地 3000 端口启动 Webhooks 服务器。

  3. 安装 pm2 和 pm2-logrotate

  4. 在目标服务器上运行以下命令开启 rishiqing-deploy 持久化进程:

    如果执行成功,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

纠错
反馈