VCF 9.1 Consumption CLI 插件同步失败解决方法
一、问题现象在 VCF 9.1 环境执行vcf plugin sync同步插件时系统尝试下载 9.0.1 版本插件环境实际为 9.1出现以下错误[i] Installing plugins from plugin group vmware-vcfcli/essentials:v9.0.1 [x] Failed to install plugin telemetry:v9.0.1 [!] unable to install plugin telemetry: unable to fetch the plugin metadata for plugin telemetry: MANIFEST_UNKNOWN [!] No active contexts available to perform plugin sync即便环境已升级至 9.1CLI 仍默认拉取 9.0.1 插件清单导致安装失败。二、问题根因VCF 9.1 对 Consumption CLI 插件分发机制做了变更不再默认从 Broadcom 公共仓库projects.packages.broadcom.com拉取插件。在线环境需将插件 OCI 镜像迁移至私有容器仓库离线 / 隔离环境则必须通过本地离线包安装否则会因仓库路径变更导致同步失败。三、离线安装步骤推荐适用于所有环境1. 下载离线安装包登录 Broadcom 支持门户BSP进入路径My Downloads → VMware Cloud Foundation → 9.1.0.0下载以下两个文件VCF Consumption CLI客户端二进制文件VCF Consumption CLI Plugins插件离线包格式VCF-Consumption-CLI-PluginBundle-[OS]_[ARCH]-9.1.0.0.tar.gz2. 清理旧配置缓存删除旧版本插件缓存目录避免冲突rm -rf ~/.local/vcf rm -rf ~/.local/vcf-cli-telemetry3. 解压插件离线包创建专用目录并解压插件包mkdir -p VCF-Consumption-CLI-Plugins-9.1.0.0 tar -zxvf VCF-Consumption-CLI-PluginBundle-Darwin_AMD64-9.1.0.0.25305443.tar.gz -C VCF-Consumption-CLI-Plugins-9.1.0.04. 本地安装所有插件通过--local-source参数指定本地插件目录批量安装vcf plugin install all --local-source VCF-Consumption-CLI-Plugins-9.1.0.05. 验证安装结果执行以下命令查看已安装插件确认所有插件含 telemetry状态为installed、版本为 9.1.0vcf plugin list输出示例NAME DESCRIPTION INSTALLED STATUS addon Add-on lifecycle management v3.6.1 installed cluster Kubernetes cluster operations v3.6.1 installed imgpkg Package/distribute OCI artifacts v9.1.0 installed telemetry Telemetry for VCF Workload CLI v9.1.0 installed四、在线环境替代方案私有仓库若环境可联网且已有私有容器仓库如 Harbor可将插件 OCI 镜像从官方仓库迁移至私有仓库再配置 CLI 指向私有仓库地址无需离线安装包。五、关键注意事项离线包必须与客户端系统 / 架构匹配如 Darwin_AMD64 对应 macOS。清理旧缓存目录是必要步骤残留文件会导致安装失败。9.1 插件与 9.0.x 不兼容不可混用旧版本离线包。