# 镜像包管理
#### 前提条件
- 已有可正常使用的华为云账号。
- 已有至少一个正常可用的工作空间。
- 请确保您已开通镜像包操作白名单功能。如果有试用需求，请在[DataArts Fabric工作空间管理台](https://console.huaweicloud.com/fabric/)顶部导航栏选择"工单 \> 新建工单"申请权限。
 
#### 上传镜像压缩包到SWR
登录容器镜像服务SWR控制台，在"页面上传"对话框参照上传提示信息，上传镜像压缩包到SWR。如果文件大小超过2GB，请使用客户端上传。具体操作，请参见[页面上传镜像](https://support.huaweicloud.com/usermanual-swr/swr_01_0012.html)。
图1上传镜像   
![](https://support.huaweicloud.com/usermanual-fabric/figure/zh-cn_image_0000002156123161.png)
上传完成后，镜像压缩包如下图所示。
图2镜像上传成功   
![](https://support.huaweicloud.com/usermanual-fabric/figure/zh-cn_image_0000002120813380.png)
 #### 创建镜像包
1. 登录[DataArts Fabric工作空间管理台](https://console.huaweicloud.com/fabric/)，选择已创建的工作空间，单击"进入工作空间"。
2. 在左侧导航栏，选择"运维管理 \> 镜像包管理"，单击右上角的"创建镜像包"。
3. 根据提示输入名称和版本名称，为指定版本选择存储在OBS的镜像包路径，配置完成后，单击"确认"创建镜像包。 界面参数说明请参见[创建镜像包参数说明]。
   图3创建镜像包   
   ![](https://support.huaweicloud.com/usermanual-fabric/figure/zh-cn_image_0000002214749109.png)
    表1创建镜像包参数说明 
   | 参数   | 参数说明                                             |
   |:---|:---|
   | 名称   | 镜像包名称。                                           |
   | 描述   | 根据需求填写该镜像包的描述信息。                                 |
   | 类型   | 镜像包类型，Ray集群场景选择RAY_CLUSTER，Ray服务场景选择RAY_SERVICE。 |
   | 版本名称 | 镜像包可有多个版本，根据当前创建信息填入一个版本名称。                      |
   | 版本描述 | 当前创建版本的描述信息。                                     |
   | 版本类型 | 当前只支持OBS。                                        |
   | 路径   | 当前创建版本所在的OBS路径。                                  |
      
   
 
![](https://support.huaweicloud.com/usermanual-fabric/public_sys-resources/note_3.0-zh-cn.png)
如果新建RAY_CLUSTER或RAY_SERVICE类型的Cap，Cap的名称、版本名称需要和包名严格一致。
例如：OBS路径下包名obs://xxx/ray-cap/files/ray-cluster-2.34.0.tgz，包名为ray-cluster-2.34.0。则名称必须为ray-cluster，版本必须为2.34.0，否则页面会校验不通过。
创建完自定义版本后，则可以在创建Ray集群时看到"我的Ray镜像包"，或在创建Ray服务时看到"我的Ray服务镜像包"。
#### 新增镜像包版本
1. 在"镜像包管理"页面的"操作"列，单击目标镜像包对应的"查看版本列表"。
2. 在"当前镜像包版本列表"页面，单击"新增版本"。
3. 在新增镜像包版本页面，配置相关信息，然后单击"确认"。 界面参数说明请参见[创建镜像包版本参数说明]。
   图4创建镜像包版本   
   ![](https://support.huaweicloud.com/usermanual-fabric/figure/zh-cn_image_0000002214905129.png)
    表2创建镜像包版本参数说明 
   | 参数   | 参数说明                                                  |
   |:---|:---|
   | 版本名称 | 镜像包支持有多个版本，请根据当前创建信息填入一个版本名称。镜像包版本需要和选择的OBS文件的包版本号一致。 |
   | 版本描述 | 当前创建版本的描述信息。                                          |
   | 版本类型 | 当前只支持OBS。                                             |
   | 路径   | 当前创建版本所在的OBS路径。请选择到包含metadata.yaml文件的父级目录。            |
      
   
 
#### 删除镜像包版本
删除镜像包版本后，相关数据将被全部清除，请您谨慎操作。
1. 在"镜像包管理"页面的"操作"列，单击目标镜像包对应的"查看版本列表"。
2. 在"当前镜像包版本列表"页面的"操作"列，单击目标版本对应的"删除"。
3. 在"删除当前镜像包版本"对话框，输入"DELETE"或者单击"一键输入"，然后单击"确认"。
   图5删除镜像包版本   
   ![](https://support.huaweicloud.com/usermanual-fabric/figure/zh-cn_image_0000002121125780.png) 
 
#### 删除镜像包
删除镜像包后无法恢复，相关数据将被全部清除，请您谨慎操作。
1. 在"镜像包管理"页面的"操作"列，单击目标镜像包对应的"删除"。
2. 在"删除当前镜像包"对话框，输入"DELETE"或者单击"一键输入"，然后单击"确认"。
   图6删除当前镜像包   
   ![](https://support.huaweicloud.com/usermanual-fabric/figure/zh-cn_image_0000002156494585.png)