KubeVela 是基于 OAM 模型的应用层抽象，非 Kubernetes 替代品；部署 Golang 微服务需将交付逻辑适配为 Application、Component、Trait 和 Workflow 四类对象，而非直接应用原生 YAML，否则无法启用自动扩缩、灰度发布等能力。
KubeVela 不是 Kubernetes 的替代品，而是上层抽象层；直接用它部署 Golang 微服务，核心不是“怎么配 KubeVela”，而是“怎么把 Go 服务的交付逻辑适配进它的模型里”。
为什么不能照搬 Helm 或 kubectl 那套 YAML？
KubeVela 基于 Open Application Model（OAM）设计，它把“应用”拆成 Application、Component、Trait 和 Workflow 四类对象。Golang 微服务如果还只写一个 Deployment + Service YAML，KubeVela 会识别为“无结构裸资源”，无法启用自动扩缩、流量灰度、配置分发等能力。
- 直接 apply 原生 Deployment YAML → KubeVela 当作普通 Kubernetes 资源托管，不触发 OAM 流程
- 没定义
Component类型 → KubeVela 不知道这是个 HTTP 服务还是 gRPC 服务，无法自动注入健康探针 Trait - 没绑定
autoscaler或ingressTrait → 即使写了 HorizontalPodAutoscaler 或 Ingress，也不会随应用生命周期自动创建/销毁
Component 必须声明 Go 服务类型和端口协议
Go 微服务在 Component 中不能只填镜像地址，得明确语义：它是 HTTP 还是 gRPC？监听哪个端口？是否需要 TLS 终止？这些决定后续 Trait 能否正确生效。
-
type: webservice是最常用类型，但仅适用于 HTTP/HTTPS 流量；gRPC 服务必须用type: worker+ 显式挂载ingressTrait 并设置appProtocol: grpc -
ports字段必须与 Go 代码中http.ListenAndServe("0.0.0.0:8080", nil)一致，且不能写127.0.0.1:8080，否则 KubeVela 注入的 Service 无法路由 - 若 Go 服务暴露
/healthz和/readyz，应在traits中启用healthTrait，它会自动配置livenessProbe和readinessProbe，不用手动写 probe 配置
ConfigMap/Secret 注入必须走 Parameterized Component
KubeVela 默认把环境变量当静态字符串处理。如果你的 Go 服务用 viper.AutomaticEnv() 读取 DATABASE_URL，但直接在 Component 里写 env: [{name: DATABASE_URL, value: "mysql://..."}]，会导致所有环境共用同一套值，无法做多集群差异化配置。
立即学习“go语言免费学习笔记（深入）”；
- 正确做法是定义
parameter字段，把敏感字段声明为参数：parameters: [{name: databaseURL, type: string, description: "DB connection string"}] - 在
Application实例中通过variables或components[*].properties注入真实值，KubeVela 会校验类型并阻止非法输入 - Secret 值必须用
fromSecret引用，不能硬编码；否则vela dry-run会报错，CI 流水线也会卡住
Workflow 里别漏掉镜像构建和推送环节
KubeVela 自身不构建镜像，也不推送到仓库。很多团队误以为写完 Application 就能一键部署，结果 ImagePullBackOff 报错才发现镜像根本不存在。
- Workflow 步骤必须显式包含
build-image（调用 Kaniko 或 BuildKit）或git-clone + docker-build任务 - 镜像 tag 推荐用
git commit hash而非latest，否则 KubeVela 的版本比对机制失效，滚动更新不会触发 - Workflow 执行权限需提前绑定
serviceAccount，确保它有imagePullSecrets权限访问私有 Registry，否则即使镜像存在也拉不到
真正卡点不在 KubeVela 配置语法，而在于 Go 服务是否已按 OAM 模型“解耦”——配置、运维策略、交付流程都得从代码里抽出来，变成可声明、可复用、可组合的模块。否则 KubeVela 只是套壳，没发挥出应用交付平台的价值。
