容器注册表

发布符合 开放容器倡议 规范的镜像，供您的用户或组织使用。容器注册表遵循 OCI 规范，并支持所有兼容的镜像，例如 Docker 和 Helm Charts。

需求

要使用容器注册表，您可以使用特定镜像类型的工具。以下示例使用 docker 客户端。

登录到容器注册表

要推送镜像或如果镜像位于私有注册表中，您必须进行身份验证

docker login gitea.example.com

如果您使用的是 2FA 或 OAuth，请使用 个人访问令牌 而不是密码。

镜像命名约定

镜像必须遵循以下命名约定

{registry}/{owner}/{image}

在构建 Docker 镜像时，使用上述命名约定，如下所示

# build an image with tag
docker build -t {registry}/{owner}/{image}:{tag} .
# name an existing image with tag
docker tag {some-existing-image}:{tag} {registry}/{owner}/{image}:{tag}

其中您的注册表是您的 Gitea 实例的域名（例如 gitea.example.com）。例如，以下都是对所有者 testuser 有效的镜像名称

gitea.example.com/testuser/myimage

gitea.example.com/testuser/my-image

gitea.example.com/testuser/my/image

注意

注册表仅支持不区分大小写的标签名称。因此，image:tag 和 image:Tag 被视为相同的镜像和标签。

推送镜像

通过执行以下命令推送镜像

docker push gitea.example.com/{owner}/{image}:{tag}

参数	描述
owner	镜像的所有者。
image	镜像的名称。
tag	镜像的标签。

例如

docker push gitea.example.com/testuser/myimage:latest

拉取镜像

通过执行以下命令拉取镜像

docker pull gitea.example.com/{owner}/{image}:{tag}

参数	描述
owner	镜像的所有者。
image	镜像的名称。
tag	镜像的标签。

例如

docker pull gitea.example.com/testuser/myimage:latest