Argo Proj on Learning Notes

Argo Workflows

Mon, 01 Jan 0001 00:00:00 +0000

概览 #

Argo Workflows 是 CNCF 毕业项目，Kubernetes 原生的工作流引擎，用于编排容器化的任务（CI/CD、数据处理、ML 训练等）。

项目	说明
官网	argoproj.github.io/workflows
文档	argo-workflows.readthedocs.io
GitHub	argoproj/argo-workflows
API 版本	`argoproj.io/v1alpha1`
CRD	`Workflow`、`WorkflowTemplate`、`ClusterWorkflowTemplate`、`CronWorkflow`
Online	killercoda, Github

架构 #

┌─────────────────────────────────────────────────────────────────┐
│ argo namespace │
│ │
│ ┌──────────────────────┐ ┌──────────────────────────┐ │
│ │ Workflow Controller │ │ Argo Server │ │
│ │ (Deployment) │ │ (Deployment) │ │
│ │ │ │ │ │
│ │ - Watch Workflow CRD │ │ - gRPC/HTTP API :2746 │ │
│ │ - 创建/管理 Pod │ │ - Web UI (React) │ │
│ │ - Reconcile 状态 │ │ - SSO / Token 认证 │ │
│ └──────────┬───────────┘ └──────────────────────────┘ │
│ │ │
└─────────────┼────────────────────────────────────────────────────┘
 │ 创建 Pod
 ▼
┌─────────────────────────────────────────────────────────────────┐
│ 目标 namespace │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ Workflow Pod │ │
│ │ │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │ │
│ │ │ init │──▶│ main │──▶│ wait │ │ │
│ │ │ (拉取 │ │ (用户 │ │ (上传 artifact、 │ │ │
│ │ │ artifact)│ │ 容器) │ │ 保存参数) │ │ │
│ │ └──────────┘ └──────────┘ └──────────────────┘ │ │
│ └─────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘

核心组件：

Argo Events

Mon, 01 Jan 0001 00:00:00 +0000

Argo Events #

Kubernetes Event-Driven Workflow Automation Framework — 事件驱动的工作流自动化框架，监听 20+ 事件源并触发 Argo Workflows、K8s 资源、Serverless 等动作。CNCF Graduated（Argo 项目家族成员）。

Website	Doc	Github	Demo	Comment
Argo Events	Doc	Github	Demo	CNCF 毕业项目，事件驱动依赖管理，支持多种事件源

Read First #

Docs, Github, CNCF

Concepts - Architecture

Concepts - EventSource

Tutorial - Introduction

Tutorial - Parameterization

核心概念 #

Event-Driven Architecture（事件驱动架构） #

Argo Events 将 Kubernetes 集群转变为事件驱动的平台：监听外部事件（Webhook、Git、日历、消息队列等）→ 转换为 CloudEvents → 通过 EventBus 传递 → Sensor 匹配依赖条件 → 触发下游动作（Argo Workflows、K8s 资源、HTTP 请求等）。

Argo CD

Mon, 01 Jan 0001 00:00:00 +0000

Argo CD #

Declarative, GitOps continuous delivery tool for Kubernetes. CNCF Graduated 项目。

Website	Doc	Github	Demo	Comment
Argo CD	Doc	Github	Demo	CNCF 毕业项目，GitOps 持续交付工具，提供完整 UI

argocd-example-apps

#

Read First #

Docs, Github, CNCF

Understand The Basics

Getting Started

Architecture Overview

Argo CD vs Flux — 两大 GitOps 工具对比

Killercoda Argo CD Labs — 在线实验环境

核心概念 #

GitOps 原则 #

声明式配置：应用定义、配置和环境均以 Git 仓库为唯一真实来源（Source of Truth）
版本控制：所有变更通过 Git commit 追踪，具备完整审计能力
自动同步：控制器持续对比 Git 期望状态与集群实际状态，自动或手动同步
拉取模式（Pull）：与 CI 的 Push 模式不同，Argo CD 从 Git 拉取期望状态并应用到集群

支持的配置管理工具 #

工具	说明
Kustomize	Kubernetes 原生配置管理，overlay 模式
Helm	Kubernetes 包管理器，Chart 模板渲染
Jsonnet	数据模板语言，适合复杂配置生成
Plain YAML/JSON	直接使用 YAML/JSON 清单文件
Config Management Plugin	自定义配置管理插件（如 kustomize + helm 组合）

核心 CRD #

CRD	说明
Application	定义应用的 Source（Git 仓库 + 路径 + 目标 revision）和 Destination（目标集群 + namespace）
AppProject	多租户隔离单元，限制 Application 可用的 Git 仓库、目标集群、命名空间和 K8s 资源类型
ApplicationSet	自动生成多个 Application 的模板引擎，通过 Generator 批量创建应用（如按集群、Git 目录、矩阵等）

架构组件 #

┌──────────────────────────────────────────────────────────┐
│ Argo CD 控制面 │
│ │
│ ┌─────────────┐ ┌─────────────────┐ ┌────────────┐ │
│ │ API Server │ │ Repo Server │ │ Redis │ │
│ │ (gRPC/REST) │ │ (Git 缓存+渲染) │ │ (缓存层) │ │
│ └──────┬───────┘ └────────┬────────┘ └────────────┘ │
│ │ │ │
│ ┌──────┴────────────────────┴────────────────────────┐ │
│ │ Application Controller │ │
│ │ (持续监控 → 对比 Git 期望状态 vs 集群实际状态) │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ ┌────────────────────┐ ┌────────────────────────────┐ │
│ │ Dex (SSO/OIDC) │ │ Notifications Controller │ │
│ └────────────────────┘ └────────────────────────────┘ │
└──────────────────────────────────────────────────────────┘
 │ │
 ┌─────┴─────┐ ┌─────┴─────┐
 │ Git Repo │ │ K8s 集群 │
 │ (Source │ │ (目标环境) │
 │ of Truth)│ │ │
 └───────────┘ └───────────┘

三大核心组件 #

组件	职责
API Server	gRPC/REST 服务，暴露给 Web UI / CLI / CI 系统。负责应用管理、状态报告、认证与 RBAC、Webhook 监听
Repository Server	维护 Git 仓库本地缓存，根据 repo URL + revision + path + 模板参数生成并返回 K8s 清单
Application Controller	K8s Controller，持续对比 Git 期望状态与集群实际状态，检测 `OutOfSync` 并执行同步操作，触发 PreSync/Sync/PostSync 生命周期 Hook

辅助组件 #

组件	职责
Dex	SSO 代理，支持 OIDC/OAuth2/LDAP/SAML/GitHub/GitLab 等身份认证
Redis	缓存层，加速清单渲染和状态查询
Notifications Controller	发送同步结果通知到 Slack/Teams/Email 等

快速开始 #

1. 安装 #

kubectl create namespace argocd
kubectl apply -n argocd --server-side --force-conflicts \
 -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

--server-side --force-conflicts 是因为部分 CRD（如 ApplicationSet）超过 262KB annotation 限制。

Argo Rollouts

Mon, 01 Jan 0001 00:00:00 +0000

Argo Rollouts #

Kubernetes Progressive Delivery Controller — 提供蓝绿部署、金丝雀发布、流量管理和自动化分析能力。CNCF Graduated 项目。

Website	Doc	Github	Demo	Comment
Argo Rollouts	Doc	Github	Demo	CNCF 毕业项目，K8s 原生渐进式交付控制器

Read First #

Docs, Github, CNCF

Concepts

Architecture

Getting Started

Rollout Specification

Killercoda Argo Rollouts Labs — 在线实验环境

核心概念 #

Progressive Delivery（渐进式交付） #

渐进式交付是持续交付的演进，通过限制新版本的暴露范围→观察分析行为→逐步扩大范围→持续验证正确性，降低发布风险：

控制爆炸半径（Blast Radius）：新版本仅暴露给少量用户
自动化推广/回滚：基于指标分析结果自动决策
细粒度流量控制：按百分比、Header、镜像流量等方式分流

Rollout CRD #

Rollout 是 Argo Rollouts 的核心 CRD，等价于 Kubernetes Deployment 但具备更高级的部署策略：

特性	Deployment	Rollout
滚动更新	✅ RollingUpdate	✅ 支持（canary 无 steps 时等同）
蓝绿部署	❌	✅
金丝雀发布	❌	✅ 多阶段百分比控制
流量精细控制	❌	✅ 配合 Service Mesh/Ingress
自动化分析	❌	✅ AnalysisTemplate/AnalysisRun
自动回滚	❌	✅ 基于指标自动回滚
人工审批	❌	✅ pause 步骤

支持的部署策略 #

策略	说明	流量切换	需要流量管理器
Blue-Green	新旧版本同时运行，仅旧版本接收流量，验证后一键切换	全量切换（0%→100%）	否
Canary（基础）	按副本数比例分配流量	粗粒度百分比	否
Canary + Traffic Routing	通过 Service Mesh/Ingress 精细控制流量	细粒度百分比 + Header + 镜像	是

策略选择指南：