summaryrefslogtreecommitdiffstats
path: root/docs/content/usage/packages/container.zh-cn.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/content/usage/packages/container.zh-cn.md')
-rw-r--r--docs/content/usage/packages/container.zh-cn.md90
1 files changed, 90 insertions, 0 deletions
diff --git a/docs/content/usage/packages/container.zh-cn.md b/docs/content/usage/packages/container.zh-cn.md
new file mode 100644
index 0000000000..28e4835a3d
--- /dev/null
+++ b/docs/content/usage/packages/container.zh-cn.md
@@ -0,0 +1,90 @@
+---
+date: "2021-07-20T00:00:00+00:00"
+title: "容器注册表"
+slug: "container"
+sidebar_position: 30
+draft: false
+toc: false
+menu:
+ sidebar:
+ parent: "packages"
+ name: "容器"
+ sidebar_position: 30
+ identifier: "container"
+---
+
+# 容器注册表
+
+为您的用户或组织发布符合 [Open Container Initiative(OCI)](https://opencontainers.org/) 规范的镜像。
+该容器注册表遵循 OCI 规范,并支持所有兼容的镜像类型,如 [Docker](https://www.docker.com/) 和 [Helm Charts](https://helm.sh/)。
+
+## 目录
+
+要使用容器注册表,您可以使用适用于特定镜像类型的工具。
+以下示例使用 `docker` 客户端。
+
+## 登录容器注册表
+
+要推送镜像或者如果镜像位于私有注册表中,您需要进行身份验证:
+
+```shell
+docker login gitea.example.com
+```
+
+如果您使用的是 2FA 或 OAuth,请使用[个人访问令牌](development/api-usage.md#通过-api-认证)替代密码进行身份验证。
+
+## 镜像命名约定
+
+镜像必须遵循以下命名约定:
+
+`{registry}/{owner}/{image}`
+
+例如,以下是所有者为 `testuser` 的有效镜像名称示例:
+
+`gitea.example.com/testuser/myimage`
+
+`gitea.example.com/testuser/my-image`
+
+`gitea.example.com/testuser/my/image`
+
+**注意:** 该注册表仅支持大小写不敏感的标签名称。因此,`image:tag` 和 `image:Tag` 将被视为相同的镜像和标签。
+
+## 推送镜像
+
+通过执行以下命令来推送镜像:
+
+```shell
+docker push gitea.example.com/{owner}/{image}:{tag}
+```
+
+| 参数 | 描述 |
+| ------- | ------------ |
+| `owner` | 镜像的所有者 |
+| `image` | 镜像的名称 |
+| `tag` | 镜像的标签 |
+
+例如:
+
+```shell
+docker push gitea.example.com/testuser/myimage:latest
+```
+
+## 拉取镜像
+
+通过执行以下命令来拉取镜像:
+
+```shell
+docker pull gitea.example.com/{owner}/{image}:{tag}
+```
+
+| Parameter | Description |
+| --------- | ------------ |
+| `owner` | 镜像的所有者 |
+| `image` | 镜像的名称 |
+| `tag` | 镜像的标签 |
+
+例如:
+
+```shell
+docker pull gitea.example.com/testuser/myimage:latest
+```