特性标志

Connectors 使用 feature flags 来控制可选能力或逐步引入的能力。这些标志存储在 ConnectorsCore 组件创建的 connectors-config ConfigMap 中。

本页描述了当前为 ConnectorsCore 组件定义的 feature flags。

Feature Flags 的存储位置

ConnectorsCore 组件会在安装该组件的 namespace 中创建一个 connectors-config ConfigMap。默认 namespace 是 connectors-system。

apiVersion: v1
kind: ConfigMap
metadata:
  name: connectors-config
  namespace: connectors-system # example namespace
data:
  enable-connector-apis-permissions: "false"
  enable-connector-apis-write-passthrough: "false"
  enable-connector-proxy-permissions: "false"
  enable-connectors-approval: "false"
  enable-multi-connector: "false"
  enable-custom-ca-certs: "false"
  enable-pod-image-pull-via-connector: "false"

所有值都是字符串布尔值("true" 或 "false")。由于这些标志存储在一个共享的 ConfigMap 中,因此它们适用于当前的 Connectors 安装,而不是单个 Connector。

查看当前 Feature Flags

你可以直接检查该 ConfigMap:

kubectl -n <connectors-namespace> get configmap connectors-config -o yaml

你也可以查询 Connectors Operator API:

curl -H "Authorization: Bearer ${K8S_TOKEN}" \
  "https://platform.example.com/clusters-rewrite/${CLUSTER_NAME}/connectors-operator/featureflags"

此 API 需要访问 ConnectorClass 的权限。有关端点详情,请参见 Connector API。

更新 Feature Flag

Feature flags 通过 ConnectorsConfig.spec.components.core.spec.featureFlags 进行配置。Connectors Operator 会将该值传播到受管理的 ConnectorsCore 子 CR,并在 reconciliation 期间将其合并到 connectors-config ConfigMap 中。CR 中的值会覆盖 manifest 默认值。

通过 ConnectorsConfig(推荐)

编辑 cluster-singleton ConnectorsConfig,以声明式方式设置 feature flags:

kubectl edit connectorsconfig connectors-config -n connectors-operator
apiVersion: operator.connectors.alauda.io/v1alpha1
kind: ConnectorsConfig
metadata:
  name: connectors-config
spec:
  components:
    core:
      spec:
        featureFlags:
          enable-multi-connector: "true"
          enable-custom-ca-certs: "true"

或者使用 kubectl patch:

kubectl patch connectorsconfig connectors-config -n connectors-operator --type merge \
  -p '{"spec":{"components":{"core":{"spec":{"featureFlags":{"enable-multi-connector":"true"}}}}}}'

这里声明的 feature flags 会覆盖 connectors-config 中的 manifest 默认值。未列出的键将保留其 manifest 默认值。当新版本引入额外的 feature flags 时,它们会自动以默认值出现。

**注意:**不要直接编辑受管理的 ConnectorsCore 子 CR 或 connectors-config ConfigMap——它们都会在下一次 reconcile 时从 ConnectorsConfig 重新同步回来。请始终更新 ConnectorsConfig.spec.components.core.spec.featureFlags。

内置 Feature Flags

FlagDefaultDescription
enable-connector-apis-permissions"false"启用对通过 Connectors API 暴露的工具 API 的访问权限检查。
enable-connector-apis-write-passthrough"false"在 Connectors API gateway 上放行写方法(POST/PUT/DELETE/PATCH)。禁用时,无论 RBAC 如何,写请求都会被以 HTTP 405 拒绝。启用时,写请求将遵循与 GET 相同的细粒度 SAR 链,并由 enable-connector-apis-permissions 控制。
enable-connector-proxy-permissions"false"启用对通过 Connectors Proxy 处理的流量进行权限控制。
enable-connectors-approval"false"启用 Connectors approval workflow,用于对 Connectors Proxy 的受控访问。此标志应与 enable-connector-proxy-permissions 一起启用。
enable-multi-connector"false"启用在单个 CSI volume 中挂载和渲染多个 Connectors 的配置。
enable-custom-ca-certs"false"启用在验证到工具的 TLS 连接时信任自定义 CA 证书(带全局标签的 Secrets 以及按 Connector 配置的 spec.caCertSecretRef)。
enable-pod-image-pull-via-connector"false"控制 OCI/Harbor PodWebhook 将 Pod 镜像地址自动重写为 Connector Proxy URL 的功能。禁用时,显式声明 connectors.cpaas.io/connector 注解的 Pod 会在 admission 阶段被拒绝,并返回明确的错误信息。

Feature Flag 详情

enable-connector-apis-permissions

启用此标志后,系统会对通过 Connectors API 执行的访问应用基于 RBAC 的权限检查。这将读取 Connector 资源的权限,与使用该 Connector 访问目标工具 API 的权限分离开来。

当你希望用户或 workload 可以发现 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 处理的请求应用权限控制。这在 workload 或工具通过基于 proxy 的无密连接访问外部系统时尤其相关。

当 proxy 访问本身必须受平台权限治理时,请使用此标志。启用 enable-connectors-approval 时也需要此标志,因为 approval 功能会保护 Connectors Proxy 的使用。

相关阅读:

enable-connectors-approval

启用此标志后,Connectors 可以参与针对 Connectors Proxy 的 approval-gated 访问工作流。此功能旨在保护基于 proxy 的 connector 使用场景,尤其是 workload 通过 proxy 端点访问外部工具时。

请将 enable-connector-proxy-permissions 与此标志一起启用。若没有 proxy 权限控制,approval 功能无法保护目标 proxy 使用路径。

此功能适用于如下场景:生产环境制品晋级、部署到受保护的 cluster,或任何在授予访问权限之前必须先经过审批的基于 proxy 的 connector 使用环境。

相关阅读:

enable-multi-connector

启用此标志后,Connectors CSI Driver 可以在单个 volume 中挂载由多个 Connectors 渲染出的配置。这使一个 workload 能够同时消费多个工具集成,并且 driver 会根据配置的 configuration.names 合并渲染后的配置。

这对于某些工作流非常有用,例如一个 Tekton task 需要一个 Connector 用于读取依赖项,另一个 Connector 用于发布制品。

相关阅读:

enable-custom-ca-certs

启用此标志后,平台在验证到工具的 TLS 连接时会信任额外的 CA 证书,同时不会禁用证书验证。信任池会以叠加方式构成:

  1. 系统默认 CA 池——容器镜像中内置的 OS 级信任存储。
  2. 全局自定义 CA 证书——位于 connectors-system namespace 中、带有 connectors.cpaas.io/ca-cert: "true" 标签的 Secrets。
  3. 每个 Connector 的 CA 证书——Connector 上 spec.caCertSecretRef.name 引用的可选 Secret,该 Secret 必须与该 Connector 位于同一 namespace。

构建出的 CA 池会用于 controller liveness 和 authentication probes、Connectors Proxy 流量、ConnectorClass 可访问性检查,以及适用的 extension proxies(OCI、Harbor、Git HTTPS 等)。

启用此标志后,会在每个 Connector 上发布信息性 CACertReady condition,以反映每个 Connector 的 CA 加载状态。该 condition 的 severity 为 Info,并且不会影响顶层的 Ready condition。

相关阅读:

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 凭据分发到用户 namespace。

当该标志禁用时(默认值),PodWebhook 会拒绝带有 connectors.cpaas.io/connector 注解的 Pod 创建请求,并返回错误信息,提示启用该标志以及 ConnectorsConfig.spec.components.core.spec.featureFlags 字段。没有该注解的 Pod 不受影响,现有的手动 imagePullSecrets 工作流也会继续正常工作。

相关阅读:

下一步