CentOS 上 Jenkins 与外部系统的对接实践
一 对接总览与准备
- 常见对接对象包括：GitLab/GitHub 代码仓、Kubernetes 集群、Docker Registry（Harbor）、目标主机/API、LDAP/SSO、SonarQube 质量门禁等。
- 在 CentOS 上建议先完成：安装 JDK 8/11、通过 YUM 安装并启动 Jenkins、在 插件管理安装所需插件（如 GitLab/GitHub 插件、Pipeline、Docker Pipeline、Kubernetes、Credentials Binding、LDAP 等）、在 系统管理 → 全局工具配置 配置 JDK/Maven/Git/Docker 路径，并在 Manage Credentials 统一管理凭据（用户名/密码、SSH 密钥、Secret text/Token）。
二 与代码仓对接 GitLab/GitHub
- 安装并启用 GitLab/GitHub 插件，在 Jenkins 任务中勾选构建触发器：如 “Build when a change is pushed to GitLab”（GitLab）或 “GitHub hook trigger for GITScm polling”（GitHub）。
- 在代码仓配置 Webhook：使用 Jenkins 提供的回调地址（如 GitLab 的 /project/<JOB_NAME> 或 /github-webhook/），选择触发事件（如 Push、Merge Request）。
- 在 Jenkins 的 GitLab 连接中启用 “/project” 端点认证，添加 GitLab API Token；在任务中生成 Secret token 并填入 Webhook，实现安全回调与构建状态回写（如 Pending/Success 状态到 MR 小部件）。
三 与 Kubernetes 和容器镜像仓库对接
- 对接 Kubernetes：安装 Kubernetes 插件，在 系统配置 → Cloud → Kubernetes 填写 API Server 地址 与 Jenkins URL，按需配置 Agent Pod 模板（镜像、资源、挂载等）；在 Pipeline 中使用 agent { kubernetes { … } } 动态申请构建节点，提高资源利用率与隔离性。
- 对接 Docker Registry/Harbor：安装 Docker Pipeline 插件，在 Manage Credentials 添加 Registry 凭据；在 Pipeline 中使用 docker.build 构建镜像，配合 docker.withRegistry(‘https://registry.example.com’, ‘docker-creds’) { image.push() } 推送到 Harbor/Docker Hub，实现 CI 构建 → 镜像推送 → 部署 的闭环。
四 与运行环境及外部系统对接
- 远程主机/服务：使用 Publish Over SSH 插件或 sshPublisher 在构建后执行远程命令（如 systemctl restart my-service）；或通过 curl 调用外部 REST API 触发升级/回滚/通知。
- 代码质量与安全：对接 SonarQube（安装 SonarQube 插件、配置 SonarQube Scanner 与服务器地址/凭据），在 Pipeline 中执行分析并将结果作为质量门禁；也可结合 LDAP 统一认证与 Role-based Authorization Strategy 做细粒度权限控制。
五 安全与排错要点
- 凭据与权限：优先使用 凭据绑定 与 最小权限 原则；对外部系统（GitLab API、K8s、Registry）使用 专用账号/Token，并限制可触发事件与作用范围。
- Webhook 可达性与证书：若 Jenkins 在 内网，需在代码仓侧放行 本地/内网 回调（如 GitLab 管理后台开启相关选项）；自签名证书场景可在测试环境临时关闭 SSL verification，生产环境应使用 有效证书 或 CA 信任链。
- 日志与调试：开启 系统日志/插件日志，在 Pipeline 关键步骤打印 BUILD_NUMBER、GIT_COMMIT、IMAGE_TAG 等上下文；对 LDAP 可开启 调试日志 验证连接与搜索过滤器；对 K8s 检查 ServiceAccount/RoleBinding 与 RBAC 权限。