# 更新节点池 #### 注意事项 - 仅v1.19及以上版本的集群支持修改容器运行时、操作系统、系统盘/数据盘大小、数据盘空间分配、安装前/后执行脚本配置。 - 修改节点池容器运行时、操作系统、安装前/后执行脚本时，修改后的配置仅对新增节点生效，存量节点如需同步配置，需要手动重置存量节点。 - 节点池配置修改后，部分参数的生效机制不同，您可以在修改后的规格确认环节进行确认。 #### 更新节点池 1. 登录[CCE控制台](https://console.huaweicloud.com/cce2.0/?#/cce/cluster/list)。 2. 单击集群名称进入集群，在左侧选择"节点管理"，在右侧选择"节点池"页签。 3. 单击节点池名称后的"更新"，在弹出的"更新节点池"页面中配置参数。 **基础配置** 表1基础配置 | 参数 | 参数说明 | 更新生效机制 | |:---|:---|:---| | 节点池名称 | 自定义节点池名称。 说明： 修改节点池名称将同步修改节点标签，可能影响工作负载的节点亲和性调度策略，请及时同步调整工作负载相关调度配置。 | - | | 企业项目 | 该参数仅对开通企业项目的企业客户账号显示。 选择某个企业项目后，节点池下的节点将会创建在该企业项目下。您可以通过企业项目管理集群及其他资源（节点、ELB、以及节点的安全组等）。了解更多企业项目相关信息，请查看[企业管理](https://support.huaweicloud.com/usermanual-em/zh-cn_topic_0123692049.html)。 | 仅对新增节点自动生效 | **节点配置** 表2节点配置参数 | 参数 | 参数说明 | 更新生效机制 | |:---|:---|:---| | 节点规格 | 请根据业务需求选择相应的节点规格。 说明： - 节点池同时配置多个节点规格时，同一节点池仅支持同类型节点规格（可位于不同可用区）。例如，选择"通用计算增强型"的节点池只支持选择该类型下的规格，不支持选择"通用计算型"等其他类型的规格。 - 同一节点池仅支持添加相同GPU/NPU显卡类型的节点规格。例如，选择"nvidia-v100"显卡类型的规格后，不能同时选择"nvidia-t4"等其他显卡类型的规格。 - 一个节点池最多可添加 20 种节点规格配置（每个可用区为一条配置）。添加同一个节点规格时，支持选择不同可用区。添加节点规格时需要明确指定可用区，不支持随机可用区。 - 节点池创建后，已存在节点的规格不可删除。 | 仅对新增节点自动生效 | | 容器运行时（原容器引擎） | CCE支持Docker和Containerd容器运行时，不同的集群类型、集群版本、操作系统可能导致支持的容器运行时类型不同，请根据控制台呈现进行选择。具体场景请参见[节点操作系统与容器运行时对应关系](https://support.huaweicloud.com/usermanual-cce/cce_10_0462.html#cce_10_0462__section159298451879)。 | 新增节点自动生效，存量节点需重置后生效 | | 操作系统 | 选择操作系统类型，不同类型节点支持的操作系统有所不同。 - 公共镜像：请选择节点对应的操作系统。 - 私有镜像：支持使用私有镜像，私有镜像制作方法具体请参见[制作CCE节点自定义镜像](https://support.huaweicloud.com/bestpractice-cce/cce_bestpractice_00026.html)。 - 共享镜像：可选择其他人已共享的私有镜像。裸金属服务器、物理机节点支持。 说明： 由于业务容器运行时共享节点的内核及底层调用，为保证兼容性，建议节点的操作系统选择与最终业务容器镜像相同或接近的Linux发行版本。 | 新增节点自动生效，存量节点需重置后生效 | | cgroup版本 | v1.31及以上版本的集群中，使用Ubuntu 22.04操作系统支持选择cgroup版本。 采用cgroup v2时，对于部分直接采集cgroup文件系统的软件，可能存在兼容性问题。详情请参见[将节点迁移到cgroup v2](https://support.huaweicloud.com/usermanual-cce/cce_10_1136.html)。 | 新增节点自动生效，存量节点需重置后生效 | | 安全加固 | 等保加固会对身份鉴别、访问控制、安全审计、入侵防范、恶意代码防范进行检查并加固。详情请参见[Huawei Cloud EulerOS 2.0等保2.0三级版镜像概述](https://support.huaweicloud.com/productdesc-hce/hce_sec_0001.html)。 集群版本为v1.23.12-r0、v1.25.7-r0、v1.27.4-r0、v1.28.2-r0及以上时支持该配置。 | 新增节点自动生效，存量节点需重置后生效 | | 编辑登录方式 | 选择是否编辑登录方式，开启后支持修改节点登录方式。 - **密码** 用户名默认为"root"，请输入登录节点的密码，并确认密码。 登录节点时需要使用该密码，请妥善管理密码，系统无法获取您设置的密码内容。 - **密钥对** 选择用于登录本节点的密钥对，其中私有密钥对仅限本用户使用，账户密钥对账户下其他用户也可使用。 密钥对用于远程登录节点时的身份认证。若没有密钥对，可单击选项框右侧的"创建密钥对"来新建，创建密钥对操作步骤请参见[创建密钥对](https://support.huaweicloud.com/usermanual-ecs/zh-cn_topic_0014250631.html)。 - **使用镜像密码** （当节点类型为弹性云服务器虚拟机或物理机，且操作系统选择私有镜像时支持） 保留所选择镜像的密码。为了保证您的正常使用，请确保所选择镜像中已经设置了密码。 | 新增节点自动生效，存量节点需重置后生效 | **存储配置** 表3存储配置参数 | 参数 | 参数说明 | 更新生效机制 | |:---|:---|:---| | 系统盘 | 节点云服务器使用的系统盘，供操作系统使用。您可以设置系统盘的规格为40GiB-1024GiB之间的数值，缺省值为50GiB。v1.28及以上版本集群的系统盘最小支持**20GiB** ，但节点OS镜像、安装升级下载的组件安装包、系统组件日志等资源将占用**15GiB** 系统盘容量，系统盘实际可用空间需减去上述资源占用量，系统盘过小可能影响节点运行稳定性，请关注磁盘剩余容量，建议配置[磁盘告警](https://support.huaweicloud.com/usermanual-cce/cce_10_0659.html)。 系统盘加密：系统盘加密功能可为您的数据提供强大的安全防护，加密磁盘生成的快照及通过这些快照创建的磁盘将自动继承加密功能。**仅"弹性云服务器-虚拟机"类型支持系统盘加密，且仅部分Region支持此选项，具体请以界面为准。** - 默认不加密。 - 点选"加密"后，可在弹出的"加密设置"对话框中，选择已有的密钥，若没有可选的密钥，请单击后方的链接创建新密钥，完成创建后单击刷新按钮。 | 系统盘规格修改：仅对新增节点自动生效 系统盘加密修改：新增节点自动生效，存量节点需重置后生效 | | 系统组件存储 | 选择系统组件的存储位置： - 数据盘：必须添加一块默认数据盘，供容器运行时和Kubelet组件使用，您可以自行设置数据盘的规格为20GiB-32768GiB之间的数值，缺省值为100GiB。该数据盘不能被卸载，否则会导致节点不可用。 - 系统盘：CCE将下载的镜像、容器的临时存储、容器的stdout标准输出日志等资源都存储在系统盘中，过多占用系统盘可能影响节点运行稳定性。 说明： - v1.23.18-r0、v1.25.13-r0、v1.27.10-r0、v1.28.8-r0、v1.29.4-r0及以上版本的集群中支持选择系统组件的存储位置，且配套使用[CCE节点故障检测](https://support.huaweicloud.com/usermanual-cce/cce_10_0132.html)插件时需安装1.19.2及以上版本的插件。 - 已设置自定义Pod容器空间（basesize）的节点池不支持更新"系统组件存储"配置为"系统盘"。 | 新增节点自动生效，存量节点需重置后生效 | | 数据盘 | - 如果"系统组件存储"选择"数据盘"，**至少需要添加一块默认数据盘** ，供容器运行时和Kubelet组件使用，**该数据盘不能被卸载，否则会导致节点不可用。** - 默认数据盘：供容器运行时和Kubelet组件使用。您可以自行设置数据盘的规格为20GiB-32768GiB之间的数值，缺省值为100GiB。 - 其他普通数据盘，您可以设置数据盘的规格为10GiB-32768GiB之间的数值，缺省值为100GiB。 - 如果"系统组件存储"选择"系统盘"，则可以不添加默认数据盘。所有数据盘均为普通数据盘，您可以设置数据盘的规格为10GiB-32768GiB之间的数值，缺省值为100GiB。 **高级配置** 单击后方的"展开高级配置"可进行如下设置： - 数据盘空间分配：对数据盘上存在的容器运行时、镜像、临时存储等进行空间划分，避免因磁盘空间不足导致业务异常。数据盘空间分配详细说明请参见[默认数据盘空间分配说明](https://support.huaweicloud.com/usermanual-cce/cce_10_0341.html)。 - 加密：数据盘加密功能可为您的数据提供强大的安全防护，加密磁盘生成的快照及通过这些快照创建的磁盘将自动继承加密功能。**"**裸金属服务器**"类型节点不支持数据盘加密，且仅部分Region支持此选项，具体请以界面为准。** - 默认不加密。 - 点选"加密"后，可在弹出的"加密设置"对话框中，选择已有的密钥，若没有可选的密钥，请单击后方的链接创建新密钥，完成创建后单击刷新按钮。 **增加数据盘** 除默认数据盘外的普通数据盘挂载时默认情况直接创建为裸盘，不做任何处理。节点可挂载的数据盘数量因节点规格而异，请以控制台实际提示为准。 您也可以展开高级配置，选择如下配置。 - 默认：默认情况直接创建为裸盘，不做任何处理。 - 挂载到指定目录：将数据盘挂载到指定目录。 - 作为持久存储卷：适用于对PV有性能要求的场景。持久存储卷的节点会添加上node.kubernetes.io/local-storage-persistent标签，取值为linear或striped。 - 作为临时存储卷：适用于对EmptyDir有性能要求的场景。 其中[持久存储卷](https://support.huaweicloud.com/usermanual-cce/cce_10_0391.html)和[临时存储卷](https://support.huaweicloud.com/usermanual-cce/cce_10_0726.html)支持如下两种写入模式。 - 线性（linear）：线性逻辑卷是将一个或多个物理卷整合为一个逻辑卷，实际写入数据时会先往一个基本物理卷上写入，当存储空间占满时再往另一个基本物理卷写入。 - 条带化（striped）：创建逻辑卷时指定条带化，当实际写入数据时会将连续数据分成大小相同的块，然后依次存储在多个物理卷上，实现数据的并发读写从而提高读写性能。条带化模式的存储池不支持扩容。多块存储卷才能选择条带化。 说明： - 本地持久卷仅在集群版本 \>= v1.21.2-r0 时支持，且需要everest插件版本\>=2.1.23。 - 本地临时卷仅在集群版本 \>= v1.21.2-r0 时支持，且需要everest插件版本\>=1.2.29。 **本地盘说明** 节点规格为"磁盘增强型"或"超高I/O型"时，有一块数据盘可以是本地盘。 本地磁盘实例有宕机风险，不保证数据可靠性，建议您使用云硬盘存储您的业务数据。 | 仅对新增节点自动生效 | **网络配置** 表4网络配置参数 | 参数 | 参数说明 | 更新生效机制 | |:---|:---|:---| | 虚拟私有云 | 默认为集群所在VPC，不可修改。 | - | | 节点子网 | 节点子网默认使用创建集群时的子网配置，也可以选择其他子网。 - 多个子网：可选择同一VPC下的多个子网作为节点可用网段，扩容节点会优先消耗排序靠前的子网IP资源。 - 单个子网：当节点池关联的单个子网IP资源较为紧张时，推荐配置多个子网，否则可能会出现节点池扩容失败的问题。 | 仅对新增节点自动生效 | | 弹性公网IP | 未绑定弹性公网IP的云服务器无法直接访问外网。若需要进行外网访问，您可以为云服务器绑定一个弹性公网IP。 默认为"暂不使用"，如果选择"自动创建"，则需选择以下参数： - 线路： - 全动态BGP：可根据设定的寻路协议第一时间自动优化网络结构，以保持客户使用的网络持续稳定、高效。 - 静态BGP：网络结构发生变化，运营商无法在第一时间自动调整网络设置以保障用户的体验度。 - 公网带宽： - 按带宽计费：独享带宽，按照购买的带宽大小计费。 - 按流量计费：独享带宽，按照实际使用的流量来计费。 - 带宽大小：请根据业务需要，选择所需的带宽大小，单位Mbit/s。 | 仅对新增节点自动生效 | **支付配置** 表5支付配置参数 | 参数 | 参数说明 | 更新生效机制 | |:---|:---|:---| | 自动支付 | 开启自动支付后，每次节点池扩容包年/包月节点时，系统将自动处理订单并收取费用。在这一过程中，系统会自动应用您名下可用的折扣，并按照既定的顺序进行扣款。具体扣款顺序和规则，请参见[自动支付](https://support.huaweicloud.com/usermanual-billing/isautopay_topic_1000001.html)。 | 仅对新增节点自动生效 | **高级配置** 表6高级配置 | 参数 | 参数说明 | 更新生效机制 | |:---|:---|:---| | 资源标签 | 通过为资源添加标签，可以对资源进行自定义标记，实现资源的分类。 您可以在TMS中创建"预定义标签"，预定义标签对所有支持标签功能的服务资源可见，通过使用预定义标签可以提升标签创建和迁移效率。具体请参见[创建预定义标签](https://support.huaweicloud.com/usermanual-tms/zh-cn_topic_0144368884.html)。 CCE服务会自动帮您创建CCE-Dynamic-Provisioning-Node=节点id的标签。 | 对新增的节点自动生效，存量节点会根据"存量节点标签及污点"开关状态决定是否同步更新。 | | K8S标签（Labels） | 设置附加到Kubernetes对象（比如Pod）上的键值对，填写键值对后，单击"确认添加"。最多可以添加20条标签。 使用该标签可区分不同节点，可结合工作负载的亲和能力实现容器Pod调度到指定节点的功能。详细请参见[Labels and Selectors](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/)。 | 对新增的节点自动生效，存量节点会根据"存量节点标签及污点"开关状态决定是否同步更新。 | | K8S污点（Taints） | 默认为空。支持给节点加污点来设置反亲和性，每个节点最多配置20条污点，每条污点包含以下3个参数： - Key：必须以字母或数字开头和结尾，可以包含字母、数字、连字符、下划线和点，最长63个字符；另外可以使用DNS子域作为前缀。 - Value：必须以字母或数字开头和结尾，可以包含字母、数字、连字符、下划线和点，最长63个字符。 - Effect：只可选NoSchedule，PreferNoSchedule或NoExecute。 污点的使用请参见[管理节点污点](https://support.huaweicloud.com/usermanual-cce/cce_10_0352.html)。 | 对新增的节点自动生效，存量节点会根据"存量节点标签及污点"开关状态决定是否同步更新。 | | 存量节点标签及污点 | 勾选后，更新节点池的资源标签、K8s标签及污点时，会将节点池配置中的资源标签、K8s标签或污点修改同步至节点池中已有的节点。 说明： 节点池更新时，如果修改"同步资源标签"开关状态，需要注意如下事项： - 开关从"不同步"更改为"同步"时： - CCE会基于当前节点池的资源标签配置，对存量节点进行更新。如果用户已在ECS侧设置了与当前节点池的资源标签配置中同key值的资源标签，则该标签的value值将被刷新成节点池中的配置保持一致。 - 存量节点的资源标签同步需要一定的处理时间（通常为10分钟以内，与节点池的节点规模相关）。 - 请等待上一次资源标签同步完成之后，再下发同步资源标签的请求，否则可能会导致存量节点的资源标签不一致。 节点池更新时，如果修改"同步K8s标签"及"同步污点"开关状态，需要注意以下事项： - 开关状态从"同步"更改为"不同步"时，可能会出现节点池中的新旧节点标签或污点不一致的情况。当业务调度依赖节点标签或污点时，可能会出现调度失败或节点池弹性扩容能力失效。 - 开关状态从"不同步"更改为"同步"时： - 如果在未开启同步时用户**修改** 或**新增**了节点池配置中的标签或污点，重新开启同步后，配置会在一定时间内（一般为10分钟内）自动同步到存量节点上。 - 如果在未开启同步时用户**删除**了节点池配置中的标签或污点，重新开启同步后，需要前往节点列表界面手动删除节点已有的标签或污点。 - 如果在未开启同步时对**已有节点的污点手动修改key或effect**，在开启同步后，会在已有节点上增加一个全新的污点（key不同但value和effect相同或effect不同但key和value相同）。这是由于K8s污点原生逻辑使用key和effect作为一组匹配键值，即key或effect不同的污点会被认为是两个污点。 | 新增和存量节点自动生效 | | 新增节点调度策略 | 节点池中新增节点的默认调度策略。勾选"设置为不可调度"之后，该节点池新增的节点在创建完成之后均会被打上不可调度的标签。以方便用户在工作负载被调度到节点上之前，对节点进行一些操作。 定时开启调度时间：若设置定时开启调度功能，在超过自定义时间后，节点将会自动开启调度。 - 不设置：默认情况下，将不设置超时时间，此时节点需要您前往"节点管理"界面，手动选择节点开启调度，详情请参见[一键设置节点调度策略](https://support.huaweicloud.com/usermanual-cce/cce_10_0352.html#cce_10_0352__section184717137266)。 - 自定义：该参数可配置节点不可调度的默认超时时间，取值范围为0-99min。 说明： - 如果需要同时使用节点池的自动扩缩容能力，定时开启调度时间应小于15min。因为通过autoscaler扩容的节点如果处于不可调度状态超过15min，autoscaler会认为本次扩容失败，触发再次扩容。同时，原节点处于不可调度状态超过20min，节点将被列入缩容备选节点，被autoscaler缩容。 - 开启该开关后，节点池的创建/更新过程中，节点会被打上node.cloudprovider.kubernetes.io/uninitialized的污点。 | 新增节点自动生效，存量节点需重置后生效 | | 安装前执行脚本 | 请输入脚本命令，命令中不能包含中文字符。脚本命令会进行Base64转码。安装前/后执行脚本统一计算字符，转码后的字符总数不能超过10240。 脚本将在Kubernetes软件安装前执行，可能导致Kubernetes软件无法正常安装，需谨慎使用。 | 新增节点自动生效，存量节点需重置后生效 | | 安装后执行脚本 | 请输入脚本命令，命令中不能包含中文字符。脚本命令会进行Base64转码。安装前/后执行脚本统一计算字符，转码后的字符总数不能超过10240。 脚本将在Kubernetes软件安装后执行，不影响Kubernetes软件安装。安装后脚本执行期间，Pod可以正常调度，但如果脚本执行安装超时，会导致节点安装失败，这种情况下，您可以选择"勾选后，安装后执行脚本执行完成前节点不可调度"，避免将Pod调度到安装后脚本未执行完成的节点上。 注意： 请不要在安装后执行脚本中使用**reboot** 命令立即重启，如果需要重启，可以使用**shutdown -r 1**命令延迟1分钟重启。 | 新增节点自动生效，存量节点需重置后生效 | | 委托 | 当需要与其他账号共享云服务器资源，或者委托更专业的人或团队来代为管理时，租户管理员可以在统一身份认证服务创建委托并授予云服务器资源的管理权限。被委托方使用自己的用户登录系统后，切换到您的账号下管理资源，避免您将自己的安全凭证（密码）共享给其他账号，确保了您的账号安全。 如果您已创建了委托，可以通过单击下拉列表选择委托名称，获取相应权限。如果没有委托请单击右侧"新建委托"创建。更多关于委托的信息，请参见[委托其他账号管理资源](https://support.huaweicloud.com/usermanual-iam/iam_01_0054.html)。 | 仅对新增节点自动生效 | | 自定义节点名称前后缀 | 节点池下的节点名称自定义前后缀，支持配置前缀和后缀。配置完成之后，该节点池下的节点名称将带上配置的前后缀信息。例如前缀为prefix-，后缀为-suffix，那么最终该节点池下的节点名称为prefix-nodepoolName-五位随机数-suffix。 - 节点名称由三部分组成：前缀+节点池名称-五位随机字符+后缀，总长度不超过56个字符。 - 前缀和后缀支持小写字母、数字、点字符(.)及中划线(-)，点字符(.)前后必须为小写字母或数字，前缀需以小写字母开头，后缀结尾必须为小写字母或数字。 - 节点名称中不支持"."与特殊字符连用，例如".."、".-"、"-."。 - 仅v1.28.1、v1.27.3、v1.25.6、v1.23.11、v1.21.12及以上集群版本支持该特性。 | 仅对新增节点自动生效 | 4. 配置完成后，单击"确定"。 节点池参数更新后，前往"节点管理"页面，可查看节点池所属节点存在更新，可通过重置节点同步节点配置，与节点池配置保持一致。 ![](https://support.huaweicloud.com/usermanual-cce/zh-cn_image_0000001914450054.png "点击放大") #### 后续操作 在节点池配置更新后，节点池中的已有节点无法自动同步部分配置，您可以手动同步节点配置。详情请参见[同步节点池](https://support.huaweicloud.com/usermanual-cce/cce_10_0654.html)。