12.0

vctl Commands to Manage Container Images Registry Authentication
Command Description
vctl login [OPTION] [SERVER] Logs in to a remote registry.
vctl logout [SERVER] Logs out from a remote registry.
Note
n On macOS, the credentials are saved in the Keychain. On Windows, the credentials are saved
in the Credential Manager.
n Once the login is successful, future Pull, Push and Build requests will leverage the saved
credential.
n Logout request deletes the corresponding credential from the Keychain or the Credential
Manager.
vctl Commands to Get System Environment Ready for vctl-Based KIND
Command Description
vctl kind Prepares the system environment for vctl-based KIND.
KIND uses vctl containers as nodes for running Kubernetes
clusters.
Examples of vctl Commands
The command-line examples that follow work on VMware Fusion.
Commands Related to Image
n When you build a new image, to pull the base image from a private Docker registry
successfully, either use the vctl login command to log in to the private Docker registry first
or use the --credential option to pass a JSON file that stores credentials to vctl build
command for registry authentication. For example:
a Encode your Docker registry username and password in base64 with the following
command:
echo -n USER:PASSWORD | base64
b Create a config.json file with your Docker registry URL and the base64 encoded string
generated in step 1.
{
"auths": {
"https://index.docker.io/v2/": {
"auth": "xxxxxxxxxxxxxxx"
}
}
}
Using VMware Fusion
VMware, Inc. 186