用途:通过 YugabyteDB Kubernetes Operator 以 Kubernetes 自定义资源(CR)声明式地供应、管理和排查 YugabyteDB universe,并与 YugabyteDB Anywhere(YBA)配合使用。技能内含 references/crd-examples.md(各 CRD 完整 YAML 示例)、references/workflows.md(端到端供应、升级、备份与容灾流程)、references/kubeconfig-secrets.md、references/multi-cluster-service-mesh.md。注意:该技能面向 YBA Kubernetes Operator(商业版),并不完全适用于 CRD 与功能更少的 YugabyteDB OSS Kubernetes Operator。
主要能力:Operator 监听指定命名空间,通过 CR 管理 universe。CRD 使用 apiVersion operator.yugabyte.io/v1alpha1,依赖顺序为 Release、YBProvider、YBCertificate、YBUniverse、StorageConfig、Backup/BackupSchedule/RestoreJob、PitrConfig、PitrRestore、DrConfig、SupportBundle,每项须 Ready 后再创建下游资源。前置条件包括 kubectl 上下文指向 Operator 所在集群、目标命名空间与 yugaware.kubernetesOperatorNamespace 一致、CRD 版本与 Helm chart 一致,以及多集群时各远程集群的 kubeconfig 密钥存在。仅当 universe 与 Operator 同集群且 YBA 具备 ClusterRoleBinding 时自动创建 provider;否则需显式创建 YBProvider。CRD 需先于 helm upgrade 应用:kubectl apply -f https://raw.github.com/yugabyte/charts/<new-version>/crds/concatenated_crd.yaml,再执行 helm upgrade yba yugabytedb/yugaware --version <new-version> ...。
限制与注意:kubernetesOperatorNamespace 为空字符串时存在 status 补丁报错,导致 Release 无法触发下载,建议设置为具体命名空间。kubeconfig 密钥须含 kubeconfig 单键并提供完整 YAML,使用长期服务账号令牌。storage 相关密钥必须预先存在,否则 CR 创建后 UUID 为空且更新失败。v2026.1+ 中 tserverVolume/masterVolume 与旧 deviceInfo/masterDeviceInfo 互斥,部分字段设置后不可移除;tserverResourceSpec 对已有 kubernetesOverrides.resource 的 universe 不生效。YBC 限流中的 maxConcurrentUploads/Downloads 上限为 3。其余未提供的实现细节暂未提供。