如何通过Lambda函数触发Jenkins多分支流水线

前提确认 #

• 已配置Jenkins的API令牌（token）和可调用API的凭据（creds）
• Lambda函数已有网络权限访问Jenkins服务器（比如VPC配置、安全组放行）

关键步骤 #

1. 配置Jenkins多分支流水线支持远程触发 #

• 进入目标多分支流水线的配置页面
• 找到 "Build Triggers" 区域，勾选 "Trigger builds remotely (e.g., from scripts)"
• 记录该流水线专属的 "Authentication Token"（注意和全局token区分）
• 确保流水线支持分支指定构建：可在Jenkinsfile中通过BRANCH_NAME变量适配分支逻辑，或开启参数化构建指定分支参数

2. Lambda函数中添加分支判断与触发逻辑 #

根据业务条件（比如事件参数、环境变量）确定目标分支，再调用Jenkins API触发对应分支构建。示例Python代码：

import requests
from requests.auth import HTTPBasicAuth

def lambda_handler(event, context):
    # 从事件或环境变量获取触发条件
    trigger_condition = event.get('trigger_type', 'default')
    
    # 条件与分支的映射规则
    branch_mapping = {
        'prod_release': 'main',
        'beta_test': 'develop',
        'urgent_fix': 'hotfix/latest'
    }
    target_branch = branch_mapping.get(trigger_condition, 'develop')  # 设置默认分支
    
    # 拼接Jenkins多分支流水线的构建API地址
    jenkins_build_url = "http://your-jenkins-address/job/your-multibranch-job/job/{branch}/build"
    request_url = jenkins_build_url.format(branch=target_branch)
    
    # Jenkins认证信息
    jenkins_user = "your-jenkins-username"
    jenkins_token = "your-pipeline-specific-token"
    
    # 发送触发请求
    response = requests.post(
        request_url,
        auth=HTTPBasicAuth(jenkins_user, jenkins_token),
        headers={'Content-Type': 'application/x-www-form-urlencoded'}
    )
    
    if response.status_code == 201:
        return {
            'statusCode': 200,
            'body': f"分支 {target_branch} 构建触发成功"
        }
    else:
        return {
            'statusCode': response.status_code,
            'body': f"构建触发失败: {response.text}"
        }

3. 权限与调试注意事项 #

• 确保Jenkins用户拥有目标多分支流水线的 "Job/Build" 权限
• 若Jenkins启用CSRF保护，需先调用http://your-jenkins/crumbIssuer/api/json获取crumb，再在请求头中添加Jenkins-Crumb: <crumb-value>
• 测试时可在Lambda控制台传入测试事件，验证分支判断逻辑是否符合预期

4. 进阶优化 #

• 将Jenkins地址、凭据、令牌存入Lambda环境变量，避免硬编码
• 添加异常捕获，处理网络超时、Jenkins服务不可用等场景
• 如需传递构建参数，可在POST请求中添加data参数，示例：data={'parameter': [{'name': 'DEPLOY_ENV', 'value': 'prod'}]}

内容的提问来源于stack exchange，提问作者Rishabh