blob: 28e4835a3d451bff9be6a9a2ce9377cb9607b494 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
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
```
|
