LinuxCommandLibrary

gcrane-ls

List container image tags and repositories

TLDR

List the tags

$ gcrane ls [repository]
copy

Format response from the registry as JSON
$ gcrane ls [repository] --json
copy

Whether to recurse through repositories
$ gcrane ls [repository] [[-r|--recursive]]
copy

Display help
$ gcrane ls [[-h|--help]]
copy

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

SEE ALSO

crane(1), docker(1)

Copied to clipboard