OCI Connector
OCI Connector 是一个与平台无关的连接器,可让您连接到任意 OCI Registry,例如 Docker Hub、Harbor 等。您可以使用 OCI Connector 在 CI/CD 流水线中安全访问私有 OCI 仓库,或者在容器化工作负载中执行 OCI 操作,而无需提供凭证。此外,您还可以集中管理 OCI 访问配置,避免在每个 namespace 中重复配置 OCI 凭证。
本文将介绍:
- OCI Registry 的访问要求
- 如何基于 OCI Connector 类型创建 OCI Connector
- OCI Connector 的代理和配置能力
OCI Registry 要求
要访问的 OCI Registry 必须满足以下条件:
-
接口实现要求:
- 至少必须实现 opencontainers/distribution-spec v1.0 规范中定义的接口
- 必须能够通过 distribution-spec 的 conformance tests
-
认证方式要求:
- 必须实现基于 Token 的认证,并符合 CNCF Distribution Token Authentication Specification
基于 OCI Connector 类型创建 OCI Connector
快速开始
spec.connectorClassName
使用常量值 oci。
描述
您可以通过 annotations 字段向 OCI Connector 添加描述信息。
cpaas.io/description:OCI Connector 的描述信息。
例如:
地址
spec.address 指定 OCI Registry 的访问地址,例如:https://index.docker.io。
认证
OCI Connector 支持的认证类型:
tokenAuth:基于 Token 的认证(可选)- 对应的凭证类型:
cpaas.io/distribution-registry-token。该类型的凭证用于 CNCF Distribution Token Authentication Specification 中定义的认证流程,并且凭证必须提供username和password信息。
- 对应的凭证类型:
例如:
如果目标 OCI Registry 不需要认证,则可以省略认证信息。配置示例如下:
代理和配置
为了让客户端能够在无需凭证的情况下访问 OCI 仓库,OCI Connector 类型提供了一个代理服务器,用于自动注入认证信息。
有权访问该 connector 的客户端可以使用此代理服务器访问 OCI 仓库,而无需在客户端侧配置凭证。
为了简化使用,OCI Connector 类型提供了可通过 CSI 挂载到 Pod 中的配置信息。在 Pod 中执行 OCI 操作时,可以自动使用代理服务完成 OCI 操作。
代理
当创建 Connector 时,系统将:
- 自动为代理创建一个 Service。
- 将代理地址记录到
status.proxy.httpAddress字段中。
您可以使用该代理地址执行镜像 push 和 pull 操作。
例如:
配置
基于 OCI Connector 类型创建的 OCI Connector 提供以下配置:
docker-config:Docker CLI 所需的配置信息。
- 提供
config.json配置文件。 - 包含访问代理所需的认证信息。
例如:
dockerd:Docker Daemon 的配置信息。
- 提供
daemon.json配置文件。 - 在该配置文件中,当前 connector 将默认设置为
insecure-registries。
例如:
buildkitd:BuildKit Daemon 所需的配置信息。
- 提供
buildkitd.toml配置文件。 - 在该配置文件中,当前 connector 将默认设置为
insecure-registries。
例如:
您可以使用 connectors-csi 将这些配置信息挂载到 Pod 中,并结合代理能力,实现无密钥方式的镜像 push 或 pull 操作。