Flux RFC-0004 解读:Flux 如何统一管控 Insecure HTTP 连接(控制器开关、对象字段与 CLI 标志)

原创2026-09-24 10:18:421,431 阅读
文章标签:云原生GitOpsCI/CD容器编排DevOpsCLI配置管理

Flux RFC-0004 解读:Flux 如何统一管控 Insecure HTTP 连接(控制器开关、对象字段与 CLI 标志)

本文基于 Flux(flux2)仓库中的设计文档 RFC-0004: Block insecure HTTP connections across Flux,系统梳理 Flux 对"明文 HTTP 连接"的管控机制:控制器级 --insecure-allow-http 启动参数、对象级 .spec.insecure 字段、CLI 的 --insecure 类标志,以及代理(Proxy)场景下的校验规则与"Stalled"失败状态。读完后你将能够:在集群中强制 Flux 各控制器仅走 HTTPS、识别哪些 API 对象需要显式开启 .spec.insecure、并使用 Flux CLI 正确地连接本地非 TLS 的 OCI 仓库或 MinIO 等对象存储。

背景:Flux 各控制器对非 TLS 连接的处理并不一致

RFC-0004(Status: implementable,创建于 2022-09-08,最后更新 2023-07-26)开宗明义地指出了问题:Flux 各控制器对非 TLS 连接的支持是不一致的。具体表现为:

  • 只处理 http / https scheme 的控制器,缺少在控制器层面整体禁用 http scheme 的手段;
  • 部分 Flux 对象虽然提供了 .spec.insecure 字段来启用非 TLS 端点,但当底层不支持时(例如 Azure/GCP 的 Bucket),并不会明确告知用户该选项不可用。

RFC 提出的一致性方案分两层:

层级 机制 语义
控制器级 布尔启动参数 --insecure-allow-http(默认 true) 关闭后,该控制器发起的所有出站 HTTP 明文连接均被禁止
对象级 布尔字段 .spec.insecure(默认 false) 允许单个对象访问非 TLS 端点(前提是控制器允许且云服务商支持)

同时 RFC 明确了非目标(Non-Goals):不破坏 Flux 当前允许 HTTP 连接的行为(即默认值保持兼容),也不改变 Flux 组件之间的通信方式。如果对象声明了非 TLS 端点但该用法不被支持,reconciliation 会失败,对象被标记为 Stalled,提示需要人工介入。

控制器级开关:--insecure-allow-http

RFC 规定,以下四个控制器新增布尔参数 --insecure-allow-http,默认值为 true(保证不产生破坏性变更):

  • source-controller
  • notification-controller
  • image-automation-controller
  • image-reflector-controller

若集群管理员要强制这些控制器只走 HTTPS,需要显式传入 --insecure-allow-http=false。RFC 中给出的 Deployment 参数示例如下:

spec:
  template:
    spec:
      containers:
      - name: manager
        image: fluxcd/source-controller
        args:
          - --watch-all-namespaces
          - --log-level=info
          - --log-encoding=json
          - --enable-leader-election
          - --storage-path=/data
          - --storage-adv-addr=source-controller.$(RUNTIME_NAMESPACE).svc.cluster.local.
          - --insecure-allow-http=false

为什么 kustomize-controller 和 helm-controller 被排除

RFC 特别注明,该标志不应加到以下两个控制器,并给出了理由:

  • kustomize-controller:上游 kubernetes-sigs/kustomize 项目在拉取 remote bases 时不支持禁用 HTTP 连接,因此无法在控制器层实现该能力;若未来上游支持可再考虑。
  • helm-controller:该控制器本身不发起 HTTP 调用;虽然它也可以做 remote apply,但通过明文 HTTP 服务 kube-apiserver 这一做法在 Kubernetes 上游很早就被移除了,因此该标志在此无实际意义。

这一细节说明:RFC-0004 的设计边界是"Flux 自己可控的网络行为",对受上游库或上游项目限制的场景,选择通过其他方式弥补(如禁用 kustomize 的 remote bases)。

对象级字段:.spec.insecure

对于 GitRepository 这类 URL 自带 scheme 的对象,控制器可以通过 scheme 推断传输类型(http 还是 https)。但有些对象无法通过 URL scheme 表达非 TLS 意图,RFC 列举了两个典型:

  • ImageRepository:它的 .spec.image 字段是镜像地址,任何包含 scheme 的地址都被视为非法,且默认使用 HTTPS。这导致用户无法使用非 TLS registry 上的镜像。
  • OCI HelmRepository:.spec.url 必须以 oci:// 开头,scheme 部分被用来表示 HelmRepository 的类型,用户无法借此声明 registry 位于非 TLS 端点。

针对这类对象,RFC 的解法是引入新的布尔字段 .spec.insecure,默认 false;需要指向 HTTP 端点的用户显式置为 true。

从本仓库的 CLI 源码可以看到该字段在多个 API 中的实际落地:

  • Bucket 对象通过 Insecure: sourceBucketArgs.insecure 写入 spec(create source bucket 实现),命令帮助文案为 "for when connecting to a non-TLS S3 HTTP endpoint";
  • OCIRepository 对象同样通过 Insecure: sourceOCIRepositoryArgs.insecure 写入(create source oci 实现),帮助文案为 "for when connecting to a non-TLS registries over plain HTTP"。

即 .spec.insecure 在 Bucket、OCIRepository 等对象上已成为 API 的一等字段,与 RFC 提案一致。

CLI 侧:--insecure 与相关标志

RFC 提出:CLI 中那些会生成对象定义、且需要指定端点的命令(如创建 OCIRepository),应提供布尔标志 --insecure,用于设置对象的 .spec.insecure 值。示例:

flux create source oci podinfo \
    --url=oci://ghcr.io/stefanprodan/manifests/podinfo \
    --tag=6.1.6 \
    --interval=10m

并特别提示:--insecure 不要与 --insecure-skip-tls-verify 混淆——后者是跳过 HTTPS 连接的 TLS 证书校验,而前者是允许使用明文 HTTP。

在当前仓库的 CLI 实现中,这类标志的具体形态如下(以源码为准):

命令 标志 默认值 作用
flux create source oci --insecure false 设置 OCIRepository 的 .spec.insecure(create_source_oci.go)
flux create source bucket --insecure false 设置 Bucket 的 .spec.insecure(create_source_bucket.go)
flux pull artifact --insecure-registry false 拉取时以非 TLS 方式访问 registry,底层追加 crane.Insecure 选项(pull_artifact.go)
flux bootstrap git --allow-insecure-http false 允许 bootstrap 时对 Git 仓库使用明文 HTTP(bootstrap_git.go)

其中 pull artifact 的实现对 RFC 的设计意图做了直接印证:当 --insecure-registry 为真时,代码向 OCI 客户端选项追加 crane.Insecure(pull_artifact.go),也就是显式启用明文 HTTP 的 registry 客户端——正对应 RFC 中"当对象 .spec.insecure 为 true 时,registry 客户端应显式以启用 HTTP 连接的方式创建"的 Design Details。

bootstrap git 则体现了另一种防御姿态:默认拒绝 HTTP 仓库,只有显式传入 --allow-insecure-http=true 才会给 Git 客户端追加 WithInsecureCredentialsOverHTTP 选项(bootstrap_git.go);若 URL 为 http scheme 且未传该标志,命令直接报错 scheme http is insecure, pass --allow-insecure-http=true to allow it(bootstrap_git.go)。这与"未显式声明即拒绝"的一致性思想一脉相承。

另一个细节在 flux create source git 中:当为 http:// 仓库配置了凭据时,CLI 会打印警告 insecure configuration: credentials configured for an HTTP URL(create_source_git.go),提醒用户凭据将以明文传输。

Proxy:HTTP 代理配置同样纳入管控

RFC 将代理配置也纳入该开关的管辖范围:

  • 若控制器的 --insecure-allow-http=false,则给控制器设置 HTTP_PROXY 环境变量会导致控制器启动时直接退出失败;
  • HTTPS_PROXY 的值若为 http scheme 的 URL,同样被禁止;
  • 若代理通过对象 API 指定(如 notification.toolkit.fluxcd.io 组中 Provider 的 .spec.secretRef),且代理 URL 的 scheme 是 http,reconciler 会失败并返回错误,错误可在控制器日志和对象事件中查看。

这意味着管控点覆盖了"环境变量"与"对象 Secret"两条代理注入路径,堵住了一类容易被忽视的明文出站通道。

优先级与有效性(Precedence & Validity)

RFC 定义了两条硬性约束,可以理解为"逐层收窄"的校验链:

  1. 控制器约束对象:对象 .spec.insecure: true 只有在控制器级别允许 HTTP(--insecure-allow-http 未关闭)时才会被接受;
  2. 服务商约束对象:即使对象声明了 .spec.insecure: true,如果 Saas/Cloud 服务商本身不支持 HTTP 连接,该组合也是非法的。例如 Bucket 的 .spec.provider 设为 azure 时——Azure 不允许 HTTP 连接。

对应的失败行为(Design Details)分两种:

控制器已禁用 HTTP 时,对象 URL 为 http scheme——reconciliation 失败,对象 .status.conditions 中出现:

status:
  conditions:
  - lastTransitionTime: "2022-09-06T09:14:21Z"
    message: "Use of insecure HTTP connections isn't allowed for this controller"
    observedGeneration: 1
    reason: InsecureConnectionsDisallowed
    status: "True"
    type: Stalled

对象 .spec.insecure: true 但云服务商不允许 HTTP——reconciliation 失败,出现:

status:
  conditions:
  - lastTransitionTime: "2022-09-06T09:14:21Z"
    message: "Use of insecure HTTP connections isn't allowed for Azure Storage"
    observedGeneration: 1
    reason: UnsupportedConnectionType
    status: "True"
    type: Stalled

两种场景都以 Stalled 条件显式暴露"需要人工介入"的信号,而不是静默降级或含糊失败,这正是 RFC Motivation 中"明确通知用户该选项不受支持"的落地形式。

用户故事:多租户强制 HTTPS 与本地非 TLS registry

场景一:集群管理员强制全部控制器只走 HTTPS

作为多租户集群的管理员,我希望无论租户如何定义对象,所有控制器都只使用 HTTPS 访问端点。

做法是应用一个 kustomize 补丁,为相关 Deployment 追加 --insecure-allow-http=false;同时因为 kustomize-controller 不支持该参数,改用 --no-remote-bases=true 禁用远程 base,确保它不会发起任何明文 HTTP 连接:

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - gotk-components.yaml
  - gotk-sync.yaml
patches:
  - patch: |
      - op: add
        path: /spec/template/spec/containers/0/args/-
        value: --insecure-allow-http=false
    target:
      kind: Deployment
      name: "(source-controller|notification-controller|image-reflector-controller|image-automation-controller)"
  # Since the above flag is not available in kustomize-controller for reasons explained in a previous section,
  # we disable Kustomize remote builds by disallowing use of remote bases. This ensures that kustomize-controller
  # won't initiate any plain HTTP connections.
  - patch: |
      - op: add
        path: /spec/template/spec/containers/0/args/-
        value: --no-remote-bases=true
    target:
      kind: Deployment
      name: kustomize-controller

注意 name 使用了正则匹配四个控制器 Deployment,kustomize-controller 用第二条补丁单独处理——这与上文"两个控制器被排除"的说明严格对应。

场景二:调试推送到本地非 HTTPS registry 的镜像

作为应用开发者,我在调试一个新推送到本地 registry 的镜像,而该 registry 不提供 HTTPS。

此时在对象 spec 中显式开启 HTTP:

apiVersion: image.toolkit.fluxcd.io/v1beta1
kind: ImageRepository
metadata:
  name: podinfo
  namespace: flux-system
spec:
  image: kind-registry:5000/stefanprodan/podinfo
  interval: 1m0s
  insecure: true

前提是所在控制器的 --insecure-allow-http 未被设为 false,否则该对象会进入 Stalled 状态(见上文条件示例)。

备选方案与实施状态

RFC 讨论过的备选方案是:不新增控制器参数,而是指导用户安装 Kyverno 策略,强制所有对象 .spec.insecure 为 false、且对象定义中的 URL 不得为 http scheme。RFC 认为该方案吸引力不足:它要求用户额外安装一套软件,且使 Flux 的多租户强制能力无法独立成立。

关于实施进度,RFC 的 Implementation History 记录了第一项已落地能力:2022-08-12,允许用 flux create source oci --insecure 为非 TLS 容器 registry 定义 OCI 源,随 flux2 v0.34.0 发布。从当前仓库源码看,--insecure 标志已扩展覆盖到 create source bucket、pull artifact --insecure-registry,bootstrap git 则有配套的 --allow-insecure-http 显式放行机制(见上文 CLI 标志表),整体上"控制器总开关 + 对象字段 + CLI 标志 + Stalled 显式报错"的框架已按 RFC 骨架在仓库中持续演进。

小结:一条清晰的"逐层收窄"校验链

综合 RFC-0004 的设计,Flux 对明文 HTTP 的管控可归纳为一条自底向上的校验链:

  1. 对象声明:.spec.insecure(或 URL scheme 为 http)显式表达非 TLS 意图,CLI 通过 --insecure / --insecure-registry / --allow-insecure-http 等标志帮助正确设置;
  2. 云服务商校验:provider 不支持 HTTP(如 Azure)时,reconciler 报 UnsupportedConnectionType 并将对象置为 Stalled;
  3. 控制器校验:--insecure-allow-http=false 的控制器拒绝一切明文 HTTP,包括 HTTP_PROXY/HTTPS_PROXY 为 http scheme 的代理配置(启动失败)或对象 Secret 中的 http 代理(reconcile 失败),并打上 InsecureConnectionsDisallowed 的 Stalled 条件。

这套设计在保持向后兼容(默认 true)的前提下,让集群管理员获得了"一刀切"的能力,同时把每一次被拒绝的连接都以结构化、可观测的 Stalled 条件呈现,避免了用户面对隐式失败无从排查的问题。

登录后查看全文
flux2