fluxcd/image-reflector-controller

image-reflector-controller 镜像文档

概述

image-reflector-controller 是 Flux CNCF 项目的可选组件，专门用于扫描容器镜像仓库并获取镜像版本信息。作为 GitOps 工具链的一部分，它为自动化镜像版本跟踪和部署流程提供基础数据支持。

核心功能与特性

• 镜像仓库扫描：支持扫描各类容器镜像仓库（如 DockerHub、私有镜像仓库等）
• 版本信息提取：自动识别并提取仓库中的镜像标签及版本元数据
• 数据提供能力：为 Flux 生态中的其他组件（如 image-automation-controller）提供标准化的镜像版本数据接口

使用场景与适用范围

• GitOps 工作流中需要自动跟踪容器镜像版本的场景
• 需动态更新部署配置以使用最新镜像版本的环境
• 集成到 CI/CD 流水线中，实现镜像版本的自动化管理与同步
• Kubernetes 集群中基于镜像版本变更触发部署更新的场景

使用方法与配置说明

部署方式

作为 Flux 生态组件，通常通过 Kubernetes 集群部署，推荐使用 Flux 官方安装方式：

bash
# 通过 Flux CLI 安装（默认包含该组件）
flux install

# 或单独部署（如需自定义配置）
kubectl apply -f https://raw.githubusercontent.com/fluxcd/image-reflector-controller/main/config/install.yaml

核心配置

通过 Kubernetes 自定义资源 ImageRepository 配置镜像仓库扫描规则：

yaml
apiVersion: image.toolkit.fluxcd.io/v1beta2
kind: ImageRepository
metadata:
  name: example-repo
  namespace: flux-system
spec:
  image: docker.xuanyuan.run/library/nginx  # 目标镜像仓库地址
  interval: 5m                    # 扫描间隔（默认5分钟）
  timeout: 60s                    # 扫描超时时间
  # 可选：仓库认证配置
  secretRef:
    name: registry-credentials    # 包含仓库认证信息的 Secret 名称

版本获取

部署后，控制器将定期扫描配置的镜像仓库，并通过 ImageRepository 资源的状态字段暴露镜像版本信息：

bash
kubectl get imagerepositories example-repo -o yaml

输出中将包含 status.latestImage 等字段，展示最新扫描到的镜像版本信息。

注意事项

• 作为 Flux 可选组件，需确保与 Flux 核心组件版本兼容
• 对于私有仓库，需正确配置认证 Secret（包含 username/password 或 token）
• 扫描间隔可根据实际需求调整，避免对仓库造成过度请求压力