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