在 Tekton Task 中使用 GitLab Connector
在 Tekton Task 中使用 GitLab Connector,可以集中管理 GitLab 凭据,并在 Tekton Task 执行期间安全访问 GitLab 仓库。
目录
Tekton Task 的要求使用说明将 GitConfig 用于 Git CLI 操作将 GitLabConfig 用于 GitLab CLI 操作在 GitLab Connector 中使用自定义 CLI 工具延伸阅读Tekton Task 的要求
并非所有 Tekton Task 都可以使用 GitLab Connector。
GitLab Connector 通过 CSI Driver 注入临时凭据。它提供的配置会生成包含临时身份验证和 URL 重写设置的配置文件:
- gitconfig:为 Git CLI 操作提供
.gitconfig文件 - gitlabconfig:为 GitLab CLI (glab) 操作提供
config.yml文件
生成的 .gitconfig 示例:
生成的 config.yml 示例:
因此,Tekton Task 必须满足以下要求才能使用 GitLab Connector:
对于 Git CLI 操作:
- 支持通过 Workspace 挂载
.gitconfig文件
对于 GitLab CLI (glab) 操作:
- 支持通过 Workspace 挂载
config.yml文件 - 支持通过 Workspace 挂载
.gitconfig文件(使用 glab 克隆仓库或与仓库目录交互时需要)
使用说明
将 GitConfig 用于 Git CLI 操作
在 Tekton Task 中使用 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)
将 GitLabConfig 用于 GitLab CLI 操作
在 Tekton Task 中使用 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 Built-in Configurations
或者参考 Using Reviewdog with GitLab Connector 了解更多详细信息。
延伸阅读
- Using GitLab CLI with GitLab Connector - 了解如何使用 connector 执行 glab 命令
- Using Reviewdog with GitLab Connector - 了解如何将自定义 CLI 工具与 connector 配合使用
- Connectors CSI Built-in Configurations - 了解内置配置文件
- Using CSI Volumes in Tekton - Tekton CSI workspace 文档