特性开关
Connectors 使用特性开关来控制可选功能或逐步引入的功能。这些开关存储在由 ConnectorsCore 组件创建的 connectors-config ConfigMap 中。
本页面介绍当前为 ConnectorsCore 组件定义的特性开关。
目录
特性开关存储位置查看当前特性开关更新特性开关通过 ConnectorsConfig(推荐)内置特性开关特性开关详情enable-connector-apis-permissionsenable-connector-apis-write-passthroughenable-connector-proxy-permissionsenable-connectors-approvalenable-multi-connectorenable-custom-ca-certsenable-pod-image-pull-via-connector后续步骤特性开关存储位置
ConnectorsCore 组件会在安装该组件的命名空间中创建一个 connectors-config ConfigMap。默认命名空间为 connectors-system。
所有值都是字符串布尔值("true" 或 "false")。由于这些开关存储在一个共享的 ConfigMap 中,因此它们适用于当前 Connectors 安装,而不是某个单独的 Connector。
查看当前特性开关
你可以直接检查该 ConfigMap:
你也可以查询 Connectors Operator API:
此 API 需要访问 ConnectorClass 的权限。有关端点详情,请参见 Connector API。
更新特性开关
特性开关通过 ConnectorsConfig.spec.components.core.spec.featureFlags 进行配置。Connectors Operator 会通过受管的 ConnectorsCore 子 CR 传播该值,并在协调过程中将其合并到 connectors-config ConfigMap 中。CR 中的值会覆盖 manifest 默认值。
通过 ConnectorsConfig(推荐)
编辑集群单例 ConnectorsConfig,以声明式方式设置特性开关:
或者使用 kubectl patch:
此处声明的特性开关会覆盖 connectors-config 中的 manifest 默认值。未列出的键会保留其 manifest 默认值。当新版本引入额外的特性开关时,它们会自动以默认值出现。
注意:请不要直接编辑受管的
ConnectorsCore子 CR 或connectors-configConfigMap——它们都会在下一次协调时从ConnectorsConfig恢复。请始终更新ConnectorsConfig.spec.components.core.spec.featureFlags。
内置特性开关
特性开关详情
enable-connector-apis-permissions
启用此开关后,系统会对通过 Connectors API 执行的访问应用基于 RBAC 的权限检查。这将读取 Connector 资源的权限,与使用该 Connector 访问目标工具 API 的权限分离开来。
当你希望用户或工作负载能够发现 Connectors,但仍然要控制其是否可以对集成工具执行读写操作时,此功能非常有用。
相关阅读:
enable-connector-apis-write-passthrough
启用此开关后,Connectors API gateway 会接受写入方法(POST、PUT、DELETE、PATCH)并将其转发到目标工具。禁用时(默认),写请求会被 HTTP 405 Method Not Allowed 拒绝。读取方法(GET、HEAD、OPTIONS)不受此开关影响,始终可被接受。
有关完整行为——HTTP 方法到 Kubernetes verb 的映射、RBAC 示例,以及与 enable-connector-apis-permissions 的交互——请参见 Connector API › Write methods (passthrough)。
enable-connector-proxy-permissions
启用此开关后,会对通过 Connectors Proxy 处理的请求应用权限控制。这适用于工作负载或工具通过基于 proxy 的 secretless 连接访问外部系统的场景。
当你需要通过平台权限来管控 proxy 访问本身时,请使用此开关。启用 enable-connectors-approval 时也必须同时启用此开关,因为审批功能会保护 Connectors Proxy 的使用。
相关阅读:
enable-connectors-approval
启用此开关后,Connectors 可以参与针对 Connectors Proxy 的审批门控访问工作流。该功能旨在保护基于 proxy 的 connector 使用,尤其适用于工作负载通过 proxy 端点访问外部工具的场景。
请将 enable-connector-proxy-permissions 与此开关一起启用。没有 proxy 权限控制时,审批功能无法保护目标 proxy 使用路径。
此功能适用于诸如生产制品晋级、部署到受保护的集群,或任何必须先审批后授予访问权限的基于 proxy 的 connector 使用场景。
相关阅读:
- Connectors Permission Model
- Connectors Approval & Permission Gating
- Connectors Proxy
- Connectors CSI Driver
enable-multi-connector
启用此开关后,Connectors CSI Driver 可以在单个 volume 中挂载由多个 Connectors 渲染得到的配置。这使一个工作负载能够同时使用多个工具集成,并且驱动会根据配置的 configuration.names 合并渲染结果。
这对诸如需要一个 Connector 读取依赖项、另一个 Connector 发布制品的 Tekton task 等工作流非常有用。
相关阅读:
enable-custom-ca-certs
启用此开关后,在验证到工具的 TLS 连接时,平台会信任额外的 CA 证书,而不会禁用证书验证。信任池采用累加方式构建:
- 系统默认 CA 池——容器镜像中内置的操作系统级信任存储。
- 全局自定义 CA 证书——位于
connectors-system命名空间、带有connectors.cpaas.io/ca-cert: "true"标签的 Secrets。 - 按 Connector 配置的 CA 证书——
Connector上spec.caCertSecretRef.name引用的可选 Secret,该 Secret 必须与Connector位于同一命名空间中。
构建出的 CA 池会被控制器的 liveness 和身份验证探针、Connectors Proxy 流量、ConnectorClass 可访问性检查,以及适用的扩展代理(OCI、Harbor、Git HTTPS 等)使用。
启用此开关后,每个 Connector 上都会发布信息性 CACertReady 条件,以反映按 Connector 加载 CA 的状态。该条件的 severity 为 Info,并且不会影响顶层 Ready 条件。
相关阅读:
enable-pod-image-pull-via-connector
启用此开关后,当 Pod 带有 connectors.cpaas.io/connector: <namespace>/<connector-name> 注解时,OCI 和 Harbor Connector PodWebhook 会将 Pod 容器镜像地址重写为 Connector Proxy URL。随后 kubelet 会通过基于 ServiceAccount token 的 imagePullSecret 通过 Connector Proxy 拉取镜像,因此无需将长期有效的 registry 凭据分发到用户命名空间。
当该开关被禁用时(默认),PodWebhook 会 拒绝 带有 connectors.cpaas.io/connector 注解的 Pod 创建请求,并在错误消息中指向此开关以及用于启用它的 ConnectorsConfig.spec.components.core.spec.featureFlags 字段。不带该注解的 Pods 不受影响,现有的手动 imagePullSecrets 工作流仍可正常使用。
相关阅读: