在 Tekton Task 中使用 GitLab Connector
在 Tekton Tasks 中使用 GitLab Connector 可以集中管理 GitLab 凭据,并在 Tekton Task 执行期间安全访问 GitLab 仓库。
目录
Tekton Task 的要求使用说明为 Git CLI 操作使用 GitConfig为 GitLab CLI 操作使用 GitLabConfig结合 GitLab Connector 使用自定义 CLI 工具延伸阅读Tekton Task 的要求
并非所有 Tekton Tasks 都可以使用 GitLab Connector。
GitLab Connector 通过 CSI Driver 注入临时凭据。它提供一些配置,用于生成带有临时认证和 URL 重写设置的配置文件:
- gitconfig:为 Git CLI 操作提供
.gitconfig文件 - gitlabconfig:为 GitLab CLI (glab) 操作提供
config.yml文件
生成的 .gitconfig 示例:
生成的 config.yml 示例:
因此,Tekton Tasks 必须满足以下要求才能使用 GitLab Connector:
对于 Git CLI 操作:
- 支持通过 Workspace 挂载
.gitconfig文件
对于 GitLab CLI (glab) 操作:
- 支持通过 Workspace 挂载
config.yml文件 - 支持通过 Workspace 挂载
.gitconfig文件(使用 glab 克隆仓库或与仓库目录交互时必需)
使用说明
为 Git CLI 操作使用 GitConfig
在 Tekton Tasks 中使用 Git CLI 时,挂载 gitconfig 配置:
参数说明:
name:在 Task 中定义的 Workspace 名称csi:driver:固定值connectors-csireadOnly:固定值truevolumeAttributes:CSI Volume 属性connector.name:GitLab Connector 的名称connector.namespace:(可选)GitLab Connector 的 Namespace;如果未指定,则使用 TaskRun 的 Namespaceconfiguration.names:配置名称(Git CLI 操作为gitconfig)
为 GitLab CLI 操作使用 GitLabConfig
在 Tekton Tasks 中使用 GitLab CLI (glab) 时,同时挂载 gitlabconfig 和 gitconfig:
Task 应当:
-
将配置文件复制到相应位置:
.gitconfig→~/.gitconfigconfig.yml→~/.config/glab-cli/config.yml
-
设置正确的文件权限:
~/.gitconfig→644~/.config/glab-cli/config.yml→600
结合 GitLab Connector 使用自定义 CLI 工具
当结合 GitLab Connector 使用自定义 CLI 工具(如 reviewdog)时,可以使用内置配置文件通过代理服务访问 GitLab API。
有关更多详情,请参阅:Connectors CSI 内置配置
或者参考 将 Reviewdog 与 GitLab Connector 一起使用 了解更多详情。
延伸阅读
- 在 GitLab Connector 中使用 GitLab CLI - 了解如何使用 connector 运行 glab 命令
- 将 Reviewdog 与 GitLab Connector 一起使用 - 了解如何使用 connector 运行自定义 CLI 工具
- Connectors CSI 内置配置 - 了解内置配置文件
- 在 Tekton 中使用 CSI Volume - Tekton CSI workspace 文档