Chains 身份验证

概述

必须设置身份验证,才能使用 Chains 中的以下功能:

  • 对镜像签名后将签名推送到 OCI registry
  • 使用无密钥签名时,使用 Fulcio 获取签名证书

OCI Registry 身份验证

要推送到 OCI registry,Chains controller 会在以下两个位置查找凭据:

  1. 执行 Task 的 pod 中
  2. 配置用于运行 Task 的 service account 中

创建 Registry 凭据

根据现有凭据创建 Secret

如果你已经运行了 podman login,则可以将存储在 config.json 中的凭据复制到 Kubernetes 中。

NOTE

确保没有使用任何外部凭据存储(例如操作系统的原生 keychain)来存储凭据,并且 config.json 的格式为:

{
 "auths": {
   "<registry>": {
     "auth": "redacted"
   }
 }
}

使用 config.json 创建 secret:

kubectl create secret generic registry-credentials \
    --from-file=.dockerconfigjson=<path/to/.docker/config.json> \
    --type=kubernetes.io/dockerconfigjson \
    -n $NAMESPACE

通过在命令行中提供凭据创建 Secret

首先,你需要访问 registry 的凭据(在本例中,这些凭据位于名为 credentials.json 的文件中)。然后,创建一个 kubernetes.io/dockerconfigjson 类型的 Kubernetes secret:

kubectl create secret docker-registry registry-credentials \
  --docker-server=<gcr.io> \
  --docker-username=<username> \
  --docker-email=<email> \
  --docker-password=<password> \
  -n $NAMESPACE

设置 config.json 键:

$ DOCKER_CONFIG=$(kubectl get secret -n $NAMESPACE $REGISTRY_CREDENTIALS -o jsonpath='{.data.\.dockerconfigjson}')
$ kubectl patch secret -n $NAMESPACE $REGISTRY_CREDENTIALS -p "{\"data\":{\"config.json\":\"$DOCKER_CONFIG\"}}"

使用 pod 设置凭据

使用 Pod Template

Tekton 支持指定 Pod template,以自定义运行 Task 的 Pod。启动 Task 时,你必须使用 cli 提供 Pod template,或将其嵌入 TaskRun 中。

以下是使用 registry-credentials secret 配置的 TaskRun 示例:

apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
  name: mytaskrun
  namespace: default
spec:
  taskRef:
    name: mytask
  podTemplate:
    imagePullSecrets:
    - name: registry-credentials

使用 ServiceAccount

授予 service account 访问该 secret 的权限:

kubectl patch serviceaccount $SERVICE_ACCOUNT_NAME \
  -p "{\"secrets\": [{\"name\": \"registry-credentials\"}]}" -n $NAMESPACE

现在,Chains 对以 service account $SERVICE_ACCOUNT_NAME 运行的任何 TaskRun 都具有推送权限。

TIP

ServiceAccount 的 imagePullSecrets 属性中的 secret 也会被纳入考虑。不过,其他 Tekton 组件可能不会这样做。建议使用 secrets 属性。

Fulcio 无密钥签名身份验证

NOTE
  • 此方法要求环境能够访问 Internet。
  • 如果您已部署私有 Fulcio 服务,也可以通过调整相关配置来使用这些功能。
  • 关于部署私有 Fulcio 服务不在本文档的范围内,请参阅相关文档。

基本配置

假设已将默认部署安装到 EKS 或 GKE 集群中,它将使用公共 Fulcio。您只需将以下内容添加到 chains-config 命名空间中 tekton-chains ConfigMap 的数据部分:

signers.x509.fulcio.enabled: "true"

自定义 Fulcio 端点

如果您运行的是自己的 Fulcio 实例,则需要对此进行配置。此外,您还需要通过将以下内容添加到 chains-config,将 Chains 指向您的 Fulcio 实例:

signers.x509.fulcio.address: <"http://fulcio.fulcio-system.svc">

参考