Kubernetes Connector
Kubernetes Connector 是一个平台无关的连接器,您可以使用它连接到任何 Kubernetes 集群。
您可以使用 Kubernetes Connector 在 CICD 流水线中安全地执行 Kubernetes 操作,或者在 Kubernetes 工作负载中使用它以无凭证方式执行 Kubernetes 操作。
此外,您还可以集中管理跨命名空间的 Kubernetes 访问配置,避免在每个命名空间中重复配置 Kubernetes 凭证。
目录
OverviewIntegration RequirementsCreating a simple Kubernetes connectorFields ReferenceCapabilities of Kubernetes ConnectorAuthenticationProxy and Kubeconfig ConfigurationProxy Addresskubeconfig configuration fileUsing Connectors CSI Driver to mount kubeconfig fileFurther ReadingReferencesOverview
本文档涵盖:
- 集成要求:目标 Kubernetes 集群的前置条件
- 创建 Kubernetes Connector
- 高级功能:关于 Kubernetes Connector 的代理功能和配置功能
Integration Requirements
目标 Kubernetes 集群必须满足以下前置条件:
- CNCF 认证:集群必须符合 CNCF Certified Kubernetes 标准
Creating a simple Kubernetes connector
以下是创建基础 Kubernetes Connector 的方法:
Fields Reference
spec.connectorClassName:
k8s(固定值),指定 Kubernetes 集成的 ConnectorClass 名称。
spec.address:
目标 Kubernetes 集群 API 服务器端点,例如:https://192.168.1.100:6443。
也支持带路径的 URL,例如:https://192.168.1.100:6443/kubernetes/global,当 Kubernetes 集群 API 服务器通过代理暴露时非常有用。
spec.auth:
指定 Kubernetes 集群的认证方式
-
spec.auth.name:Kubernetes Connector 应为bearerTokenAuth。 -
spec.auth.secretRef:指定包含 Kubernetes 集群认证信息的 Secret,该 Secret 应创建在与 Connector 相同的命名空间中。
可选元数据字段:
-
cpaas.io/description:Kubernetes Connector 的描述信息,例如:
Capabilities of Kubernetes Connector
Authentication
Kubernetes Connector 支持以下认证类型:
bearerTokenAuth:基于 Bearer Token 的认证,对应的 Secret 类型为:connectors.cpaas.io/bearer-token
例如:
如果 Secret 不正确,Kubernetes Connector 的 status.conditions 字段将显示错误信息。
有关完整的状态信息,请参见 Connector Status Documentation。
Proxy and Kubeconfig Configuration
为了让客户端能够无凭证访问 Kubernetes 资源,Kubernetes Connector 提供了一个代理服务器,用于自动注入认证信息。
客户端可以使用该代理服务器访问 Kubernetes 资源,无需在客户端配置凭证。
为简化使用,Kubernetes ConnectorClass 提供了可通过 CSI 挂载到 Pod 的 kubeconfig 文件。在 Pod 中执行 Kubernetes 操作时,代理服务会自动注入认证信息。
Proxy Address
创建 Connector 后,系统会自动为目标集群配置一个代理服务。
代理端点记录在 status.proxy.httpAddress 中:
例如:
kubeconfig configuration file
Kubernetes Connector 提供以下配置:
kubeconfig:
- 提供一个
kubeconfig配置文件,结合 connector-csi-driver,该配置文件会被挂载到 Pod 中,使得通过代理访问 Kubernetes 集群时无需在客户端配置凭证。
Pod 中生成的配置文件示例:
关键字段:
server:目标 Kubernetes API 服务器端点proxy-url:带有代理认证信息的 Connector 代理地址certificate-authority-data:用于 TLS 验证的代理服务器证书
有关代理机制的详细说明,请参见快速入门指南中的 How It Works。
Using Connectors CSI Driver to mount kubeconfig file
Kubernetes Connector 提供的 kubeconfig 配置文件可以通过 Connector CSI Driver 挂载到 Pod。
例如:
参数说明:
csi.readOnly:固定值truecsi.driver:Connector CSI Driver,固定为connectors-csicsi.volumeAttributes:CSI 卷属性connector.name:Kubernetes Connector 名称connector.namespace:Kubernetes Connector 所在命名空间;若未指定,则使用 Pod 所在命名空间configuration.names:配置名称,由 Kubernetes Connector 提供,如上示例支持kubeconfig
关于如何在 Pod 中通过 connectors-csi-driver 使用 kubeconfig 文件的详细信息,请参见 Using Kubernetes Connectors in kubernetes jobs