Container Registry CLI

注释

要进一步了解如何使用 Container Registry CLI、ibmcloud cr 命令，请参阅 IBM Cloud Container Registry 开始使用。

当 ibmcloud CLI 和 container-registry CLI 插件的更新可用时，将在命令行上通知您。 确保更新 CLI，以便使用所有可用命令和选项。 如果要查看 container-registry CLI 插件的当前版本，请运行 ibmcloud plugin list 命令。

有关某些 Container Registry 命令所需的 IAM 平台和服务访问角色的更多信息，请参阅 管理 Container Registry的 IAM 访问权。

不要将个人信息放入容器映像、名称空间名称、描述字段或任何映像配置数据（例如，映像名称或映像标签）中。

如果 Container Registry ibmcloud cr 命令因未注册而失败，请参阅 《 为何 Container Registry(ibmcloud cr)命令会显示未注册 错误？》获取帮助。 如果命令执行失败并显示未登录的提示信息，请参阅 《为何无法登录 Container Registry？》 获取帮助。

示例

了解注册表 API 端点的详细信息。

ibmcloud cr api

输出

示 例中的命令返回以下输出：

Registry API endpoint   https://us.icr.io/api

OK

先决条件

如需了解所需权限的更多信息，请参阅 配置的访问角色 Container Registry。

命令选项

--scope SCOPE

要将帐户设置为作用域，请使用"*"作为值。

要将命名空间、版本库、摘要或标记设置为作用域，请按以下格式之一输入值：

• namespace
• namespace/repository
• namespace/repository:tag
• namespace/repository@digest

--issue-type ISSUE_TYPE

要豁免的安全问题的类型。 要查找有效的问题类型，请运行 ibmcloud cr exemption-types。

--issue-id ISSUE_ID

要豁免的安全问题的标识。 要查找问题 ID，请运行 ibmcloud cr va <image>，其中 <image> 是您的图像名称，并使用漏洞 ID 列中的相关值。

--output json, -o json

(可选）以 JSON 格式输出列表。

示例

输入 us.icr.io/birds/bluebird 作为范围，输入 cve 作为问题类型，输入 CVE-2018-17929 作为问题 ID，为 us.icr.io/birds/bluebird 资源库中 ID 为 CVE-2018-17929 的 CVE 创建 CVE 豁免。

ibmcloud cr exemption-add --scope us.icr.io/birds/bluebird --issue-type cve --issue-id CVE-2018-17929

输入 "*" 表示范围、cve 表示问题类型、CVE-2018-17929 表示问题 ID，为 ID 为 CVE-2018-17929 的 CVE 创建全账户范围的 CVE 豁免。

ibmcloud cr exemption-add --scope "*" --issue-type cve --issue-id CVE-2018-17929

先决条件

如需了解所需权限的更多信息，请参阅 配置的访问角色 Container Registry。

命令选项

--scope SCOPE

（可选）仅列出应用于此作用域的豁免。

要将命名空间、版本库、摘要或标记设置为作用域，请按以下格式之一输入值：

• namespace
• namespace/repository
• namespace/repository:tag
• namespace/repository@digest

--output json, -o json

(可选）以 JSON 格式输出列表。

示例

通过输入 birds/bluebird 作为范围，列出适用于 birds/bluebird 资源库中图像的所有安全问题豁免。

输出结果包括整个账户范围内的豁免、作用域为 birds 命名空间的豁免以及作用域为 birds/bluebird 资源库的豁免。 输出结果不包括任何针对 birds/bluebird 资源库中特定标记的豁免。

ibmcloud cr exemption-list --scope birds/bluebird

在 birds/bluebird@sha256:101010101010 摘要中输入 birds/bluebird@sha256:101010101010 作为范围，列出适用于图像的所有安全问题豁免。

输出结果包括整个账户的豁免、针对 birds 命名空间的豁免以及针对 birds/bluebird 资源库和 birds/bluebird@sha256:101010101010 摘要的豁免。 输出结果不包括任何针对 birds/bluebird 资源库中特定标记的豁免。

ibmcloud cr exemption-list --scope birds/bluebird@sha256:101010101010

先决条件

如需了解所需权限的更多信息，请参阅 配置的访问角色 Container Registry。

命令选项

--scope SCOPE

要将帐户设置为作用域，请使用"*"作为值。

要将命名空间、版本库、摘要或标记设置为作用域，请按以下格式之一输入值：

• namespace
• namespace/repository
• namespace/repository:tag
• namespace/repository@digest

--issue-type ISSUE_TYPE

您要删除的安全问题的豁免问题类型。 要查找豁免的问题类型，请运行 ibmcloud cr exemption-list。

--issue-id ISSUE_ID

要除去的安全问题豁免的标识。 要查找豁免的问题标识，请运行 ibmcloud cr exemption-list。

示例

输入 us.icr.io/birds/bluebird 作为范围、cve 作为问题类型、CVE-2018-17929 作为问题 ID，删除 us.icr.io/birds/bluebird 资源库中所有图像的 ID 为 CVE-2018-17929 的 CVE 豁免。

ibmcloud cr exemption-rm --scope us.icr.io/birds/bluebird --issue-type cve --issue-id CVE-2018-17929

输入 "*" 作为范围、cve 作为问题类型、CVE-2018-17929 作为问题 ID，删除 ID 为 CVE-2018-17929 的 CVE 的全账户范围 CVE 豁免。

ibmcloud cr exemption-rm --scope "*" --issue-type cve --issue-id CVE-2018-17929

先决条件

如需了解所需权限的更多信息，请参阅 配置的访问角色 Container Registry。

命令选项

--output json, -o json

(可选）以 JSON 格式输出列表。

示例

列出各类安全问题。

ibmcloud cr exemption-types

输出

示 例中的命令返回以下输出：

Listing exemption types...

Issue type      Description
cve             CVE
sn              Security Notice
configuration   Configuration Issue

OK

先决条件

如需了解所需权限的更多信息，请参阅 配置的访问角色 Container Registry。

示例

使用 IAM 策略实现细粒度授权。

ibmcloud cr iam-policies-enable

示例

显示账户的 IAM 访问策略状态。

ibmcloud cr iam-policies-status

输出

示 例中的命令返回以下输出：

IAM policy enforcement is enabled for account 'X's Account' in registry 'us.icr.io'.

OK

先决条件

如需了解所需权限的更多信息，请参阅 使用的访问角色 Container Registry。

命令选项

--format FORMAT

（可选）使用 Go 模板来设置输出元素的格式。 有关更多信息，请参阅 格式化和过滤 Container Registry CLI 输出。

--quiet, -q

(可选）每幅图像都按格式列出：repository@digest

--output json, -o json

(可选）以 JSON 格式输出列表。

--restrict RESTRICTION

(可选）限制输出，只显示指定命名空间或资源库中的图像。

--include-ibm

（可选）在输出中包含 IBM 提供的公用映像。 缺省情况下，仅列出专用映像。 只能在全局注册表中查看 IBM提供的映像。

--no-va

(可选) 从输出中排除 Vulnerability Advisor 安全状态结果。 如果您不需要将安全状态结果作为 ibmcloud cr image-digests 输出的一部分，那么可以使用此选项来提高性能。

--va

（可选）在输出中包含 Vulnerability Advisor 的安全状态结果。 您可以同时使用 和 --va 选项 --restrict，仅接收您所需的信息。

示例

通过 --quiet 以 repository@digest 的格式列出图像，并输入 birds 作为限制条件，以 repository@digest 的格式显示 birds 命名空间中的所有图像，包括未标记的图像。

ibmcloud cr image-digests --restrict birds --quiet

输出

示 例中的命令返回以下输出：

us.icr.io/birds/bluebird@sha256:11ab001ab10011cd1000101cd0101010001ab111100cd00ab111
us.icr.io/birds/blackbird@sha256:22ef00ef002220002gh200222000gh00ef2222000ab00222

先决条件

如需了解所需权限的更多信息，请参阅 使用的访问角色 Container Registry。

命令自变量

IMAGE

要获取其报告的映像的名称。 可以通过在命令中列出每个映像（各名称之间用一个空格分隔）来检查多个映像。

您可以使用摘要 <dns>/<namespace>/<repo>@<digest> 或标签 <dns>/<namespace>/<repo>:<tag> 来识别图像。 其中，<dns> 是域名，<namespace> 是命名空间，<repo> 是存储库，<digest> 是摘要，<tag> 是标记。

要查找映像的名称，请运行下列其中一个命令:

• 要通过摘要来标识映像，请运行 ibmcloud cr image-digests 命令。 将 存储库 列 (repository) 和 摘要 列 (digest) 的内容以 at (@) 符号分隔，以创建格式为 repository@digest 的映像名称。
• 要按标记标识映像，请运行 ibmcloud cr image-list 命令。 将 存储库 列 (repository) 和 标记 列 (tag) 的内容以冒号 (:) 分隔，以创建格式为 repository:tag 的映像名称。 如果未在映像名称中指定标记，那么缺省情况下会删除标记为 latest 的映像。

命令选项

--format FORMAT

（可选）使用 Go 模板来设置输出元素的格式。 有关更多信息，请参阅 格式化和过滤 Container Registry CLI 输出。

示例

使用格式化指令 "{{ .Config.ExposedPorts }}" 并输入 us.icr.io/birds/bluebird:1 作为图像，显示 us.icr.io/birds/bluebird:1 图像暴露端口的详细信息。

ibmcloud cr image-inspect  --format "{{ .Config.ExposedPorts }}" us.icr.io/birds/bluebird:1

先决条件

如需了解所需权限的更多信息，请参阅 使用的访问角色 Container Registry。

命令选项

--format FORMAT

（可选）使用 Go 模板来设置输出元素的格式。 有关更多信息，请参阅 格式化和过滤 Container Registry CLI 输出。

--quiet, -q

(可选）每幅图像都按格式列出：repository:tag

--restrict RESTRICTION

(可选）限制输出，只显示指定命名空间或资源库中的图像。

--include-ibm

（可选）在输出中包含 IBM 提供的公用映像。 缺省情况下，仅列出专用映像。 只能在全局注册表中查看 IBM提供的映像。

--no-trunc

(可选) 返回其长格式的图像摘要。

--show-type

（可选）显示映像清单类型。

--no-va

(可选) 从输出中排除 Vulnerability Advisor 安全状态结果。 如果您不需要将安全状态结果作为 ibmcloud cr image-list 输出的一部分，那么可以使用此选项来提高性能。

--va

（可选）在输出中包含 Vulnerability Advisor 的安全状态结果。 您可以同时使用 和 --va 选项 --restrict，仅接收您所需的信息。

--output json, -o json

(可选）以 JSON 格式输出列表。

示例

以 repository:tag 格式显示 birds 命名空间中的图像，而不截断图像摘要，方法是使用 --quiet 以 repository:tag 格式显示图像，使用 --no-trunc 以长格式显示图像摘要，并输入 birds 作为限制条件。

ibmcloud cr image-list --restrict birds --quiet --no-trunc

输出

示 例中的命令返回以下输出：

us.icr.io/birds/bluebird:1

先决条件

如需了解所需权限的更多信息，请参阅 使用的访问角色 Container Registry。

命令选项

--force, -f

（可选）强制命令运行，而不显示用户提示。

--output json, -o json

(可选）输出包含未标记图像清理结果的 JSON。 该选项必须与 --force 一起使用。

--restrict

(可选) 将清除限制为仅包含指定名称空间或存储库中未标记的映像。

示例

使用 --force 选项强制命令在没有用户提示的情况下运行，并输入 --json 作为输出和 birds 作为限制，在没有任何用户提示的情况下删除 birds 命名空间中所有未标记的图像，并以 JSON 格式输出结果。

ibmcloud cr image-prune-untagged [--force | -f [--json]] --restrict birds

先决条件

如需了解所需权限的更多信息，请参阅 使用的访问角色 Container Registry。

命令自变量

IMAGE

要从废纸篓复原的映像的名称。

要查找垃圾桶中的图片名称，请运行 ibmcloud cr trash-list 命令。

可以使用标记或摘要来识别映像。 要复原的映像可以由摘要 <dns>/<namespace>/<repo>@<digest> 引用，该摘要将在同一存储库中复原摘要及其所有标记，也可以由标记 <dns>/<namespace>/<repo>:<tag> 引用。 其中，<dns> 是域名，<namespace> 是命名空间，<repo> 是存储库，<digest> 是摘要，<tag> 是标记。

映像会在废纸篓中存储 30 天。

示例

输入 us.icr.io/birds/bluebird:1 作为图像，恢复 us.icr.io/birds/bluebird:1 图像。

ibmcloud cr image-restore us.icr.io/birds/bluebird:1

先决条件

如需了解所需权限的更多信息，请参阅 使用的访问角色 Container Registry。

命令自变量

IMAGE

要删除的映像的名称。 可以通过在命令中列出每个映像（各名称之间用一个空格分隔）来同时删除多个映像。 您可以使用摘要 <dns>/<namespace>/<repo>@<digest> 或标签 <dns>/<namespace>/<repo>:<tag> 来识别图像。 其中，<dns> 是域名，<namespace> 是命名空间，<repo> 是存储库，<digest> 是摘要，<tag> 是标记。

映像会在废纸篓中存储 30 天。

要查找映像的名称，请运行下列其中一个命令:

• 要通过摘要来标识映像，请运行 ibmcloud cr image-digests 命令。 将 存储库 列 (repository) 和 摘要 列 (digest) 的内容以 at (@) 符号分隔，以创建格式为 repository@digest 的映像名称。
• 要按标记标识映像，请运行 ibmcloud cr image-list 命令。 将 存储库 列 (repository) 和 标记 列 (tag) 的内容以冒号 (:) 分隔，以创建格式为 repository:tag 的映像名称。 如果未在映像名称中指定标记，那么缺省情况下会删除标记为 latest 的映像。

示例

输入 us.icr.io/birds/bluebird:1 作为图像，删除 us.icr.io/birds/bluebird:1 图像。

ibmcloud cr image-rm us.icr.io/birds/bluebird:1

先决条件

如需了解所需权限的更多信息，请参阅 使用的访问角色 Container Registry。

命令自变量

SOURCE_IMAGE

源映像的名称。 您可以使用摘要 <dns>/<namespace>/<repo>@<digest> 或标记 <dns>/<namespace>/<repo>:<tag> 来标识源图像。 其中，<dns> 是域名，<namespace> 是命名空间，<repo> 是存储库，<digest> 是摘要，<tag> 是标记。

TARGET_IMAGE

目标映像的名称。TARGET_IMAGE 的格式必须为 repository:tag，例如 us.icr.io/namespace/image:latest。

示例

输入 us.icr.io/birds/bluebird:1 作为源图像，输入 us.icr.io/birds/bluebird:latest 作为目标图像，在图像 us.icr.io/birds/bluebird:1 中添加另一个标记 latest。

ibmcloud cr image-tag  us.icr.io/birds/bluebird:1 us.icr.io/birds/bluebird:latest

输入 us.icr.io/birds/bluebird:peck 作为源镜像，输入 us.icr.io/birds/pigeon:peck 作为目标镜像，将镜像 us.icr.io/birds/bluebird:peck 复制到同一命名空间 birds/pigeon 中的另一个资源库。

ibmcloud cr image-tag us.icr.io/birds/bluebird:peck us.icr.io/birds/pigeon:peck

将 us.icr.io/birds/bluebird:peck 映像复制到您可以访问的另一个命名空间，例如 animals 命名空间，输入 us.icr.io/birds/bluebird:peck 作为源映像，输入 us.icr.io/animals/dog:bark 作为目标映像。

ibmcloud cr image-tag us.icr.io/birds/bluebird:peck us.icr.io/animals/dog:bark

先决条件

如需了解所需权限的更多信息，请参阅 使用的访问角色 Container Registry。

命令自变量

IMAGE

要为其除去标记的映像的名称。 您可以同时从多个映像中删除标记，方法是在命令中列出每个映像，并在每个名称之间使用空格。IMAGE 的格式必须为 repository:tag，例如 us.icr.io/namespace/image:latest。

要查找映像的名称，请运行 ibmcloud cr image-list。 将 存储库 列 (repository) 和 标记 列 (tag) 的内容以冒号 (:) 分隔，以创建格式为 repository:tag 的映像名称。 如果映像名称中未指定标记，那么命令将失败。

示例

输入 us.icr.io/birds/bluebird:1 作为图像，删除 us.icr.io/birds/bluebird:1 图像中的标签 1。

ibmcloud cr image-untag us.icr.io/birds/bluebird:1

示例

查找注册表的名称和账户。

ibmcloud cr info

输出

示 例中的命令返回以下输出：

Plugin version                    1.3.16
Container Registry                us.icr.io
Container Registry API endpoint   https://us.icr.io/api
IBM Cloud API endpoint            https://cloud.ibm.com
IBM Cloud account details         X's Account (1100110011001100)

OK

命令选项

-- client

(可选) 选择要登录的客户机。 有效值为 docker 和 podman。 如果未使用此选项并且已安装 Docker，那么缺省值为 docker; 如果未安装 Docker，那么缺省值为 podman。

示例

要使用 Podman 登录注册表，请输入 podman 作为客户端。

ibmcloud cr login --client podman

先决条件

如需了解所需权限的更多信息，请参阅 使用的访问角色 Container Registry。

命令自变量

IMAGE

要检查清单的映像的名称。 您可以使用摘要 <dns>/<namespace>/<repo>@<digest> 或标签 <dns>/<namespace>/<repo>:<tag> 来识别图像。 其中，<dns> 是域名，<namespace> 是命名空间，<repo> 是存储库，<digest> 是摘要，<tag> 是标记。

要查找映像的名称，请运行下列其中一个命令:

• 要通过摘要来标识映像，请运行 ibmcloud cr image-digests 命令。 将 存储库 列 (repository) 和 摘要 列 (digest) 的内容以 at (@) 符号分隔，以创建格式为 repository@digest 的映像名称。
• 要按标记标识映像，请运行 ibmcloud cr image-list 命令。 将 存储库 列 (repository) 和 标记 列 (tag) 的内容以冒号 (:) 分隔，以创建格式为 repository:tag 的映像名称。

命令选项

--quiet, -q

（可选）减少输出以仅显示必要元素。

示例

输入 us.icr.io/birds/bluebird:1 作为图像，查看 us.icr.io/birds/bluebird:1 图像的清单内容。

ibmcloud cr manifest-inspect us.icr.io/birds/bluebird:1

先决条件

要了解有关所需许可权的更多信息，请参阅 平台管理角色 和 用于配置 Container Registry 的访问角色。

命令自变量

NAMESPACE

要添加的名称空间。 名称空间在同一区域的所有 IBM Cloud 帐户中必须唯一。 名称空间必须具有 4 到 30 个字符，并且只能包含小写字母、数字、连字符 (-) 和下划线 (_)。 名称空间必须以字母或数字开头和结尾。

不要将个人信息放入名称空间名称中。

命令选项

-g (RESOURCE_GROUP_NAME | RESOURCE_GROUP_ID)

(可选）指定要添加命名空间的资源组名称或 ID。 如果未设置此选项，那么将使用目标资源组。 如果未设置此选项，并且未将资源组作为目标，那么将使用帐户的缺省资源组。

示例

创建名称为 birds2 的命名空间，并将其添加到资源组 beaks 中，在资源组名称中输入 beaks，在命名空间中输入 birds2。

ibmcloud cr namespace-add -g beaks birds2

输出

示 例中的命令返回以下输出：

Adding namespace 'birds2' in resource group 'beaks' for account X's Account in registry us.icr.io...

Successfully added namespace 'birds2'

OK

先决条件

要了解有关所需许可权的更多信息，请参阅 平台管理角色 和 用于配置 Container Registry 的访问角色。

命令自变量

NAMESPACE

要分配给资源组的名称空间。

命令选项

-g (RESOURCE_GROUP_NAME | RESOURCE_GROUP_ID)

(可选）指定要为其分配命名空间的资源组名称或 ID。 如果未设置此选项，那么将使用目标资源组。

示例

将名称为 birds 的命名空间分配给资源组 beaks，在资源组名称中输入 beaks，在命名空间中输入 birds。

ibmcloud cr namespace-assign -g beaks birds

输出

示 例中的命令返回以下输出：

Assigning namespace 'birds' to resource group 'beaks' for account X's Account in registry us.icr.io...

Successfully assigned namespace 'birds' to resource group 'beaks.'

OK

先决条件

如需了解所需权限的更多信息，请参阅 使用的访问角色 Container Registry。

命令选项

--verbose, -v

(可选) 列出所有名称空间，并包含有关资源组和名称空间的创建日期的信息。

--output json, -o json

(可选）以 JSON 格式输出列表。

示例

使用 --verbose 选项查看所有命名空间的列表，包括有关资源组和创建日期的信息。

ibmcloud cr namespace-list -v

输出

示 例中的命令返回以下输出：

Listing namespaces for account 'X's Account' in registry 'us.icr.io'...

Namespace   Resource Group   Created
birds       default          1 year ago
birds2      beaks            40 seconds ago

OK

先决条件

如需了解所需权限的更多信息，请参阅 配置的访问角色 Container Registry。

命令自变量

NAMESPACE

要除去的名称空间。

命令选项

--force, -f

（可选）强制命令运行，而不显示用户提示。

示例

输入 birds 作为命名空间，删除 birds 命名空间。

ibmcloud cr namespace-rm birds

先决条件

如需了解所需权限的更多信息，请参阅 配置的访问角色 Container Registry。

命令选项

--output json, -o json

(可选）以 JSON 格式输出列表。

示例

输入 json 作为输出，以 JSON 格式输出定价计划。

ibmcloud cr plan -o json

输出

示 例中的命令返回以下输出：

{
	"plan": "Free"
}

先决条件

如需了解所需权限的更多信息，请参阅 配置的访问角色 Container Registry。

命令自变量

PLAN

（可选）要升级为的价格套餐的名称。 如果未指定 PLAN，缺省值为 standard。

示例

输入 standard 作为计划，升级到标准定价计划。

ibmcloud cr plan-upgrade standard

先决条件

• 必须设置 IBM Cloud Monitoring，请参阅 IBM Cloud Monitoring。
• 针对平台度量值启用 IBM Cloud Monitoring 实例。
• 如需了解所需权限的更多信息，请参阅 配置的访问角色 Container Registry。

命令选项

--enable

(可选）为您的账户启用该设置。

--disable

(可选）禁用账户设置。

--status

(可选）显示账户是否已启用该设置。

示例

使用 --enable 选项为您的账户启用平台指标。

ibmcloud cr platform-metrics --enable

输出

示 例中的命令返回以下输出：

OK

先决条件

如需了解所需权限的更多信息，请参阅 配置的访问角色 Container Registry。

命令选项

--enable

(可选) 防止映像拉取或推送帐户的公用网络连接。

--disable

(可选) 恢复映像拉取或推送帐户的公用网络连接。

--status

(可选) 检查是否阻止在您的帐户中使用公共连接进行映像推送或拉取。

示例

使用 --enable 选项，防止通过公共网络连接为您的账户提取或推送图像。

ibmcloud cr private-only --enable

先决条件

如需了解所需权限的更多信息，请参阅 配置的访问角色 Container Registry。

命令选项

--output json, -o json

(可选）以 JSON 格式输出列表。

示例

输入 json 作为输出选项，以 JSON 格式显示流量和存储配额。

ibmcloud cr quota -o json

输出

示 例中的命令返回以下输出：

{
	"usage": {
		"traffic": 0,
		"store": 0
	},
	"limit": {
		"traffic": 5368709120,
		"store": 536870912
	}
}

先决条件

如需了解所需权限的更多信息，请参阅 配置的访问角色 Container Registry。

命令选项

--traffic TRAFFIC

（可选）将流量配额更改为指定的值（以兆字节为单位）。 如果您无权设置流量，或者如果设置的值超过当前价格套餐，那么操作会失败。

--storage STORAGE

（可选）将存储配额更改为指定的值（以兆字节为单位）。 如果您无权设置存储配额，或者如果设置的值超过当前价格套餐，那么操作会失败。

示例

输入 7000 作为流量配额，输入 600 作为存储配额，将拉取流量的配额限制设为 7000 兆字节，将存储限制设为 600 兆字节。

ibmcloud cr quota-set --traffic 7000 --storage 600

输出

示 例中的命令返回以下输出：

Setting quotas: 'storage: 600 , traffic: 7000'...

OK

示例

了解您的目标地区和注册表。

ibmcloud cr region

输出

示 例中的命令返回以下输出：

You are targeting region 'us-south', the registry is 'us.icr.io'.

OK

命令自变量

REGION

(可选）目标区域的名称，例如 us-south。 有关更多信息，请参阅区域。

示例

以达拉斯地区为目标，输入 us-south 作为地区。

ibmcloud cr region-set us-south

输出

示例 中的命令返回以下输出：

The region is set to 'us-south', the registry is 'us.icr.io'.

OK

先决条件

如需了解所需权限的更多信息，请参阅 使用的访问角色 Container Registry。

命令选项

--output json, -o json

(可选）以 JSON 格式输出列表。

示例

输入 json 作为输出，以 JSON 格式列出账户中的保留策略。

ibmcloud cr retention-policy-list -o json

输出

示 例中的命令返回以下输出：

{
	"birds": {
		"namespace": "birds",
		"account": "",
		"images_per_repo": -1,
		"retain_untagged": true
	},
	"birds2": {
		"namespace": "birds2",
		"account": "",
		"images_per_repo": -1,
		"retain_untagged": true
	}
}

先决条件

如需了解所需权限的更多信息，请参阅 使用的访问角色 Container Registry。

命令自变量

NAMESPACE

要为其创建策略的名称空间。

命令选项

--retain-untagged

(可选）在处理保留策略时保留所有未标记的图像。 仅分析已标记的图像，如果这些图像不符合条件，那么将删除这些图像。 如果未指定该选项，那么将分析所有已标记和未标记的图像，如果这些图像不符合条件，那么将删除这些图像。

--force, -f

（可选）强制命令运行，而不显示用户提示。

--images

确定在指定的名称空间中每个存储库内保留多少个映像。 将保留最新的映像。 映像的时间由其构建日期确定。IMAGE_COUNT 是要在名称空间的每个存储库中保留的映像数。 要将策略恢复到默认状态，即保持所有图像设置 IMAGE_COUNT 至 All。

示例 1

在 birds 命名空间中的每个存储库内设置保留最新 20 个图像的策略，输入 20 作为要保留的图像数，输入 birds 作为命名空间。 分析所有已标记和未标记的图像，若图像不符合标准，则予以删除。

ibmcloud cr retention-policy-set --images 20 birds

示例1的输出

示 例1中的命令返回以下输出：

Found n images to delete.

OK
A scheduled retention policy is set that keeps 20 images in each repository in birds and retain-untagged is set to false.

OK

示例 2

输入 All 作为要保留的图像数量，输入 birds 作为命名空间，将策略还原为默认状态，以便在 birds 命名空间中保留所有图像。

ibmcloud cr retention-policy-set --images All birds

输出示例 2

示例 2 中的命令返回以下输出：

The retention policy to keep all images in birds is set.

OK

先决条件

如需了解所需权限的更多信息，请参阅 使用的访问角色 Container Registry。

命令自变量

NAMESPACE

要清除的名称空间。

命令选项

--force, -f

（可选）强制命令运行，而不显示用户提示。

--output json, -o json

（可选）包含清除名称空间结果的输出 JSON。 该选项必须与 --force 一起使用。

--retain-untagged

(可选）在处理保留策略时保留所有未标记的图像。 仅分析已标记的图像，如果这些图像不符合条件，那么将删除这些图像。 如果未指定该选项，那么将分析所有已标记和未标记的图像，如果这些图像不符合条件，那么将删除这些图像。

--images

确定在指定的名称空间中每个存储库内保留多少个映像。 将保留最新的映像。 映像的时间由其构建日期确定。IMAGE_COUNT 是要在名称空间的每个存储库中保留的映像数。

示例

在 birds 命名空间中保留每个存储库中最新的 20 个图像，输入 20 作为要保留的图像数，输入 birds 作为命名空间。

ibmcloud cr retention-run --images 20 birds

输出

示 例中的命令返回以下输出：

Retrieving images to delete from namespace 'birds' in registry us.icr.io'...

Found n images to delete.

OK

先决条件

如需了解所需权限的更多信息，请参阅 使用的访问角色 Container Registry。

命令选项

--restrict NAMESPACE

（可选）将输出限制为仅显示指定名称空间中的映像。

--output json, -o json

（可选）包含废纸篓内容详细信息的输出 JSON。

示例

在 birds 命名空间中输入 birds 作为限制条件，显示垃圾中的图片。

ibmcloud cr trash-list --restrict birds

输出

示 例中的命令返回以下输出：

Listing the contents of the trash...

Digest   Days until expiry   Tags
110011   24                  1

OK

示例

了解您正在使用的 Vulnerability Advisor 版本。

ibmcloud cr va-version

输出

示 例中的命令返回以下输出：

You are targeting Vulnerability Advisor version 'v4'.

OK

命令自变量

VERSION

您要使用的 Vulnerability Advisor 版本。 唯一有效的值是 v4。

示例

输入 v4 作为版本，将 Vulnerability Advisor 设置为版本 4：

ibmcloud cr va-version-set v4

输出

示 例中的命令返回以下输出：

You are targeting Vulnerability Advisor version 'v4'.

OK

先决条件

如需了解所需权限的更多信息，请参阅 使用的访问角色 Container Registry。

命令自变量

IMAGE

要获取其报告的映像的名称。 此报告指出该映像是否有任何已知的包漏洞。 可以通过在命令中列出每个映像（各名称之间用一个空格分隔）来同时请求多个映像的报告。

要查找映像的名称，请运行 ibmcloud cr image-list。 将 存储库 列 (repository) 和 标记 列 (tag) 的内容以冒号 (:) 分隔，以创建格式为 repository:tag 的映像名称。 如果未在映像名称中指定标记，那么报告会评估标记为 latest 的映像。

有关受支持的 Docker 基本映像的更多信息，请参阅 易受攻击的软件包。

有关更多信息，请参阅使用 Vulnerability Advisor 管理映像安全性。

命令选项

--extended, -e

（可选）命令输出显示有关有漏洞包的修订的其他信息。

--vulnerabilities, -v

（可选）命令输出限制为仅显示漏洞。

--output FORMAT, -o FORMAT

（可选）命令输出以所选格式返回。 缺省格式为 text。

支持以下格式：

• text
• json

示例

输入 us.icr.io/birds/bluebird:1 作为图像，查看 us.icr.io/birds/bluebird:1 图像的标准漏洞评估报告。

ibmcloud cr vulnerability-assessment us.icr.io/birds/bluebird:1

使用 -- vulnerabilities 选项，输入 json 作为输出格式，输入 us.icr.io/birds/bluebird:1 作为图像，查看以 JSON 格式显示 us.icr.io/birds/bluebird:1 图像的漏洞评估报告。

ibmcloud cr vulnerability-assessment --vulnerabilities --output json us.icr.io/birds/bluebird:1