openchoreo-setup

OpenChoreo 设置

将 OpenChoreo 引导部署到 Kubernetes 上。两个目标，每个目标都有单集群和多集群两种路径：

在本地 k3d 上（开发者／贡献者工作流）

• 单集群 → ./references/on-k3d-locally.md
• 多集群（每个平面使用一个集群）→ ./references/on-k3d-multi-cluster.md

在你的 Kubernetes 环境中（k3s、GKE、EKS、AKS、DOKS、Rancher Desktop 或自托管环境）

• 单集群 → ./references/on-your-environment.md
• 多集群（完整多集群、混合或多区域）→ ./references/multi-cluster.md

如果用户尚未说明，请询问他们选择的目标和拓扑。然后加载匹配的参考文档并从头到尾遵循其中的步骤——该文档规定了此路径的选项确认、版本解析、获取、逐步执行和报告流程。

首先固定 kube 上下文

运行任何 kubectl / helm 命令前，先明确每条命令的目标上下文，并显式传入该上下文——不要依赖当前激活的上下文。环境中通常会有多个上下文（而当前激活的上下文可能是占位上下文或指向错误的集群），因此隐式上下文可能会悄无声息地将安装部署到错误位置。

• 预先确认目标：运行 kubectl config get-contexts，并与用户确定哪个上下文是安装目标（如有需要，创建或重命名上下文）。对于多集群部署，每个平面（cp / dp / op / wp）各确定一个上下文。
• 每条命令都传入上下文：使用 kubectl --context=<ctx> … 和 helm --kube-context=<ctx> …。对于多集群，在每条命令中注明对应平面的上下文——绝不要依赖“当前”状态在各步骤间延续。
• 如果首次调用 kubectl 时遇到身份验证提示、EOF 或 API 无法访问的错误，则说明当前激活的上下文是虚拟上下文或错误的集群——先解决上下文问题再继续，不要绕过它。