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.1，CLI 仍默认拉取 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.gz）

2. 清理旧配置缓存

删除旧版本插件缓存目录，避免冲突：

rm -rf ~/.local/vcf rm -rf ~/.local/vcf-cli-telemetry

3. 解压插件离线包

创建专用目录并解压插件包：

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.0

4. 本地安装所有插件

通过--local-source参数指定本地插件目录，批量安装：

vcf plugin install all --local-source VCF-Consumption-CLI-Plugins-9.1.0.0

5. 验证安装结果

执行以下命令查看已安装插件，确认所有插件（含 telemetry）状态为installed、版本为 9.1.0：

vcf 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 不兼容，不可混用旧版本离线包。