gcrane-ls
List container image tags and repositories
TLDR
List the tags
Format response from the registry as JSON
Whether to recurse through repositories
Display help
SYNOPSIS
gcrane ls [flags] repository
PARAMETERS
--json
Output results in JSON format.
--raw
Output image names without the registry prefix.
DESCRIPTION
The `gcrane ls` command lists the repositories and images within a Google Container Registry (GCR) or Artifact Registry. It allows users to discover and explore the contents of remote container image registries without needing to download the images. This is especially useful for managing container images in cloud environments, identifying available versions, and verifying uploads. The command offers filtering options to narrow down results based on repository names or image tags. It simplifies the process of browsing container images stored in GCR, improving container image management workflows.
CAVEATS
Requires authentication with Google Cloud to access private registries. Output might be large for registries containing many images and repositories.
AUTHENTICATION
gcrane relies on the standard Google Cloud authentication mechanisms. Make sure you are authenticated to access the registry before running gcrane ls. This can be achieved via the gcloud auth command or by leveraging service account credentials.
Proper authentication is critical for gcrane to operate against private repositories.
EXAMPLES
List all images in a repository:gcrane ls gcr.io/my-project/my-image
List all repositories under a project (requires appropriate permissions):gcrane ls gcr.io/my-project
Output the list of images in JSON format:gcrane ls --json gcr.io/my-project/my-image