功能标志
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 值会覆盖清单默认值。
通过 ConnectorsConfig(推荐)
编辑集群单例 ConnectorsConfig,以声明方式设置功能标志:
或者使用 kubectl patch:
此处声明的功能标志会覆盖 connectors-config 中的清单默认值。未列出的键会保留其清单默认值。当新版本引入其他功能标志时,它们会自动以默认值出现。
注意:不要直接编辑受管的
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 网关会接受写入方法(POST、PUT、DELETE、PATCH),并将其转发到目标工具。禁用此标志时(默认设置),写入请求会被拒绝并返回 HTTP 405 Method Not Allowed。无论此标志如何设置,读取方法(GET、HEAD、OPTIONS)都会被接受。
有关完整行为(包括 HTTP 方法到 Kubernetes verb 的映射、RBAC 示例,以及与 enable-connector-apis-permissions 的交互),请参阅 Connector API › 写入方法(直通)。
enable-connector-proxy-permissions
启用此标志后,会对通过 Connectors Proxy 处理的请求应用权限控制。当工作负载或工具通过基于代理的无 Secret 连接访问外部系统时,此设置非常重要。
当代理访问本身必须受到平台权限管理时,请使用此标志。启用 enable-connectors-approval 时也必须启用此标志,因为审批功能会保护对 Connectors Proxy 的使用。
相关内容:
enable-connectors-approval
启用此标志后,Connectors 可以参与针对 Connectors Proxy 的审批门控访问工作流。此功能旨在保护基于代理的 Connector 使用场景,尤其适用于工作负载通过代理端点访问外部工具的情况。
请将 enable-connector-proxy-permissions 与此标志一起启用。如果没有代理权限控制,审批功能将无法保护目标代理使用路径。
此功能适用于生产构件提升、部署到受保护集群,或任何必须在授予访问权限前审批基于代理的 Connector 使用的环境。
相关内容:
enable-multi-connector
启用此标志后,Connectors CSI Driver 可以在单个卷中挂载由多个 Connectors 呈现的配置。这样,一个工作负载就可以同时使用多个工具集成,并且 driver 会根据配置的 configuration.names 合并呈现的配置。
这对于以下工作流非常有用:例如,一个 Tekton 任务需要使用一个 Connector 读取依赖项,并使用另一个 Connector 发布构件。
此标志还控制 Pipeline Integrations 中额外 Connectors 的使用。当 ResourceInterface 启用 multipleMergeConnectors 时,用户可以向 Integration 添加额外的 Connectors。启用 allowCrossTypeConnectors 后,这些 Connector 可以属于其他类型,例如在 OCI 构件 Integration 中使用 Maven Connector。
相关内容:
enable-custom-ca-certs
启用此标志后,平台在验证与工具建立的 TLS 连接时,会信任额外的 CA 证书,但不会禁用证书验证。信任池以增量方式构成:
- 系统默认 CA 池 — 容器镜像中预置的操作系统级信任存储。
- 全局自定义 CA 证书 — 位于
connectors-system命名空间中、带有connectors.cpaas.io/ca-cert: "true"标签的 Secrets。 - 每个 Connector 的 CA 证书 — 由
spec.caCertSecretRef.name在Connector上引用的可选 Secret,该 Secret 必须位于与Connector相同的命名空间中。
构建的 CA 池会在适用时用于 controller 存活性和身份验证探针、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 令牌的 imagePullSecret 通过 Connector Proxy 拉取镜像,因此无需将长期有效的 registry 凭据分发到用户命名空间。
禁用此标志时(默认设置),PodWebhook 会拒绝带有 connectors.cpaas.io/connector 注解的 Pod 创建请求,并显示一条错误消息,指向此标志以及用于启用该标志的 ConnectorsConfig.spec.components.core.spec.featureFlags 字段。不带此注解的 Pod 不受影响,现有的手动 imagePullSecrets 工作流也会继续正常运行。
相关内容: