为 PAC 创建 Git Secret
当你通过 Webhook(而不是 GitHub App)将 repository 与 PAC 集成时,Repository 资源会引用一个 Kubernetes Secret,其中包含两类凭证:
- Git 访问令牌:PAC 用它调用 Git provider 的 API(读取 repository 元数据、提交状态检查、管理 webhook)。
- webhook secret:Git provider 在发送事件时会附带该值,PAC 可以据此验证请求是否来自预期来源。
本指南将为 GitHub Webhook 模式和 GitLab Webhook 模式创建该 Secret。GitHub App 模式不需要按 repository 配置 Secret,因为 controller 使用的是集群范围的 App 凭证。
目录
PAC 如何读取 Secret前提条件第 1 步:创建 Git 访问令牌第 2 步:选择一个 Webhook Secret第 3 步:创建 Kubernetes Secret第 4 步:在 Repository 中引用该 Secret验证更新凭证后续步骤PAC 如何读取 Secret
PAC 通过 Repository.spec.git_provider 字段查找该 Secret:
- 如果在
secret上省略key,PAC 会读取provider.token。 - 如果在
webhook_secret上省略key,PAC 会读取webhook.secret。 secret.name和webhook_secret.name可以指向同一个Secret,也可以指向两个不同的Secret。
该 Secret 必须与 Repository 资源位于同一个 namespace 中。
前提条件
- 一个 Git provider 账户,并且有权限在该 repository 上创建 Personal Access Token (PAT)。
- Repository 资源的目标 namespace。
- 对该 namespace 的
kubectl访问权限。
第 1 步:创建 Git 访问令牌
在你的 Git provider 上创建一个 PAT:
请立即复制该令牌。大多数 provider 只会显示一次。
第 2 步:选择一个 Webhook Secret
webhook secret 是 PAC 与 Git provider 之间共享的字符串。PAC 会使用此值验证传入事件。
你可以使用任何足够随机的字符串,例如密码管理器生成的密码。相同的值必须同时存储在 Kubernetes Secret 中,并配置到 Git provider 的 webhook 中。
如果你想从命令行生成一个,openssl 是一种选择:
示例输出:
Webhook secret 是可选项,但强烈建议配置。没有它,任何知道 webhook URL 的人都可以伪造事件。
第 3 步:创建 Kubernetes Secret
创建一个 Secret,在默认键下同时存储这两个值。将以下内容替换为:
-
<git-access-token>:第 1 步中的 Git provider 令牌。 -
<webhook-secret>:第 2 步中的共享 webhook secret 字符串。
示例输出:
或者,也可以通过 manifest 创建:
第 4 步:在 Repository 中引用该 Secret
在 Repository 资源中,将 git_provider.secret 和 git_provider.webhook_secret 都指向你刚刚创建的 Secret。由于使用的是默认键,因此可以省略 key 字段:
如果你将凭证存储在非默认键下,请在这两个字段上显式设置 key。
验证
确认该 Secret 已存在并包含这两个键:
示例输出:
在创建 Repository 资源后,PAC 日志会显示一次成功查找。请在 PAC namespace 中跟踪 controller 日志:
如果 controller 日志中出现认证失败(“401 Unauthorized”、“invalid token”),说明令牌错误或 scope 不足;完整的故障排查清单请参见 Common Issues。
更新凭证
通过原地更新 Secret 来轮换令牌:
PAC 会在每个传入事件时读取该 Secret,因此无需重启 controller。