格式化和过滤 Container Registry CLI 输出

您可以格式化和过滤 IBM Cloud® Container Registry 命令行界面 (CLI) 输出的支持 IBM Cloud Container Registry 命令。

缺省情况下，CLI 输出会以人类可读的格式显示。 但是，此视图可能会限制您使用输出的能力，尤其是在以编程方式运行命令的情况下。 例如，在 ibmcloud cr image-list CLI 输出中，您可能希望按数字顺序对 Size 字段进行排序，但命令返回的是字符串描述。 container-registry CLI 插件提供了 format 选项，可用于将 Go 模板应用于 CLI 输出。 Go 模板是 Go 编程语言的一项功能，可用于定制 CLI 输出。

可以通过两种不同方式应用 format 选项来变更 CLI 输出：

• 在 CLI 输出中格式化数据。 例如，将 Created 字段输出从 UNIX® 时间改为标准时间。
• 过滤 CLI 输出中的数据。 例如，通过使用 Go 模板 if gt 条件，按映像详细信息进行过滤以显示特定映像子集。

可以将 format 选项用于以下 IBM Cloud Container Registry 命令。 单击命令可查看可用字段及其数据类型的列表。

• ibmcloud cr image-digests 指挥
• ibmcloud cr image-list 指挥
• ibmcloud cr image-inspect 指挥

以下代码示例演示了可如何对选项进行格式设置和过滤。

• 运行以下 ibmcloud cr image-digests 命令，显示摘要中引用的所有未标记的图像。

  ibmcloud cr image-digests --format '{{if not .Tags}}{{.Repository}}@{{.Digest}}{{end}}'
  

  下面的信息是该命令的输出示例

  example-<region>.icr.io/user1/my_first_repo@<digest1>
  example-<region>.icr.io/user1/my_first_repo@<digest2>
  example-<region>.icr.io/user1/my_first_repo@<digest3>
  

• 运行以下 ibmcloud cr image-list 命令，显示所有大小超过 1 MB 的标记图像的存储库、标记和安全状态。

  ibmcloud cr image-list --format "{{ if gt .Size 1000000 }}{{ .Repository }}:{{ .Tag }} {{ .SecurityStatus.Status }}{{end}}"
  

  以下消息是命令输出的示例：

  example-<region>.icr.io/user1/my_first_repo:latest No Issues
  example-<region>.icr.io/user1/my_second_repo:1 2 Issues
  example-<region>.icr.io/user1/my_second_repo:test1 1 Issue
  example-<region>.icr.io/user1/my_second_repo_2:test2 7 Issues
  

  如果列表图片超时，请参阅 “为什么列出图片时会出现超时？” 以获取帮助。

• 运行以下 ibmcloud cr image-inspect 命令，显示指定 IBM 公共图像的 IBM 文档托管位置。

  ibmcloud cr image-inspect ibm_public_image --format "{{ .ContainerConfig.Labels }}"
  

  以下消息是命令输出的示例：

  map[doc.url:/docs/images/docker_image_ibm_public_image/ibm_public_image_starter.html]
  

• 运行以下 ibmcloud cr image-inspect 命令，显示指定映像的暴露端口。

  ibmcloud cr image-inspect ibm_public_image --format "{{ .Config.ExposedPorts }}"
  

  以下消息是命令输出的示例：

  map[9080/tcp: 9443/tcp:]