forgejo/docs/content/doc/usage/packages/container.zh-cn.md
2023-05-25 03:22:45 +00:00

2.1 KiB
Raw Blame History

date title slug weight draft toc menu
2021-07-20T00:00:00+00:00 容器注册表 container 30 false false
sidebar
parent name weight identifier
packages 容器 30 container

容器注册表

为您的用户或组织发布符合 Open Container Initiative(OCI) 规范的镜像。 该容器注册表遵循 OCI 规范,并支持所有兼容的镜像类型,如 DockerHelm Charts

目录

{{< toc >}}

目录

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

登录容器注册表

要推送镜像或者如果镜像位于私有注册表中,您需要进行身份验证:

docker login gitea.example.com

如果您使用的是 2FA 或 OAuth请使用[个人访问令牌]({{< relref "doc/development/api-usage.zh-cn.md#通过-api-认证" >}})替代密码进行身份验证。

镜像命名约定

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

{registry}/{owner}/{image}

例如,以下是所有者为 testuser 的有效镜像名称示例:

gitea.example.com/testuser/myimage

gitea.example.com/testuser/my-image

gitea.example.com/testuser/my/image

注意: 该注册表仅支持大小写不敏感的标签名称。因此,image:tagimage: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}
Parameter Description
owner 镜像的所有者
image 镜像的名称
tag 镜像的标签

例如:

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