用 Notion 按钮一键触发云效流水线

青萍叙事2025-05-22

📌 背景介绍

Notion 是一个极受欢迎的协作笔记与知识库工具，而阿里云效是国内广泛使用的 DevOps 平台。

在上一篇《阿里云效静态部署 NotionNext 的完整指南》介绍到了如何使用阿里云效进行网站的静态部署，但是每次发布文章都还需要登录到阿里云控制台，较为麻烦。

这篇我们将二者结合，可以打通“文档+执行”的最后一步 —— 让团队成员在 Notion 页面中点击按钮，即可触发云效的自动化构建或部署流程。

这样做有如下优势：

无需开发背景的成员也能触发构建
保证触发流程与文档内容强关联
降低切换成本，提升团队协作效率

🛠 实现步骤

1. 创建云效流水线并配置 Webhook

打开云效自动化流水线，进行如下操作：

进入项目 > 流水线 > 选择或新建一个流水线
点击“触发设置”> 开启 “Webhook触发”
此时会自动生成通用 Webhook 和流水线源 Webhook，我们只需要使用通用的即可。

2. 自定义一个 POST API 接口

由于 Webhook 必须是通过 POST 发送请求的，但是原生 Notion Button 不支持发送 POST HTTP 请求，需要借助第三方服务。

这里我们可以自己简单的通过 Python 提供一个 GET 的 API 接口，然后在该接口中去调 Webhook 即可。

核心代码如下：

@app.get("/release")
async def release(token: str = Query(..., description="Webhook token")):
    # 从环境变量获取token
    expected_token = os.getenv("WEBHOOK_TOKEN")
    if not expected_token:
        raise HTTPException(status_code=500, detail="WEBHOOK_TOKEN environment variable is not set")
    
    # 验证token
    if token != expected_token:
        raise HTTPException(status_code=403, detail="Invalid token")
    
    # 目标URL
    target_url = f"http://flow-openapi.aliyun.com/pipeline/webhook/{token}"
    
    # 请求头
    headers = {
        "Content-Type": "application/json"`
    }
    
    # 请求体
    payload = {}
    
    try:
        response = requests.post(target_url, headers=headers, json=payload)
        response.raise_for_status()
        return response.json()
    except requests.exceptions.RequestException as e:
        raise HTTPException(status_code=500, detail=str(e))