创建自定义镜像

云服务器文档中心入门中心API 中心SDK 中心文档活动我的反馈文档反馈官招募中，报名立赚积分兑换代金券！> HOT文档中心>云服务器>操作指南>镜像>创建自定义镜像创建自定义镜像最近更新时间：2025-06-03 11:17:42

微信扫一扫QQ新浪微博复制链接链接复制成功我的收藏本页目录：操作场景注意事项操作步骤相关操作查看各地域自定义镜像数量数据盘数据迁移操作场景除了使用腾讯云提供的公共镜像、云镜像市场外，您还可以创建自定义镜像。创建自定义镜像后，您可以在腾讯云控制台快速创建与该镜像相同配置的腾讯云云服务器实例。说明：由于镜像底层使用了云硬盘快照服务：国内地域提供80GB的免费额度，详情请参见 赠送额度。在创建自定义镜像时会默认创建关联该镜像的快照，且保留自定义镜像会产生一定的快照费用，详情请参见 快照计费概述。若您的腾讯云账户进入欠费状态，为避免您的数据丢失，我们将保留您的自定义镜像及关联的快照，快照占用超出免费额度的容量将会持续计费，直到快照被删除；除删除操作外，镜像快照将永久保留。注意事项每个地域暂支持500个自定义镜像。正常情况下，创建的自定义镜像容量大小与实例磁盘大小一致。若您的 Linux 实例具备数据盘，但您仅制作系统盘自定义镜像时，请确认 /etc/fstab 不包含数据盘配置，否则会导致使用该镜像创建的实例无法正常启动。制作过程需要持续十分钟或更长时间，具体时间与实例的数据大小有关，请提前做好相关准备，以防影响业务。若您的 Windows 实例需入域且使用域账号，则在创建自定义镜像前，请执行 Sysprep 操作以确保在实例入域后 SID 唯一。详情请参见 通过 Sysprep 实现云服务器入域后 SID 唯一。若您使用的是配置25Gbps 网卡的裸金属服务器（即机型的内网带宽值是25Gbps），暂不支持使用控制台及 API 创建自定义镜像。操作步骤入口：控制台实例页面入口：控制台镜像页面入口：API入口：客户端基于Packer工具创建自定义镜像1. 登录 云服务器控制台，查看对应实例是否需进行关机。注意：2018年7月之后创建的实例（系统盘为云硬盘），支持在线制作镜像（即实例不关机的情况下制作镜像）。除此情况外的实例，请先将实例关机后再进行镜像制作，以确保镜像与当前实例部署环境完全一致。需要，则关机实例。不需要，请继续执行后续步骤。2. 在实例的管理页面，根据实际使用的视图模式进行操作：列表视图：选择更多 > 镜像/操作系统 > 创建自定义镜像。如下图所示：页签视图：选择右上角的更多操作 > 镜像/操作系统 > 创建自定义镜像。如下图所示：3. 在弹出的创建自定义镜像窗口中，参考以下信息进行配置：镜像名称及镜像描述：自定义名称及描述。标签：可按需增加标签，用于资源的分类、搜索和聚合。更多信息请参见 标签。当您的实例含数据盘时，默认创建系统盘+数据盘的整机镜像，您可以指定仅创建系统盘镜像。4. 单击创建镜像即可。

您可单击左侧导航栏中的 镜像，在镜像页面中查看镜像的创建进度。使用自定义镜像创建实例（可选）待镜像完成创建后，在镜像列表中选择您创建的镜像，单击其所在行右侧的创建实例，即可购买与之前相同镜像的服务器。如下图所示：创建自定义镜像1. 登录 云服务器控制台，查看对应实例是否需进行关机。注意2018年7月之后创建的实例（系统盘为云硬盘），支持在线制作镜像（即实例不关机的情况下制作镜像）。除此情况外的实例，请先将实例关机后再进行镜像制作，以确保镜像与当前实例部署环境完全一致。需要，则关机实例。不需要，请继续执行后续步骤。2. 单击左侧导航栏中的 镜像，进入镜像页面，在列表上方选择创建自定义镜像。3. 在弹出的创建自定义镜像窗口中，参考以下信息进行配置：选择实例：选择该地域下需要创建自定义镜像的实例。镜像名称及镜像描述：自定义名称及描述。标签：可按需增加标签，用于资源的分类、搜索和聚合。更多信息请参见 标签。当您的实例含数据盘时，默认创建系统盘+数据盘的整机镜像，您可以指定仅创建系统盘镜像。4. 单击创建镜像即可。

之后您可以在镜像页面中查看镜像的创建进度。使用自定义镜像创建实例（可选）待镜像完成创建后，在镜像列表中选择您创建的镜像，单击其所在行右侧的创建实例，即可购买与之前相同镜像的服务器。如下图所示：您可以使用 CreateImage 接口创建自定义镜像。具体内容可以参见 创建镜像 API。背景信息Packer 是一款开源的、轻量级的自动化镜像构建工具。使用 JSON 格式或 HCL2（HashiCorp Configuration Language）的配置文件来定义镜像的构建过程，从而实现快速、可靠的镜像构建和部署。Packer 还能为测试和更新镜像带来使用便利，降低运维和管理镜像的时间成本。更多信息参见 Packer 官网。前提条件已创建子用户，并已具备云服务器及云 API 所有权限。创建子用户请参见 新建子用户。为子用户授予权限请参见 子用户权限设置，本文为子用户授予 QcloudCVMFullAccess、QcloudCVMFinanceAccess及 QcloudAPIFullAccess 预设策略。为子用户创建 SecretId 与 SecretKey，操作步骤请参见 子账号访问密钥管理。请记录并妥善保管。注意：可以使用主账号 SecretId 与 SecretKey，由于主账号对名下资源有完全控制权限，为了避免因访问密钥泄露带来的安全风险，不建议您使用主账号，请创建子账号。操作步骤安装 Packer1. 运行以下命令，获取 Packer 安装包。wget https://releases.hashicorp.com/packer/1.9.4/packer_1.9.4_linux_amd64.zip2. 运行以下命令，解压 Packer 安装包。unzip packer_1.9.4_linux_amd64.zip3. 运行以下命令，安装 Packer 到环境变量目录/usr/local/bin。sudo mv packer /usr/local/bin4. 运行以下命令查看 Pakcer 版本，从而验证是否安装成功。packer -v说明：安装 Packer 也可以参见 Packer 官网。定义 Packer 模板使用 Packer 创建自定义镜像，首先，需要定义 HCL 格式或者 JSON 格式的模板文件，其次，您需要在此文件中指定创建自定义镜像的 Builders（生成器）和 Provisioners（配置器），以及创建过程中使用的临时实例信息。1. 运行以下命令，创建模板文件。HCL 格式JSON 格式vim tencentcloud.pkr.hclvim tencentcloud.json2. 按i进入文件编辑模式，根据实际情况，编辑自定义镜像生成器配置器，以及实例信息。HCL 格式JSON 格式variable "secret_id" { type = string default = env("TENCENTCLOUD_SECRET_ID")}variable "secret_key" { type = string default = env("TENCENTCLOUD_SECRET_KEY")}source "tencentcloud-cvm" "basic" { secret_id = var.secret_id secret_key = var.secret_key region = "ap-guangzhou" zone = "ap-guangzhou-6" instance_type = "SA3.MEDIUM2" disk_type = "CLOUD_PREMIUM" source_image_id = "img-9xqekomx" image_name = "packer-basic" ssh_username = "root" associate_public_ip_address = true run_tags = { "packer" = "packer-test" }}build { sources = ["source.tencentcloud-cvm.basic"]

provisioner "shell" { inline = ["sleep 30", "yum install redis.x86_64 -y"] }}{ "variables": { "secret_id": "{{env `TENCENTCLOUD_SECRET_ID`}}", "secret_key": "{{env `TENCENTCLOUD_SECRET_KEY`}}" }, "builders": [ { "type": "tencentcloud-cvm", "secret_id": "{{user `secret_id`}}", "secret_key": "{{user `secret_key`}}", "region":"ap-guangzhou", "zone": "ap-guangzhou-6", "instance_type": "SA3.MEDIUM2", "disk_type": "CLOUD_PREMIUM", "source_image_id": "img-9xqekomx", "image_name": "packer-basic", "ssh_username": "root", "associate_public_ip_address": true, "run_tags": { "packer": "packer-test" } } ], "provisioners": [{ "type": "shell", "inline": ["sleep 30", "yum install redis.x86_64 -y"] }]}自定义各参数说明如下表所示：参数是否为必选说明secret_id是secret_id 推荐设置TENCENTCLOUD_SECRET_ID环境变量。secret_key是secret_key 推荐设置TENCENTCLOUD_SECRET_KEY环境变量。region是地域。创建临时 cvm 所在地域，以及创建镜像所在的地域。示例值：ap-guangzhouzone是可用区。创建临时 cvm 所在可用区。示例值：ap-guangzhou-4instance_type是实例机型。不同实例机型指定了不同的资源规格。示例值：SA3.MEDIUM2source_image_id是基础镜像 ID，用于创建临时 cvm 镜像，可从公共镜像列表获取，或者通过接口 DescribeImages 查询获得。示例值：img-9xqekomximage_name是指定自定义镜像的名称。由字母、数字和-组成，不能超60个字符。示例值：packer-basicimage_description否镜像描述。不能超60个字符。associate_public_ip_address否是否为临时 cvm 开启公网 IP，默认false。如果通过公网 IP 连接，请设置值为true。force_poweroff否当关闭临时 cvm 创建镜像时失败，是否强制关机创制镜像，默认为false。sysprep否是否在创建 Windows 映像期间启用 Sysprep。示例值：falseimage_copy_regions否创建镜像后将复制到的区域。示例值：["ap-beijing"]image_share_accounts否创建镜像后将共享的账户。示例值：["10002297xxxx"]skip_region_validation否验证时不检查区域和区域。示例值：falseinternet_max_bandwidth_out否启动的最大带宽（以 MB 为单位）。 值可设置在 1 ~ 100 之间。instance_name否实例名称disk_type否系统磁盘类型，默认为 CLOUD_PREMIUM。 您可以参见系统盘的信息。disk_size否系统磁盘大小。值范围（以 GB 为单位）：- LOCAL_BASIC: 50

- Other: 50 ~ 1000（>50需要白名单）data_disks否数据磁盘配置，磁盘详情如下表：数据磁盘详情。vpc_id否创建临时 cvm 所需 vpc_id。vpc_name否私有网络名称，创建 cvm 前创建 vpc 的名称，如果不输入给默认值，例如 packer-****。cidr_block否若未设置 vpc_id，则指定将创建的 vpc 的 cider 块。示例值：falsesubnet_id否创建临时 cvm 所需 subnet_idsubnet_name否子网名称，创建 cvm 前创建 subnet 的名称，如果不输入给默认值，例如 packer-****。subnect_cidr_block否若未设置 subnet_id，则指定将创建的 subnet 的 cider 块。示例值：falsesecurity_group_id否创建临时 cvm 所需的安全组 id。security_group_name否安全组名称，未设定security_group_id时，创建安全组时所需。user_data否用户数据。user_data_file否用户数据文件。host_name否主机名。run_tags否标签，用于创建临时 cvm 时指定实例标签，创建镜像不会使用。数据磁盘详情：参数是否为必选说明disk_type是数据磁盘的类型。 有效选择：CLOUD_BASIC、CLOUD_PREMIUM 和 CLOUD_SSD。disk_size是数据磁盘的大小。disk_snapshot_id是数据磁盘快照的 ID。更多参数请参见 Packer 官网参数。3. 按 Esc 键，并输入:wq 后按下回车键，保存并退出。创建自定义镜像1. 配置环境变量 SecretId 与 SecretKey。export TENCENTCLOUD_SECRET_ID=xxxxexport TENCENTCLOUD_SECRET_KEY=xxxx2. 执行以下命令，开始创建自定义镜像。HCL 格式JSON 格式packer build tencentcloud.pkr.hclpacker build tencentcloud.json注意：本操作会创建计费资源，请注意释放和清理。如 cvm 实例、公网IP、镜像等（除镜像外，其他资源正常情况会自动清理）。运行结果如下：tencentcloud-cvm.basic: output will be in this color.==> tencentcloud-cvm.basic: Trying to check image name: packer-basic... tencentcloud-cvm.basic: Image name: useable==> tencentcloud-cvm.basic: Trying to check source image: img-9xqekomx... tencentcloud-cvm.basic: Image found: CentOS Stream 9 64bit==> tencentcloud-cvm.basic: Trying to create a new keypair: packer_656c7***... tencentcloud-cvm.basic: Keypair created: skey-2ekzd***==> tencentcloud-cvm.basic: Trying to create a new vpc... tencentcloud-cvm.basic: Vpc created: vpc-bm797***==> tencentcloud-cvm.basic: Trying to create a new subnet... tencentcloud-cvm.basic: Subnet created: subnet-74c4j***==> tencentcloud-cvm.basic: Trying to create a new securitygroup... tencentcloud-cvm.basic: Securitygroup created: sg-7kf8z***==> tencentcloud-cvm.basic: Trying to create securitygroup polices... tencentcloud-cvm.basic: Securitygroup polices created==> tencentcloud-cvm.basic: Trying to create a new instance... tencentcloud-cvm.basic: Waiting for instance ready tencentcloud-cvm.basic: Instance created: ins-n6dp2***==> tencentcloud-cvm.basic: Using SSH communicator to connect: 1.14.***.***==> tencentcloud-cvm.basic: Waiting for SSH to become available...==> tencentcloud-cvm.basic: Connected to SSH!==> tencentcloud-cvm.basic: Provisioning with shell script: /var/folders/0_/xl3kk_6n79vbnpgj97******0000gn/T/packer-shell1288510462 tencentcloud-cvm.basic: CentOS Stream 9 - AppStream 42 MB/s | 18 MB 00:00 tencentcloud-cvm.basic: CentOS Stream 9 - BaseOS 31 MB/s | 7.9 MB 00:00 tencentcloud-cvm.basic: Last metadata expiration check: 0:00:01 ago on Sun 03 Dec 2023 09:18:14 PM CST. tencentcloud-cvm.basic: Dependencies resolved. tencentcloud-cvm.basic: ================================================================================ tencentcloud-cvm.basic: Package Architecture Version Repository Size tencentcloud-cvm.basic: ================================================================================ tencentcloud-cvm.basic: Installing: tencentcloud-cvm.basic: redis x86_64 6.2.7-1.el9 appstream 1.3 M tencentcloud-cvm.basic: tencentcloud-cvm.basic: Transaction Summary tencentcloud-cvm.basic: ================================================================================ tencentcloud-cvm.basic: Install 1 Package tencentcloud-cvm.basic: tencentcloud-cvm.basic: Total download size: 1.3 M tencentcloud-cvm.basic: Installed size: 4.7 M tencentcloud-cvm.basic: Downloading Packages: tencentcloud-cvm.basic: redis-6.2.7-1.el9.x86_64.rpm 6.5 MB/s | 1.3 MB 00:00 tencentcloud-cvm.basic: -------------------------------------------------------------------------------- tencentcloud-cvm.basic: Total 6.5 MB/s | 1.3 MB 00:00 tencentcloud-cvm.basic: Running transaction check tencentcloud-cvm.basic: Transaction check succeeded. tencentcloud-cvm.basic: Running transaction test tencentcloud-cvm.basic: Transaction test succeeded. tencentcloud-cvm.basic: Running transaction tencentcloud-cvm.basic: Preparing : 1/1 tencentcloud-cvm.basic: Running scriptlet: redis-6.2.7-1.el9.x86_64 1/1 tencentcloud-cvm.basic: Installing : redis-6.2.7-1.el9.x86_64 1/1 tencentcloud-cvm.basic: Running scriptlet: redis-6.2.7-1.el9.x86_64 1/1 tencentcloud-cvm.basic: Verifying : redis-6.2.7-1.el9.x86_64 1/1 tencentcloud-cvm.basic: tencentcloud-cvm.basic: Installed: tencentcloud-cvm.basic: redis-6.2.7-1.el9.x86_64 tencentcloud-cvm.basic: tencentcloud-cvm.basic: Complete!==> tencentcloud-cvm.basic: Trying to detach keypair: skey-2ekzdz0x... tencentcloud-cvm.basic: Waiting for keypair detached tencentcloud-cvm.basic: Keypair detached==> tencentcloud-cvm.basic: Trying to create a new image: packer-basic... tencentcloud-cvm.basic: Waiting for image ready tencentcloud-cvm.basic: Image created: img-pubkd***==> tencentcloud-cvm.basic: Cleaning up instance...==> tencentcloud-cvm.basic: Cleaning up securitygroup...==> tencentcloud-cvm.basic: Cleaning up subnet...==> tencentcloud-cvm.basic: Cleaning up vpc...==> tencentcloud-cvm.basic: Cleaning up keypair...Build 'tencentcloud-cvm.basic' finished after 3 minutes 38 seconds.==> Wait completed after 3 minutes 38 seconds==> Builds finished. The artifacts of successful builds are:--> tencentcloud-cvm.basic: Tencentcloud images(ap-guangzhou: img-pubkd***) were created.3. 查看已创建的自定义镜像。3.1 登录 云服务器控制台。3.2 在左侧导航栏中，单击 镜像，进入镜像管理页面。3.3 单击左上角的地域，即可在下拉框中查看所在地域的自定义镜像。相关文档Packer tencentcloud相关操作查看各地域自定义镜像数量在镜像资源较多、跨地域部署等场景下，一键查询各地域镜像数量可帮助您更高效地管理镜像资源。1. 登录 云服务器控制台。2. 在左侧导航栏中，单击 镜像，进入镜像管理页面。3. 单击左上角的地域，即可在下拉框中查看各地域的自定义镜像数量。4. 切换至共享镜像管理页面，单击左上角的地域，即可在下拉框中查看各地域的共享镜像数量。数据盘数据迁移如果您需要在启动新实例时同时保留原有实例数据盘上的数据，您可以先对数据盘做 快照，并在启动新实例时使用该数据盘快照创建新的云硬盘数据盘。

更多相关信息，请参见 快照创建云硬盘。上一篇: 查询配额申请记录下一篇: 操作系统转换Copyright © 2013-2025 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有深圳市腾讯计算机系统有限公司ICP备案/许可证号：粤B2-20090059粤公网安备44030502008569号腾讯云计算（北京）有限责任公司京ICP证150476号 | 京ICP备11018762号中国站中文International文档“捉虫”活动检视指定产品文档，发现和反馈有效问题，奖！API专项"捉虫"反馈API文档问题，代金券、周边好礼奖不停！文档建议，你提了吗快来使用腾讯云产品文档，提出有效建议，奖！在线咨询目录返回顶部