code.gitea.io/gitea@v1.22.3/docs/content/usage/packages/container.zh-cn.md (about)

     1  ---
     2  date: "2021-07-20T00:00:00+00:00"
     3  title: "容器注册表"
     4  slug: "container"
     5  sidebar_position: 30
     6  draft: false
     7  toc: false
     8  menu:
     9    sidebar:
    10      parent: "packages"
    11      name: "容器"
    12      sidebar_position: 30
    13      identifier: "container"
    14  ---
    15  
    16  # 容器注册表
    17  
    18  为您的用户或组织发布符合  [Open Container Initiative(OCI)](https://opencontainers.org/) 规范的镜像。
    19  该容器注册表遵循 OCI 规范，并支持所有兼容的镜像类型，如 [Docker](https://www.docker.com/) 和 [Helm Charts](https://helm.sh/)。
    20  
    21  ## 目录
    22  
    23  要使用容器注册表，您可以使用适用于特定镜像类型的工具。
    24  以下示例使用 `docker` 客户端。
    25  
    26  ## 登录容器注册表
    27  
    28  要推送镜像或者如果镜像位于私有注册表中，您需要进行身份验证：
    29  
    30  ```shell
    31  docker login gitea.example.com
    32  ```
    33  
    34  如果您使用的是 2FA 或 OAuth，请使用[个人访问令牌](development/api-usage.md#通过-api-认证)替代密码进行身份验证。
    35  
    36  ## 镜像命名约定
    37  
    38  镜像必须遵循以下命名约定：
    39  
    40  `{registry}/{owner}/{image}`
    41  
    42  例如，以下是所有者为 `testuser` 的有效镜像名称示例：
    43  
    44  `gitea.example.com/testuser/myimage`
    45  
    46  `gitea.example.com/testuser/my-image`
    47  
    48  `gitea.example.com/testuser/my/image`
    49  
    50  **注意:** 该注册表仅支持大小写不敏感的标签名称。因此，`image:tag` 和 `image:Tag` 将被视为相同的镜像和标签。
    51  
    52  ## 推送镜像
    53  
    54  通过执行以下命令来推送镜像：
    55  
    56  ```shell
    57  docker push gitea.example.com/{owner}/{image}:{tag}
    58  ```
    59  
    60  | 参数    | 描述         |
    61  | ------- | ------------ |
    62  | `owner` | 镜像的所有者 |
    63  | `image` | 镜像的名称   |
    64  | `tag`   | 镜像的标签   |
    65  
    66  例如：
    67  
    68  ```shell
    69  docker push gitea.example.com/testuser/myimage:latest
    70  ```
    71  
    72  ## 拉取镜像
    73  
    74  通过执行以下命令来拉取镜像：
    75  
    76  ```shell
    77  docker pull gitea.example.com/{owner}/{image}:{tag}
    78  ```
    79  
    80  | Parameter | Description  |
    81  | --------- | ------------ |
    82  | `owner`   | 镜像的所有者 |
    83  | `image`   | 镜像的名称   |
    84  | `tag`     | 镜像的标签   |
    85  
    86  例如：
    87  
    88  ```shell
    89  docker pull gitea.example.com/testuser/myimage:latest
    90  ```