SSH 密钥在持续集成中怎么用

风婷同学_4111

风婷同学_4111

2026-08-28

778人浏览

原创

ssh密钥是ci稳定运行的关键基础设施,用于自动、安全、免交互地访问代码仓库或部署目标;它避免http/https的rpc错误,解决凭据硬编码、泄露及token过期等问题,支持git拉取与远程部署两大场景,并需遵循最小权限、密钥隔离、ed25519算法、严格权限与定期轮换等安全实践。

ssh 密钥在持续集成中怎么用

SSH 密钥在持续集成(CI)中主要解决的是「自动、安全、免交互地访问代码仓库或部署目标」的问题。它不是可选项,而是稳定运行 CI 流水线的关键基础设施。

为什么 CI 必须用 SSH 密钥?

HTTP/HTTPS 协议拉取代码时容易触发 RPC 错误(比如 error: RPC failed; curl 56),尤其在大仓库、弱网络或 CI 节点资源受限时。SSH 协议基于 TCP 长连接,传输更鲁棒;更重要的是——它不依赖密码,避免了凭据硬编码、环境变量泄露、Token 过期等运维痛点。

典型使用方式:两种主流场景

1. 从 Git 仓库拉取源码
CI 工具(如 Jenkins、GitLab CI、GitHub Actions 自托管 runner)需要克隆代码。此时需在构建节点上配置 SSH 私钥,并把对应公钥添加到仓库的「Deploy Keys」或「SSH Keys」设置中:

宝塔Linux面板11.3.0
宝塔Linux面板11.3.0

宝塔面板11.3.0是一款针对Linux服务器设计的可视化管理工具,通过重构核心模块实现资源占用显著降低,尤其适合低配置服务器环境。它将复杂的命令行操作转化为直观的图形界面,帮助开发者快速完成网站部署、环境配置及日常运维工作,无需专业技术背景即可高效管理服务器。

下载
  • 推荐为 CI 单独生成密钥(如 ssh-keygen -t ed25519 -f ~/.ssh/ci_deploy_key -C "ci@project"),避免复用个人密钥
  • 公钥添加到 GitHub/GitLab 的项目级 Deploy Keys(只读)或账户级 SSH Keys(读写),按最小权限原则选择
  • Jenkins 等平台支持「Credentials Binding」插件,可安全注入私钥到构建环境,无需明文写入脚本

2. 向远程服务器部署产物
构建完成后,常需通过 scp 或 rsync 推送二进制包、或用 ssh 执行部署命令:

  • 私钥应预置在 CI 构建节点(如 Jenkins agent)的 ~/.ssh/ 下,并确保权限为 600
  • 目标服务器的 ~/.ssh/authorized_keys 中需有该私钥对应的公钥,且服务端 sshd_config 开启 PubkeyAuthentication yes
  • 建议配合 ~/.ssh/config 定义 Host 别名和 IdentityFile,让部署脚本简洁可靠

安全与实践要点

CI 环境下的密钥管理容错率极低,以下细节直接影响安全性与可用性:

  • 绝不将私钥明文写入 CI 脚本或版本库;使用平台内置凭证管理(如 Jenkins Credentials、GitLab CI Variables 加密字段)
  • 密钥建议用 ed25519 算法(OpenSSH ≥6.5 支持),比 RSA 更快更小更安全;若需兼容旧系统,选 rsa -b 4096
  • 为 CI 密钥设置 passphrase 并配合 ssh-agent 解锁(如 ssh-add -D && ssh-add ~/.ssh/ci_deploy_key),但需注意 CI 环境是否支持交互式输入——通常改用无密码密钥 + 严格文件权限替代
  • 定期轮换 CI 密钥(如每季度),并及时从所有仓库和服务器移除旧公钥

多环境/多仓库怎么管?

一个 CI 流水线可能涉及多个 Git 仓库(主仓、依赖子模块、私有包仓)或多个部署目标(测试服、预发服、生产服)。这时不能只靠一套密钥:

  • 为不同用途生成独立密钥对,命名清晰(如 gitlab-ci-deploy、prod-server-key)
  • 用 ~/.ssh/config 做路由映射,例如:
    Host gitlab.com<br>  HostName gitlab.com<br>  User git<br>  IdentityFile ~/.ssh/gitlab_ci_key
  • 在 CI 脚本中通过 git clone git@gitlab.com:group/repo.git 自动命中对应密钥,无需额外参数

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

219

16

PHP 命令行脚本与自动化任务开发
PHP 命令行脚本与自动化任务开发

本专题系统讲解 PHP 在命令行环境(CLI)下的开发与应用,内容涵盖 PHP CLI 基础、参数解析、文件与目录操作、日志输出、异常处理,以及与 Linux 定时任务(Cron)的结合使用。通过实战示例,帮助开发者掌握使用 PHP 构建 自动化脚本、批处理工具与后台任务程序 的能力。

2025.12.13

466

14

Figma AI自动化智能数据填充与交互生成实战
Figma AI自动化智能数据填充与交互生成实战

告别机械重复,详细演示如何用 AI 填充业务真实数据,并自动为页面添加交互连线,将静态设计稿快速转变为动态原型。

2026.05.13

285

17

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

20

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

0

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

2026.09.30

0

12

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

2026.09.30

20

26

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

2026.09.29

20

15

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

220

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程