在 Debian 上配置 Jenkins 插件的完整步骤
一 准备与前提
- 确保已安装 Java(推荐 OpenJDK 11):sudo apt update && sudo apt install -y openjdk-11-jdk
- 安装并启动 Jenkins:sudo apt install -y jenkins && sudo systemctl enable --now jenkins
- 首次访问 http://服务器IP:8080,按提示解锁(初始密码位于 /var/lib/jenkins/secrets/initialAdminPassword),完成初始化管理员账户。
二 在线安装插件
- 进入 Manage Jenkins → Manage Plugins,在 Available 页搜索并勾选所需插件,点击 Install without restart 或 Install after restart 完成安装。
- 安装完成后按需重启 Jenkins,使插件生效。
- 常用插件示例(按场景选择):
- Pipeline:流水线即代码
- GitHub Integration:GitHub 集成
- Docker:容器化构建与运行
- Kubernetes CLI:K8s 命令行工具
- Credentials Binding:凭据绑定与安全使用。
三 离线安装与 CLI 安装
- 离线安装(UI):在 Manage Plugins → Advanced → Upload Plugin 上传插件的 .hpi 文件,上传后按提示重启。
- 命令行安装(需 jenkins-cli.jar):
- 获取 CLI:在 Manage Jenkins → Tools and Actions 下载 jenkins-cli.jar,或在 Jenkins 安装目录(如 /usr/share/jenkins/)查找。
- 安装命令:java -jar jenkins-cli.jar -s http://localhost:8080/ install-plugin 插件名或插件.hpi
- 重启生效:java -jar jenkins-cli.jar -s http://localhost:8080/ safe-restart。
四 常用插件配置要点
- Git:在 Manage Jenkins → Global Tool Configuration 配置 Git 安装路径;在 Manage Jenkins → Configure System 或具体任务中配置 凭证(用户名/密码或 SSH 密钥) 与仓库地址。
- Maven:在 Global Tool Configuration 指定 Maven 安装目录(MAVEN_HOME);在任务中配置 pom.xml 路径与目标(如 clean package)。
- Docker:在 Global Tool Configuration 配置 Docker 安装路径或 Docker daemon 地址;在构建步骤中使用 Docker 命令或 Docker Pipeline 步骤。
- Kubernetes CLI(kubectl):在 Global Tool Configuration 配置 kubectl 路径;在任务或 Pipeline 中使用 withKubeConfig/credentials 绑定 Kubeconfig 凭据。
五 插件更新维护与加速
- 更新与卸载:在 Manage Plugins 的 Updates 页执行更新;在 Installed 页可 Disable/Uninstall 插件(部分操作需重启)。
- 国内镜像加速(可选):在 Manage Jenkins → Manage Plugins → Advanced 配置 Update Site 为国内镜像源(如清华/中科大镜像),可显著提升下载速度;保存后检查更新并安装。