
# 了解注册表
#### 功能简介
注册表是容器镜像服务企业版中用于集中管理容器镜像的核心组件，用于存储、管理和分发容器镜像。您可以上传镜像、下载镜像，并对镜像进行安全扫描等。
#### 操作场景
本节将指导您如何将一个本地容器镜像上传到容器镜像服务企业版中。上传后，您可以在云上环境（如CCE容器集群）中直接使用该镜像创建工作负载。
#### 前提条件
使用注册表前，您需要完成如下工作：
- 已经[购买注册表](https://support.huaweicloud.com/usermanual2-swr/swr_02_0408.html)。
- 已经设置了注册表的访问权限，具体请参见[访问控制概述](https://support.huaweicloud.com/usermanual2-swr/swr_02_0448.html)。
- 已经[创建访问凭证](https://support.huaweicloud.com/usermanual2-swr/swr_02_0422.html)。
 
#### 上传镜像
1. 准备一台计算机，需满足如下要求： 
   - 安装的容器引擎版本必须为18.06及以上版本。
   
   - 这台计算机已在[访问控制](https://support.huaweicloud.com/usermanual2-swr/swr_02_0447.html)中定义的公网或内网允许访问范围内。
   
   
   
   
2. 以root用户登录这台计算机。
3. 使用[访问凭证](https://support.huaweicloud.com/usermanual2-swr/swr_02_0422.html)创建的访问凭证获取的镜像访问凭证登录注册表。
   
   登录成功会显示"Login Succeeded"。
   
   
4. 执行以下命令为镜像打标签。 
   **docker tag** **\[镜像名称1:版本名称1\] \[注册表地址\]/\[命名空间名称\]/\[镜像名称2:版本名称2\]**
   其中：
   - **\[镜像名称1:版本名称1\]**请替换为您所要上传的实际镜像的名称和版本名称。
   
   - **\[注册表地址\]** 为注册表的访问地址，获取方式如下：
     由于容器镜像服务企业版目前处于公测阶段，如果您的租户登录页面后看不到"企业版"链接，请提交[工单](https://console.huaweicloud.com/ticket/?locale=zh-cn#/ticketindex/createIndex)申请入口。申请成功后，登录容器镜像服务企业版控制台，在页面左上角切换Region到您所在的Region，单击注册表名称进入注册表详情页面，在"总览"页面获取访问地址，如[图1]所示。
     图1访问地址   
     ![](https://support.huaweicloud.com/usermanual2-swr/zh-cn_image_0000001868664261.png) 
   
   - **\[命名空间名称\]** 请替换为您在[创建命名空间](https://support.huaweicloud.com/usermanual2-swr/swr_02_0413.html#swr_02_0413__section54551244316)中创建的命名空间。
   
   - **\[镜像名称2:版本名称2\]**请替换为您期待的镜像名称和版本名称。
   
   
   样例如下：
   **docker tag nginx:latest test-01-2v8iom.swr.cn-east-3.myhuaweicloud.com/library/nginx:1** **.1.1**
   
   
5. 上传镜像至注册表。 
   **docker push** **\[注册表地址\]/\[命名空间名称\]/\[镜像名称:版本名称\]**
   样例如下：
   **docker push test-01-2v8iom.swr.cn-east-3.myhuaweicloud.com/library/nginx:1.1.1**
   终端显示如下信息，表明上传镜像成功。
   ```
   fbce26647e70: Pushed 
   fb04ab8effa8: Pushed 
   8f736d52032f: Pushed 
   009f1d338b57: Pushed 
   678bbd796838: Pushed 
   d1279c519351: Pushed 
   f68ef921efae: Pushed 
   v1: digest: sha256:0cdfc7910db531bfa7726de4c19ec556bc9190aad9bd3de93787e8bce3385f8d size: 1780
   ```
   在注册表详情页面"仓库"中可查看到对应的镜像信息。
   ![](https://support.huaweicloud.com/usermanual2-swr/public_sys-resources/note_3.0-zh-cn.png)
   镜像上传以后，您可以在CCE控制台创建工作负载。
   
   
 
#### 查看镜像下载地址
1. 由于容器镜像服务企业版目前处于公测阶段，如果您的租户登录页面后看不到"企业版"链接，请提交[工单](https://console.huaweicloud.com/ticket/?locale=zh-cn#/ticketindex/createIndex)申请入口。申请成功后，登录容器镜像服务企业版控制台，在页面左上角切换Region到您所在的Region，单击注册表名称进入注册表详情页面。
2. 在左侧导航栏选择仓库。
3. 单击仓库名称进入镜像详情。
4. 在对应镜像版本"下载指令"一列可以获取镜像下载指令，如[图2]所示。
   
   图2下载指令   
   ![](https://support.huaweicloud.com/usermanual2-swr/zh-cn_image_0000002660856309.png)
   
   
   
 
#### 注册表其他操作
- 搜索仓库 支持根据命名空间和镜像名称搜索镜像。
  图3搜索镜像
  ![](https://support.huaweicloud.com/usermanual2-swr/zh-cn_image_0000002583488414.png)
  
  
  
  
- 删除仓库 单击镜像所在行的"删除"即可删除镜像。为避免您误删重要数据，删除镜像时需要输入DELETE进行二次确认。
  ![](https://support.huaweicloud.com/usermanual2-swr/public_sys-resources/caution_3.0-zh-cn.png)
  删除镜像会同时删除镜像下的所有版本，请谨慎操作。
  
- 删除镜像版本 单击仓库名称进入镜像详情，在镜像版本所在行单击"删除"即可删除镜像版本。为避免您误删重要数据，删除镜像版本时需要输入DELETE进行二次确认。
  
 
#### 后续操作
镜像上传到注册表后，您还可以对镜像进行一系列的操作，包括：
- 配置镜像签名规则，根据规则自动对镜像签名。具体请参见[镜像签名](https://support.huaweicloud.com/usermanual2-swr/swr_02_0431.html)。
- 配置镜像同步规则，根据规则与目标仓库自动同步镜像。具体请参见[将镜像同步到其他区域](https://support.huaweicloud.com/usermanual2-swr/swr_02_0432.html)。
- 配置镜像老化规则，根据规则自动清理不需要的镜像。具体请参见[镜像老化](https://support.huaweicloud.com/usermanual2-swr/swr_02_0433.html)。
 
