全部文档
当前文档
最近更新时间：2024-09-26 15:29:25
本文主要介绍如何在金山云容器服务使用自定义镜像创建Kubernetes集群。
使用自定义的镜像，请在金山云容器团队提供的标准镜像上制作自定义镜像。
目前仅支持同类型的操作系统镜像的制作。例如，使用 CentOS 基础镜像制作 CentOS 类的自定义镜像。
为了提升镜像的稳定性，并提供更多特性，金山云容器团队为您提供容器服务的标准镜像。您可以通过调用容器服务的获取容器服务支持的节点操作系统接口，获取容器服务提供的标准镜像。
说明：KCE将持续对标准镜像进行优化或者 bugfix，并生成新版本标准镜像。新版本镜像不会对您之前使用旧版本标准镜像制作的自定义镜像产生任何影响。为了达到更好的使用效果，建议您使用新版本标准镜像。
调用云主机的 RunInstances 创建云服务器实例,其中ImageId请替换为容器服务的标准镜像，获取方式详见获取容器服务支持的节点操作系统。
用户根据业务的实际制作自定义镜像，参考制作镜像完成创建。
自定义镜像制作完成后，请联系您的商务同学，将镜像导入到容器服务。导入成功后，即可在容器服务控制台使用用户自定义的镜像。
请基于容器服务提供的标准镜像制作自定义镜像。
请勿删除镜像中/usr/libexec/appctl和/lib/systemd/system/appctl.service 文件。
KCE支持使用自定义镜像做为集群节点的操作系统，为确保使用自定义镜像的云服务器、裸金属服务器能够顺利加入集群，KCE提供从组件依赖、系统配置、系统镜像等维度的检测工具，帮助您确定自定义镜像的可用性。
您在构建完成镜像后，可以使用如下命令进行镜像检查
wget https://kce-image-check.ks3-cn-beijing.ksyuncs.com/check.sh
chmod +x check.sh
./check.sh检查工具运行完成后，当日志显示Successed，说明镜像可以作为节点镜像使用，当日志显示Failed，说明镜像中存在问题，作为节点镜像使用时，可能会导致节点加入集群时失败。WARN类型日志可以忽略不进行处理，ERROR类型日志建议您按照相关提示信息进行处理。
检测模块 | 检测项 | 报错与建议 |
app-agent | 节点未安装appctl | [WARN] appctl component is not active, please check if the appctl component is installed. |
节点中appctl损坏 | [ERROR] Local file and server file version do not match,, local demon version: , server demon version: app-agent损坏，需要重新安装appctl | |
节点使用agent版本落后 | ||
kubelet | 节点内存在kubelet残留 | [ERROR] Kubelet should not exist, as it will affect the installation of the Kubernetes node, please manually uninstall kubelet 节点中建议不要提前安装kubelet，可能导致加入集群时产生冲突 |
节点上已存在kubelet | ||
GPU节点 | 节点上未安装nvidia-container-toolkit | [ERROR] missing CUDA driver, you can manually install the CUDA driver by following the instructions in the document: https://docs.ksyun.com/documents/2591?type=3 gpu镜像未安装cuda驱动，建议您按照文档指引安装cuda驱动 |
时区 | 节点时区是否同步 | [ERROR] System time differs from the NTP server time by more than five minutes, and the time is not synchronized. 系统时间与服务器时间时差大于五分钟，会导致加入集群时失败，建议您通过ntp服务与ntp.ksyun.cn同步，或者手动设置时间 |
域名 | DNS域名能否解析 | [ERROR] DNS issues, unable to resolve domain name: ${domainName}, please check the /etc/resolv.conf file and ensure that the domain name 'rpm.kce.sdns.ksyun.com' can be resolved 无法解析依赖域名，建议您检查dns配置，确定可以解析金山云域名 |
信息文件 | 节点是否缺少系统信息文件 | [ERROR] Mount point not found, cgroup might be corruptedcgroup 缺少基础挂载点可能损坏，会导致容器运行时存在问题，建议您重装系统 |
检测节点内文件内容格式是否准确 | ||
镜像 | 使用不支持的系统镜像 | [ERROR] unsupported system 当前系统不支持作为容器节点使用，详见获取容器服务支持的节点操作系统 |
cgroup异常 | [ERROR] Mount point not found, cgroup might be corruptedcgroup缺少基础挂载点可能损坏，会导致容器运行时存在问题，建议您重装系统 |
当自定义镜像如需修改DNS Server配置时，需要保留所在机房原有DNS配置，各个机房DNS Server地址如下：
region | DNS1 | DNS2 |
华北1（北京） | 198.18.254.30 | 198.18.254.31 |
华北金融1（北京） | 198.18.254.30 | 198.18.254.31 |
华东1（上海） | 198.18.254.40 | 198.18.254.41 |
华东金融1（上海） | 198.18.254.40 | 198.18.254.41 |
华北专属1区（天津-小米） | 198.18.254.30 | 198.18.254.31 |
华南1（广州） | 198.18.254.60 | 198.18.254.61 |
西北1区（庆阳） | 198.18.254.60 | 198.18.254.61 |
华东2（宁波） | 198.18.254.60 | 198.18.254.61 |
西北4（海东） | 198.18.254.60 | 198.18.254.61 |
新加坡 | 198.18.254.60 | 198.18.254.61 |
俄罗斯（莫斯科） | 198.18.254.60 | 198.18.254.61 |
纯净模式