Docker Hub 上的软件制品

Table of contents

您可以使用 Docker Hub 存储任何类型的软件制品，而不仅仅是容器镜像。软件制品是指在软件开发过程中产生的、有助于软件创建、维护或理解的任何项目。Docker Hub 通过利用镜像清单 (image manifest) 中的 config 属性来支持 OCI 制品。

什么是 OCI 制品？

OCI 制品是与软件应用程序相关的任何文件。一些示例包括：

Docker Hub 支持 OCI 制品意味着您可以使用一个仓库来存储和分发容器镜像以及其他资产。

OCI 制品的一个常见用例是 Helm charts。Helm charts 是一种打包格式，用于为应用程序定义 Kubernetes 部署。由于 Kubernetes 是一种流行的容器运行时，因此将应用程序镜像和部署模板都托管在一个地方是合理的。

您管理 Docker Hub 上的 OCI 制品的方式与管理容器镜像的方式类似。

向仓库推送和从仓库拉取 OCI 制品是通过仓库客户端完成的。ORAS CLI 是一个命令行工具，提供了在仓库中管理 OCI 制品的功能。如果您使用 Helm charts，Helm CLI 提供了内置功能，用于向仓库推送和从仓库拉取 chart。

仓库客户端会向 Docker Hub 仓库 API 发起 HTTP 请求。该仓库 API 符合 OCI 分发规范中定义的标准协议。

本节介绍了一些在 Docker Hub 中使用 OCI 制品的示例。

以下过程展示了如何将 Helm chart 作为 OCI 制品推送到 Docker Hub。

先决条件：

步骤：

将 Helm chart 打包成一个 tar 包。

$ helm package demo
Successfully packaged chart and saved it to: /Users/hubuser/demo-0.1.0.tgz

使用您的 Docker 凭证通过 Helm 登录 Docker Hub。
$ helm registry login registry-1.docker.io -u hubuser
将 chart 推送到 Docker Hub 仓库。
$ helm push demo-0.1.0.tgz oci://registry-1.docker.io/docker
这会将 Helm chart tar 包上传到 docker 命名空间下的 demo 仓库中。
转到 Docker Hub 上的仓库页面。页面的 Tags 部分会显示 Helm chart 标签。
选择标签名称以转到该标签的页面。

该页面列出了一些用于处理 Helm charts 的有用命令。

以下过程展示了如何将容器卷作为 OCI 制品推送到 Docker Hub。

先决条件：

步骤：

使用 ORAS CLI 登录 Docker Hub。

$ oras login -u hubuser registry-1.docker.io

将文件推送到 Docker Hub。
$ oras push registry-1.docker.io/docker/demo:0.0.1 \ --artifact-type=application/vnd.docker.volume.v1+tar.gz \ myvolume.txt:text/plain
这会将卷上传到 docker 命名空间下的 demo 仓库中。--artifact-type 标志指定了一种特殊的媒体类型，使 Docker Hub 将该制品识别为容器卷。
转到 Docker Hub 上的仓库页面。该页面上的 Tags 部分会显示卷标签。

以下过程展示了如何将通用 OCI 制品推送到 Docker Hub。

先决条件：

步骤：

使用 ORAS CLI 登录 Docker Hub。

$ oras login -u hubuser registry-1.docker.io

将文件推送到 Docker Hub。

$ oras push registry-1.docker.io/docker/demo:0.0.1 myartifact.txt:text/plain