## 前言

前面8篇讲的是 ArgoCD，现在切换到 Flux。Flux 是另一个 CNCF 毕业的 GitOps 工具，更轻量、CLI 友好。本篇从零安装 Flux，配置第一个 GitRepository，部署第一个应用。

---

## 一、Flux 架构回顾

```
Flux v2 架构（GitOps Toolkit）:
  
  ┌──────────────────────────────────────────────────┐
  │                  Flux Controllers                  │
  │                                                   │
  │  ┌────────────────┐  ┌──────────────────────────┐ │
  │  │ source-controller│  │ kustomize-controller     │ │
  │  │ (管理Git/Helm源) │  │ (同步Kustomize到集群)     │ │
  │  └────────────────┘  └──────────────────────────┘ │
  │                                                   │
  │  ┌────────────────┐  ┌──────────────────────────┐ │
  │  │ helm-controller │  │ notification-controller  │ │
  │  │ (管理Helm Release)│  │ (发送告警通知)            │ │
  │  └────────────────┘  └──────────────────────────┘ │
  │                                                   │
  │  ┌────────────────┐  ┌──────────────────────────┐ │
  │  │ image-reflector│  │ image-automation         │ │
  │  │ (扫描镜像仓库)   │  │ (自动更新镜像版本)          │ │
  │  └────────────────┘  └──────────────────────────┘ │
  └──────────────────────────────────────────────────┘
```

每个 Controller 是一个独立的 Deployment，通过 CRD 管理资源。你可以按需安装——不需要 Helm 就不装 helm-controller。

---

## 二、安装 Flux

### 安装 Flux CLI

```bash
# 方式1：官方脚本
curl -s https://fluxcd.io/install.sh | sudo bash

# 方式2：直接下载
curl -sLO "https://github.com/fluxcd/flux2/releases/latest/download/flux_$(uname -s)_$(uname -m).tar.gz"
tar xzf flux_*_*.tar.gz
sudo install flux /usr/local/bin/

# 验证
flux version
# flux: v2.2.3
```

### 前置检查

```bash
# 检查集群是否满足 Flux 要求
flux check --pre
# ► connecting to kubernetes.default.svc
# ► running preflight checks
# ✔ kubectl version 1.28.x
# ✔ Kubernetes 1.28.x
# ✔ prerequisites checks passed
```

### 安装 Flux 到集群

```bash
# 方式1：基础安装（需要已有 Git 仓库和 Token）
flux install

# 方式2：完整 bootstrap（推荐！自动创建 Git 仓库结构）
flux bootstrap github \
  --owner=myorg \
  --repository=myapp-deploy \
  --branch=main \
  --path=clusters/prod \
  --personal=false \
  --token-auth=true
```

### Bootstrap 做了什么

```
flux bootstrap 做了5件事:
  1. 在集群中安装 Flux 控制器
  2. 在 Git 仓库中创建 clusters/prod/flux-system/ 目录
  3. 将 Flux 自身配置写入 Git 仓库
  4. 创建 GitRepository CR（指向你的 Git 仓库）
  5. 创建 Kustomization CR（同步 flux-system 目录）

结果:
  → Flux 自己管理自己（用 GitOps 管理 GitOps）
  → Git 仓库中有完整的 Flux 配置
  → 新集群可以从 Git 仓库恢复 Flux
```

### 验证安装

```bash
# 检查控制器状态
flux check
# ► checking prerequisites
# ► Kubernetes 1.28.x
# ► installing components
# ✔ source-controller: ready
# ✔ kustomize-controller: ready
# ✔ helm-controller: ready
# ✔ notification-controller: ready
# ✔ image-reflector: ready
# ✔ image-automation-controller: ready

# 查看 Flux 资源
flux get all
# NAME                      READY   MESSAGE
# GitRepository/flux-system  True    stored: true
# Kustomization/flux-system   True    Applied revision: main/abc123
```

---

## 三、配置第一个 GitRepository

### 创建 GitRepository CRD

```yaml
# clusters/prod/myapp-source.yaml
apiVersion: source.toolkit.fluxcd.io/v1
kind: GitRepository
metadata:
  name: myapp-deploy
  namespace: flux-system
spec:
  url: https://github.com/myorg/myapp-deploy.git
  ref:
    branch: main                # 跟踪 main 分支
  interval: 30s                 # 每30秒检查一次
  secretRef:
    name: myapp-deploy-creds    # 引用认证 Secret（私有仓库）
```

### 私有仓库认证

```bash
# 创建认证 Secret
kubectl create secret generic myapp-deploy-creds \
  --namespace=flux-system \
  --from-literal=username=$GIT_USER \
  --from-literal=password=$GIT_TOKEN

# 或用 SSH 方式
kubectl create secret generic myapp-deploy-creds \
  --namespace=flux-system \
  --from-file=identity=$HOME/.ssh/flux_repo_key \
  --from-file=identity.pub=$HOME/.ssh/flux_repo_key.pub \
  --from-file=known_hosts=$HOME/.ssh/known_hosts
```

### 验证 GitRepository

```bash
# 查看同步状态
flux get sources git
# NAME            READY   MESSAGE
# myapp-deploy    True    stored: true, revision: main/abc123

# 手动触发同步（不等 interval）
flux reconcile source git myapp-deploy --namespace flux-system
# ► annotating GitRepository myapp-deploy
# ► reconciling GitRepository myapp-deploy
# ✔ source updated: main/abc123
```

---

## 四、部署第一个应用

### 创建 Kustomization CRD

```yaml
# clusters/prod/myapp-kustomization.yaml
apiVersion: kustomize.toolkit.fluxcd.io/v1
kind: Kustomization
metadata:
  name: myapp
  namespace: flux-system
spec:
  # 源：引用上面的 GitRepository
  sourceRef:
    kind: GitRepository
    name: myapp-deploy
    namespace: flux-system
  
  # 部署清单路径（Git 仓库中的路径）
  path: ./overlays/prod
  
  # 同步间隔
  interval: 1m
  
  # 清理策略
  prune: true                    # 自动删除 Git 中不存在的资源
  wait: true                     # 等待资源就绪再标记为 Ready
  timeout: 5m                    # 超时时间
  
  # 健康检查
  healthChecks:
    - apiVersion: apps/v1
      kind: Deployment
      name: myapp
      namespace: myapp-prod
    - apiVersion: v1
      kind: Service
      name: myapp
      namespace: myapp-prod
  
  # 依赖（先同步基础设施）
  dependsOn:
    - name: infrastructure-redis
    - name: infrastructure-postgres
```

### Git 仓库结构

```
myapp-deploy/  (Git 仓库)
├── clusters/
│   └── prod/                    # 生产集群配置
│       ├── flux-system/        # Flux 自身配置
│       ├── myapp-source.yaml   # GitRepository
│       └── myapp-kustomization.yaml  # Kustomization
├── base/                        # 基础部署清单
│   ├── deployment.yaml
│   ├── service.yaml
│   └── kustomization.yaml
└── overlays/
    ├── dev/
    │   ├── kustomization.yaml
    │   └── patches.yaml
    └── prod/
        ├── kustomization.yaml
        └── patches.yaml
```

### 提交并同步

```bash
# 提交 Flux 配置到 Git
cd myapp-deploy
git add clusters/prod/myapp-source.yaml clusters/prod/myapp-kustomization.yaml
git commit -m "add flux source and kustomization"
git push origin main

# Flux 在 30秒内检测到变更，自动同步
# 手动加速
flux reconcile kustomization myapp --with-source --namespace flux-system

# 查看状态
flux get kustomizations
# NAME    READY   MESSAGE
# myapp   True    Applied revision: main/abc123

# 查看 Pod
kubectl get pods -n myapp-prod
# NAME     READY   STATUS    RESTARTS
# myapp-0  1/1     Running   0
# myapp-1  1/1     Running   0
```

---

## 五、多集群管理

### 不同集群用不同路径

```
myapp-deploy/  (Git 仓库)
├── clusters/
│   ├── prod/          # 生产集群的 Flux 配置
│   │   ├── flux-system/
│   │   ├── myapp-source.yaml
│   │   └── myapp-kustomization.yaml
│   └── staging/      # 预发集群的 Flux 配置
│       ├── flux-system/
│       ├── myapp-source.yaml
│       └── myapp-kustomization.yaml
├── base/              # 共享基础配置
└── overlays/
    ├── prod/
    └── staging/
```

### 在每个集群上运行 Flux

```bash
# 在 staging 集群上
flux bootstrap github \
  --owner=myorg \
  --repository=myapp-deploy \
  --branch=main \
  --path=clusters/staging    # 注意路径不同

# 在 prod 集群上
flux bootstrap github \
  --owner=myorg \
  --repository=myapp-deploy \
  --branch=main \
  --path=clusters/prod
```

> **培训要点**：Flux 的多集群方式和 ArgoCD 不同——Flux 是在每个集群内运行一个 Flux 实例，各自从同一个 Git 仓库的不同路径读取配置。ArgoCD 是一个实例管理多个集群。选择取决于你更倾向于集中管理还是分布式管理。

---

## 六、本篇要点回顾

1. `flux install` 基础安装，`flux bootstrap` 一键安装+自管理（推荐）
2. GitRepository CR 定义 Git 仓库源，Kustomization CR 定义同步规则
3. `flux reconcile` 手动触发即时同步（不等 interval）
4. `prune: true` + `wait: true` + `healthChecks` 确保同步完整
5. 多集群用不同路径：clusters/prod/ 和 clusters/staging/

**下一篇预告**：《核心概念：Source、Kustomization 与 HelmRelease》——深入 Flux 的三大核心 CRD。

前面8篇讲的是 ArgoCD，现在切换到 Flux。Flux 是另一个 CNCF 毕业的 GitOps 工具，更轻量、CLI 友好。本篇从零安装 Flux，配置第一个 GitRepository，部署第一个应用。

【GitOps·Flux篇】环境搭建：安装配置与首次 GitRepository

研发部经理

开发工具

运维

后端

Flux是CNCF毕业的GitOps工具，提供轻量、CLI友好的部署方案。本文详解Flux v2架构、安装步骤及GitRepository/Kustomization配置，实现从零部署首个应用。涵盖bootstrap自管理、私有仓库认证、多集群管理策略，助你快速掌握Flux核心工作流。

2026上云采购 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

【GitOps·Flux篇】环境搭建：安装配置与首次 GitRepository-腾讯云开发者社区-腾讯云

【GitOps·Flux篇】环境搭建：安装配置与首次 GitRepository

【GitOps·Flux篇】环境搭建：安装配置与首次 GitRepository

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐