快速开始
本文档将帮助您快速了解如何创建一个 Git 连接器,并在不直接处理凭证的情况下安全地克隆仓库。
目录
介绍适用场景预计阅读时间注意事项前提条件流程概述操作步骤操作步骤 1: 创建命名空间操作步骤 2: 创建 Git 凭证和连接器操作步骤 3: 创建克隆任务操作步骤 4: 验证操作预期结果工作原理故障排除下一步介绍
适用场景
Git 连接器允许您通过以下方式安全地执行代码克隆操作:
- 中央管理凭证,而不是在工作负载中硬编码凭证
- 在克隆过程中自动注入身份验证
- 提供跨团队对私有仓库的受控访问
这种方法特别适用于:
- 需要安全访问私有仓库的 CI/CD 流水线
- 共享仓库访问而不共享凭证的团队
- 需要集中管理 Git 凭证的环境
预计阅读时间
15 分钟
注意事项
- Git 连接器使用 CSI 驱动程序集成来安全地注入 Git 凭证。
- 连接器生成的配置在 30 分钟后过期。
前提条件
- 安装有连接器系统(Operator、Core 和 Git 组件)的 Kubernetes 集群。有关安装这些组件的详细信息,请参阅 安装指南。
- 已配置 kubectl 与您的集群进行通信
- 拥有有效凭证(用户名/密码或令牌)的 Git 仓库
- 对 Kubernetes 资源的基本知识
流程概述
操作步骤
操作步骤 1: 创建命名空间
为本演示创建一个专用命名空间:
操作步骤 2: 创建 Git 凭证和连接器
创建包含 Git 凭证的 Secret 和 Git 连接器资源。有关创建和配置连接器的详细信息,请参阅 连接器快速开始指南。
验证连接器是否处于 "Ready" 状态:
输出应显示:
操作步骤 3: 创建克隆任务
创建一个使用连接器克隆仓库的任务:
关键参数:
connector.name: 您的 Git 连接器名称configuration.names: 设置为 "gitconfig",引用 Git ConnectorClass 中定义的特定配置模板。该模板用于生成带有适当身份验证和 URL 重写设置的 ".gitconfig" 文件。mountPath: 必须设置为 "/root/",因为容器以 root 用户身份运行,Git 将在 "/root/.gitconfig" 路径中查找配置。
操作步骤 4: 验证操作
检查任务的日志以确认仓库是否成功克隆:
您应该看到 Git 克隆操作成功完成,且没有任何身份验证错误。
预期结果
在成功完成所有步骤后,您将看到:
-
一个处于 "Ready" 状态的 Git 连接器:
-
在任务日志中看到成功的 Git 克隆操作:
工作原理
Git 连接器的工作原理为:
- 将原始 Git 仓库 URL 替换为代理服务 URL
- 将身份验证信息注入请求到代理服务
- 代理服务在将请求转发到 Git 服务器时添加必要的凭证
要检查生成的配置:
查看生成的配置:
示例输出:
故障排除
如果您的克隆操作失败,请检查以下内容:
-
连接器状态: 确保连接器处于 "Ready" 状态:
-
RBAC 权限: 验证 RoleBinding 是否正确配置。
-
任务配置:
- 确保卷挂载路径正确(/root/)
- 验证仓库 URL 是否与连接器中配置的一致
下一步
在成功使用 Git 连接器克隆第一个仓库后,您可以:
- 查看 Tekton Task 适配要求
- 将这种方法集成到您的 CI/CD 流水线中
- 在其他 Git 操作中使用连接器,如 clone, push
- 为不同的 Git 服务创建连接器