mumoshu/crossover

Crossover

Crossover是针对Envoy的极简且够用的xDS实现，旨在帮助Kubernetes环境下的金丝雀部署，同时保留Envoy的所有原生特性。它通过本地文件系统与Envoy通信，无需复杂的gRPC服务或CRD，依赖极少且易于维护。

核心功能

• 最小依赖：仅依赖Go标准库和go-yaml，无需kubectl、client-go等额外工具。
• 渐进迁移：支持从静态Envoy配置逐步过渡到动态配置，无需一次性替换现有架构。
• 易于理解：通过本地文件提供xDS配置，调试简单（直接查看生成的配置文件），无需掌握gRPC知识。
• 功能完整：不做任何抽象层，保留Envoy所有原生特性，用户可编写标准Envoy配置文件。

使用场景

1. Ingress网关：将stable/envoy chart转化为动态可配置的API网关或前端代理。
2. 金丝雀发布：实现加权负载均衡和金丝雀部署，无需重启Envoy或使用CRD。
3. 集群内路由/负载均衡：为应用流量添加重试、熔断、追踪和metrics，无需从一开始就使用服务网格。

配置说明

命令行参数

console
crossover -h
Usage of ./crossover:
  -apiserver string    K8s api endpoint (默认 "https://kubernetes")
  -configmap value     要处理的ConfigMap
  -dry-run             打印处理后的配置，不提交到集群
  -insecure            禁用TLS服务器验证
  -namespace string    处理的命名空间
  -onetime             运行一次后退出
  -output-dir string   Envoy读取xDS配置的目录
  -smi                 启用SMI集成
  -sync-interval duration 模板处理的时间间隔（默认1m0s）
  -token-file string   ServiceAccount token文件路径（默认"/var/run/secrets/kubernetes.io/serviceaccount/token"）
  -trafficsplit value  要监控并合并到ConfigMap的TrafficSplit
  -watch               使用Watch API实时检测变化

快速开始

ConfigMap-only模式

1. 部署Envoy：

bash
helm repo add stable https://kubernetes-charts.storage.googleapis.com
helm upgrade --install envoy stable/envoy -f example/values.yaml -f example/values.services.yaml

2. 部署后端服务（以podinfo为例）：

bash
helm repo add flagger https://flagger.app
helm upgrade --install bold-olm flagger/podinfo --set canary.enabled=false
helm upgrade --install eerie-octopus flagger/podinfo --set canary.enabled=false

3. 测试流量切换：

bash
kubectl run -it --rm --image alpine:3.9 tester sh
apk add --update curl
watch curl http://envoy:10000

4. 修改权重：

bash
# 100%流量到bold-olm
helm upgrade --install envoy stable/envoy -f example/values.yaml -f example/values.services.yaml \
  --set services.podinfo.backends.eerie-octopus-podinfo.weight=0 \
  --set services.podinfo.backends.bold-olm-podinfo.weight=100

ConfigMap + SMI TrafficSplit模式

1. 部署Envoy时启用SMI：

bash
helm upgrade --install envoy stable/envoy \
  -f example/values.yaml -f example/values.services.yaml \
  --set services.podinfo.smi.enabled=true

2. 使用TrafficSplit修改权重：

yaml
apiVersion: split.smi-spec.io/v1alpha2
kind: TrafficSplit
metadata:
  name: podinfo
spec:
  service: podinfo
  backends:
  - service: eerie-octopus-podinfo
    weight: 0
  - service: bold-olm-podinfo
    weight: 100

应用配置：kubectl apply -f podinfo-v0.trafficsplit.yaml