# 创建镜像缓存
通过创建镜像缓存，能够实现从SWR镜像仓库、开源镜像仓库以及其他镜像仓库拉取镜像制作成相应的镜像快照。在创建工作负载过程中，使用预先创建的镜像缓存，可以直接从镜像缓存中获取镜像，从而加速镜像下载，提升负载的启动速度。创建镜像缓存具体流程，请参见[图1 镜像缓存创建流程]。
图1镜像缓存创建流程   
![](https://support.huaweicloud.com/usermanual-cce-autopilot/zh-cn_image_0000002202643901.png "点击放大")
#### 前提条件
- 已有一个CCE Autopilot集群，并且满足以下条件：
  - 该集群版本要求在v1.28.8、v1.31.4及以上。如果您的集群版本不符合该要求，则需要通过集群升级使用该功能，关于集群升级的详细说明请参见[升级概述](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0197.html)。
  
  - 如果镜像需要从SWR镜像中心仓库拉取，则已有集群需要事先配置SWR和OBS终端节点。您可以进入该集群的"概览"页，在"网络信息"模块的"镜像访问"中查看是否配置终端节点。如果集群暂未配置终端节点，请参考[配置访问镜像中心的VPC终端节点](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0461.html)进行配置。
  
  - 如果镜像需要通过公网拉取，则指定的构建集群需要事先配置NAT网关的SNAT规则。您可以进入该集群的"概览"页，在"网络信息"模块的"公网访问"中查看是否配置已SNAT规则。如果集群暂未配置SNAT规则，请参考[从容器访问公网](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0400.html)进行配置。
   
- 如果需要镜像为第三方镜像，则需要您提供私有镜像仓库的地址、用户名和密码，用于创建访问密钥。您可以提前在构建集群中[创建第三方镜像密钥](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0009.html)，也可以在创建镜像缓存时根据页面提示创建相关访问密钥。
 
#### 约束与限制
- 创建的镜像缓存数量不超过50个，且每个镜像缓存最多包含20个容器镜像。创建镜像缓存时采用串行下载的方式，选择的任一镜像下载失败都会导致创建失败。
- 创建镜像缓存后，当前区域中版本在v1.28.8、v1.31.4及以上的CCE Autopilot集群皆可使用。如果您的集群版本不符合该要求，则需要通过集群升级使用该功能。关于集群升级的详细说明请参见[升级概述](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0197.html)。
 
#### 计费说明
| 操作阶段↵ | 计费项     | 计费说明↵                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 相关文档↵                                                                                                                  |
|:---|:---|:---|:---|
| 创建镜像缓存↵ | Pod费用 | 涉及Pod的相关费用。创建镜像缓存时，需要运行一个临时Pod实例用于拉取容器镜像。该Pod实例规格如下：↵ - 实例类型：通用型  - CPU：2Cores↵  - 内存：4GiB↵  - 存储费用（镜像缓存）：与镜像缓存大小一致↵   镜像缓存创建完成后，该Pod实例会自动清理并停止计费。↵ | 关于Pod费用的详细说明，请参见[CCE Autopilot集群计费项](https://support.huaweicloud.com/price-cce-autopilot/cce_03_0006.html#section0)。↵ |
   
#### 操作步骤
1. 登录[CCE控制台](https://console.huaweicloud.com/cce2.0/?#/cce/cluster/list)，在左侧导航栏中选择"镜像缓存"，在右侧页面单击"创建镜像缓存"。
2. 配置镜像缓存基础信息。 
   图2镜像缓存基础信息   
   ![](https://support.huaweicloud.com/usermanual-cce-autopilot/zh-cn_image_0000002502947028.png "点击放大")
   表1镜像缓存基础信息 
   | **参数**    | **示例**                                                                 | **参数说明**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   |:---|:---|:---|
   | 镜像缓存名称      | autopilot-test                                                           | 填写镜像缓存的名称，且不能与已有镜像缓存名称重复。 镜像缓存的名称长度范围为1\~128个字符，可以包含小写英文字母、数字、中划线(-)和点（.），并以小写英文字母或数字为开头和结尾。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   | 构建集群     | ap-test1                                                                 | 选择用于创建临时Pod拉取镜像的CCE Autopilot集群。镜像缓存需要提前将容器镜像拉取至本地，CCE将在指定的构建集群中自动创建一个临时Pod用于拉取容器镜像。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   | 容器镜像      | 镜像名称：选择容器镜像 \> 镜像中心 \>nginx 镜像版本：latest | **"添加"按钮：**当容器镜像不止一个时，可以单击"添加"按钮，添加更多容器镜像信息，添加的镜像信息不可重复。每个镜像缓存最多包含20个容器镜像。 **镜像名称：** - 当您需要使用第三方镜像时，请直接输入镜像地址。  - 当您不需要使用第三方镜像时，请单击"选择容器镜像"。 - 我的镜像：可以选择当前区域的SWR镜像仓库中的镜像。  - 镜像中心：可以选择公共镜像。  - 共享镜像：可以选择SWR镜像仓库中他人共享的镜像。     **镜像版本**：镜像指定完成后，需要选择镜像的版本号。 |
   | 镜像缓存大小    | 20GiB                                                                  | 填写镜像缓存的大小，默认为20GiB。镜像缓存大小支持自定义，范围为20GiB\~400GiB，包含20GiB和400GiB。 缓存的对象为解压后的镜像文件，占用空间与实际镜像压缩率相关，建议镜像缓存大小不低于镜像大小总和的3倍。当镜像缓存大小小于解压后的镜像文件的大小时，可能导致镜像缓存创建失败。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   | 镜像缓存保留时间 | 60天                                                                    | 设置镜像缓存的保留时间，镜像缓存到期后系统会自动删除对应的镜像缓存。镜像缓存到期过后对已使用该镜像缓存创建的工作负载无影响。 - 不限制：默认为永久。  - 自定义：可以自定义保留时间，选择范围为1\~10000天。                                                                                                                                                                                                                                                                                                                                                                                                                            |
   | 镜像访问凭证    | -                                                                        | 表示拉取镜像的凭证，可添加多个，最多不超过20个。参数说明请参见[表2]。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
      
    表2镜像缓存的镜像访问凭证信息 
   | **参数** | **示例**           | **参数说明**                                                                                                                                                                                                                                                                                                                                                                                                                          |
   |:---|:---|:---|
   | 命名空间     | default         | 选择已有命名空间或单击"创建命名空间"按钮，创建新的命名空间。如果需要创建新的命名空间，具体参数说明请参见[创建命名空间](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0278.html)。 指定命名空间后，"密钥名称"仅支持使用该命名空间下的密钥。                                                                                                                                                                                                                            |
   | 密钥名称      | default-secret | - 如果使用SWR镜像，可直接选择default-secret。  - 如果使用公开镜像，不需要选择密钥。  - 如果使用第三方镜像，请选择私有仓库对应镜像。如果没有，请单击"创建密钥"，密钥类型仅支持kubernetes.io/dockerconfigjson，具体参数说明请参见[使用第三方镜像](https://support.huaweicloud.com/usermanual-cce-autopilot/cce_11_0009.html)。   |
      
   
   
3. 确认镜像缓存配置信息无误后，单击"创建"。 
   当镜像缓存列表中，对应镜像缓存状态变为"可用"，则说明镜像缓存创建成功。创建完成后，集群需要一定时间同步镜像缓存的信息以便您进一步使用镜像缓存，不同集群的同步时间可能有所差异，请耐心等候。
   
   
 
