VKS 環境においてプライベート レジストリを使用すると MANIFEST_UNKNOWN エラーで VKS Standard Packages のインストールが失敗する
Article ID: 441642
Updated On:
Products
Issue/Introduction
免責事項：これは英文の記事 「VKS Standard Packages installation fails with MANIFEST_UNKNOWN from private Harbor registry」の日本語訳です。
記事はベストエフォートで翻訳を進めているため、ローカライズ化コンテンツは最新情報ではない可能性があります。
最新情報は英語版の記事で参照してください。
VMware Cloud Foundation (VCF) 上の vSphere Kubernetes Service (VKS) において、プライベートレジストリ（Harbor 等）から Istio パッケージをインストールする際、以下のエラーが発生してプロビジョニングが失敗します。
エラーメッセージ：
MANIFEST_UNKNOWN: manifest unknown; map[Name:packages/istio Revision:sha256:f80707b5dd9cd953a0c0032ad71697194#####cbdd75d96d289d89b33f737cdc]インストール時に kapp-controller が依存するコンテナマニフェストを取得できず処理が停止します。
Environment
vSphere Kubernetes Service (VKS)
VKS Standard Packages
Cause
プライベートレジストリへ Carvel バンドルをコピーする際、コピー中にコマンドが終了するなどで必要なパッケージ(マニフェスト)の転送が完了せず、
Standard Packages のインストールに必要な依存コンテナイメージが、レジストリで不足しています。
Resolution
以下の手順で、依存関係にある不足したイメージバンドルをプライベートレジストリにアップロードします。
Push Standard Packages to a Private Harbor Registry を参考に、imgpkg copy コマンドを実行します。
imgpkg copy -b projects.packages.broadcom.com/vsphere/supervisor/packages/2025.1.7/vks-standard-packages:v2025.1.7 --to-repo harbordomain.com/packages/repo --registry-ca-cert-path xxx/ca.crt
...中略
copy | will export projects.packages.broadcom.com/vsphere/supervisor/packages/2025.8.19/vks-standard-packages@sha256:f80707b5dd9cd953a0c0032ad71697194#####cbdd75d96d289d89b33f737cdc
copy | exported 180 images
copy | importing 180 images
...
引き続き失敗する場合は、並列度を下げて(concurrency 1)、アップロードが完了するか確認します。
imgpkg copy -b projects.packages.broadcom.com/vsphere/supervisor/packages/2025.1.7/vks-standard-packages:v2025.1.7 --to-repo harbordomain.com/packages/repo --registry-ca-cert-path xxx/ca.crt --concurrency 1
Additional Information
Feedback
