本文主要介绍相关术语解释 镜像（Image） 容器镜像是一个模板，是容器应用打包的标准格式，在部署容器化应用时可以指定镜像，镜像可以来自于镜像中心或者用户的私有Registry。例如一个容器镜像可以包含一个完整的Ubuntu操作系统环境，里面仅安装了用户需要的应用程序及其依赖文件。容器镜像用于创建容器。容器引擎本身提供了一个简单的机制来创建新的镜像或者更新已有镜像，您也可以下载其他人已经创建好的镜像来使用。 容器（Container） 一个通过容器镜像创建的运行实例，一个节点可运行多个容器。容器的实质是进程，但与直接在宿主执行的进程不同，容器进程运行于属于自己的独立的命名空间。 镜像（Image）和容器（Container）的关系，就像是面向对象程序设计中的类和实例一样，镜像是静态的定义，容器是镜像运行时的实体。容器可以被创建、启动、停止、删除、暂停等。 组织 组织用于隔离镜像仓库，每个组织可对应一个公司或部门，将其拥有的镜像集中在该组织下。同一用户可属于不同的组织。支持为帐号下不同用户分配相应的访问权限（读取、编辑、管理）。

本节介绍了有关镜像选择的问题。 在创建弹性云主机或物理机实例时，必须选择一个镜像，如何在众多镜像类型和操作系统中选择合适的镜像，取决于以下因素： 区域和可用区 镜像类型 操作系统 区域和可用区 镜像是一种区域性资源，您不能跨区域使用镜像创建实例。例如，在区域A创建实例时，您只能选择位于区域A的镜像。更多区域，请参见区域和可用区。 镜像类型 根据镜像来源不同，分为公共镜像、私有镜像和共享镜像。其中，私有镜像又分为系统盘镜像、数据盘镜像和整机镜像。详情请参见产品定义。 操作系统 选择操作系统时，您可能需要考虑以下方面： 选择架构类型 系统架构 适用内存 使用限制 ::: 32位 适用于4 GB以下内存 实例规格内存大于4 GB时，无法使用32位操作系统。 32位操作系统只能4 GB内寻址，超过4 GB的内存操作系统无法访问。 64位 适用于4 GB及以上内存 如果您的应用需要4 GB以上内存或者未来需要扩充到4 GB以上，请使用64位操作系统。 选择操作系统类型 操作系统类型 适用场景 使用限制 ::: Windows 适合运行Windows下开发的程序，如.NET等。 支持SQL Server等数据库（需要自行安装）。 系统盘要求40 GB及以上、内存1 GB及以上。 Linux 适合运行高性能Web等服务器应用，支持常见的PHP、Python等编程语言。 支持MySQL等数据库（需要自行安装）。 系统盘要求40 GB及以上、内存512 MB及以上。

使用镜像创建应用 步骤参考 1.在群管理页面的左侧导航栏中，选择“工作负载”。 2.点击“无状态”，在无状态页面中，单击左上角的“创建Deployment”。 3.进入新建Deployment页面，设置应用的基本信息。 配置项 描述 负载类型 工作负载的类型，切换负载类型会导致已填写的部分关联数据被清空，请谨慎切换 负载名称 工作负载的名称 命名空间 工作负载所在的命名空间 实例数量 工作负载的副本数 实例内容器 工作负载中的容器实例配置，可配置一个或多个 容器名称 填写容器的名称 更新策略 支持IfNotPresent、Always、Never 镜像及镜像版本 支持在容器镜像服务或开源镜像中选择镜像以及镜像版本 CPU/内存配额限制 Limit用于设置容器使用资源的最大上限，避免异常情况下节点资源消耗过多 初始化容器 初始化容器用于业务容器启动前安装特定工具或脚本 启动命令（选填） ● 运行命令：对应镜像的ENTRYPOINT命令，将会覆盖镜像的ENTRYPOINT命令；每个输入框仅输入一个命令或参数启动执行 ● 运行参数：对应镜像的CMD命令，将会覆盖镜像的CMD命令；每个输入框仅输入一个命令或参数 启动后处理（选填） ● 命令行脚本：容器启动后执行，注意由于是异步执行，无法保证一定在ENTRYPOINT之后运行；每个输入框仅输入一个命令或参数 ● HTTP请求：输入路径、端口、主机地址 停止前处理（选填） ● 命令行脚本：容器停止前执行，常用于资源清理。每个输入框仅输入一个命令或参数 ● HTTP请求：输入路径、端口、主机地址 容器健康检查（选填） ● 存活检查：检查容器是否正常，不正常则重启实例 ● 就绪检查：检查容器是否就绪，不就绪则停止转发流量到当前实例 ● 启动探针：检查容器内应用是否已经启动 环境变量（选填） 支持配置容器的环境变量 数据存储（选填） 支持挂载数据卷到容器内的指定路径，支持EmptyDir、Config Map、Secret 服务配置（选填） 配置Service访问负载 高级配置（选填） 需配置升级策略、负载标签、负载注解、Pod标签、Pod注解、DNS配置、Pod安全设置等信息 4. 信息填写完成后，点击“提交”。

前提条件 当前资源池具备对象存储能力。 使用限制 1. 目前支持squashfs、qcow2格式的镜像文件的上传。 2. 将已准备好的镜像文件、镜像分区文件和对应MD5文件上传至对象存储桶。具体可参考“制作私有镜像”。 3. 为确保过程顺利，镜像名称、对象存储桶名、路径名称中请不要使用中文、空格以及特殊字符。 4. 导入相关镜像文件时，请确认文件对云平台可读： 如果您的资源池支持自动授权，请直接授权云平台访问文件。 否则，请手动将文件权限设置为公共读。 流程概览 通过镜像文件创建系统盘镜像是指用户可以从本地或其他云平台将准备好的镜像文件导入天翼云，导入后可以用此镜像创建物理机或者对物理机进行重装。 通过镜像文件创建系统盘镜像包括3个步骤： 1. 准备符合要求的镜像文件，请参考“制作私有镜像”。 2. 上传镜像文件至对象存储桶，请参考下文“上传镜像文件”。 3. 将上传的镜像文件注册为私有镜像，请参考下文“注册镜像”。 上传镜像文件 镜像文件准备好后，需要将镜像文件上传至对象存储桶中。上传镜像文件的操作请参考上传文件。 注册镜像 镜像文件上传至对象存储桶后，需要将其注册为云平台可用的私有镜像，以下为详细操作步骤。 操作步骤 1. 登录天翼云控制中心。 2. 单击控制中心顶部的选择区域。 3. 在左侧导航栏选择“计算 > 镜像服务”。 4. 在“镜像”列表页面，单击右上角“创建私有镜像”，进入创建私有镜像页面。 5. 在创建私有镜像页面，镜像类型选择“系统盘镜像”，镜像源选择“物理机镜像文件”。 6. 选择镜像文件。 7. 选择镜像分区文件。 8. 选择MD5文件。 注意 确保镜像文件、镜像分区文件和MD5文件的匹配关系一致。 9. 选择操作系统以及对应的版本，此处的系统和版本用于匹配使用私有镜像去创建物理机或者重装系统。 注意 制作Windows私有镜像需要选择Windows操作系统以及版本，制作Linux私有镜像需要选择Linux操作系统以及版本，否则将会导致镜像制作失败。 10. 选择分区设置。 11. 选择企业项目，企业项目为必填项，一个私有镜像必须属于一个企业项目。 12. 填写镜像名称（长度232位，只能由数字、字母、、和.组成，不能以数字、、和.开头、且不能以结尾）。 13. 在高级配置中，设置标签和描述（可选）。 14. 单击“下一步”。 15. 确认镜像参数，勾选“我已阅读并同意相关协议”，并单击“确认下单”按钮。 根据镜像大小的不同，创建时间不同，等待一段时间后即可在私有镜像列表看到创建出的私有镜像。

后续步骤 镜像导出成功后，您可以在对象存储服务控制台，或者客户端的指定OBS桶中下载镜像文件。

本文主要介绍流量镜像使用流程。 使用流量镜像功能，您需要创建镜像会话，通过在镜像会话中关联筛选条件、镜像源和镜像目的，实现指定流量的镜像，使用流程如下图所示。 步骤 说明 设置镜像会话基本信息 设置镜像会话的名称，优先级等参数，开始创建镜像会话。 关联筛选条件 选择网络流量的筛选条件，关联至镜像会话。一个镜像会话可以关联一个筛选条件，如果没有合适的筛选条件，您可以创建筛选条件。 关联镜像源 选择弹性网卡作为镜像源，关联至镜像会话。 一个镜像会话可关联多个镜像源。 关联镜像目的 选择云服务器网卡或者弹性负载均衡ELB实例作为镜像目的，关联至镜像会话。 创建完成 镜像会话创建完成并开启后，对于镜像源符合筛选条件的网络流量，将被镜像到镜像目的实例。如果您在创建镜像会话期间关闭了镜像会话，则无法监控镜像源的网络流量。

本节介绍了容器镜像加签验签的用户指南。 概述 镜像签名功能保障镜像来源安全可靠，避免中间人攻击和非法镜像的更新与运行。CRS支持为命名空间的镜像自动加签，每次推送容器镜像后都会匹配加签规则自动加签，保障您的容器镜像内容可信。 镜像签名步骤 为命名空间下的镜像设置自动加签的步骤如下： 1. 登录容器镜像服务控制台。 2. 在顶部菜单栏，选择所需资源池。 3. 在实例页面中选择容器镜像仓库实例。 4. 在企业版实例管理页面的左侧菜单上选择"安全可信" "镜像签名"，点击左上角的创建镜像加签规则按钮。 5. 在弹出的对话框，填写镜像加签规则的，然后点击“确定”按钮，完成创建，界面各项参数说明如下表； 参数 是否必选 说明 命名空间 必选 选择需要自动加签的命名空间名称 使用默认私钥 非必选 加签时是否使用默认的私钥，勾选则表明使用默认私钥加签，若不勾选则表明使用自定义私钥，则需要往下录入自定义私钥的信息 私钥 非必选 如果上述"使用默认私钥"不勾选，则必须在此框填入自定义私钥的信息，可以将私钥直接贴入，或者从"文件导入"，私钥目前只支持长度位数是2048，格式为PKC8的RSA密钥 密码 非必选 如果创建RSA密钥对时有添加密码，则需要再此处填上，否则会影响加签执行 6. 创建完毕的规则会展示在镜像签名的列表中，可对签名规则进行编辑，如更换签名密钥等。 注意 1. 镜像加签不会影响镜像的常规使用，更不会影响镜像中原有的能力及业务功能。 2. 单个命名空间只能创建一个加签规则。 3. 如果是使用自定密钥，密钥对需要自行保存维护好，使用跟密钥对应的公钥方可验签成功。

本节为您介绍镜像服务常见的操作系统类问题。 目前支持哪些操作系统？ 公共镜像支持的操作系统包括Windows、Ubuntu、Centos、Anolis、openEuler、CTyunOS、Debian、KylinOS、UniontechOS、Fedora CoreOS。具体支持的版本和支持的云主机类型参考公共镜像概述。私有镜像用户可以自己导入，天翼云没有限制导入镜像的操作系统，但是私有镜像是否可用需要用户自行保证。 如何选择操作系统？ Windows 适用于Windows环境下的开发平台或运营业务。 系统盘要求40GB及以上、内存1GB及以上。 可以安装IIS、SQL Server等。 Linux 适用于Linux环境下的开发平台或运营业务。当前提供CentOS（推荐）和Ubuntu等类型操作系统。 系统盘要求40GB及以上、内存512MB及以上。 4G以上内存操作系统选择 如果使用4GB及以上内存，请选择64位的操作系统（32位操作系统只能4GB内寻址，超过4GB的内存操作系统无法访问）。 如何查看Windows 操作系统云主机虚拟化类型？ 您可以通过以下步骤查看当前云主机的虚拟化类型： 1. 打开命令提示符（CMD）窗口。您可以通过按下Win+R键，然后输入 "cmd" 并按 Enter 来打开命令提示符窗口。 2. 在命令提示符窗口中，输入以下命令并按 Enter 键： systeminfo 3. 命令执行后，您会看到一些系统信息的输出。在输出中寻找 "System Manufacturer" 和 "BIOS 版本" 这两行信息。 4. 如果 "System Manufacturer" 和 "BIOS 版本" 显示为 "KVM"，则说明当前云主机使用 KVM虚拟化类型。

本节介绍了免密拉取镜像的用户指南。 概述 安装免密拉取插件cubecredentialhelper，可以使云容器引擎集群免密拉取容器镜像服务企业版和个人版的私有镜像，简化工作负载的发布流程。 安装步骤 1. 登录云容器引擎控制台。 2. 左侧导航栏点击"集群"。 3. 在集群管理页面点击已有集群名称进入集群信息页面。 4. 左侧导航栏点击"插件" "插件市场"，在页面中找到cubecredentialhelper插件并安装。 使用步骤 前置条件 已创建容器镜像服务实例。 配置参数 namespaces和serviceAccounts参数指定插件生效的命名空间和serviceAccount。 plaintext 使免密拉取插件作用于集群指定的Namespace 默认值为"default"。当取值为""时，表示期望所有Namespace均能免密拉取。如需配置多个Namespace时，以英文半角逗号（,）分隔。 namespaces: "default" 使免密拉取插件作用于集群指定的ServiceAccount 默认值为"default"。当取值为""时， 表示支持指定命名空间下的所有ServiceAccount。如需配置多个ServiceAccount时,以英文半角逗号（,）分隔。 serviceAccounts: "default" credentials参数指定镜像拉取凭证，注意需要填写实际的CRS实例的内网地址、用户名和密码，否则免密拉取插件不生效。 plaintext 镜像拉取凭证，支持配置多个。需要将以下样例中的CRS实例的内网地址、用户名和密码替换为实际值。 credentials: registry: "registryhuadong1.crsinternal.ctyun.cn" CRS实例的内网地址 username: "username" CRS实例的用户名 password: "password" CRS实例的密码

本文介绍CDN镜像源的使用场景和使用说明。 功能介绍 为缓解客户源站压力，降低源站宕机的风险，部分客户有CDN镜像源的需求，即期望CDN回源时优先回镜像源，当请求的文件在镜像源没有找到时，镜像源能触发回客户源站拉取文件，存储文件的同时响应给CDN，从而在CDN与客户源站之间通过镜像源进行隔离，让镜像源承担主要的回源压力，同时实现同一个文件只回客户源一次。天翼云通过结合媒体存储和CDN加速灵活的回源配置能力，可以帮助客户获得镜像源的能力。 相关业务流程如下图： 前提条件 在已经开通并使用CDN加速服务的基础上，需要开通媒体存储，详情请见：开通天翼云媒体存储。 1. 创建存储区域：目前不支持客户自助创建，需要您通过提交工单联系天翼云客服或客户经理，由其人工通过线下渠道为您创建存储区域。因媒体存储仅部分资源池支持镜像回源功能，申请时请详细说明。具体可参考：资源池与区域节点。 2. 创建媒体存储的存储桶，详情请见：新建Bucket。创建完成后，可以在基础信息查看，找到 Bucket域名（即回源域名）。

公共镜像特点 操作系统类型：包含基于Linux或者Windows的系统，并定期更新维护。 软件支持：集成了一些服务器的网络以及用户基本功能正常使用所依赖的相关插件。 CloudInit或CloudbaseInit工具 Cloudinit或CloudbaseInit工具是云平台中linux/Windows镜像里对新开的虚拟机进行初始化的工具，包括初始化主机名，网络配置，重置密码等功能。Linux系统公共镜像默认已安装CloudInit；Windows系统公共镜像默认已安装CloudbaseInit。 重置密码插件 公共镜像创建的弹性云主机均支持一键式重置密码功能，当操作系统密码丢失或过期时，如果您的云主机提前安装了密码重置插件，可以在控制台页面设置新密码。公共镜像默认已安装该插件。 安全性：公共镜像具有高度稳定性，请放心使用。

本节介绍了免密拉取镜像的用户指南。 概述 安装免密拉取插件cubecredentialhelper，可以使云容器引擎集群免密拉取容器镜像服务企业版和个人版的私有镜像，简化工作负载的发布流程。 安装步骤 1. 登录云容器引擎控制台。 2. 左侧导航栏点击"集群"。 3. 在集群管理页面点击已有集群名称进入集群信息页面。 4. 左侧导航栏点击"插件" "插件市场"，在页面中找到cubecredentialhelper插件并安装。 使用步骤 前置条件 已创建容器镜像服务实例。 配置参数 namespaces和serviceAccounts参数指定插件生效的命名空间和serviceAccount。 plaintext 使免密拉取插件作用于集群指定的Namespace 默认值为"default"。当取值为""时，表示期望所有Namespace均能免密拉取。如需配置多个Namespace时，以英文半角逗号（,）分隔。 namespaces: "default" 使免密拉取插件作用于集群指定的ServiceAccount 默认值为"default"。当取值为""时， 表示支持指定命名空间下的所有ServiceAccount。如需配置多个ServiceAccount时,以英文半角逗号（,）分隔。 serviceAccounts: "default" credentials参数指定镜像拉取凭证，注意需要填写实际的CRS实例的内网地址、用户名和密码，否则免密拉取插件不生效。 plaintext 镜像拉取凭证，支持配置多个。需要将以下样例中的CRS实例的内网地址、用户名和密码替换为实际值。 credentials: registry: "registryhuadong1.crsinternal.ctyun.cn" CRS实例的内网地址 username: "username" CRS实例的用户名 password: "password" CRS实例的密码

天翼云容器镜像服务协议，详情请参见这里。

本文主要介绍最佳实践 天翼云容器镜像服务最佳实践.pdf

镜像队列 Rabbitmq支持镜像队列，队列的多个副本保存在不同实例节点。队列分为主备角色，对某个Queue来说，只有master对外提供服务，而其他slave只提供备份服务，在master所在节点不可用时，选出一个slave作为新的master继续对外提供服务。无论客户端的请求打到master还是slave最终数据都是从master节点获取。 当请求打到master节点时，master节点直接将消息返回给client，同时master节点会通过 GM（Guaranteed Multicast）协议将Queue的最新状态广播到slave节点。GM保证了广播消息的原子性，即要么都更新要么都不更新。 当请求打到slave节点时，slave节点需要将请求先重定向到master节点，master节点将将消息返回给client，同时master节点会通过GM协议将queue的最新状态广播到slave节点。

$%^&+｜{}[]:;'<>,.?/且不能以斜线号 / 开头； 不能包含3个及以上连续字符； Linux镜像不能包含镜像用户名（root）、用户名的倒序（toor）、用户名大小写变化（如RoOt、rOot等）； Windows镜像不能包含镜像用户名（Administrator）、用户名大小写变化（adminiSTrator等） 1qaz@WSX monitorService 否 Boolean 监控参数，支持通过该参数指定云主机在创建后是否开启详细监控，取值范围： false（不开启）， true（开启） 若指定该参数为true或不指定该参数，云主机内默认开启最新详细监控服务。 若指定该参数为false，默认公共镜像不开启最新监控服务；私有镜像使用镜像中保留的监控服务。 说明：仅部分资源池支持monitorService参数，详细请参考监控Agent概览。 true orderCount 否 Integer 购买数量，取值范围：[1, 50]。注：不填则默认为1 1 表 dataDiskList 参数 是否必填 参数类型 说明 示例 下级对象 diskMode 否 String 云硬盘属性，取值范围： FCSAN（光纤通道协议的SAN网络）， ISCSI（小型计算机系统接口）， VBD（虚拟块存储设备） 您可以查看磁盘模式及使用方法 注：默认为VBD VBD diskName 否 String 云硬盘名称，仅允许英文字母、数字及或者，长度为263字符，不能以特殊字符开头。 注：该参数在非多可用区类型资源池下无效 ebs.name diskType 是 String 云硬盘类型，取值范围： SATA（普通IO）， SAS（高IO）， SSD（超高IO）， SSDgenric（通用型SSD）， FASTSSD（极速型SSD） 您可以查看磁盘类型及性能介绍磁盘类型相关信息 SATA diskSize 是 Integer 磁盘容量，单位为GB，取值范围：[10, 32768] 20 decTypeID 否 String 专属云存储ID 32af90b5664c41c4bc590f88b39eebc2 表 networkCards 参数 是否必填 参数类型 说明 示例 下级对象 nicName 否 String 长度2~32，支持拉丁字母、中文、数字、下划线、连字符，中文或英文字母开头，不能以http:或https:开头 net.name fixedIP 否 String 内网IPv4地址，注：不可使用已占用IP 192.168.3.20 isMaster 是 Boolean 是否主网卡，取值范围： true（表示主网卡）， false（表示扩展网卡） 注：只能含有一个主网卡 true subnetID 是 String 子网ID，您可以查看基本概念来查找子网的相关定义 获取： 查 查询子网列表 创 创建子网 注：在多可用区类型资源池下，subnetID通常以“subnet”开头，非多可用区类型资源池subnetID为uuid格式 a90eebf0d7985017b9f09468bb2301c2

本章节介绍如何通过镜像部署微服务应用到容器 概述 在微服务云应用平台中接入您的应用进行发布，所支持的介质类型大体上可分为制品（JAR/WAR/TAR包等）、镜像等，您可以按实际需求选择接入的方式。 本文介绍如何通过镜像部署微服务应用到容器。 通过镜像部署微服务应用到容器 前提条件 1. 您已开通微服务云应用平台 2. 您已订购一个云容器引擎实例 3. 您已订购一个nacos注册中心实例 创建环境和导入资源 在左侧导航栏，选择环境管理。在环境列表左上角点击创建环境。环境创建好后，将云容器引擎和nacos注册中心导入到环境中。 创建项目和应用 在左侧导航栏，选择应用列表。在应用列表点击新增项目。展开新增完成的项目，在应用管理下创建应用，技术栈选择 SpringCloud。 项目关联环境 展开项目，在环境管理下将步骤1创建的环境关联上。 创建容器应用实例并部署 基本信息 项目/应用：步骤2创建的应用 应用实例名称：无需修改，使用默认名称即可 技术栈版本：选择1.0.0j180jar 接入方式：选择镜像 应用实例版本：无需修改，使用默认版本即可 企业项目：选择default 部署配置 选择集群：选择步骤1导入到环境中的云容器引擎 镜像类型：选择Demo镜像（支持自购镜像仓库、Demo镜像和MSAP仓库镜像） 选择镜像：选择springcloudprovidernacos.jar镜像使用1.0.0版本 完成以上信息填写后，点击下一步进入到预览页面，确认信息无误后，点击创建按钮，完成应用实例创建。 应用实例创建完成后，直接点击查看实例详情按钮，到实例详情页面。点击上方发布应用实例按钮，进入到应用发布界面。点击右下角发布按钮，进入到发布单详情界面。等待发布单完成初始化后再点击发布按钮进行应用发布。应用开始发布后，可点击应用实例发布单，查看应用发布具体信息。

本节为创建私有镜像的方法导航页。 私有镜像是包含操作系统、预装的公共应用以及用户私有应用的镜像，仅用户个人可见。私有镜像包括系统盘镜像、数据盘镜像和整机镜像，由现有运行的云主机创建而来，或由外部导入而来。 本章介绍以下创建私有镜像的方法： 通过云主机创建Linux系统盘镜像 通过外部镜像文件创建Windows系统盘镜像 通过外部镜像文件创建Linux系统盘镜像 创建物理机系统盘镜像 通过数据盘创建数据镜像 通过外部镜像文件创建数据盘镜像 通过云主机创建整机镜像 通过云主机备份创建整机镜像 通过云服务备份创建整机镜像 通过ISO文件创建Windows系统盘镜像 通过ISO文件创建Linux系统盘镜像 快速导入镜像文件

$%^&+｜{}[]:;'<>,.?/且不能以斜线号 / 开头 不能包含3个及以上连续字符； Linux镜像不能包含镜像用户名（root）、用户名的倒序（toor）、用户名大小写变化（如RoOt、rOot等） Windows镜像不能包含镜像用户名（Administrator）、用户名大小写变化（adminiSTrator等） 1qaz@WSX monitorService 否 Boolean 监控参数，支持通过该参数指定云主机在创建后是否开启详细监控，取值范围： false：不开启， true：开启 若指定该参数为true或不指定该参数，云主机内默认开启最新详细监控服务 若指定该参数为false，默认公共镜像不开启最新监控服务；私有镜像使用镜像中保留的监控服务 说明：仅部分资源池支持monitorService参数，详细请参考监控Agent概览 true 表 dataDiskList 参数 是否必填 参数类型 说明 示例 下级对象 diskMode 否 String 云硬盘属性，取值范围： FCSAN：光纤通道协议的SAN网络， ISCSI：小型计算机系统接口， VBD：虚拟块存储设备 您可以查看磁盘模式及使用方法 注：默认为VBD VBD diskName 否 String 云硬盘名称，长度限制2~63字符，不支持中文 ebs.name diskType 是 String 云硬盘类型，取值范围： SATA：普通IO， SAS：高IO， SSD：超高IO， FASTSSD：极速型SSD 您可以查看磁盘类型及性能介绍磁盘类型相关信息 SATA diskSize 是 Integer 磁盘容量，单位为GB，取值范围：[10, 32768] 20 decTypeID 否 String 专属云存储ID 32af90b5664c41c4bc590f88b39eebc2 表 networkCards 参数 是否必填 参数类型 说明 示例 下级对象 nicName 否 String 长度2~32，支持拉丁字母、中文、数字、下划线、连字符，中文或英文字母开头，不能以http:或https:开头 net.name fixedIP 否 String 内网IPv4地址，注：不可使用已占用IP 192.168.3.20 isMaster 是 Boolean 是否主网卡，取值范围： true：表示主网卡， false：表示扩展网卡 注：只能含有一个主网卡 true subnetID 是 String 子网ID，您可以查看基本概念来查找子网的相关定义 获取： 查 查询子网列表 创 创建子网 注：在多可用区类型资源池下，subnetID通常以“subnet”开头，非多可用区类型资源池subnetID为uuid格式 a90eebf0d7985017b9f09468bb2301c2

接口功能介绍 调用该接口创建镜像缓存 接口约束 无 URI POST /eci/api/v1/imageCache/createImageCache 路径参数 无 Query参数 无 请求参数 请求头header参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 区域ID bb9fdb42056f11eda1610242ac110002 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 imageCacheName 是 String 镜像缓存名字 test imageCacheSize 否 Integer 镜像缓存大小 ,默认为20G 20 retentionDays 否 Integer 镜像缓存保留时间（单位天），不传或传0表示永不过期 ，最大值3650 30 tags 否 Array of Objects 标签 tag securityGroupId 是 String 安全组ID sgtest vSwitchId 是 String 子网ID subnettest azInfo 是 Object 可用区 azInfo imageRegistryCredentials 否 Array of Objects 不带 http:// 或 https:// 前缀的镜像仓库地址 imageRegistryCredential images 是 Array of Strings 镜像列表 ["registryvpccrshuadong1.ctyun.cn/xeci/base:latest"] eip 否 Object 弹性公网 IP。如果需要拉取公网镜像，需要确保 ECI 实例能够访问公网，您可以配置 EIP 或者 NAT 网关实现公网访问。 eip vpcId 是 String 实例所在VpcId vpcctt6yag121 表 tag 参数 是否必填 参数类型 说明 示例 下级对象 key 否 String 标签的key keytest value 否 String 标签的value valuetest 表 azInfo 参数 是否必填 参数类型 说明 示例 下级对象 azName 是 String az名称 az1 表 imageRegistryCredential 参数 是否必填 参数类型 说明 示例 下级对象 server 是 String 服务名称 chengdu1az1.crs.ctyun.cn userName 是 String 用户名 testuser password 是 String 镜像凭证密码 testpwd 表 eip 参数 是否必填 参数类型 说明 示例 下级对象 eipInstanceId 是 String eip 实例ID az1

本节介绍了什么是云服务备份、备份、快照、镜像有什么区别、云服务备份产品架构、备份机制、备份的方式及适用场景。 什么是云备份 云服务备份（Cloud Backup and Recovery，CBR）可以为云主机、云硬盘提供简单易用的备份服务，当发生病毒入侵、人为误删除、软硬件故障等事件时，可将数据恢复到任意备份点。 云服务备份保障用户数据的安全性和正确性，确保业务安全。 备份、快照、镜像有什么区别？ 备份分为云主机备份和云硬盘备份。 镜像分为系统盘镜像、数据盘镜像、整机镜像。 备份类型 备份对象 适用场景 区别和优势 备份方法 恢复方法 :::::: 云主机备份 弹性云主机中的所有云硬盘（系统盘和数据盘） 云主机受到攻击或病毒入侵 通过云主机备份，可立即恢复到最近一次没有受黑客攻击或病毒入侵的备份时间点。 数据被误删 通过云主机备份，可立即恢复到删除前的备份时间点，找回被删除的数据 应用程序更新出错 通过云主机备份，可立即恢复到应用程序更新前的备份时间点，使系统正常运行。 云主机宕机 通过云主机备份，可立即恢复到宕机之前的备份时间点，使云主机能再次正常启动 备份的同一个云主机下的所有云硬盘数据具有一致性，即同时对所有云硬盘进行备份，不存在因备份创建时间差带来的数据不一致问题。 且云备份支持根据备份策略自动备份。 创建云主机备份 使用云主机备份恢复数据（恢复至原服务器） 使用云主机备份恢复数据（创建新的云主机） 云硬盘备份 指定的单个或多个云硬盘（系统盘或数据盘） 系统盘没有个人数据，因而只需要对部分的数据盘进行备份 当云硬盘出现故障或云硬盘中的数据发生逻辑错误时（如误删数据、遭遇黑客攻击或病毒危害等），可快速恢复数据。 备份作为基线数据 设置备份策略，根据策略自动对云硬盘进行数据备份，通过定期创建的备份作为基线数据，用来创建新的云硬盘或者恢复数据到云硬盘。 备份数据则存储在对象存储 (OBS)中，可以实现在云硬盘存储损坏情况下的数据恢复 保证数据安全的同时降低备份成本 创建云硬盘备份 使用云硬盘备份恢复数据（恢复至原磁盘） 使用云硬盘备份恢复数据（创建新的磁盘） 快照 指定的单个或多个云硬盘（系统盘或数据盘） 日常备份数据 通过对云硬盘定期创建快照，实现数据的日常备份，可以应对由于误操作、病毒以及黑客攻击等导致数据丢失或不一致的情况 快速恢复数据 应用软件升级或业务数据迁移等重大操作前，您可以创建一份或多份快照，一旦升级或迁移过程中出现问题，可以通过快照及时将业务恢复到快照创建点的数据状态。 例如，当由于云主机 A的系统盘 A发生故障而无法正常开机时，此时您可以使用系统盘 A已有的快照新创建一块云硬盘 B并挂载至正常运行的云主机 B上，从而云主机 B能够通过云硬盘 B读取原系统盘 A的数据。 快速部署多个业务 通过同一个快照可以快速创建出多个具有相同数据的云硬盘，从而可以同时为多种业务提供数据资源。 例如数据挖掘、报表查询和开发测试等业务。这种方式既保护了原始数据，又能通过快照创建的新云硬盘快速部署其他业务，满足企业对业务数据的多元化需求。 说明 只支持回滚快照数据至原云硬盘，不支持快照回滚到其它云硬盘。 重装操作系统或切换操作系统后，系统盘快照会自动删除；数据盘快照不受影响，可以照常使用。 快照数据与云硬盘数据存储在一起，可以支持快速备份和恢复 快速保存指定时刻云硬盘的数据，同时还可以通过快照创建新的云硬盘，这样云硬盘在初始状态就具有快照中的数据 创建快照 使用快照回滚数据 系统盘镜像 系统盘 快速恢复系统 更换操作系统、应用软件升级或业务数据迁移等重大操作前，将系统盘创建成系统盘镜像，一旦迁移过程中出现问题，可以通过系统盘镜像切换操作系统，或重新创建新的云主机。 快速部署多个业务 通过同一个系统盘镜像可以快速创建出多个具有相同操作系统的云主机，从而快速部署多个业务。 系统盘镜像可以实现在云主机操作系统损坏情况下快速切换至损坏前的操作系统。 创建系统盘镜像 使用系统盘镜像切换故障云主机的操作系统 使用系统盘镜像创建新的云主机 数据盘镜像 指定的数据盘 快速复制数据 通过同一个数据盘镜像可以快速创建出多个具有相同数据的云硬盘，再将新创建的云硬盘挂载到其他服务器上，从而可以同时为多种业务提供数据资源。 数据盘镜像可以复制全盘的数据并创建新的云硬盘挂载到其他服务器上，实现云主机数据盘的复制和共享。 创建数据盘镜像 使用数据盘镜像创建数据盘 整机镜像 弹性云主机中的所有云硬盘（系统盘和数据盘） 快速恢复系统 更换操作系统、应用软件升级或业务数据迁移等重大操作前，将云主机的系统盘和数据盘创建成整机镜像，一旦迁移过程中出现问题，可以通过整机镜像切换操作系统，或重新创建新的云主机。 快速部署多个业务 通过同一个整机镜像可以快速创建出多个具有相同操作系统和数据的云主机，从而快速部署多个业务。 通过整机镜像实现业务的整理迁移。 创建整机镜像 使用整机镜像创建新的云主机

本文主要介绍流量镜像应用场景。 网络流量检查： 当您需要进行网络入侵检测时，通过流量镜像功能可以镜像您所需的网络流量。获取到流量后，您可以使用安全软件对流量进行全面分析检查，快速查找安全漏洞，确保网络安全。 网络流量审计： 通过流量镜像功能，您可以将流量镜像到指定的平台进行审计分析，适用于金融等对安全性要求比较高的业务场景。 网络问题定位： 通过流量镜像功能，运维工程师直接查看镜像的流量来排查问题，而不用通过业务服务器抓取报文，避免了运维期间可能对业务造成的影响。

本节介绍了通过镜像文件注册私有镜像过程中,系统会对镜像做哪些修改的相关内容。 如果您通过镜像文件注册私有镜像时勾选了“进行后台自动化配置”，那么后台系统会进行以下操作。 Linux操作系统 检查pvdriver相关驱动是否存在，如果存在，将删除相关驱动。 修改grub和syslinux配置文件，增加内核启动参数，并将磁盘分区名改成“UUID磁盘分区的UUID”。 检查“/etc/fstab”文件中的磁盘分区名并修改成“UUID磁盘分区的UUID”。 检查“initrd”文件是否含有XEN和IDE驱动，若不含有，则加载XEN和IDE驱动。 修改xwindow配置文件“/etc/X11/xorg.conf”文件，避免图形化界面显示失败。 删除VMware tools对应的服务。 记录最近一次自动化配置对镜像做的修改，记录文件位置为“/var/log/rainbowmodificationrecord.log”。 Linux操作系统会拷贝自带的virtio前端驱动到initrd或initramfs中去。具体支持情况请参见外部镜像文件支持的格式和操作系统类型。 说明： 对于如下场景的镜像文件，勾选“进行后台自动化设置”后，该功能不生效： /usr目录被单独分区的镜像文件 使用xfs文件系统的Fedora 29 64bit、Fedora 30 64bit、CentOS 8.0 64bit镜像 使用ext4文件系统的SUSE 12 SP4 64bit镜像 Windows操作系统 对IDE驱动进行修复，系统第一次启动使用IDE启动。 对鼠标和键盘对应的注册表键值删除，让鼠标键盘注册表键值在新的平台上重新生成，保证鼠标键盘可用。 对PV Driver注册表键值修复，解决系统无法安装驱动问题和XEN驱动冲突问题。 离线注入virtio驱动，解决在没有安装UVP VMTools情况下系统无法正常启动的问题。 修复DHCP，系统会根据DHCP协议动态获取IP地址等信息。

是否支持镜像不同租户不同区域的流量？ 不支持。 一个会话的源和目的必须归属同一个租户的同一个区域。 目前流量镜像仅支持在同账号的同地域下选择镜像源与镜像目的，您可以选择镜像源和镜像目的在同VPC或跨VPC的场景下。不支持跨地域或跨账号的场景。一个弹性网卡实例不能既作为镜像源又作为镜像目的。 镜像源和镜像目的是否可以为同一个网卡？ 不可以。 流量镜像是将网络流量从弹性网卡镜像到其他指定的云服务器的网卡，镜像源和镜像目的分别是流量提供方与接收方，所以一个网卡不能既作镜像源又作镜像目的。在控制台上会限制您的网卡行为选择，当您选择某一网卡为镜像源后，在选择镜像目的的时候会限制您选择同一个网卡，请您合理规划网卡的使用。 流量镜像是否采集网络的全部流量？ 不是。 流量镜像不采集ACL丢弃流量、安全组丢弃流量、QoS丢弃流量和被筛选条件过滤掉的流量。 创建镜像会话时关联筛选条件，镜像会话创建成功后开启镜像会话，所有符合筛选条件的网络流量都会被镜像，不符合筛选条件的流量均会被过滤掉。规则的生效顺序取决于规则的优先级，数字越小，优先级越高，出/入方向最多可配置10条规则。请您合理设置筛选条件中的筛选规则。

本节为您介绍镜像服务常见的镜像优化类问题。 一定要在云主机中安装Guest OS driver吗？ 安装Guest OS driver对于云主机的性能、稳定性和用户体验有不少影响，但并非一定要安装。 如果您希望获得更好的性能、可靠性和一体化管理体验，安装这些驱动程序是一个不错的选择。如果您只是简单地在虚拟机上运行一些基本应用，可能并不需要过多考虑这些驱动。 在Windows操作系统中，安装PV（Paravirtualization）driver和UVP（Unmodified Virtualized Platforms）VMTools可以改善虚拟机的性能、可靠性和安全性，同时提供更好的集成和管理功能。 对于Linux操作系统，确保使用正确的驱动并在initrd中加载驱动也是很重要的。使用xenpv和virtio原生驱动可以改善磁盘和网络性能，并确保云主机在虚拟化环境中的正常运行。 Windows操作系统为什么要安装并更新VMTools？ 为什么要安装VMTools？ VMTools是一种半虚拟化驱动（virtio driver），主要用于提供高性能的磁盘和网卡支持。安装VMTools可以提升弹性云主机的性能、兼容性和功能支持，确保云主机在虚拟化环境中正常运行并获得最佳体验。以下是安装VMTools的几个主要原因： 提供高性能驱动： VMTools提供了与虚拟化平台相匹配的高性能驱动，能够优化云主机的磁盘和网络性能，从而提供更好的用户体验。 改善兼容性： 标准的Windows系统通常不包含虚拟化平台所需的virtio驱动，安装VMTools可以保证在虚拟化环境中的兼容性，避免因驱动问题而导致性能下降或不稳定的情况。 增强功能支持： 安装VMTools可以使虚拟机获得一些额外的功能支持，比如更好的时间同步、精确的鼠标控制、自动调整分辨率等。 公共镜像默认支持： 平台提供的公共镜像通常已经预先安装了VMTools，以确保镜像可以在平台上正常运行并获得最佳性能。 私有镜像自行安装： 对于用户自己创建的私有镜像，需要用户自行安装VMTools，以确保云主机能够充分发挥性能和功能。

接口功能介绍 查询镜像同步规则 接口约束 仅限企业版实例使用 URI GET /v2/getRepoSyncRule 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 id 是 String 规则ID 1669608740672020481 请求参数 请求头header参数 参数 是否必填 参数类型 说明 示例 下级对象 ContentType 是 String 类型 application/json regionId 是 String 资源池编码（资源池ID，您可以查看容器镜像服务资源池获取） bb9fdb42056f11eda1610242ac110002 请求体body参数 无 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 响应码 （800为请求成功，900为失败 ） 800 message String 返回信息 error String 错误码 returnObj Object 任务详情 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 reposyncRuleId Long 规则ID 1672892136646057985 ruleName String 规则名称 myRule ruleDesc String 规则描述 desc srcTag String 源版本，表示全部 syncMode String 同步类型，导入规则：migrate 同步规则：sync 默认值: sync sync srcType String 源仓库类型,crs: 镜像仓库实例 oss：对象存储 huaweiSWR：华为云 tencenttcr：腾讯云企业版 aliacr：阿里云企业版 默认值：crs crs srcInstanceId String 源实例ID f04e47d9b48747958c9f4516cf1a8d82 srcNamespaceId String 源命名空间ID f5b49578426e6da458fb9aba36d8cfdb dstInstanceId String 目标实例ID 59793156d5524c56b69b6c5b824a5f43 dstNamespaceId String 目标命名空间ID 0d24866c7ff243d2898d5c4817eb4627 srcRepositoryId String 源仓库ID，1表示全部 1 ruleContent String 同步内容, Image:镜像 Chart All：镜像和chart isOverride Boolean 是否覆盖,true表示覆盖，false表示不覆盖 true syncScene String 同步场景,同账户：sameaccount 跨账户：crossaccount 外部迁移：external sameaccount latestN Long 保留最近镜像个数 ,0代表保留所有 0 state String 是否启用 ，ENABLE DISABLE ENABLE

本节主要介绍管理镜像 获取镜像下载地址 1、登录ServiceStage控制台，选择“软件中心 > 镜像仓库 > 我的镜像”。 2、在“仓库组织管理”右侧下拉列表框，选择组织。 3、在镜像仓库列表，单击镜像仓库名称，进入镜像仓库详情页。 4、在“镜像版本”页签，可以获取镜像版本下载指令。 编辑镜像仓库属性 1、登录ServiceStage控制台，选择“软件中心 > 镜像仓库 > 我的镜像”。 2、在“仓库组织管理”右侧下拉列表框，选择组织。 3、在镜像仓库列表，单击镜像仓库名称，进入镜像仓库详情页。 4、单击右上角“编辑”，根据需要在弹出的窗口中： 设置“共享类型”：重新设置“共享类型”为“公共”或“私有”。 说明 公共镜像所有用户都可以下载使用。 如果您的节点与镜像仓库在同一区域，访问仓库是通过内网访问。 如果您的节点与镜像仓库在不同区域，通过公网才能访问仓库，下载跨区域仓库的镜像需要节点可以访问公网。 设置“仓库类型”：重新设置“仓库类型”。 更新“描述”：更新镜像仓库描述信息。 5、单击“确认”，完成编辑。 添加镜像授权 在镜像详情中为用户添加授权，授权完成后，该帐号下用户享有读取/编辑/管理该镜像的权限。 1、登录ServiceStage控制台，选择“软件中心 > 镜像仓库 > 我的镜像”。 2、在“仓库组织管理”右侧下拉列表框，选择组织。 3、在镜像仓库列表，单击镜像仓库名称，进入镜像仓库详情页。 4、在“权限管理”页签，单击“添加授权”，选择用户名称，添加“读取/编辑/管理”的权限，然后单击“确认”。 添加后，该用户享有对应权限。

本章节主要介绍物理机镜像概述。 镜像是一个至少包含操作系统，还可以包含应用软件（例如，数据库软件）及软件必要配置的物理机模板。 镜像分为公共镜像和私有镜像，公共镜像为系统默认提供的镜像，私有镜像为用户自己创建的镜像，用户也可以提工单给天翼云运维团队协助您完成私有镜像的创建。您可以灵活便捷地使用公共镜像或者私有镜像申请物理机。同时，用户还能通过已有的物理机或者外部镜像文件创建私有镜像，这样可以快速轻松地创建能满足您一切需求的物理机。

参数 参数类型 说明 示例 下级对象 imageOid String 镜像ID mii4ri4afb4inm29d52o85d imageName String 镜像名称 hhj云服务器v1.0 osName String 操作系统名称 hhj云服务器 osType String 操作系统类型（Windows;Linux） Linux platform String 操作系统平台（Windows;Centos;Ubuntu;UOS;Kylin银河麒麟;NeoKylin中标麒麟） Centos sysDisk Object 系统盘相关信息 sysDisk gpuCategory Boolean 是否为GPU类型镜像 false updateTime String 修改时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 20230913T10:08:06Z

镜像描述 当前镜像处于公测阶段，您可在华东1资源池试用。如果您希望在其他资源池试用该镜像，可以提交工单申请。 openGauss 是面向数据基础设施的开源关系型数据库。openGauss 调优镜像由天翼云与 openGauss 社区联合推出，基于 AI 学习自动优化数据库参数，提供预装 openGauss 并配置最优参数的 ECS 镜像。使用该镜像，用户可快速部署 openGauss 数据库，并获得优于默认配置的性能表现。该镜像采用 NUMA（NonUniform Memory Access，非统一内存访问）分区优化、ARM 指令集加速等关键技术，并通过多轮测试数据训练性能预测模型，最终实现接近真实业务场景的自动化最优调参。 配置要求 推荐配置：vCPU ≥ 4 核，内存 ≥ 16 GB；建议使用鲲鹏架构的云服务器。 免责说明 免责声明：本镜像中集成的 openGauss 数据库来源于第三方开源社区，仅供用户参考和使用。本公司不对因不当使用该镜像所导致的任何损失或损害承担法律责任。用户应确保其使用行为符合相关法律法规，并遵守 openGauss 社区的相关协议。 实践指南 数据库镜像使用指导 您可在华东1云主机订购页市场镜像服务器软件分类 选择试用openGauss调优专用镜像。 自行安装说明（若使用天翼云 openGauss 调优专用镜像，可跳过此部分）。 plaintext 极简模式服务器单点参考： 下载数据库安装包(登录openGauss开源社区[](openGauss开源社区)，选择对应平台的最新安装包下载。对于个人开发者或非企业级环境，下载极简安装包（不安装OM等组件）即可)。 plaintext 下载链接： plaintext 考虑到 glibc 版本兼容性问题，CtyunOS操作系统需要下载 openEuler 22.03 对应的安装版本： x8664: arm64： 首次使用天翼云 openGauss 调优专用镜像开通云主机后需要执行以下步骤： 说明 由于 openGauss 要求使用非 root 普通用户进行安装和运行，该镜像已预置非 root 用户 omm。出于云主机安全考虑，omm 用户默认被禁止登录。 plaintext

共享镜像 1. 进入“AI云电脑（政企版）”管理控制台； 2. 展开“AI云电脑管理”菜单栏，选择“镜像管理”，选择“自定义镜像”，然后选择您要共享的镜像； 3. 选择需要共享的资源池，输入该资源池内接受者的天翼云账号，点击“确定”； （注：切换资源池后，可重新输入接受者的天翼云账号，从而把共享给多个租户） 4. 点击“确认”，即完成镜像共享。 接受共享镜像 1. 进入“AI云电脑（政企版）”管理控制台； 2. 当其他租户共享镜像给接受者后，接受者可在“镜像管理”“共享镜像“中查看共享镜像信息； 3. 接收者选择希望接受共享的镜像，并点击“全部接受”; 4. 确认接受后，约1~3分钟后即可完成镜像共享。 镜像导入（政企客户请联系客户经理申请开通） 1. 进入“AI云电脑（政企版）”控制台； 2. 展开“AI云电脑管理”菜单栏，选择“镜像管理”，选择“镜像导入”标签页； 3. 点击“导入镜像”选择需要导入的镜像类型，点击“导入”选择本地对应的镜像文件，再点击“上传发布”并等待上传完成（注：上传完成前切勿关闭弹窗，镜像文件仅保留7天，过期自动删除，删除后可再次上传）； 4. 选择所需镜像，点击“发布”，录入镜像信息并点击“确定发布”，即可启用该镜像； 5. 开通桌面时，可在“自定义镜像”中查找已发布的镜像，用于创建AI云电脑。（注：每个导入的镜像只能创建5个AI云电脑实例）

镜像会话源和目的缺失时会话是否可以运行？ 不可以。 由于资源释放导致镜像源/镜像目的被删除时，镜像会话的镜像源和镜像目的信息处于缺失状态，镜像会话将从启动状态变为停止状态，且禁止重新启动会话。 流量镜像是将网络流量从弹性网卡镜像到其他指定的云服务器的网卡，镜像源和镜像目的分别是流量提供方与接收方，所以镜像源和镜像目的均不可缺失，缺失将无法形成完整的镜像会话。 虚拟IP是否支持广播和组播通信？ 不支持。 对于可用区资源池来说，虚拟IP只支持单播，不支持广播和组播。如果您使用keepalived等第三方软件结合虚拟IP搭建高可用场景，您需要将配置文件中的通信方式修改为单播通信。 对于地域资源池来说，仅vxlan架构资源池的IPv4类型的虚拟IP支持组播，其余形式均不支持组播。虚拟IP也不支持广播通信。 使用keepalived实现高可用时，推荐使用什么版本的keepalived？ 推荐使用V2.0.20及以上版本的keepalived。 是否支持使用虚拟IP实现自建Linux虚拟服务器（LVS）高可用？ 不支持。 虚拟IP是一个从子网中分配的内网IP地址，没有分配给真实弹性云服务器网卡。您可以通过将虚拟IP与主备弹性云服务器绑定，根据是否需要访问公网可以为虚拟IP绑定一个弹性IP，配合高可用软件（例如Keepalived）使用，实现业务的高可用。