QingCloud 文档 – 集群管理 - kaiyun官方网站下载手机网页

Container: 配置参数

Mon, 01 Jan 0001 00:00:00 +0000

QKE 支持自定义部分参数的值，您可以根据自己的业务情况对集群运行参数进行调整。

操作步骤

登录 QingCloud 管理控制台。
在控制台顶部的导航菜单中，选择产品与服务 > 容器服务 > 容器引擎 QKE，进入 QKE 集群列表页面。
点击目标集群 ID 号，进入集群详情页面。
在页面右侧区域，点击配置参数页签。

页面显示当前版本所支持的所有参数配置项、参数描述及参数当前值。
点击修改属性，参数值变为可编辑状态。

说明

部分参数仅支持在创建集群时配置，此处不可修改，仅作为展示。
根据实际情况进行参数值修改。

详细说明请参见下述参数说明。
修改完成后，点击保存，弹出提示框。
确认无误后，点击确认。

参数说明

参数	描述	注意
API 密钥	QingCloud IaaS API 密钥 (https://console.qingcloud.com/access_keys/)，此密钥将被用来创建云平台的资源，比如负载均衡器、PV 挂盘等。	集群创建后无法修改。
安装 KubeSphere	选择是否安装 KubeSphere，默认为 true 表示安装 KubeSphere 以及监控组件。说明：安装 KubeSphere 后，其应用商店中的 App 仅限于体验、测试用途。公有云工单服务支持仅限于 App 部署，App 自身的业务可用性支持不在工单服务范围内。	集群创建后无法修改，请在创建集群前规划好集群用途。
选装组件	选装希望安装的组件。QKE 默认仅最小化安装 KubeSphere，此处勾选后将安装所选组件，各组件的功能说明可参考 KubeSphere 官方文档。说明：此选项只有在选项安装 KubeSphere 为 true 时才会生效。此选项只负责安装组件，清空此选项并不会执行卸载操作，如需卸载请手动操作。安装这些组件可能需要较长时间，请耐心等待。	-
KubeSphere 控制台 EIP	如果希望通过公网 LoadBalancer 方式访问 KubeSphere 控制台，可在此选择可用的 EIP，将为此 EIP 自动创建一个负载均衡器并绑定；如果没安装 KubeSphere，无需设置此参数	-
K8s apiserver EIP	如果希望通过公网访问 Kubernetes API Server，可在此处填写可用的 EIP，系统将会自动创建一个 LB 并绑定此 EIP。	集群创建后无法修改。
Kubernetes EIP 地址	Kubernetes 的外网访问地址，请按照 IPv4 格式填写，例如：`139.198.123.23`。该参数用于更新 Kubeconfig 文件中 `server` 的 IP 地址。	修改此项会重启所有主节点的 kube-apiserver 从而导致 kube-apiserver 服务短暂中断，建议在业务低谷时间操作。
Kubernetes EIP 端口	Kubernetes 的外网访问端口，默认是 6443 (范围: 1 - 65535)。该参数用于更新 Kubeconfig 文件中 `server` 的访问端口。	-
重命名 K8s 节点	true：表示使用易读的 Kubernetes 节点名，比如 master1（一号主节点），worker-p001（一号基础型工作节点），worker-s002（二号企业型工作节点）。 false：表示使用系统自动生成的随机节点名。	集群创建后无法修改。
Proxy Mode	选择一种 Proxy Mode（ipvs 或 iptables）。	集群创建后无法修改。
网卡插件	选择网卡插件（calico 或 flannel）。	集群创建后无法修改。
云服务器 hosts 记录	自定义添加到 `/etc/hosts` 文件的记录，多条记录用逗号分割。比如 `192.168.2.2 host1,192.168.2.3 host2`。	-
registry-mirrors	完整的 Docker 镜像服务地址，比如 `https://mirror.harbor.local`，多个地址之间用空格分隔。	-
insecure-registries	需要通过非安全的 HTTP 或不受信任的 HTTPS 访问的 Docker 仓库，比如 `mirror.harbor.local`，多个地址通过空格分隔。	-
Docker 网桥地址	Docker 网桥的 IP 地址和子网掩码，请按照标准的 CIDR 格式填写。默认为 `172.30.0.1/16`。	修改此项需要通过集群菜单依次重启所有 Kubernetes 节点（包括主节点、基础型节点、企业型节点和 GPU 节点），请在业务低谷时操作。
Docker 清理天数	每天凌晨 2 点 35 分自动清理指定天数之前创建的 Docker 容器、镜像、网络等闲置资源。默认为 `3` 表示只清理创建时间超过 3 天（72 小时）的闲置资源；`0` 表示不自动清理 (范围: 0 - 30)。	-
Pod 网段	Pod 网段，请按照标准的 CIDR 格式填写。例如：`10.10.0.0/16`。	集群创建后无法修改。
Service 网段	Service 网段，请按照标准的 CIDR 格式填写。例如：`10.96.0.0/16`。	集群创建后无法修改。
集群内 DNS 域名	集群内的 DNS 域名，用于 Kubernetes Services。	集群创建后无法修改。
NodePort 范围	每个节点可分配的 NodePort 范围，例如 ‘30000-32767’。	集群创建后无法修改。
最大 pod 数量	每个节点上可运行的最大 pod 数量，默认为 120。	-
Kubernetes 日志级别	Kubernetes 的日志级别，范围: 0 - 10，数字越大记录越详细，也会占用更多日志空间。	修改此项会重启所有 Kubernetes 组件（kube-apiserver、kube-controller-manager、kube-scheduler、kube-proxy）从而导致服务短暂中断，建议在业务低谷时间操作。
日志保留天数	KubeSphere 使用 ElasticSearch 存储日志，可通过配置此参数自动清理指定天数之前的日志，范围: 0 - 30，0 表示不自动清理。	集群创建后无法修改。
audit-policy	设置审计规则文件路径。路径为空或文件不存在则不记录审计日志。可通过客户端节点登录到所有主节点并把规则文件放到 `/etc/kubernetes/audit/policies/` 目录下；系统已内置默认审计规则文件 `/etc/kubernetes/audit/policies/default.yaml`。	修改此项会重启所有主节点的 kube-apiserver 从而导致 kube-apiserver 服务短暂中断，建议在业务低谷时间操作
audit-webhook	设置 Webhook 配置文件的路径。Webhook 配置文件使用 kubeconfig 格式指定服务的远程地址和用于连接它的凭据。留空此项表示把日志存储在主节点本地目录 `/etc/kubernetes/audit/logs/` 下。	-
audit-log-maxage	自动清理指定天数之前产生的审计日志文件，范围: 0 - 30。默认为 `7`, 表示自动清理创建时间超过 7 天的审计日志文件，	修改此项会重启所有主节点的 kube-apiserver 从而导致 kube-apiserver 服务短暂中断，建议在业务低谷时间操作。
audit-log-maxsize	自动轮转达到指定文件大小的审计日志文件，以 MB 为单位，范围: 1 - 200。默认为 `1`, 表示当审计日志文件达到 1 MB 以后触发自动轮转。	修改此项会重启所有主节点的 kube-apiserver 从而导致 kube-apiserver 服务短暂中断，建议在业务低谷时间操作。
audit-log-maxbackup	最多保留指定数量的审计日志文件，范围: 1 - 100。默认为 `100` 表示最多保留最近的 100 个审计日志文件。	修改此项会重启所有主节点的 kube-apiserver 从而导致 kube-apiserver 服务短暂中断，建议在业务低谷时间操作。
kube-controller-manager 参数	kube-controller-manager 参数，自定义配置，支持多项配置，需严格遵循每行配置一项且保持 `key: value` 的格式。配置示例：`add-dir-header: \"true\"`，其他配置项请参考官网文档 kube-controller-manager configurations，使用时请去掉 `--` 符号。	-
kube-apiserver 参数	kube-apiserver 参数，自定义配置，支持多项配置，需严格遵循每行配置一项且保持 `key: value` 的格式。配置示例：`add-dir-header: \"true\"`，其他配置项请参考官网文档 kube-apiserver configurations，使用时请去掉 `--` 符号。	-
kube-scheduler 参数	kube-scheduler 参数，自定义配置，支持多项配置，需严格遵循每行配置一项且保持 `key: value` 的格式。配置示例：`add-dir-header: \"true\"`，其他配置项请参考官网文档 kube-scheduler configurations，使用时请去掉 `--` 符号。	-
kube-proxy iptables 参数	kube-proxy iptables 参数，自定义配置，支持多项配置，需严格遵循每行配置一项且保持 `key: value` 的格式。配置示例：`masqueradeAll: true`，其他配置项请参考 kube-proxy iptables configurations。	-
kubelet 参数	kubelet 参数，自定义配置，支持多项配置，需严格遵循每行配置一项且保持 `key=value` 的格式。配置示例：`--add-dir-header=true`，其他配置项请参考官方文档 kubelet configurations，使用时请保留 `--` 符号。	-
用户 SSH 公钥	用于通过 SSH 方式连接到集群节点。公钥以算法、密钥、注释（可省略）这三部分表示，三部分之间用空格隔开，如：`ssh-rsa AAAA… user@i-xxxw`。	-

Container: 启停集群

Mon, 01 Jan 0001 00:00:00 +0000

本小节主要介绍如何手动及自动进行 QKE 集群的启动及关闭操作。

操作场景

当您暂时不需要使用 QKE 集群时，你可以停用集群以释放所占用的资源，在需要继续使用时再启用即可。

注意事项

停用集群将导致集群连接中断，在集群未成功启动前，您无法对集群进行读写操作，若您的集群应用于生产环境，建议在业务低峰期操作。

关闭集群

登录 QingCloud 管理控制台。
在控制台顶部的导航菜单中，选择产品与服务 > 容器服务 > 容器引擎 QKE，进入 QKE 集群列表页面。
在集群列表，勾选需要停用的目标集群，点击关闭，弹出确认提示框。
确认信息无误后，点击确认，返回集群列表页面。

集群状态变为关闭中，待状态切换为已关闭，表示集群停用成功。

启动集群

登录 QingCloud 管理控制台。
在控制台顶部的导航菜单中，选择产品与服务 > 容器服务 > 容器引擎 QKE，进入 QKE 集群列表页面。
在集群列表，勾选需要启动的目标集群，点击更多操作 > 启动，弹出确认提示框。
确认信息无误后，点击确定，返回集群列表页面。

集群状态变为启动中，待状态切换为运行中，表示集群启动完成。

定时启停集群

您可以通过定时器功能，创建定时任务，实现定时启动或关闭集群的功能。

登录 QingCloud 管理控制台。
选择产品与服务 > 运维与管理 > 定时器，进入定时器列表页面。
创建定时器。
1. 点击创建，弹出定时器基本配置页面。
2. 配置定时器类型、周期（仅重复执行时）、时间、通知事件等信息。
3. 点击提交，返回定时器列表页面。
创建定时任务。

点击定时器 ID，进入详情页面。
1. 点击创建，弹出任务配置窗口。
2. 配置定时任务信息。
  
  任务类型选择开启集群或关闭集群，资源选择目标 QKE 集群。
3. 点击提交，返回定时器任务列表页面。
  
  配置完成后，集群将会在定时器指定时间点启动或关闭集群。

Container: 升级集群

Mon, 01 Jan 0001 00:00:00 +0000

您可以在控制台上一键升级 QKE 集群版本，从而体验更丰富的功能。

升级说明

目前不支持 v1.0.x 到 v3.0.x 的跨版本更新，需要先升级到 v2.0.x 再升级到 v3.0.x。
升级一般需要 12 小时，请耐心等待。

注意事项

由于升级过程需要消耗较多的磁盘 IO 以及 CPU，生产环境请在业务低谷期操作，升级过程中请避免部署新工作负载或者变更配置等操作。
客户端节点所有数据以及 Kubernetes 节点 /data 目录以外的数据会在重启后重置，如果有此类自定义的数据请先备份后再升级。
QKE v1.0.0 基于 Ubuntu 16.04 操作系统，在升级完成后，可能会在 KubeSphere 页面上遇到 CPU 使用率显示不正确的情况，这是由操作系统内核原因造成，需要在升级后根据业务情况关闭集群然后再开启集群来解决（此操作会把操作系统替换成 Ubuntu 18.04）。

前提条件

升级前请确保所有 Kubernetes 节点（包括主节点和工作节点）的 /data 数据盘至少有 50G 的可用空间。
请确保客户端节点处于开机运行状态。

操作步骤

登录 QingCloud 管理控制台。
在控制台顶部的导航菜单中，选择产品与服务 > 容器服务 > 容器引擎 QKE，进入 QKE 集群列表页面。
在集群列表，右键单击目标集群，选择升级。
选择需要升级的目标版本，下方对应显示版本特性。
点击升级，弹出提示信息框。
确认无误后，点击确认。

开始升级，集群节点状态变为更新中，等待所有节点状态变为活跃，则升级成功。

Container: 删除集群

Mon, 01 Jan 0001 00:00:00 +0000

本小节主要介绍如何删除集群。

注意

删除集群为危险操作，请谨慎操作。集群彻底删除后，将删除集群关联的所有资源。

约束限制

集群删除后，将在回收站中保留2个小时，这期间可以进行恢复操作。超过2小时，集群资源将被彻底销毁，不可恢复。
不支持删除正在执行操作的集群。
集群删除后，关联资源立即释放，请谨慎操作。如需保留数据信息，请确认完成数据备份再执行删除操作。

操作步骤

登录 QingCloud 管理控制台。
在控制台顶部的导航菜单中，选择产品与服务 > 容器服务 > 容器引擎 QKE，进入 QKE 集群列表页面。
勾选目标集群，点击操作栏更多操作 > 删除，弹出确认窗口。
勾选强制删除，点击确认，返回集群列表页面，集群状态变为删除中。

后续操作

集群删除后，可以前往产品与服务 > 运维与管理 > 回收站，查看已删除的集群。回收站的资源仅保留 2 小时，在这期间：

若您需要彻底删除，勾选已删除的集群，点击彻底删除，弹出提示框，点击确认。
若您想要恢复集群，勾选已删除的集群，点击恢复，弹出恢复资源窗口，查看恢复资源所需金额，确保账户余额中的金额大于欠费总金额后，点击提交。

集群永久删除后，您可手动删除 QKE 集群残留资源，如硬盘、负载均衡器、安全组。