自动部署

本节假设你已经阅读了上一节快速上手,文档已经编写完毕,且已经将你的项目放置到 Github 或其他 Git 源上。本节将以 Netlify 为例,来介绍如何实现自动部署。

1 新建一个 Netlify 项目

如果你未曾使用 Netlify,你需要首先注册一个 Netlify 账号。目前,Netlify 支持直接通过 Github、Gitlab、Bitbucket 直接登录,并直接选择现有的 Repo。

image.png

选择你想要部署的项目后,填写正确的部署设置:

image.png

2 Netlify 配置

在你的 Netlify 项目中,依次通过 Settings > Build & deploy > Continuous deployment > Build hooks 找到新建 Hook 的位置。

点击 Add build hook 新建一个 Hook 后,记住拿到的 hook,它的格式应该是这样:

https://api.netlify.com/build_hooks/XXXXXXXXXXXXXXX

3 语雀配置

进入语雀知识库的 设置 > 开发者设置 > 添加 Web Hook:

image.png

填写在上一步获取到的 Hook URL

image.png

其中,两种触发更新的区别在于:

  • 所有更新触发:该知识库下的任何一篇文档的更新都会触发 WebHook;
  • 仅主动推送更新触发:只在文档发布或更新的时候勾选了「文档有较大更新,推送给关注人」才会触发 WebHook:

image.png




使用语雀查看