jenkins如何触发构建

在 Jenkins 中“触发构建”通常指在什么条件下自动或手动启动一次 Job/Pipeline 构建。下面按常见方式系统说明。

一、手动触发构建

最直接的方式：

• Jenkins 页面
  • 打开 Job
  • 点击 Build Now / 立即构建
• REST API

  curl -X POST http://jenkins-url/job/your-job/build \
    --user user:api_token
  

• CLI（较少用）

  jenkins-cli build job-name
  

二、代码提交触发（最常用）

1️⃣ Git / GitHub / GitLab 推送到分支触发

Job 配置 → 构建触发器

• 勾选：
  • ✅ GitHub hook trigger for GITScm polling
  • 或 Poll SCM（见下）

Webhook 配置

• GitHub / GitLab：
  • Webhook URL：

    http://jenkins-url/github-webhook/
    

  • 事件：push

推荐：Webhook 实时触发，而不是轮询

三、定时触发（类似 crontab）

构建触发器 → Build periodically

示例：

H 2 * * *      # 每天凌晨2点
H/30 * * * *   # 每30分钟

格式：

分 时 日 月 周

四、轮询 SCM（Poll SCM）

构建触发器 → Poll SCM

H/5 * * * *

每 5 分钟检查一次代码是否有变更。

⚠️ 不如 Webhook 实时，但简单稳定。

五、上游 Job 触发（Job 依赖）

构建触发器 → Build after other projects are built

或 Pipeline 中：

build job: 'upstream-job', wait: true

也可在 Pipeline 里触发下游：

build job: 'downstream-job'

六、参数化触发构建

1️⃣ 手动传参

Job 启用：

• ✅ This project is parameterized

2️⃣ API 触发带参数

curl -X POST http://jenkins/job/job-name/buildWithParameters \
  --user user:token \
  -d ENV=prod -d BRANCH=main

3️⃣ Pipeline 触发

build job: 'deploy',
  parameters: [
    string(name: 'ENV', value: 'prod')
  ]

七、Pipeline 中的触发方式

1️⃣ 定时器

pipeline {
  triggers {
    cron('H 3 * * *')
  }
}

2️⃣ Git 触发

triggers {
  githubPush()
}

3️⃣ 上游触发

triggers {
  upstream(
    upstreamProjects: 'build-job',
    threshold: hudson.model.Result.SUCCESS
  )
}

八、远程触发（Token）

构建触发器 → Trigger builds remotely

URL：

http://jenkins/job/job-name/build?token=TOKEN

九、常见触发方式对比

如果你愿意，可以告诉我：

• 用的是 FreeStyle 还是 Pipeline
• 代码托管（GitHub / GitLab / 自建 Git）
• 是否 K8s / Docker / 多分支

我可以直接给你可复制的配置或 Jenkinsfile。