TKE 标准集群指南

最佳实践

API 文档

诚邀爱技术、爱分享的你,成为文档内容共建者> HOT

操作场景

本文档介绍如何使用腾讯云容器服务(TKE)提供的基础镜像进行自定义镜像制作。

说明:

基础镜像包括 TKE 支持的公共镜像市场镜像,支持的镜像列表请参考 镜像概述

使用须知

  • 目前仅支持同类型的操作系统镜像的制作。例如,使用 CentOS 基础镜像制作 CentOS 类的自定义镜像。
  • 如果您使用自定义镜像功能,请使用 TKE 提供的基础镜像来制作自定义镜像。
  • 若 TKE 后期计划调整镜像逻辑,会提前至少一周通过站内信、短信、邮件的方式进行通知,请您放心使用。镜像逻辑变化可能会造成用原有自定义镜像新建节点失败,您需要重新制作自定义镜像。如集群有使用节点池,需调整节点池的镜像配置。
  • 如需使用自定义镜像功能,请 提交工单 申请。

注意事项

制作自定义镜像前,请务必仔细阅读以下注意事项。自定义镜像属于非标环境,腾讯云不提供官方支持以及持续维护。

  • 请勿随意修改/etc/fstab
  • 制作镜像之后请及时清理 /var/lib/cloud/instances/${instance-id} 目录。
  • 如果您在自定义镜像中预装了运行时组件,节点初始化无法正常进行,会直接报错。

操作步骤

本文以使用基础镜像创建云服务器(CVM)为例。

1. 创建 CVM

  1. 登录 云服务器控制台,选择新建进入云服务器购买页面。
  2. 在“镜像”中选择容器服务基础镜像,这里以公共镜像 TencentOS Server 3.1 为例。如下图所示:
  3. 其他选项设置请参考 新建 CVM 实例

2. 创建自定义镜像

  1. 请参考 使用标准登录方式登录 Linux 实例(推荐) 登录 CVM。
  2. 执行以下命令,新建 test.txt 文件。
    vi test.txt
  3. i 进入编辑模式,并写入以下内容。
    this is customer cvm images test
  4. Esc 并输入 :wq 退出并保存。
  5. 请参考 创建自定义镜像 完成创建。

3. 使用自定义镜像

自定义镜像制作完成后,即可使用该镜像创建 TKE 集群。

在“创建集群”页面的“镜像提供方”中选择自定义镜像,“操作系统”则选择已创建的自定义镜像。如下图所示:

其他选项设置请参考 创建集群

4. 验证自定义镜像

  1. 登录 TKE 控制台,选择左侧导航栏中的集群
  2. 选择使用自定义镜像创建的集群 ID,进入集群详情页。
  3. 选择左侧导航栏中的节点管理 > 节点,记录需要登录验证的节点 ID。
  4. 登录 云服务器控制台,在搜索框中输入记录的节点 ID 并单击,即可看到已创建的节点。如下图所示:
  5. 请参考 使用标准登录方式登录 Linux 实例(推荐),登录节点。
  6. 执行以下命令,验证自定义镜像。
    cat test.txt
    返回结果如下,则表示该节点已使用自定义镜像。

使用总结

  • 制作自定义镜像必须使用 TKE 提供的基础镜像,没有满足此要求的自定义的镜像在 TKE 控制台上不会显示。
  • 若在自定义镜像中对 /etc/resolv.conf 文件设置文件保护(chattr +i /etc/resolv.conf),则会导致 clount-init 失败。由于 TKE 依赖于 cloud-init 成功状态,最终会导致节点加入集群失败。
  • 由于 rc.localcontainer_cluster_agent 无法保证执行顺序,会导致用户 start_init.sh 脚本拷贝的数据丢失。不建议您把 start_init.sh 放在 rc.local 中执行,建议在 user-data 中执行。
  • 曾经制作过镜像的节点上如果保留了 /var/lib/cloud 目录,那么 /var/lib/cloud/instances/ins-1cgoe1y9/sem 目录下的 config_scripts_user 文件会影响 cloud-init 服务无法正常执行,会导致该节点加入 TKE 集群内时修改的节点主机名无法生效。
  • 在自定义镜像中添加个人 yum 源时,若放置在不合适的目录下(例如 /etc/yum.repo.d/),则会引起 container-cluster-agent 在执行 yum install 操作时报错,从而跳过该步骤,导致 agent 安装 yum 源失败。
目录