LinuxCommandLibrary

ibmcloud-cr

Manage IBM Cloud Container Registry

TLDR

Set target region for IBM Cloud Container Registry

$ ibmcloud cr region-set
copy

List images available
$ ibmcloud cr [[images|image-list]]
copy

Inspect an image data
$ ibmcloud cr image-inspect [image]
copy

Run vulnerability assessment on an image
$ ibmcloud cr [[va|vulnerability-assessment]] [image]
copy

Log the local Docker or Podman client in to IBM Cloud Container Registry
$ ibmcloud cr login
copy

List all actions available under this command
$ ibmcloud cr help
copy

SYNOPSIS

ibmcloud cr [command] [flags]

PARAMETERS

build
    Build container image

image-delete
    Delete image(s)

image-inspect
    Inspect image(s)

image-list
    List image(s)

image-pull
    Pull image(s)

image-push
    Push image(s)

login
    Login to registry

logout
    Logout from registry

namespace-add
    Add namespace(s)

namespace-delete
    Delete namespace(s)

namespace-list
    List namespace(s)

plugin-update
    Update cr plugin

quota
    Show quota usage

region
    Show/list regions

repositories
    List repositories

va
    Vulnerability reports

--api
    API endpoint override

--check
    Check plugin version

--help, -h
    Show help

--locale
    Set locale

--output, -o
    Output format (json, yaml, table)

--registry
    Registry hostname override

--trace
    Show trace info

--verbose, -v
    Verbose output

DESCRIPTION

The ibmcloud cr command provides a command-line interface to manage container images and namespaces in the IBM Cloud Container Registry (ICR). Part of the IBM Cloud CLI, it requires installing the cr plugin via ibmcloud plugin install cr.

It supports operations like logging in/out, listing/inspecting/pulling/pushing/deleting images, managing namespaces and repositories, checking quotas, building images, and vulnerability assessments. Users must authenticate with an IBM Cloud API key or IAM token.

Ideal for CI/CD pipelines and DevOps workflows on IBM Cloud, it integrates with tools like Docker. Output formats include table, JSON, or YAML for scripting.

CAVEATS

Requires IBM Cloud CLI v0.28+ and cr plugin. Authentication via ibmcloud login and API key mandatory. Regional availability varies; use --registry for multi-region.

INSTALLATION

Run ibmcloud plugin install cr after installing IBM Cloud CLI from ibm.com/cloud/cli.

AUTHENTICATION

ibmcloud login, then ibmcloud cr login with API key for image ops.

HISTORY

Introduced in 2018 with IBM Cloud Container Registry launch. Evolved from Bluemix registry tools; actively maintained by IBM with updates for IAM auth and vulnerability scanning.

SEE ALSO

docker(1), podman(1), ibmcloud(1), skopeo(1)

Copied to clipboard