type
status
date
slug
summary
category
tags
create_time
May 22, 2025 08:06 AM
icon
password
my_create_time
📌 背景介绍
Notion 是一个极受欢迎的协作笔记与知识库工具，而阿里云效是国内广泛使用的 DevOps 平台。
这篇我们将二者结合，可以打通“文档+执行”的最后一步 —— 让团队成员在 Notion 页面中点击按钮，即可触发云效的自动化构建或部署流程。
这样做有如下优势：
- 无需开发背景的成员也能触发构建
- 保证触发流程与文档内容强关联
- 降低切换成本，提升团队协作效率
🛠 实现步骤
1. 创建云效流水线并配置 Webhook
打开云效自动化流水线，进行如下操作：
- 进入项目 > 流水线 > 选择或新建一个流水线
- 点击“触发设置”> 开启 “Webhook触发”
- 此时会自动生成通用 Webhook 和流水线源 Webhook，我们只需要使用通用的即可。
2. 自定义一个 POST API 接口
由于 Webhook 必须是通过 POST 发送请求的，但是原生 Notion Button 不支持发送
POST HTTP 请求，需要借助第三方服务。这里我们可以自己简单的通过 Python 提供一个 GET 的 API 接口，然后在该接口中去调 Webhook 即可。
核心代码如下：
完整代码已上传到github:
最后需要将该代码部署到服务器，然后在 Notion 中调用即可。
3. 在 Notion 添加 Button 调用
- 随便新建一个文档，然后添加 Button
- 在按钮新操作中选择打开页面、表单或网址
- 地址填写为：
https://<你的域名>/release?token=<你的流水线token>
4. 测试与验证
在你的 Notion 文档中点击按钮，检查云效流水线是否被成功触发。
可前往云效流水线界面查看执行日志。
🧠 总结与思考
通过将 Notion 的 Button 功能与云效自动化流水线结合：
- 实现了从“知识管理”到“执行协作”的闭环
- 降低了 DevOps 的使用门槛
- 为跨职能团队提供了一种更自然的协作方式
这种模式尤其适合：
- 中小型团队希望简化部署流程
- 产品或测试人员希望主动触发部署
- 想将“文档即入口”理念落地的团队
有关文章的任何疑问，欢迎您在底部评论区留言，一起交流~
若您认可我的内容，欢迎 请我喝杯咖啡~
- 作者:lusyoe
- 链接:https://blog.lusyoe.com/article/notion-button-trigger-pipeline
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议，转载请注明出处。
