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.connectorClassNamedescription地址身份验证代理和配置代理配置更多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。
description
你可以通过 annotations 字段向 OCI Connector 添加描述信息。
cpaas.io/description:OCI Connector 的描述。
例如:
地址
spec.address 用于指定 OCI Registry 的访问地址,例如:https://index.docker.io。
身份验证
OCI Connector 支持的身份验证类型:
tokenAuth:基于 Token 的身份验证(可选)- 对应的 credential 类型:
cpaas.io/distribution-registry-token。此类 credential 用于 CNCF Distribution Token Authentication Specification 中定义的身份验证流程,并且 credential 必须提供username和password信息。
- 对应的 credential 类型:
例如:
如果目标 OCI Registry 不需要身份验证,可以省略身份验证信息。配置示例如下:
代理和配置
为了让客户端能够在无需凭证的情况下访问 OCI 仓库,OCI Connector 类型提供了一个代理服务器,用于自动注入身份验证信息。
具有该连接器访问权限的客户端可以使用此代理服务器访问 OCI 仓库,而无需在客户端侧配置凭证。
为简化使用,OCI Connector 类型提供了配置信息,可通过 CSI 挂载到 Pods 中。在 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配置文件。 - 在该配置文件中,当前连接器默认会被设置为
insecure-registries。
例如:
buildkitd:BuildKit Daemon 所需的配置信息。
- 提供
buildkitd.toml配置文件。 - 在该配置文件中,当前连接器默认会被设置为
insecure-registries。
例如:
你可以使用 connectors-csi 将这些配置信息挂载到 Pods 中,并结合代理能力,以无密钥方式执行镜像 push 或 pull 操作。