配置Jenkins：全面指南

### Jenkins配置全攻略 #### 1. 理解永久Docker代理 在考虑永久代理的场景时，每个从节点都是相同的。若要构建依赖Java 8的项目，可在管道脚本中定义合适的Docker镜像（而非指定从节点标签）。 #### 2. Jenkins Swarm代理 以往，我们需在Jenkins主节点中永久定义每个代理。这种方案虽在很多情况下可行，但当需要频繁扩展从节点数量时，会成为负担。Jenkins Swarm则允许动态添加从节点，无需在主节点中进行配置。 ##### 2.1 配置Jenkins Swarm代理 - **第一步**：在Jenkins中安装Self-Organizing Swarm Plug-in Modules插件。可通过Jenkins Web UI，在“Manage Jenkins”和“Manage Plugins”中完成安装。安装后，主节点就可动态连接从节点。 - **第二步**：在每个要作为Jenkins从节点的机器上运行Jenkins Swarm从节点应用程序。可使用`swarm-client.jar`应用程序，该程序可从[Jenkins Swarm插件页面](https://wiki.jenkins-ci.org/display/JENKINS/Swarm+Plugin)下载，此页面还提供了所有可能的执行选项。 要连接Jenkins Swarm从节点，运行以下命令： ```bash $ java -jar swarm-client.jar -master <jenkins_master_url> -username <jenkins_master_user> -password <jenkins_master_password> -name jenkins-swarm-slave-1 ``` 在编写本文时，存在一个已知问题，即`client-slave.jar`通过安全的HTTPS协议无法正常工作，因此需在命令执行时添加`-disableSslVerification`选项。 成功执行后，会在Jenkins主节点上看到新的从节点。此时运行构建任务，将在该代理上启动。 另一种添加Jenkins Swarm代理的方法是使用基于`swarm-client.jar`工具构建的Docker镜像，在Docker Hub上有多个可用镜像，如`csanchez/jenkins-swarm-slave`。 ##### 2.2 理解Jenkins Swarm代理 Jenkins Swarm允许动态添加代理，但未指定使用特定或基于Docker的从节点，因此两者均可使用。乍一看，Jenkins Swarm似乎用处不大，毕竟只是将代理设置从主节点转移到了从节点，仍需手动操作。但它能在服务器集群上实现从节点的动态扩展。 #### 3. 动态配置Docker代理 还可设置Jenkins在每次启动构建时动态创建新代理。这种方案最为灵活，因为从节点数量会根据构建任务数量动态调整。 ##### 3.1 配置动态配置的Docker代理 - 首先安装Docker插件，可在“Manage Jenkins”和“Manage Plugins”中完成。安装后，按以下步骤配置： 1. 打开“Manage Jenkins”页面。 2. 点击“Configure System”链接。 3. 在页面底部找到“Cloud”部分。 4. 点击“Add a new cloud”，选择“Docker”。 5. 填写Docker代理详细信息。多数参数无需更改，但需设置以下两个参数： - **Docker URL**：运行代理的Docker主机的地址。 - **Credentials**：若Docker主机需要身份验证，需提供相应凭证。 若计划使用与主节点相同的Docker主机，需让Docker守护进程监听`docker0`网络接口，可通过修改`/lib/systemd/system/docker.service`文件中的一行来实现： ```plaintext ExecStart=/usr/bin/dockerd -H 0.0.0.0:2375 -H fd:// ``` 6. 点击“Add Docker Template”，选择“Docker Template”。 7. 填写Docker从节点镜像的详细信息，可使用以下参数： - **Docker Image**：Jenkins社区中最流行的从节点镜像是`evarga/jenkins-slave`。 - **Credentials**：`evarga/jenkins-slave`镜像的凭证为用户名`jenkins`，密码`jenkins`。 - **Instance capacity**：定义同时运行的最大代理数量，初始可设置为10。 也可构建并使用自己的从节点镜像，当有特定环境要求（如安装Python解释器）时，这是必要的。 ##### 3.2 理解动态配置的Docker代理 动态配置的Docker代理可视为标准代理机制之上的一层，它既不改变通信协议，也不改变代理的创建方式。Jenkins使用我们提供的Docker代理配置的步骤如下： 1. 启动Jenkins作业时，主节点在从节点Docker主机上从`jenkins-slave`镜像运行新容器。 2. `jenkins-slave`容器实际上是安装了SSHD服务器的Ubuntu镜像。 3. Jenkins主节点自动将创建的代理添加到代理列表。 4. 使用SSH通信协议访问代理以执行构建。 5. 构建完成后，主节点停止并删除从节点容器。 运行Jenkins主节点和从节点作为Docker容器是相互独立的，两者都运行是合理的，但也可单独运行。 这种解决方案与永久Docker代理解决方案类似，都是在Docker容器内运行构建。不同之处在于从节点配置，这里整个从节点都进行了容器化，而非仅构建环境。它具有两个显著优点： - **自动代理生命周期**：代理的创建、添加和删除过程自动化。 - **可扩展性**：从节点Docker主机可以是由多台机器组成的集群，添加资源只需向集群添加新机器，无需在Jenkins中进行任何更改。 Jenkins构建通常需要下载大量项目依赖项（如Gradle/Maven依赖项），这可能会花费大量时间。若为每个构建自动配置Docker从节点，可设置Docker卷以实现构建之间的缓存。 #### 4. 测试代理 无论选择哪种代理配置，都应检查其是否正常工作。回到“hello world”管道脚本，通常构建任务比“hello-world”示例耗时更长，可通过在管道脚本中添加休