提交后还要手工在本机跑构建,Jenkins 官方怎么把第一段流水线跑起来?

代码提交之后,构建还是在自己这台电脑上点一下才跑。Jenkins 官方的 Installing 和 Guided Tour 写了怎么把软件装上,并走完第一段引导。这不是再写一篇已经发过的 GitLab 持续集成。站内这篇讲的是那套产品怎么写出第一段流水线:GitLab CI。密钥怎么放、定时任务碰到时区怎么处理,属于另一套产品里的问题。密钥存放见这篇 GitHub Actions Secrets。定时任务的时区见这篇 Actions 时区。下面只按它自己的安装说明和引导来写。

Jenkins User Documentation 面向的是想使用现有功能和插件的人。若要自己编写扩展,那一页会指向开发者文档。它对产品的说明是:这是一个自包含的开源自动化服务器,用来把构建、测试、交付或部署这类任务自动化。安装途径包括系统原生软件包、Docker,以及在已具备 Java 运行环境的机器上独立运行。文档后半还写了,引导、教程和手册里的说明,基于已安装 Blue Ocean,并走完向导里建议那一组扩展的环境。

Installing Jenkins 写明该章步骤面向新装。常见做法是让它在独立进程里运行:发行的 WAR 里打进了 Winstone(对 Jetty 的封装),只要平台上的 Java 版本受支持,就可以启动。理论上也能丢进 Apache Tomcat 或 WildFly 这类传统容器,但文档说这种用法基本没经过充分测试,限制不少,尤其 WebSocket 代理只在 Jetty 里实现过。动手之前还得先选定发行线路,因为两种线路的安装说明和软件包并不相同。长期支持线路每隔约 12 周从按星期发布的那条流里挑一个基线,之后大约每 4 周带回移植的缺陷和安全修复,变动更少,适合希望节奏稳一些的人。另一条发布更勤的线路则大致按星期推送修复和新功能,面向需要更快拿到改动的使用者与插件开发者。已有环境若要从一条线路换到另一条,页里指向专门说明。

引导本身在 Getting started with the Guided Tour。它用来认识基本用法,以及主功能 Pipeline,并且采用可在本机独立运行的发行版。页上的准备条件是:机器至少有 256 MB 内存,更建议超过 2 GB。磁盘空间写的是 10 GB,用来放下 Jenkins 以及你的 Docker 镜像。软件方面需要 Java 21 或 25,并预先装好 Docker。下载入口指向官方的 Get Docker 站点。随后下载 Generic Java package(.war),在保存该文件的目录打开终端,执行:

java -jar jenkins.war --httpPort=8080

再在浏览器访问 http://localhost:8080,按页面提示把安装做完。

引导的下一步是 Creating your first Pipeline。它把 Pipeline 写成一组插件,用来把持续交付流程接到这套自动化服务器里。这条流水线,是把软件从版本库一直送到用户手中的过程用自动化的方式表达出来。定义通常写进名为 Jenkinsfile 的文本文件,并提交到项目的源码库。想尽快跑起来,该页给出的顺序是:到 Manage Jenkins > Plugins 安装 Docker Pipeline,完成后再重启,让它可用。把示例复制到仓库里并命名为 Jenkinsfile。接着在界面点 New Item,起一个名字(页上的例子是 My-Pipeline),类型选 Multibranch Pipeline。再点 Add Source,选好仓库种类并填好信息,保存后即可看到它开始运行。若示例里的命令和项目里实际要跑的不一致,页上建议改 sh 里的内容,改成你在本机同样会执行的那一条。配置完成之后,仓库里新出现的分支或拉取请求会被自动发现,并为之启动流水线。

Java 的声明式示例如下,页里注明需要 Docker Pipeline 插件:

pipeline {
    agent { docker { image 'maven:3.10.0-eclipse-temurin-21-alpine' } }
    stages {
        stage('build') {
            steps {
                sh 'mvn --version'
            }
        }
    }
}

同一页还为 Node.js、Ruby、Python、PHP 和 Go 准备了类似的声明式与脚本式写法。镜像标签只是打开那一页时看到的示例字符串,不要理解成本机或仓库要对齐的版本号。

你们第一段是先用这份 Jenkinsfile 跑通版本查询,还是直接写进自己项目里的构建命令?