基于 Docker 制作自定义镜像

容器服务支持使用基于 veLinux 的自定义镜像为节点安装操作系统，本文为您介绍如何使用docker run方式打包和预热自定义镜像。

背景信息

本方式已经对自定义镜像打包过程进行产品化封装，使用docker run命令即可自动进行自定义镜像的打包和预热，命令执行过程将自动完成以下步骤：

1. 系统根据所选规格临时新建一台 veLinux 操作系统的 ECS、一个 EIP、一个 VPC 及其子网，其中 ECS 和 EIP 将以按量计费方式进行收费。

2. 执行自定义镜像预热，从镜像仓库拉取待打包镜像，以及 VKE 本身的容器镜像。

3. 打包自定义镜像，并检查自定义镜像的可用性。

4. 将已经打包并检查无误的镜像，导入 ECS 的镜像中心。

5. 删除临时创建的所有资源，并以按量计费方式结算 ECS 和 EIP 的费用。

前提条件

• 已经在本地或云服务器中安装 Docker，且确保可以连接到互联网。详细操作参见：官方文档。

• 已经为当前账号添加 自定义镜像预热 API 功能的白名单权限，可 提交工单 申请。

• 已经获取可用的火山引擎账号 AK、SK，可前往 API 访问密钥 获取。

• （可选）若使用企业版镜像仓库，确保已经准备待打包的镜像，并获取镜像地址、镜像仓库用户名和镜像仓库密码。

• （可选）若使用企业版镜像仓库，确保制作镜像的 ECS 实例与镜像仓库网络互通，可使用公网连接或指定 VPC。

  • 若使用公有网络，要求镜像仓库开启公网访问，操作方法参见：开启公网访问。另外，公有网络将以按量计费方式进行收费。
  • 若指定 VPC，要求同时在镜像仓库的访问控制中添加此 VPC，操作方法参见：连通本账号 VPC。

• （可选）若使用子用户打包自定义镜像，确保已经具备基础设施 ECS、EIP、VPC 相关的 IAM 权限，包含以下 Action：

{
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ecs:RunInstances",
                "ecs:StopInstance",
                "ecs:DeleteInstance",
                "ecs:DescribeInstances",
                "ecs:CreateImage",
                "ecs:PreheatImage",
                "ecs:DescribeImages",
                "ecs:DescribeTasks",
                "vpc:CreateVpc",
                "vpc:DeleteVpc",
                "vpc:DescribeVpcs",
                "vpc:CreateSubnet",
                "vpc:DeleteSubnet",
                "vpc:DescribeSubnets",
                "vpc:DescribeSecurityGroups",
                "vpc:AllocateEipAddress",
                "vpc:AssociateEipAddress",
                "vpc:DescribeEipAddresses",
                "vpc:DisassociateEipAddress",
                "vpc:ReleaseEipAddress"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}

使用限制

• 目前仅支持基于容器服务基础镜像 veLinux 制作自定义镜像。

• 自定义镜像打包过程会临时创建一台 ECS 和一个 EIP，待所有流程结束后自动删除并以按量计费方式结算费用，请确保账号余额充足，否则可能导致镜像打包失败。

操作说明

满足以上前提条件后，即可在已经安装 Docker 的本地或云服务器中，使用docker run方式进行自定义镜像的打包和预热。其中，所有参数均通过环境变量（ENV）来配置。

使用示例

• 示例一：仅包含必选参数的简单示例

docker run --rm \
        -e VOLC_AK="<AK>" \ 
        -e VOLC_SK="<SK>" \ 
        -e TAILOR_SPEC="ecs.xxx.large" \ 
        vke-cn-beijing.cr.volces.com/vke/private-image-packer:v1.0.7

• 示例二：包含所有参数的详细示例

docker run --rm \
        -e VOLC_AK="<AK>" \ 
        -e VOLC_SK="<SK>" \ 
        -e REGION="cn-shanghai" \
        -e ZONE="cn-shanghai-a" \
        -e TAILOR_IMAGE_NAME="my-image-name" \
        -e TAILOR_SPEC="ecs.xxx.large" \ 
        -e TAILOR_DISK_SIZE="60" \
        -e TAILOR_COMPAT="false"  \
        -e IMAGES="cr-helm2-cn-beijing.cr.volces.com/****/busyxxx:latest,cr-helm2-cn-beijing.cr.volces.com/****/3gixxx:latest" \
        -e REGISTRY_USERNAME="paas2b_prod@2100****" \
        -e REGISTRY_PASSWORD="password123" \
        -e TAILOR_PASSWORD="password"\
        -e TAILOR_VPC="vpc-13fawddpwxxxxxx6nu4g2y8bt"\
        -e TAILOR_SUBNET="subnet-mj92ij8xxxxxxsmt1arvwrtw"\
        -e TAILOR_KERNEL="5.4"\
        -e PREHEAT_DISABLED="true"\
        vke-cn-beijing.cr.volces.com/vke/private-image-packer:v1.0.7

参数说明

private-image-packer 更新记录

后续操作

打包过程故障处理

若docker run命令执行过程中报错中断自定义镜像打包，需要根据报错提示进行处理，然后重新执行命令。可能存在的错误包括：

• docker run 命令错误：命令参数不符合语法定义、缺少可用的参数值等。

• 自定义镜像检查不通过：操作系统与内核版本、systemd 等基础组件版本、cloud-init 状态、DNS 配置、NTP 状态、atop/proxima/unscd 等组件版本、文件系统挂载状态、网卡名匹配、系统启动参数等检查不通过。

查看自定义镜像

docker run命令执行成功后，打包好的自定义镜像将自动上传到 ECS 的镜像中心。

使用自定义镜像

创建集群、创建节点池或添加已有节点时，即可选择使用已经打包并上传到镜像中心的自定义镜像。详细操作参见：创建集群、添加已有节点、创建节点池。