企业微信 on Liangweidong's blog

Jenkins 镜像实战：JDK21 升级、Agent 集群、钉钉/企微通知、Kubernetes 动态 Agent 与流水线部署 Java/Golang/Vue

Sun, 15 Sep 2024 00:00:00 +0800

Jenkins 是 CI/CD 界的"老大哥"——2004 年从 Hudson 分支出来后，已经走了 20 年。2024 年 9 月它发布了基于 JDK21 的 LTS（2.504.x 系列），而 2024-09-24 正是 Jenkins 官方对 JDK11 镜像停止安全更新的日期。这篇文章不是"Jenkins 是什么"的科普文，而是把零散的实战笔记整理成"从镜像拉取到一条完整流水线"的路径：拉哪个镜像、Agent 怎么挂、钉钉/企微通知怎么接、Kubernetes 上的动态 Agent 怎么配、流水线部署 Java/Golang/Vue 项目分别怎么写。

阅读对象：需要从零搭一套 Jenkins CI/CD，或正在做 JDK8→JDK11→JDK21 升级的开发者、运维
覆盖范围：官方 LTS 镜像选择、Agent 节点（JNLP）、钉钉/企业微信 webhook 通知、Active Choices 级联参数、Generic Webhook Trigger 触发、SSH/Credentials 凭据、Kubernetes 动态 Agent（jnlp-slave）、自定义 sshpass/rsync Agent、流水线部署 Java/Golang/Vue 模板、常见排错

一、Jenkins 镜像选择：JDK8 / JDK11 / JDK21 LTS

Jenkins 官方镜像 jenkins/jenkins 有几个常用 tag，先把它们的关系理清楚：

Tag	含义	备注
`2.346.3-lts-jdk8`	JDK8 + Jenkins 2.346.3 LTS	2022 年主流选择，但 JDK8 已停止安全更新
`2.440.3-lts-jdk11`	JDK11 + Jenkins 2.440.3 LTS	2024 年过渡选择，2024-09-24 停止安全更新
`2.504.2-lts-jdk21`	JDK21 + Jenkins 2.504.2 LTS	当前推荐（LTS 路线）

When to use：JDK21 LTS（2.504.x 系列）已是新装 Jenkins 的默认推荐。JDK11 LTS 在 2024-09-24 之后不再收安全补丁——还在跑 JDK11 的同学需要规划升级。

1.1 最小启动：JDK8 老镜像

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


# 拉镜像
docker pull jenkins/jenkins:2.346.3-lts-jdk8

# 创建数据目录
mkdir -p /data/jenkins/home
chown -R 1000:1000 /data/jenkins/home

# 启动
docker run --name jenkins -d \
 -p 8090:8080 \
 -p 50000:50000 \
 -v /data/jenkins/apache-maven-3.8.6:/data/jenkins/apache-maven-3.8.6 \
 -v /data/jenkins/.nvm:/data/jenkins/.nvm \
 -v /data/jenkins/home:/var/jenkins_home \
 -v /etc/localtime:/etc/localtime \
 --restart=on-failure \
 jenkins/jenkins:2.346.3-lts-jdk8

坑 1：第一个启动慢是因为它要执行 init.groovy.d 下的初始化脚本，并下载默认插件。耐心等几分钟，初始密码可以通过 docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword 拿到。

1.2 JDK11 升级路径（已被 JDK21 取代）

如果已经在线上跑着 JDK8 或 JDK11，可以保留数据卷 jenkins_home，直接换镜像 tag 升级。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


# docker-compose.yaml
version: '3'
services:
 jenkins:
 image: jenkins/jenkins:2.440.3-lts-jdk11
 container_name: jenkins11
 restart: always
 privileged: true
 environment:
 - TZ=Asia/Shanghai
 - JAVA_OPTS=-Duser.timezone=Asia/Shanghai
 ports:
 - "8091:8080"
 - "50001:50000"
 volumes:
 - "/var/run/docker.sock:/var/run/docker.sock" # 让 Jenkins 在容器内调 docker
 - "/usr/bin/docker:/usr/bin/docker"
 - "/home/docker/jenkins11/work:/var/jenkins_home"
 - "/usr/local/maven/apache-maven-3.9.3:/usr/local/maven/apache-maven-3.9.3"
 - "/etc/localtime:/etc/localtime:ro"

升级完后第一次启动会提示"java11 将在 2024-09-24 结束支持"——这是 Jenkins 内置的提示，不是 bug。

坑 2：挂 docker.sock 是为了在 Jenkins 容器内构建镜像（docker build）。但这等同于把宿主机的 docker 权限交给 Jenkins，多用户场景需要谨慎。

1.3 JDK21 升级路径（当前推荐）

1
2
3


docker pull jenkins/jenkins:2.504.2-lts-jdk21
docker tag jenkins/jenkins:2.504.2-lts-jdk21 <private-registry>/base/jenkins/jenkins:2.504.2-lts-jdk21
docker push <private-registry>/base/jenkins/jenkins:2.504.2-lts-jdk21

把启动脚本里的镜像 tag 换成 2.504.2-lts-jdk21 即可，数据卷 jenkins_home 完全兼容——Jenkins 2.504.x 会自动迁移配置。

坑 3：容器时区是对的，但 Jenkins 日志时间格式仍是 UTC。解决：在 系统管理 → 脚本命令行 执行 System.setProperty('org.apache.commons.jelly.tags.fmt.timeZone', 'Asia/Shanghai')，或启动时加 -e JAVA_OPTS=-Duser.timezone=Asia/Shanghai。新版本还支持在 用户列表 → admin → 设置 → 用户自定义时区 里改 UI 时区，但日志里那行仍是 UTC。

二、必备插件清单

Jenkins 的 90% 价值在插件。一份覆盖 90% 场景的最小集合：

插件	作用
`git` / `gitlab`	Git 源码拉取、GitLab 集成
`SSH plugin`	SSH 远程执行命令
`Publish Over SSH`	把构建产物 SCP 到远端并执行命令
`SSH Pipeline Steps` (`ssh-steps`)	流水线里用 `sshCommand` / `sshPut`
`Maven Integration`	构建 Maven 项目
`NodeJS`	构建 Node 项目
`Go`	构建 Golang 项目
`git-parameter`	构建时选择 Git 分支
`Active Choices` (`uno-choice`)	多级参数级联
`Generic Webhook Trigger`	接收 Git 服务的 webhook
`Qy Wechat Notification`	构建后发企业微信
`DingTalk`	构建后发钉钉
`Naginator`	构建失败后自动重试
`Environment Injector`	注入运行时环境变量
`Pipeline` / `Workflow Aggregator`	流水线基础
`Kubernetes`	在 K8s 上跑动态 Agent
`JDK Parameter`	多 JDK 项目里选择 jdk 版本
`Config File Provider`	集中管理 `settings.xml` / `npmrc` 等配置文件

坑 4：插件安装慢？Jenkins 4.x 之后插件源会从 updates.jenkins-ci.org 拉。国内网络下经常卡死，建议：

用 *.hpi 文件手动下载：https://updates.jenkins-ci.org/download/plugins/

或在 系统管理 → 插件管理 → 高级 里把 升级站点 换成国内镜像（如 https://mirror.tuna.tsinghua.edu.cn/jenkins/updates/）

三、钉钉 / 企业微信通知：3 行就能接

3.1 钉钉机器人

群设置 → 智能群助手 → 添加机器人 → 自定义
安全设置选"自定义关键词"或"加签"
拿到 webhook（形如 https://oapi.dingtalk.com/robot/send?access_token=xxxx）
Jenkins 安装 DingTalk 插件，在 Job 配置里填 webhook

curl 直接测试：

1
2
3


curl 'https://oapi.dingtalk.com/robot/send?access_token=<YOUR_TOKEN>' \
 -H 'Content-Type: application/json' \
 -d '{"msgtype":"markdown","markdown":{"title":"构建通知","text":"## ${JOB_NAME} 构建成功"}}'

3.2 企业微信机器人

群右键 → 群机器人 → 添加 → 选"群机器人"
拿到 webhook（形如 https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxx）
Jenkins 安装 Qy Wechat Notification 插件

1
2
3
4
5
6
7
8


curl "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=<YOUR_KEY>" \
 -H "Content-Type: application/json" \
 -d '{
 "msgtype": "markdown",
 "markdown": {
 "content": "## ${JOB_NAME} 构建信息\n**构建ID**: ${BUILD_ID}\n**状态**: ${currentBuild.currentResult}\n[查看日志](${BUILD_URL}/console)"
 }
 }'

3.3 在 Pipeline 里推 commit 信息

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


sh '''
 git config --global log.date format:'%Y-%m-%d %H:%M:%S'
 commit_info=$(git log -1 --oneline --pretty=format:'%s by %an at %cd' --no-merges)
'''
def commitInfo = sh(script: "git log -1 --oneline --pretty=format:'%s by %an at %cd' --no-merges", returnStdout: true).trim()

httpRequest(
 url: 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=<YOUR_KEY>',
 httpMode: 'POST',
 contentType: 'APPLICATION_JSON',
 requestBody: """
 {"msgtype":"markdown","markdown":{"content":"<font color=\"warning\">**${env.JOB_NAME} 构建**</font>\n>提交：${commitInfo}\n>状态：${currentBuild.currentResult}\n[日志](${env.BUILD_URL}/console)"}}
 """
)

坑 5：把 webhook 凭据硬编码在脚本里？不要这样做。把 webhook 放进 Jenkins 凭据（Credentials）→ Secret text 里，再通过 withCredentials([string(credentialsId: 'wechat-webhook', variable: 'WEBHOOK')]) 引用。

四、Agent 集群：JNLP 节点 + K8s 动态 Agent

4.1 JNLP Agent（传统固定节点）

适合：物理机 / 虚拟机 / 容器化的固定 Agent。

前置：在 Agent 机器上装好 java、maven、git。

启动方式 A：java web 启动代理

1
2
3
4
5


nohup java -jar /usr/local/jenkins/agent.jar \
 -jnlpUrl http://<JENKINS_URL>/computer/<NODE_NAME>/jenkins-agent.jnlp \
 -secret <SECRET_FROM_JENKINS> \
 -workDir "/usr/local/jenkins/ws" \
 > nohup.log &

启动方式 B：Kubernetes 上的 JNLP 静态 Agent

1
2


# jenkins-master 上的 SSH remote hosts / Publish over SSH
# 用 Publish Over SSH 把 jar 推到远端, 然后 java -jar 启动

4.2 Kubernetes 动态 Agent（推荐）

Jenkins 装 Kubernetes 插件，每次 Job 触发时在 K8s 里拉一个临时 Pod，构建完销毁。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18


pipeline {
 agent {
 kubernetes {
 cloud 'k8s' # 配在 系统管理 → 节点管理 → Configure Clouds
 inheritFrom 'jnlp-slave' # 复用 Pod Template
 namespace 'kube-ops'
 }
 }
 stages {
 stage('build') {
 steps {
 container('jnlp') {
 sh 'mvn clean package -P prod'
 }
 }
 }
 }
}

前置：

制作 Jenkins 连接 K8s 的证书（K8s ~/.kube/config 的 certificate-authority-data / client-certificate-data / client-key-data 三个字段，base64 解码后保存）
把 kube-ca.crt + kube-cert.pfx 配到 Jenkins 凭据里
创建一个 jnlp-slave Pod Template（基础镜像 jenkins/inbound-agent:latest-jdk21）

K8s 集群配置：

1
2


Kubernetes Cloud URL: https://<K8S_API_SERVER>:6443
Kubernetes Cloud Credentials: <上面做的 pfx 凭据>

坑 6：Pod 启动失败？用 kubectl logs -f --tail=10 查看 Jenkins 动态创建的 Pod。80% 的情况是 jnlp-slave Pod Template 里的镜像拉不到（私有仓库没配 imagePullSecrets）或 Jenkins 容器内没装 rsync。

4.3 自定义 Agent 镜像（装 rsync + sshpass）

jenkins/inbound-agent 基础镜像不带 rsync 和 sshpass，但流水线里经常要用。两种方式：

方式 A：临时容器安装 + commit

1
2
3
4
5
6
7
8


docker run -u root -it --name jenkins-agent-temp \
 jenkins/inbound-agent:latest-jdk21 /bin/bash
# 容器内
apt update && apt install -y rsync sshpass
exit
# 宿主机
docker commit jenkins-agent-temp <private-registry>/base/jenkins/inbound-agent:latest-jdk21-rsync
docker push <private-registry>/base/jenkins/inbound-agent:latest-jdk21-rsync

方式 B：Dockerfile（推荐，可追溯）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


ARG version=latest-jdk21
FROM jenkins/inbound-agent:$version
ARG version
LABEL Description="Custom Jenkins Agent with rsync and sshpass" Vendor="某安全公司" Version="$version"
ARG user=jenkins
USER root
RUN apt-get update && \
 apt-get install -y rsync sshpass && \
 rm -rf /var/lib/apt/lists/*
USER ${user}
ENTRYPOINT ["/usr/local/bin/jenkins-agent"]

1
2


docker build -t <private-registry>/base/jenkins/inbound-agent:latest-jdk21-rsync .
docker push <private-registry>/base/jenkins/inbound-agent:latest-jdk21-rsync

五、流水线：声明式 vs 脚本式

5.1 声明式（推荐）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55


pipeline {
 agent any
 options {
 buildDiscarder logRotator(daysToKeepStr: '10', numToKeepStr: '10')
 timeout(time: 30, unit: 'MINUTES')
 }
 parameters {
 choice(name: 'profiles', choices: ['dev', 'test', 'prod'], description: '请选择构建环境')
 }
 triggers {
 GenericTrigger(
 genericRequestVariables: [[key: 'profile', regexpFilter: '$']],
 token: 'test'
 )
 }
 stages {
 stage('git checkout') {
 steps {
 git branch: 'master', credentialsId: 'gitlab-cred', url: 'http://<GITLAB>/<your-org>/gdsTmqtt.git'
 }
 }
 stage('build') {
 steps {
 sh 'mvn clean package -P prod -DskipTests'
 }
 }
 stage('publish') {
 steps {
 sshPublisher(
 publishers: [sshPublisherDesc(
 configName: 'prod-server',
 transfers: [sshTransfer(
 cleanRemote: false,
 execCommand: '''
 mkdir -p /home/project/safety/gdsTmq/jar
 docker rm -f gdsTomq
 mv /home/tmp/safety-gdsTomq/*.jar /home/project/safety/gdsTmq/jar/
 docker run -d --restart=always --net=host --name=gdsTomq \
 -v /home/project/safety/gdsTmq/jar:/jar \
 <private-registry>/base/jdk:8u381-2 \
 java -jar /jar/gds-0.0.1-SNAPSHOT.jar
 ''',
 remoteDirectory: '/home/tmp/safety-gdsTomq',
 sourceFiles: 'target/gds-0.0.1-SNAPSHOT.jar'
 )]
 )]
 )
 }
 }
 }
 post {
 success { echo 'deploy success' }
 failure { echo 'deploy failed' }
 }
}

5.2 脚本式（灵活但难维护）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


node {
 stage('Remote SSH') {
 def remote = [:]
 remote.name = 'test'
 remote.host = '<INTERNAL_HOST>'
 remote.user = 'root'
 remote.password = '<REDACTED>'
 remote.allowAnyHosts = true
 sshCommand remote: remote, command: "ls -lrt"
 }
}

坑 7：声明式是 2017 年之后的官方推荐。新项目用声明式；老项目如果是脚本式，不要一次性重写，逐步迁移。

六、Active Choices：多级参数级联

真实场景：先选节点（master/dev/联创），再选项目（不同节点不同项目），再选主机（不同节点不同主机），再选分支（不同项目不同分支）。

步骤：

Job 选"参数化构建"
加 Active Choices Parameter，name=agent，Choice Type=Single
Script：

1

return ["master", "dev", "liangchuang"]

加 Active Choices Reactive Parameter，name=project，Referenced parameters=agent

1
2
3
4
5


if (agent.equals("master")) {
 return ["safetyBackend", "safetyAppBackend", "safetyFrontend", "safetyAuth", "safetyAppH5", "safetyGds"]
} else if (agent.equals("dev")) {
 return ["safetyBackend", "safetyAuth"]
}

同样做 host（referenced=agent）、branch（referenced=project）

坑 8：低版本 Jenkins（2.346.x）装 Active Choices 时提示依赖缺失，要先装 script-security 1.x 版本，再装 uno-choice。

七、流水线部署三类项目：Java / Golang / Vue

7.1 部署 Java 项目

参考第五章 5.1 的完整 pipeline。核心点：

mvn clean package -P <profile> 打 jar
sshPublisher 把 jar 传到目标机器
远端 docker rm -f <container> + docker run -d 重启

钉钉/企微通知 + commit 信息：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


stage('notify') {
 steps {
 sh '''
 git config --global log.date format:'%Y-%m-%d %H:%M:%S'
 commit_info=$(git log -1 --oneline --pretty=format:'%s by %an at %cd' --no-merges)
 '''
 script {
 def commitInfo = sh(script: "git log -1 --oneline --pretty=format:'%s by %an at %cd' --no-merges", returnStdout: true).trim()
 httpRequest(
 url: "<WEBHOOK_URL>",
 httpMode: 'POST',
 contentType: 'APPLICATION_JSON',
 requestBody: "{\"msgtype\":\"markdown\",\"markdown\":{\"content\":\"**${env.JOB_NAME} 构建成功**\\n>提交：${commitInfo}\"}}"
 )
 }
 }
}

7.2 部署 Golang 项目

Golang 项目的特殊点：Go 安装路径、GOPATH 设置、交叉编译。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28


pipeline {
 agent any
 environment {
 GOPATH = "${JENKINS_HOME}/golang_workspace"
 GOPROXY = "https://goproxy.cn"
 }
 stages {
 stage('build') {
 steps {
 sh '''
 export PATH=$PATH:$GOPATH/bin
 mkdir -p $GOPATH
 CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o main main.go
 '''
 }
 }
 stage('publish') {
 steps {
 sshCommand remote: [...], command: '''
 rm -f /home/project/tailings/main
 mv /home/docker/jenkins/data/workspace/tailings-backend/main /home/project/tailings/
 chmod +x /home/project/tailings/main
 docker-compose -f /home/docker-compose.yml restart tailings-backend
 '''
 }
 }
 }
}

坑 9：Jenkins 装 Go 插件后，Go 路径会被装到 $JENKINS_HOME/tools/org.jenkinsci.plugins.golang.GolangInstallation/go/<version>/。如果手动 tar -C 解压到 /home/docker/jenkins/data/go/，路径对不上会找不到——解决方法是用 tar -C 时直接建 go1.21.5 子目录，让最终路径是 /home/docker/jenkins/data/go/go1.21.5/。

7.3 部署 Vue 项目

Vue 项目用 npm 构建，产物在 dist/：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42


pipeline {
 agent any
 tools {
 nodejs 'node14.17.3' # 在 全局工具配置 里先加 NodeJS 安装
 }
 stages {
 stage('build') {
 steps {
 sh '''
 npx browserslist@latest --update-db
 npm install
 npm run build:test
 cd dist
 tar -zcvf dist.tar.gz *
 '''
 }
 }
 stage('publish') {
 steps {
 sshPublisher(
 publishers: [sshPublisherDesc(
 configName: 'frontend-server',
 transfers: [sshTransfer(
 sourceFiles: 'dist/dist.tar.gz',
 removePrefix: 'dist/',
 remoteDirectory: '/project/frontend/dist',
 execCommand: '''
 cd /home/project/frontend/dist
 shopt -s extglob
 rm -rf !(dist.tar.gz)
 tar -zxvf dist.tar.gz -C ./
 rm -rf dist.tar.gz
 cd /home
 docker-compose restart frontend
 '''
 )]
 )]
 )
 }
 }
 }
}

坑 10：docker-compose restart frontend 只重启容器，不会重新读 docker-compose.yaml 的端口/环境变量。改了 compose 文件必须 docker-compose up -d。

八、定时构建 + 自动合并代码

轮询 SCM（在 Job 的"构建触发器"里勾选"轮询 SCM"）：

1
2
3
4
5


TZ=Asia/Shanghai
0 9,13 * * * # 每天 9 点和 13 点
0 14,20 * * * # 每天 14 点和 20 点
*/5 16-17 * * * # 每天 16-17 点，每 5 分钟
H/5 * * * * # 每 5 分钟（H 是 hash 分散）

坑 11：5 个星分别是"分时日月周"，别写反。H/5 比 */5 好——Jenkins 会在集群内做 hash 分散，多个 Job 不会同时触发。

自动合并代码（在 SCM 的 Additional Behaviours 加）：

Clean before checkout（构建前清空工作区）
Prune stale remote-tracking branches（同步远程分支）
Merge before build（构建前 merge 目标分支）

坑 12：Name of repository 一定要写 origin，否则 Merge before build 报 Could not find remote ref。

九、常见排错

9.1 “Waiting for Jenkins to finish collecting data” 等待时间长

Jenkins 通过 Maven 构建 Java 项目后，会做 指纹验证——给每个 jar 算一个 SHA-1，写入数据库。Java 项目越大、依赖越多，等待时间越长。

解决：关掉指纹验证 → Job 配置 → 构建环境 → 勾选 “Disable deferred wipeout and improve performance”。

9.2 中文乱码

启动加：

1
2


LANG=zh_CN.UTF-8
JAVA_OPTS=-Dsun.jnu.encoding=UTF-8 -Dfile.encoding=UTF-8 -Duser.timezone=Asia/Shanghai

9.3 IllegalArgumentException: No enum constant io.jenkins.plugins.localization_zh_cn.UserCommunityProperty.ShowConditions

中文插件版本不兼容。解决：删除中文插件 → 重装匹配 Jenkins 版本的 localization-zh-cn 插件 → 重启。

9.4 Publish Over SSH 连接超时

检查：

~/.ssh/known_hosts 里有没有目标机器的公钥（StrictHostKeyChecking=no 可绕过）
远端 sshd_config 是否允许 PasswordAuthentication yes
网络是否可达（telnet <INTERNAL_HOST> 22）

9.5 流水线里 Git 拉取失败

1
2
3
4
5


git branch: 'master', 
 credentialsId: 'gitlab-cred', 
 url: 'http://<INTERNAL_HOST>:13000/<your-org>/gdsTmqtt.git',
 // 新版要加 poll: false 否则每分钟检查一次
 poll: false

9.6 Kubernetes 插件连接集群失败

1
2
3
4


# 查看 Jenkins 创建的 agent pod 日志
kubectl logs -f --tail=10 \
 $(kubectl get pods -n jenkins | grep <job-name> | awk '{print $1}' | head -1) \
 -n jenkins

80% 是这几个原因：

证书过期（K8s 证书默认 1 年）
镜像拉取失败（私有仓库没配 imagePullSecrets）
jnlp-slave Pod Template 里 command / args 写错

十、写在最后

Jenkins 的"全"是把双刃剑——插件生态丰富意味着学习曲线陡。从 2004 年走到 2024 年，Jenkins 仍是大量企业 CI/CD 的"事实标准"（不是"应该"，是"事实上"）。如果你正在做新项目选型，可以看看 GitHub Actions（云原生、YAML 优先）或 Drone（容器化、声明式），但对存量 Jenkins 集群，升级到 JDK21 LTS、关闭指纹验证、清理无用插件，就能让 80% 的项目跑得更稳。

下一步建议：

Jenkins on K8s 的完整部署：Jenkins Master 也跑在 K8s 里 + dynamic Agent
Jenkins Configuration as Code (JCasC)：用 jenkins.yaml 管理所有插件、凭据、节点
Pipeline as Code：把 Jenkinsfile 放进 Git 仓库，Job 通过 Multibranch Pipeline 自动发现

2024+ 视角补充

本文写于 2024-09，2025-2026 期间 Jenkins 关键演进：

Jenkins 2.516.x LTS（2025-04 起）：JDK 17 / 21 双轨 LTS，JDK 11 LTS 已于 2024-09-24 停止安全补丁——本文内容完全契合
Jenkins Evergreen 持续完善：CD-as-a-Service 模式，与 Kubernetes Operator 深度集成
Jenkins on K8s Operator（jenkinsci/kubernetes-operator）：Jenkins Master 本身也跑在 K8s 上，生产级高可用 + 自动备份
Pipeline as Code 主导：Jenkinsfile + Multibranch Pipeline 成为 2025+ 事实标准，老的 FreeStyle Job 模式逐步淘汰
AI 辅助插件（2025+）：Jenkins 接入 LLM 做"日志摘要 + 失败原因诊断"，但仅作为辅助——核心编排仍是声明式流水线

实战建议（2025-2026 视角）：Jenkins 仍是 Java 后端 CI/CD 事实标准；GitHub Actions / GitLab CI 在新项目是强力竞争者，但存量 Jenkins 集群升级到 JDK 21 LTS + 跑在 K8s 上仍是 2025+ 主路线。

参考资料

Jenkins 官方文档：https://www.jenkins.io/zh/doc/
Jenkins 官方镜像：https://hub.docker.com/r/jenkins/jenkins
Jenkins K8s Operator：https://github.com/jenkinsci/kubernetes-operator
Kubernetes 插件：https://plugins.jenkins.io/kubernetes
Active Choices 插件：https://plugins.jenkins.io/uno-choice
Generic Webhook Trigger：https://plugins.jenkins.io/generic-webhook-trigger
钉钉自定义机器人：https://open.dingtalk.com/document/orgapp/custom-robot-access
企业微信群机器人：https://developer.work.weixin.qq.com/document/path/91770

2024 主流 IM 横评：钉钉 / 企业微信 / 飞书 / Slack / Teams / Discord / QQ / 微信

Mon, 15 Apr 2024 00:00:00 +0800

〇、写于 2024-04 的"2024 IM 选型"视角

2015 年我们只有 QQ + 微信，10 年后的 2024 年：钉钉、企业微信、飞书三件套占据国产企业 IM 90% 份额；Slack、Microsoft Teams 在跨境业务里是事实标准；Discord 异军突起，从游戏圈走向技术社区；老牌 QQ 仍是中国个人用户的"文件传输之王"，微信 PC 仍是国民级沟通工具。

本文按"国产企业 IM → 海外企业 IM → 个人 / 社区 IM"三大块做 2024 年的横评，所有功能描述以 2024-04 当时版本为准。

一、8 款 IM 全景对比（2024-04）

工具	定位	平台	强项	弱项	适合
钉钉	国产企业 IM	Win/Mac/Linux/iOS/Android	DING 强提醒 / OA / 考勤	海外体验一般	制造业 / 政企 / 强管理
企业微信	腾讯企业 IM	Win/Mac/iOS/Android	与微信互通 / 客户群	内部 IM 弱于钉钉	与微信客户打通的销售 / 运营
飞书	字节企业 IM	Win/Mac/Linux/iOS/Android	多维表格 / 协作文档 / 体验	老牌企业迁移成本高	互联网 / 创新业务 / 全球化
Slack	海外企业 IM	Win/Mac/Linux/iOS/Android + Web	生态 / 集成 / 频道	中文体验差	跨境业务 / 海外团队 / DevOps
Microsoft Teams	微软全家桶	Win/Mac/iOS/Android + Web	与 Office 365 深度集成	启动慢 / 占用大	已上 Office 365 的中大型企业
Discord	社区 + 语音	Win/Mac/Linux/iOS/Android	语音频道 / 社区运营	缺企业 OA	技术社区 / 开源项目 / 兴趣群
QQ	个人 + 文件传输	Win/Mac/iOS/Android	大文件 / 截图 / 远程协助	工作场景弱	个人 / 跨设备文件
微信 PC	国民级沟通	Win/Mac	国民覆盖 / 视频号	不支持多账号 / 不能加好友	客户沟通 / 朋友圈运营

二、钉钉：制造业与政企的"国民 App"

2.1 核心模块

消息：DING 消息（电话级强提醒 + 已读回执 + 未读电话外呼）
工作台：OA / 审批 / 考勤 / 打卡 / 报销
文档：钉钉文档（表格函数对标 Excel 365）
视频会议：钉钉会议（对标腾讯会议）
群直播：培训 / 公开课
考勤打卡：弹性 / 固定 / 外勤 / Wi-Fi 打卡
审批流：自定义流程 + 表单

2.2 杀手锏：DING 消息

已读回执（强制要求确认）
未读电话外呼（未读 5 次会发短信）
适合紧急通知 / 运维告警

1
2
3
4


# CI/CD 失败告警 → DING webhook
curl -X POST "https://oapi.dingtalk.com/robot/send?access_token=XXX" \
 -H "Content-Type: application/json" \
 -d '{"msgtype":"text","text":{"content":"⚠️ 构建失败: <BUILD_URL>"}}'

2.3 钉钉文档对比

工具	强项
钉钉文档	表格函数最全、考勤排班
腾讯文档	微信生态打通
飞书文档	多维表格 + 思维笔记（创新者）
语雀	程序员知识库（阿里出品）

三、企业微信：与微信互通的"销售运营神器"

3.1 核心定位

内外打通：唯一能与个人微信双向加好友的"半官方"通道
客户群：单群 500 人，群发助手 / 客户标签 / 离职继承
SCRM：第三方应用市场丰富的客户运营工具
与微信生态打通：小程序 / 视频号 / 公众号全链路

3.2 群发助手

内部群：单次 200 人
外部客户群：单次 200 客户/天（避免骚扰）
支持文字 / 图片 / 链接 / 小程序卡片

3.3 Webhook 与机器人

1
2
3
4


# 企业微信群机器人 Webhook
curl -X POST "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=XXX" \
 -H "Content-Type: application/json" \
 -d '{"msgtype":"text","text":{"content":"部署完成"}}'

四、飞书：创新团队与多维表格的"协同一哥"

4.1 核心模块

消息：频道 + 话题（类 Slack，不强制全员打扰）
多维表格：类 Airtable（字节创新代表）
飞书文档：思维笔记 / 画板
妙记：会议自动转录 + AI 总结（2024 杀手锏）
视频会议：飞书会议
应用引擎：低代码搭建业务应用

4.2 多维表格 5 大场景

OKR 跟踪：双视图（表格 + 看板 + 甘特图）
需求池：表单收集 + 自动评审流
资产管理：设备/工位/合同到期提醒
客户 CRM：对接外部 SCRM
Bug 跟踪：状态机 + 自动通知

4.3 妙记（2024 杀手锏）

会议中自动识别发言人
会议结束 5 分钟出"摘要 + 行动项 + TODO"
多语言实时翻译
全文搜索"上次会议谁说过去做这件事"

五、Slack：海外企业 IM 的事实标准

5.1 核心特性

频道（Channel）：按主题 / 项目 / 团队分频道
线程（Thread）：主消息 + 嵌套回复，避免主频道刷屏
应用市场：2400+ 应用（Jira / GitHub / Datadog / PagerDuty 一键集成）
Slackbot：自动化工作流（Workflow Builder 2024 已图形化）
Canvas：2024 新增的"协作文档"
Huddle：轻量语音（对标 Teams 的"抱团"）

5.2 DevOps 集成示例

GitHub → Slack：新 PR / Issue 自动推到 #dev 频道
Datadog → Slack：告警分级路由（critical → @oncall）
Jenkins / GitLab CI → Slack：构建状态实时更新
Sentry → Slack：错误堆栈直接贴到 #frontend 频道

5.3 痛点

中文体验差（搜索中文分词、表情包）
免费版消息只保留 90 天
网络国内访问需稳定海外通道

六、Microsoft Teams：Office 365 全家桶的"必装件"

6.1 核心特性

与 Office 365 深度集成：Word / Excel / PowerPoint 实时协作
频道（Team）：按部门 / 项目建 Team
会议：2000 人上限，会议录制自动落到 OneDrive / SharePoint
电话（Teams Phone）：云 PBX
应用：200+ 应用 + Power Platform 集成

6.2 适用场景

已上 Office 365 / Microsoft 365 的中大型企业——Teams 是必装
跨国企业（Teams 全球网络质量好）
金融 / 政企（合规、审计、eDiscovery）

6.3 痛点

启动慢（10-30 秒）、内存占用大（空闲 500MB+）
离职文件归属复杂（与 OneDrive / SharePoint 权限绑定）
与 Slack / 飞书对比 UI 偏传统

七、Discord：技术社区与兴趣群的"语音之王"

7.1 核心特性

服务器（Server）：类 IRC 频道
语音频道：永远在线的低延迟语音（点连接即通话）
舞台频道：1000+ 听众的"播客式"直播
机器人生态：10000+ 社区机器人（Moderation / Music / Game）
屏幕共享 + 视频
跨平台：Win/Mac/Linux/iOS/Android + Web

7.2 适用场景

开源项目社区（React、Vue、Elixir 等大项目都用 Discord）
游戏公会（语音 + 频道天然适合）
兴趣群（加密货币、AI 绘画、读书会）
企业 Meetup / 技术沙龙

7.3 痛点

缺企业 OA（考勤、审批流基本没有）
管理后台偏弱（相比企业微信 / 飞书）
国内访问偶发抽风（虽已备案）

八、QQ：2024 仍是"文件传输之王"

8.1 2024 状态

单文件 4GB（比微信 100MB 强 40 倍）
离线文件支持（接收方不在线也能传）
文件夹传输（右键 → 发送文件夹）
群最多 3000 人（超级群）
截图：Ctrl+Alt+A（国民级截图快捷键）+ OCR
远程协助（局域网极快，跨公网卡）

8.2 适用场景

跨设备传大文件
临时截图 + 标注
老牌技术群（QQ 群至今仍是很多技术社区主阵地）

九、微信 PC：国民级沟通 + 视频号 + 小程序

9.1 2024 状态

文件 100MB（小，大文件用微云）
视频号直播可在 PC 端观看
公众号 / 小程序 PC 端也能开
屏幕共享与腾讯会议联动
多开痛点：官方不支持，需用 “WeChatMultiple” 等第三方工具（有封号风险）

十、组合实战

10.1 国产企业办公三件套

1
2
3


钉钉（考勤 / DING 强通知 / 制造业）
+ 企业微信（客户群运营 / 销售）
+ 飞书（多维表格 / 协作文档 / 创新业务）

10.2 跨境 / 外贸业务

1
2
3
4


Slack（与海外客户/团队协作）
+ Teams（与微软生态客户开会）
+ 飞书（国内研发 + 海外业务）
+ 邮件（兜底）

10.3 互联网 / DevOps 团队

1
2
3
4


Slack / 飞书（IM + 频道）
+ GitHub / GitLab（PR / Issue 集成到频道）
+ Datadog / Grafana（告警推到频道）
+ 飞书妙记 / 腾讯会议录制（会议纪要）

十一、选型决策树

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23


需要 OA / 考勤 / 强管理？
└─ 是 → 钉钉

需要与微信客户群打通？
└─ 是 → 企业微信

需要创新协作 / 多维表格 / 全球化？
└─ 是 → 飞书

已上 Office 365？
└─ 是 → Teams（必装）

海外业务 / DevOps 生态集成？
└─ 是 → Slack

开源 / 游戏 / 兴趣社区？
└─ 是 → Discord

个人 / 大文件 / 跨设备？
└─ 是 → QQ

国民级客户沟通 / 朋友圈？
└─ 是 → 微信 PC

十二、常见问题

12.1 飞书 / 钉钉 / 企业微信同时装？

可以，但建议团队统一。三家都支持"通讯录互通"——选其中一家做主 IM，其它两家做"外部对接"。

12.2 Slack 国内网络问题

企业网络走合规的海外业务通道（不绕 GFW）
个人使用的请使用 Slack 官方 Web 版
建议有出海业务再装

12.3 飞书妙记 vs 腾讯会议录制

工具	强项
飞书妙记	AI 摘要、说话人识别、跨会议搜索
腾讯会议录制	视频存档、共享屏幕回放

12.4 Discord 国内使用

国内直连基本可用（Discord 在 2022 已合规备案）
部分 AI 绘画 / 加密货币社区是 Discord 主场

十三、下一步

企业 IM + DevOps 集成：参考 2024-03 飞书妙记、Slack Workflow Builder
多维表格做业务系统：参考飞书 / Airtable
会议纪要 AI：飞书妙记 / 腾讯会议 AI 字幕
旧版提示：本文首发于 2015 年，最近一次 2024-04 大改——5 款工具扩张到 8 款，去掉 ToDesk 单独成文，补充 2024 主流视角

2.1 安装与登录

官方 https://im.qq.com/。Windows PC 版 + Mac 版 + 手机版。登录方式：

账号 + 密码（已支持手机号）
扫码登录（多设备同时在线）
微信扫码（关联登录）

2.2 办公高频功能

文件传输：

拖文件到聊天窗口 → 上传到 QQ 云
单文件最大 4 GB（2024+）
文件 7 天后过期（重要文件要转存微云）
文件夹传输：右键 → 发送文件夹

截图：

Ctrl + Alt + A（默认截图快捷键）
区域截图 / 窗口截图 / 截长图
标注：方框、箭头、马赛克、文字
OCR 文字识别（2020+ 客户端内置）

远程协助：

聊天窗口 → + → 远程协助
被控端 点"接受" → 主控端 看到屏幕
可控制 vs 仅查看两种模式
速度比 ToDesk 慢（局域网优化好，跨公网卡）

通讯录：

同事 → 公司组织架构
外部客户 → 群标签管理
群最多 3000 人（超级群）

2.3 QQ 五笔

SogouWBInput.md 对应搜狗五笔——QQ 早期办公的标配输入法。比拼音快、比双拼更准。

详见 [2015-11-15 系统效率工具：7-Zip / AHK / 搜狗五笔]

三、微信 PC 版：国民级通讯

3.1 安装

https://weixin.qq.com/。注意：

微信 PC 必须先在手机端登录才能扫码登录
不支持多账号（有需求装"多开助手"）
微信 PC 不能直接加好友（先在手机加）

3.2 办公场景

文件传输：

聊天窗口拖文件 → 临时存储
单文件 100 MB（比 QQ 小）
跨设备同步：手机发的文件 PC 立即看到
大文件走微云

群：

普通群 500 人
群文件长期保留
群接龙 / 群公告功能（企业微信风格）

视频号：

PC 端可看视频号直播
屏幕共享：与"腾讯会议"联动

3.3 微信开发者工具

前端开发者必装——调试小程序：

https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html
模拟手机端 + 真机调试
微信扫码登录后即可预览

3.4 微信 + IDE

IDEA WeChat Plugin：代码提交时微信通知
VSCode WeChaty：机器人框架
企业微信 Webhook：CI/CD 推送告警

四、钉钉：企业协作的"国民 App"

4.1 安装

https://www.dingtalk.com/。Windows + Mac + Linux 全平台（国产 IM 罕见）。首次启动用手机号注册 → 扫码登录。

4.2 核心模块

模块	用途
消息	IM 基础功能（DING 消息强提醒）
工作台	OA / 审批 / 考勤 / 打卡
文档	协作文档（对标飞书）
视频会议	与"腾讯会议"直接竞争
钉钉群直播	培训 / 公开课
考勤打卡	弹性 / 固定 / 外勤
审批	自定义流程

4.3 杀手锏：DING 消息

钉钉的 DING 消息是电话级强提醒——

已读回执（强制要求确认）
未读电话外呼（未读 5 次会发短信）
适合紧急通知 / 运维告警

1
2
3
4
5


实战：CI/CD 失败告警
- 触发：Jenkins / GitLab CI 失败
- 渠道：DING webhook
- 配置：群 → 群设置 → 智能群助手 → 添加机器人 → 自定义
- Webhook URL：https://oapi.dingtalk.com/robot/send?access_token=XXX

1
2
3
4
5
6
7
8
9


# curl 发送 DING 告警
curl -X POST "<webhook>" \
 -H "Content-Type: application/json" \
 -d '{
 "msgtype": "text",
 "text": {
 "content": "⚠️ 构建失败: <BUILD_URL>"
 }
 }'

4.4 钉钉机器人

自定义机器人：Webhook + 加签
企业内部机器人：调用企业 OpenAPI
群机器人：自动回复 / 集成 Jenkins

4.5 钉钉文档 vs 腾讯文档 vs 飞书

工具	强项
钉钉文档	表格强（钉钉表格函数最全）
腾讯文档	微信生态打通
飞书文档	多维表格 + 思维笔记（创新者）
语雀	程序员知识库（阿里出品）

五、腾讯会议：云会议的事实标准

5.1 安装

https://meeting.tencent.com/。Windows + Mac + iOS + Android。首次启动微信扫码登录。

5.2 核心功能

会议规模：

免费版：100 人 / 60 分钟
商业版：300 人 / 24 小时
旗舰版：2000 人

关键能力：

屏幕共享（含应用窗口）
白板（多端实时同步）
会议录制（云端 + 本地）
AI 字幕（2023+ 自动转录）
背景虚化（绿幕抠图）
等候室（控制准入）
同声传译（AI 翻译）

5.3 Webhook 接入

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# 会议开始/结束事件订阅（企业版）
POST /webhook HTTP/1.1
Content-Type: application/json

{
 "event": "meeting.started",
 "data": {
 "meeting_id": "123-456-789",
 "start_time": 1714100000,
 "host": "user@example.com"
 }
}

5.4 与钉钉 / 飞书对比

维度	腾讯会议	钉钉会议	飞书会议
稳定性	★★★★★	★★★★	★★★★
UI 美观	★★★★	★★★	★★★★★
生态	微信	钉钉	飞书
大型会议（>500人）	★★★★★	★★★	★★★
海外体验	★★★★	★★	★★★

选型：

腾讯系 → 腾讯会议
阿里系 → 钉钉
字节系 → 飞书
混合办公 → 腾讯会议（兼容性最好）

六、ToDesk：国产远程桌面新星

6.1 定位

ToDesk 2020 年发布，对标 TeamViewer / AnyDesk。优势：

国内服务器 → 国内连国内快（vs TeamViewer 走国外）
免费版不限速（TeamViewer 商业检测严）
个人免费（不用像 TeamViewer 一样被怀疑商用）

6.2 安装

https://www.todesk.com/。Windows + Mac + Linux + iOS + Android 全平台。

6.3 核心功能

功能	详情
远程控制	主被控角色
文件传输	拖拽即可
屏幕墙	同时看多台
命令行	终端远控
隐私屏	黑屏保护

6.4 性能优化

4K / 60 FPS：高带宽场景
色彩模式：4:4:4 文字 / 4:2:0 视频
编码：H.264 / H.265 / AV1
键盘映射：Mac → Windows / Windows → Mac

6.5 安全机制

临时密码 vs 固定密码
设备授权：信任列表
登录二次验证
黑屏 + 锁键鼠：被控时启用

七、组合实战

7.1 远程办公

1
2
3
4
5


日常沟通：微信 + 钉钉（DING 强提醒）
正式会议：腾讯会议（≥ 50 人）
小会 & 站立：腾讯会议 / 钉钉会议
文件同步：QQ（临时大文件）+ 微云（长期）
远程控制：ToDesk

7.2 团队协作分层

1
2
3
4
5


个人沟通：微信
群组协作：钉钉 / 飞书 / 微信群
正式通知：钉钉 DING + 邮件
视频会议：腾讯会议
项目管理：Jira / 飞书项目

八、选型对比

工具	适合
QQ	个人 / 团队文件传输 / 截图
微信	客户沟通 / 朋友圈运营
钉钉	企业 OA / DING 强通知
企业微信	客户群运营 / 与微信打通
飞书	创新团队 / 多维表格
腾讯会议	大型会议 / 外部协作
ToDesk	远程桌面

九、常见问题

9.1 微信多开

Windows 官方不支持。变通方案：

WeChatMultiple 开源工具
MuMu 模拟器装微信
企业微信（与微信互通）

9.2 钉钉 DING 太多被打扰

设置 → 消息 → DING 提醒 → 关闭非工作时间

9.3 腾讯会议卡顿

关闭背景虚化
切换到"流畅优先"模式
用有线网络（Wi-Fi 容易抖动）

9.4 ToDesk 黑屏

被控端开"隐私屏"是正常行为。要关闭时被控端 在 设置 → 隐私屏 → 关闭 即可。

9.5 跨平台群发

钉钉群发助手 vs 企业微信群发 vs 企业微信客户群发：

钉钉：限内部群
企业微信：内外打通（最灵活）

十、下一步

想看远程办公 IT 设施：[2015-11-15 系统效率工具：7-Zip / AHK / 输入法]
想看企业 IM 集成：[2024-07-28 AI 行业趋势综述]
想看 CI/CD 告警：[2020-12-15 K8s 集群流量入口：Ingress-nginx]

本文写于 2015 年，回看当时：钉钉 1.0 刚发布，没人预料到它能挑战微信企业版；腾讯会议 2019 年才上线，Zoom 那时还是中国远程会议的代名词；ToDesk 2020 年才发布，TeamViewer 还在被怀疑"商业用途"——4 年时间国产 IM 完成了对国外的全面替代。