/wharfie

Pulls and unpacks a container image to the local filesystem. Usable both as a standalone CLI tool, and as a go module.

Primary LanguageGoApache License 2.0Apache-2.0

wharfie

Utility libraries to provide additional functionality for users of go-containerregistry. Also includes a basic command-line app demonstrating use of the library code.

cli

NAME:
   wharfie - pulls and unpacks a container image to the local filesystem

USAGE:
   wharfie [global options] command [command options] <image> <destination>

VERSION:
   v0.3.1

DESCRIPTION:
   Supports K3s/RKE2 style repository rewrites, endpoint overrides, and auth configuration.
   Supports optional loading from local image tarballs or layer cache.
   Supports Kubelet credential provider plugins.

COMMANDS:
   help, h  Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --private-registry value                   Private registry configuration file (default: "/etc/rancher/common/registries.yaml")
   --images-dir value                         Images tarball directory
   --cache                                    Enable layer cache when image is not available locally
   --cache-dir value                          Layer cache directory (default: "$XDG_CACHE_HOME/rancher/wharfie")
   --image-credential-provider-config value   Image credential provider configuration file
   --image-credential-provider-bin-dir value  Image credential provider binary directory
   --debug                                    Enable debug logging
   --help, -h                                 show help
   --version, -v                              print the version

image credential providers

(KEP-2133) kubelet image credential providers are supported. At the time of this writing, none of the out-of-tree cloud providers offer standalone binaries. The wharfie docker image (available by running make package-image) bundles provider plugins at /bin/plugins, with a sample config file at /etc/config.yaml.

More information is available at: