对存储量和拉出流量计费

根据选择的服务套餐，会根据每个区域每月使用的存储量和拉出流量向您收费。

存储和拉取流量的配额限制

根据选择的服务套餐，您可以向名称空间推送映像并从名称空间中拉出映像，直到超过每个区域特定于套餐的配额限制或定制配额限制为止。

费用 Container Registry

您可以在产品详细信息页面的定价计划部分查看 IBM Cloud Container Registry 的成本，请参见 Container Registry.

容器映像

在容器运行时内用于创建容器的文件系统及其执行参数。 文件系统由一系列层组成，这些层在运行时组合在一起，随着容器映像的连续更新而创建。 容器映像不会在容器运行时保留其状态。

容器镜像存储在命名空间中的存储库中。

摘要

摘要可用作注册表中各种对象（如图像清单、图层和配置项）的不可变引用。

在注册表中，图像摘要是对图像的不可变引用，通过使用图像 清单 的 sha256 哈希值来识别图像。 您可以使用图像摘要来确保您始终引用相同版本的图像。 使用图像文摘的长格式处理图像，如拉取、推送和删除图像。

要查找图像摘要，请运行 ibmcloud cr image-digests 命令。 该 ibmcloud cr image-list 命令也会返回图像摘要，但默认情况下是截断格式。 您可以在 ibmcloud cr image-list 命令中添加一个选项，以返回长格式的图像摘要。

使用图像摘要识别图像时，请始终使用长格式。

在 Container Registry 中，任何提及“摘要”的地方都是指“图像摘要”。

Dockerfile

Dockerfile 是一个文本文件，其中包含关于构建 Docker 映像的指示信息。

通常，容器镜像建立在包含基本操作系统（如 Ubuntu ）的基本镜像之上。 您可以利用 Dockerfile 指示信息以递增方式更改基本映像，以便定义出应用程序运行所需的环境。 对基本映像的每个更改都描述了该映像的一个新层，您可以在 Dockerfile 的一行中进行多个更改。 Dockerfile 中的指令还可能引用单独存储的构建工件，如应用程序、应用程序的配置及其依赖项。 有关 Dockerfile 的更多信息，请参阅 Dockerfile 参考资料。

Docker V2 容器图像

符合 Image Manifest Version 2, Schema 2 规范的容器映像。

Docker Image Manifest V2，Schema 2 的介质类型为 application/vnd.docker.distribution.manifest.v2+json，清单列表的介质类型为 application/vnd.docker.distribution.manifest.list.v2+json。 Docker V2 容器映像是一种 OCI 容器映像。 有关 Docker 支持的更多信息，请参阅 Docker。

域名

主机系统的名称。 域名由一系列子名称组成，子名称之间用分隔符分隔，例如 www.ibm.com.

Container Registry 使用的域名格式为 us.icr.io。 Container Registry 早期使用的域名格式为 registry.ng.bluemix.net. 这两种格式的域名指向相同的注册机构和内容。 Container Registry 服务对早期域名和规范域名的响应相同。 您可以交替使用其中一个域名来推送或拉动图像。

域名只有在以下情况下才有意义：

• Kubernetes 在选择拉取密码时，会选择与域名匹配的密码。
• 当 ibmcloud cr login 帮助您登录时，只使用 us.icr.io 格式的域名。
• 图像签名时，签名包括签名时使用的域名。

有关 Container Registry 使用的域名的更多信息，请参阅 地区。

映像清单

映像清单是 .json 文档，其中引用了配置对象和映像层，这些都是提取和运行映像所必需的。 sha256 图像清单的哈希值就是 摘要，用于识别图像。 运行 ibmcloud cr manifest-inspect 命令来查看图像清单。

OCI 容器映像

符合 OCI 映像格式规范的容器映像。

OCI 容器映像的介质类型为 application/vnd.oci.image.manifest.v1+json。

注册表

公用或专用容器映像存储和分发服务。

为 OCI 容器映像符合 OCI 映像格式规范的容器映像 （也称为 Docker 容器映像）提供存储空间。 使用相应注册域名的 OCI 客户端可以访问或“提取”OCI 容器映像。 任何人都可以访问容器映像（公共映像），也可以仅限于某个群体访问（私有映像）。Container Registry 提供一个多租户、高可用性的私有映像注册表，由 IBM 托管和管理。 要使用注册表，您可以添加您的帐户专用的名称空间，然后将映像推送到该名称空间中。

注册表名称空间

文件夹，其中包含在 Container Registry 中存储容器映像的文件夹或存储库。 注册表命名空间与您的 IBM Cloud 账户相关联。 一个账户中可以有多个注册表命名空间。

在 Container Registry 中设置自己的命名空间时，命名空间会附加到注册表 URL <region>.icr.io/<my_namespace> 中，其中 <region> 是区域，<my_namespace> 是自己的命名空间。 名称空间在同一区域的所有 IBM Cloud 帐户中必须唯一。 IBM Cloud 账户中拥有正确 IAM 权限的每个用户都可以查看和处理存储在注册表命名空间中的图像。

每个区域可以有 100 个命名空间。

命名空间在您指定的 资源组中 创建，这样您就可以在资源组级别配置对命名空间内资源的访问。 如果未指定资源组，也没有目标资源组，则使用默认资源组。 如果有一个不在资源组中的旧命名空间，可以将其分配给一个资源组，然后在资源组级别为该命名空间设置权限。 有关资源组的更多信息，请参阅 将现有命名空间分配给资源组。

分配给资源组的名称空间显示在 IBM Cloud 控制台的 资源列表 页面中。

存储库

存储相关容器图像的集合。 资源库存储在命名空间中。 容器图像仅通过标签或摘要进行区分。 资源库一词经常与容器镜像互换使用，但一个资源库有可能保存容器镜像的多个标记变体。

标记

附加到资源库中容器映像的标识符。 标签可以从图像中重新分配或删除。

您可以使用 标签附加到帐户中包含的资源分组的用户定义的标识。 标记在帐户范围内可视。来区分版本库中同一基础镜像的不同版本。 运行 Docker 命令时，如果没有指定版本库图像的标记，则默认使用标记为 latest 的图像。

无标记图片

没有标记的图像是无标记图像。 可以使用摘要参考格式 <repository>@<digest> 而不是标签参考格式 <repository>:<tag> 来引用无标签的图像。 无标记图像通常是使用预先存在的 <repository>:<tag> 组合推送图像的结果。 在这种情况下，标签将被覆盖，原始图像将变成无标签图像。

命令查看未标记的图像，使用 ibmcloud cr image-digests 命令查看未标记的图像，使用 ibmcloud cr image-prune-untagged 命令清理未标记的图像。

全局注册表

全局注册表可用。 全球注册表的名称中不包括地区 (icr.io)。除了托管用户命名空间和图像外，该注册表还托管由 IBM 提供的公共图像。

Container Registry 的全局实例可使用下表所示的 域名。

要了解如何使用专用域名连接 Container Registry，请参阅 使用专用网络连接。

现有的 bluemix.net 域名已被弃用，但目前仍可继续使用。 支持结束日期尚未确定。

本地区域

Container Registry 的区域实例可使用下表所示的 域名。

要了解如何使用专用域名连接 Container Registry，请参阅 使用专用网络连接。

现有的 bluemix.net 域名已被弃用，但目前仍可继续使用。 支持结束日期尚未确定。

对 Docker 的支持

IBM Cloud Container Registry 支持 所支持的 版本。Docker Docker Engine

Docker 只有在要推拉图像时才需要使用。

支持 Docker V2 Schema 2 映像。 还支持清单列表。 更多信息，请参阅 注册表兼容性。

Docker V2 模式 1 图像已停用，不能再将其推送到 Container Registry。

为其他客户提供支持

IBM Cloud Container Registry 支持符合 OCI Distribution 规范第 1 版或更高版本的客户端支持版本，如，，和。Buildah Podman Skopeo