Skip to content

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

License

Notifications You must be signed in to change notification settings

rancher/wharfie

Folders and files

NameName
Last commit message
Last commit date

Latest commit

0b73264 · Feb 11, 2025

History

56 Commits
Jun 21, 2024
Oct 1, 2024
Feb 11, 2025
Dec 1, 2024
May 6, 2021
Oct 1, 2024
Apr 29, 2021
May 4, 2021
Dec 23, 2022
Feb 11, 2025
Feb 11, 2025
Feb 11, 2025

Repository files navigation

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:

About

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

Resources

License

Security policy

Stars

Watchers

Forks

Languages