本文主要介绍节点Python命令检查。 检查项内容 检查Node节点中Python命令是否可用。 检查方式 /usr/bin/python version echo $? 如果回显值不为0证明检查失败。 解决方案 安装Python之后再进行升级。

本文主要介绍 节点CCEAgent版本检查。 检查项内容 检测当前节点的CCE包管理组件cceagent是否为最新版本。 解决方案 cceagent非最新版本时，自动更新失败，该问题通常由OBS地址失效或组件版本过低引起。 步骤 1 登录检查通过的 正常节点 ，获取cceagent配置文件路径，查看有效OBS地址。 cat ​ps aux grep cceagent grep v grep awk F 'f ''{print $2}'​ 配置文件内的OBS配置地址字段为packageFrom.addr 步骤 2 登陆检查失败的 异常节点 ，参考上一步重新获取OBS地址，检查是否一致。若不一致，请将异常节点的OBS地址修改为正确地址。 步骤 3 通过以下命令下载最新的二进制文件。 x86系统 curl k " > /tmp/cceagent ARM系统 curl k " > /tmp/cceagentarm 步骤 4 替换原有的cceagent二进制文件。 x86系统 mv f /tmp/cceagent /usr/local/bin/cceagent chmod 750 /usr/local/bin/cceagent chown root:root /usr/local/bin/cceagent ARM系统 mv f /tmp/cceagentarm /usr/local/bin/cceagentarm chmod 750 /usr/local/bin/cceagentarm chown root:root /usr/local/bin/cceagentarm 步骤 5 重启cceagent服务。 systemctl restart cceagent 若您对上述执行过程有疑问，请联系技术支持人员。

本文主要介绍节点池检查 检查项内容 当前检查项包括以下内容： 检查节点池状态是否正常 检查节点池弹性伸缩能力是否关闭 解决方案 问题场景一：节点池状态异常 请登录CCE控制台，前往“集群信息>资源>节点管理>节点池”，查看问题节点池状态。若该节点池状态处于伸缩中，请等待节点池伸缩完毕，并参考问题场景二关闭节点池弹性伸缩能力。 问题场景二：节点池弹性伸缩能力未关闭 解决方案一（推荐） 请登录CCE控制台，前往“集群信息>运维>插件管理>autoscaler插件”处，卸载该插件。 、 说明 卸载autoscaler插件前，请单击“升级”按钮，备份当前插件配置，便于重装时还原插件配置。 卸载autoscaler插件前，请进入“运维>节点伸缩页面”，备份当前伸缩策略，便于重装时还原节点伸缩策略，这些策略会随autoscaler插件卸载而清除。 节点伸缩策略：通过编辑按钮获取并备份 解决方案二 若您并不希望卸载autoscaler插件，请登录CCE控制台，前往“集群信息>运维>节点管理>节点池”，单击对应节点池的“编辑”按钮，关闭弹性伸缩功能。 说明 关闭弹性伸缩时，请备份当前节点池弹性伸缩配置，便于开启时还原配置。

本文主要介绍残留待迁移节点检查。 检查项内容 检查节点是否需要迁移。 解决方案 由1.13滚动升级而来的1.15集群，需要将所有节点迁移（重置或新建替换）后，才允许再次进行升级。 解决方案一 请登录CCE控制台，前往“集群信息>资源>节点管理”，单击对应节点的“更多>重置节点”，详情请参见重置节点。节点重置完毕后，重试检查任务。 重置节点会重置所有节点标签，可能影响工作负载调度，请在重置节点前检查并保留您手动为该节点打上的标签。 解决方案二 新建节点后，删除问题节点。

本文主要介绍黑名单检查 检查项内容 当前检查用户是否处于升级黑名单列表中。 解决方案 CCE基于以下几点原因暂时关闭该集群升级功能： 基于客户提供的信息，该集群被识别为核心重点保障生产集群 正在或即将进行提高集群稳定性的其他运维任务，例如Master节点3AZ改造等。 请联系技术支持人员了解限制原因并申请解除升级限制。

本文主要介绍 通过kubectl连接集群。 操作场景 本文将以CCE集群为例，介绍如何通过kubectl连接CCE集群。 权限说明 kubectl访问CCE集群是通过集群上生成的配置文件（kubeconfig.json）进行认证，kubeconfig.json文件内包含用户信息，CCE根据用户信息的权限判断kubectl有权限访问哪些Kubernetes资源。即哪个用户获取的kubeconfig.json文件，kubeconfig.json就拥有哪个用户的信息，这样使用kubectl访问时就拥有这个用户的权限。 使用kubectl连接集群 若您需要从客户端计算机连接到kubernetes集群，可使用kubernetes命令行客户端kubectl，您可登录CCE控制台，单击待连接集群名称，在“集群信息”页面查看访问地址以及kubectl的连接步骤，如下图所示。 CCE支持“VPC网络内访问”和“互联网访问”两种方式访问集群。 VPC网络内访问：即通过内网地址访问，访问集群的客户端机器需要位于集群所在的同一VPC内。 互联网访问：即通过公网地址访问，访问集群的客户端机器需要具备访问公网的能力，并为集群绑定公网地址。 注意 通过“互联网访问”方式访问集群，您需要在集群信息页中的“连接信息”版块为集群绑定公网地址。绑定公网集群的kubeapiserver将会暴露到互联网，存在被攻击的风险，请谨慎开放该能力。 图 集群连接信息 您需要先下载kubectl以及配置文件，拷贝到您的客户端机器，完成配置后，即可以访问kubernetes集群。使用kubectl连接集群的步骤如下：

本文主要介绍规格变更。 详细信息请参见 变更集群规格

本节主要介绍按需计费。 先使用后付费的方式，从“开通”资源开启计费到“删除”资源结束计费，按用户实际购买时长计费。这种购买方式比较灵活，您可以按需取用资源，随时开启和释放，无需提前购买大量资源。 关于CCE集群休眠或节点关机后的收费说明： 集群休眠 ：集群休眠后，控制节点资源费用将停止收费。 节点关机： 集群休眠后，集群中的工作节点（如云主机、物理机）并不会自动关机，节点关机后不再收费。如需节点关机请登录云主机控制台进行操作。 （1）预存后付费方式：提前充值现金到天翼云账户中，现金账户余额不低于100元，之后系统按照用户实际使用量进行结算。 （2）计费周期：按小时计费，以自然小时为计费单位（均以北京时间为准），不满一小时按照一小时计费。费用从用户账户现金余额中扣费。开通时间建议整点开通，开通不足一个自然小时，按一小时收费。提前删除也按照自然小时收费。

本节主要介绍退订。 请参考“用户指南”>“集群管理 > 删除集群”

参数 是否必填 参数类型 说明 示例 下级对象 imageCacheName 是 String 镜像缓存名字 test imageCacheSize 否 Integer 镜像缓存大小 ,默认为20G 20 retentionDays 否 Integer 镜像缓存保留时间（单位天），不传或传0表示永不过期 ，最大值3650 30 tags 否 Array of Objects 标签 tag securityGroupId 是 String 安全组ID sgtest vSwitchId 是 String 子网ID subnettest azInfo 是 Object 可用区 azInfo imageRegistryCredentials 否 Array of Objects 不带 http:// 或 https:// 前缀的镜像仓库地址 imageRegistryCredential images 是 Array of Strings 镜像列表 ["registryvpccrshuadong1.ctyun.cn/xeci/base:latest"] eip 否 Object 弹性公网 IP。如果需要拉取公网镜像，需要确保 ECI 实例能够访问公网，您可以配置 EIP 或者 NAT 网关实现公网访问。 eip vpcId 是 String 实例所在VpcId vpcctt6yag121 表 tag

参数 是否必填 参数类型 说明 示例 下级对象 eipInstanceId 否 String eip 实例ID eipxxxxxxxx autoCreateEip 否 Boolean 自动创建 eip false eipBandwidth 否 Integer eip 带宽 1 表 dataSource

本文介绍如何指定ECS规格创建实例。 用户可以根据业务需要指定ECS规格来创建一个ECI Pod，配置参考如下： shell apiVersion: apps/v1 kind: Deployment metadata: name: nginxdeployment labels: app: nginx spec: replicas: 1 selector: matchLabels: app: nginx template: metadata: annotations: k8s.ctyun.cn/eciusespecs: s7.xlarge.2 指定ECS规格 labels: app: nginx spec: containers: name: nginx image: registryhuadong1.crsinternal.ctyun.cn/opensource/nginx:1.25alpine ports: containerPort: 80 nodeName: vndu53cymkxxxxcnhuadong1jsnj1apublicctcloud

使用方式 配置项 示例值 说明 指定镜像缓存 k8s.ctyun.cn/eciimcid imcdfaexxxxx 明确指定使用某个镜像缓存创建Pod

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 地域Id bb9fdb42056f11eda1610242ac110002

参数 是否必填 参数类型 说明 示例 下级对象 vpcId 是 String 虚拟节点所在Vpc ID vpcctt6yag121 vSwitchId 是 String 虚拟节点所在的子网ID subnety9n723knrg securityGroupId 是 String 虚拟节点所在的安全组ID sg5bvqyvrmch azInfo 是 Array of Objects 区域信息 azInfo virtualNodeName 否 String 虚拟节点名称 test kubeConfig 是 String 虚拟节点要连接的 K8s 集群的 KubeConfig。需进行 Base64 编码 YXBpdmVyc2lvb tags 否 Array of Objects 标签 tag taints 否 Array of Objects 污点 taint 表 azInfo

使用方式 配置项 示例值 说明 指定镜像缓存 k8s.ctyun.cn/eciimcid imcdfaexxxxx 明确指定使用某个镜像缓存创建Pod

名称 类型 示例值 描述 UsageNanoCores Long 0 CPU在采样窗口内的使用量（纳秒） UsageCoreNanoSeconds Long 70769883 CPU历史使用总量 Load Long 0 最近10秒的平均负载情况 Limit Long 2000 CPU使用上限（CPU核数1000）

本文介绍如何进行身份管理。 为确保您的天翼云账号及云资源使用安全，如非必要都应避免直接使用天翼云账号（即主账号）来访问ECI。推荐的做法是使用IAM身份（即IAM用户）来访问ECI。 IAM用户 IAM用户需要由天翼云账号（即主账号）或拥有管理员权限的IAM用户来创建，且必须在获得授权后才能登录控制台或使用API访问天翼云账号下的资源。 对于IAM用户的使用，建议您： 使用天翼云账号创建一个IAM用户，并为IAM用户授予管理员权限，后续使用有管理员权限的IAM用户创建并管理其他IAM用户。 将人员用户和程序用户分离。 创建IAM用户时，支持设置控制台访问和OpenAPI调用访问两种访问方式。控制台用户使用账号密码访问云产品控制台，API用户使用访问密钥AK（AccessKey）调用API访问云资源。建议您将两个不同的使用场景分离，避免误操作导致服务受到影响。 按需为IAM用户分配最小权限。 最小权限是指授予用户执行某项任务所需的权限，不授予其他无需用到的权限。最小授权可以避免用户操作权限过大，提高数据安全性，减少因权限滥用导致的安全风险。 不要把IAM用户的AccessKey ID和AccessKey Secret保存在工程代码中，否则可能导致AK泄露，威胁您账号下所有资源的安全。 IAM用户相关操作 创建用户 查看用户详情 重置密码

本文介绍如何为ECI实例分配IPv6地址。 ECI实例同时支持IPv4和IPv6地址，相比IPv4，IPv6大大扩展了地址的可用空间。本文介绍如何为ECI实例分配一个IPv6地址。 背景信息 IPv4的应用范围虽广，但网络地址资源有限，制约了互联网的发展。IPv6不仅可以解决网络地址资源有限的问题，还可以解决多种接入设备连入互联网障碍的问题。 前提条件 1、已为ECI实例所属的VPC和子网开通IPv6网段功能。 2、指定vCPU和内存创建的ECI实例均支持配置IPv6地址。指定ECS规格创建ECI实例时，请先确保指定的ECS规格支持IPv6。 在满足以上条件后，会自动为创建的eci实例分配IPv6地址，可调用describeContainerGroup接口查看ipv6Address字段。 使用条件 需放开IPv6的安全组规则。放开IPV6的安全组规则后，ECI实例之间可以通过IPv6地址实现互相访问。

1、如果您当前在专属云节点中，比如当前在“贵州(Dec001)”，可以点击控制台上方右侧资源节点切换的下拉箭头选择【贵州】切换到公有云节点； 2、如果您当前在公有云节点中，比如当前在“贵州“，可以点击控制台上方右侧资源节点切换的下拉箭头选择专属云节点”贵州(Dec001)“切换到专属云节点。

本节介绍网络的用户指南:Ingress。 与Service的四层负载均衡不同，Ingress是反向代理的抽象，提供七层的HTTP和HTTPS协议转发，可使用域名和路径配置转发规则，例如通过访问路径将请求路由到不同的Service，以实现7层的负载均衡。 关于Ingress详细配置和管理，请参见Ingress管理。

本节介绍了命名空间的用户指南。 操作场景 查看集群的命名信息，并对节点进行资源配额以及删除或者新增命名空间。 前提条件 ● 您需要存在⼀个可用集群。若没有可⽤集群，请参照创建一个应用集群。 操作指引 新增或删除 点击 新增 按钮，新增⼀个命名空间。 按需配置即可。

本节介绍了节点标签的用户指南。 操作场景 查看和设置节点标签。 前提条件 在查看集群节点前，您需要存在⼀个可⽤集群。若没有可用集群，请参照订购集群 进⾏创建。 操作步骤 点击“ ...” 按钮，查看节点标签。 同时也可点击 设置标签 按钮，给节点配置上自定义标签。 添加完成后的标签，会在 标签列表 这个tab页展示出来，并可以进行删除操作。

本节介绍了:集群基本信息 操作场景 查看集群的物理部署信息以及其他访问信息或者绑定弹性IP对外提供服务。 前提条件 ● 在查看集群信息前，您需要存在⼀个可用集群。若没有可用集群，请参照订购集群 进⾏创建。 ● 如果需要绑定弹性IP（EIP），您需要确保已经购买弹性IP。 操作步骤 1、点击绑定EIP 。 2、下拉选择需要绑定的EIP，点击确认 。

返回DeepSeek专题导航。

本节介绍了:集群资源。 操作场景 查询集群的VPC和安全组信息。 前提条件 在查看集群信息前，您需要存在⼀个可用集群。若没有可⽤集群，请参照 快速入门​>​>创建一个集群 内容进行创建。

本节介绍了任务的用户指南。 基本概念 普通任务：即kubernetes中的“Job”，普通任务是一次性运行的短任务，部署完成后即可执行。使用场景为在创建工作负载前，执行普通任务，将镜像上传至镜像仓库。 操作场景 普通任务是一次性运行的短任务，部署完成后即可执行。正常退出（exit 0）后，任务即执行完成。 普通任务是用来控制批处理型任务的资源对象。批处理业务与长期伺服业务（Deployment、Statefulset）的主要区别是： 批处理业务的运行有头有尾，而长期伺服业务在用户不停止的情况下永远运行。Job管理的Pod根据用户的设置把任务成功完成就自动退出了。成功完成的标志根据不同的spec.completions策略而不同，即： 单Pod型任务有一个Pod成功就标志完成。 定数成功型任务保证有N个任务全部成功。 工作队列型任务根据应用确认的全局成功而标志成功。 前提条件 在创建任务前，您需要存在一个可用集群。若没有可用集群，请参照集群开通中内容创建。 操作步骤及说明 创建Job与创建Deployment的过程类似，但存在以下的差异，需要注意： Job参数：相比于Deployment，Job多了这部分参数设置： 高级设置升级方式：Job不支持更新，因此没有升级方式这个参数。

本节介绍了守护进程的用户指南。 基本概念 创建守护进程集：即kubernetes中的“DaemonSet”，守护进程集确保全部（或者某些）节点都运行一个Pod实例，支持实例动态添加到新节点，适用于实例在每个节点上都需要运行的场景，如ceph、fluentd、Prometheus Node Exporter等。 操作场景 守护进程集（DaemonSet）可以确保全部（或者某些）节点上仅运行一个Pod实例，当有节点加入集群时，也会为他们新增一个 Pod。当有节点从集群移除时，这些Pod也会被回收。删除 DaemonSet 将会删除它创建的所有Pod。 使用DaemonSet的一些典型用法： 运行集群存储daemon，例如在每个节点上运行glusterd、ceph。 在每个节点上运行日志收集daemon，例如fluentd、logstash。 在每个节点上运行监控daemon，例如Prometheus Node Exporter、collectd、Datadog代理、New Relic代理，或Ganglia gmond。 一种简单的用法是为每种类型的守护进程在所有的节点上都启动一个DaemonSet。一个稍微复杂的用法是为同一种守护进程部署多个DaemonSet；每个具有不同的标志， 并且对不同硬件类型具有不同的内存、CPU要求。 前提条件 在创建守护进程集前，您需要存在一个可用集群。若没有可用集群，请参照集群开通中内容创建。 操作步骤及说明 创建DaemonSet与创建Deployment的过程类似，仅升级方式有差异，需要注意： 删除升级（不推荐这种升级方式）：如果设置DaemonSet的升级方式为删除升级，那么我们全量替换升级DaemonSet时，全量替换更新的内容在我们重新部署Pods前是不会生效的。 滚动升级：如果设置DaemonSet的升级方式为滚动升级，那么我们全量替换升级DaemonSet时，k8s会自动帮我们删除重建DaemonSet的每一个Pod，此时有一个可选的参数MaxUnavailable。MaxUnavailable：设置升级过程中最多有多少个Pod处于不可用状态，默认值为1。

本节介绍了:Ingress常见错误信息及故障排查方法的用户指南。 常见错误信息 在 Kubernetes Ingress 的使用过程中，可能会遇到以下几种错误信息： "default backend 404" 这个错误通常表示请求的路径没有匹配到任何 Ingress 规则，并且没有配置默认的后端服务。你需要检查你的 Ingress 资源的路径规则或添加一个默认后端。 "No endpoints available for service" 这个错误表示请求的服务没有可用的 endpoints，这可能是因为该服务的 Pods 都不可用或者不存在。你需要检查服务对应的 Pods 的状态。 "Unable to find backend: ServiceName" 这个错误表示 Ingress 控制器无法找到你在 Ingress 规则中指定的后端服务。你需要检查你的服务是否存在，以及其名称是否拼写正确。 "Error retrieving endpoints for the service: ServiceName" 这个错误表示 Ingress 控制器无法获取服务的 endpoints，可能是因为网络问题或 Kubernetes API 服务器的问题。 "Invalid Certificate" 这个错误表示客户端无法验证服务器的 SSL/TLS 证书。你需要检查你的证书是否有效，以及是否正确安装。 "Certificate not trusted" 这个错误表示客户端不信任服务器的 SSL/TLS 证书。你需要确保你的证书是由一个受信任的证书颁发机构（CA）颁发的。 "Timeout" 或 "Connection Refused" 这些错误通常表示网络问题，例如 Ingress 控制器无法与后端服务或 Pods 建立连接。你需要检查你的网络配置和防火墙规则。 "503 Service Unavailable" 这个错误表示后端服务无法处理请求。这可能是因为服务的 Pods 都不可用，或者 Pods 无法正确处理请求。 常见故障排查方法 在 Kubernetes Ingress 的使用过程中，有多种故障排查方法可以帮助你识别和解决问题： 查看 Ingress 资源的状态 使用 kubectl describe ingress 命令查看 Ingress 资源的状态。这可以帮助你查看 Ingress 的配置和状态，以及任何可能的错误信息。 查看 Ingress 控制器的日志 使用 kubectl logs 命令查看 Ingress 控制器的日志。这可以帮助你查看 Ingress 控制器的运行状态，以及任何可能的错误信息。 查看后端服务和 Pods 的状态 使用 kubectl describe service 和 kubectl describe pod 命令查看后端服务和 Pods 的状态。这可以帮助你查看服务和 Pods 的运行状态，以及任何可能的错误信息。 查看网络配置和状态 检查Ingress 控制器和后端服务的网络配置，包括网络策略、防火墙规则等。使用网络诊断工具，例如 ping、traceroute或 netcat，检查网络连通性。 验证 DNS 配置 确保你的 DNS 记录正确，将主机名解析到正确的 Ingress 控制器的 IP 地址。 检查 SSL/TLS 证书 如果你在使用 HTTPS，确保你的 SSL/TLS 证书有效，已经正确安装，且是由一个受信任的证书颁发机构（CA）颁发的。 使用Kubernetes 集群诊断工具 Kubernetes 提供了许多用于故障排查的工具，例如 kubectl describe、kubectl logs、kubectl get、kubectl debug 等命令，以及更高级的工具，例如 kubectl clusterinfo dump。

本节介绍网络的用户指南:服务发现DNS概述。 创建集群时会自动安装CoreDNS插件，用来提供集群内部域名解析。在kubesystem命名空间下，可以查看到CoreDNS相关Pod： kubectl nkubesystem get po l k8sappkubedns NAME READY STATUS RESTARTS AGE coredns84f6584c855rmgq 1/1 Running 0 41h coredns84f6584c85rs4n6 1/1 Running 0 41h 作为集群内部DNS服务器，CoreDNS会将Service域名与Service的IP记录起来，Pod可以向CoreDNS查询Service域名获取对应IP地址。Pod访问的Service域名格式为..svc.，其中为Service名称，为命名空间名称，为集群内部域名，默认为cluster.local。若客户端和服务端在同一个命名空间下，可通过直接访问。建议在集群内部使用Service域名访问Pod，无需感知具体Service地址。 默认情况下，会将Coredns Service的地址作为域名解析服务地址写在Pod的/etc/resolv.conf kubectl nkubesystem get svc kubedns NAME TYPE CLUSTERIP EXTERNALIP PORT(S) AGE kubedns ClusterIP 10.96.0.10 53/UDP,53/TCP,9153/TCP 9d kubectl exec it nginxdemo748fb499d78f2t5 cat /etc/resolv.conf search default.svc.cluster.local svc.cluster.local cluster.local nameserver 10.96.0.10 options ndots:5 Pod内通过Service域名访问后端Pod的DNS解析过程，如下图所示：

返回DeepSeek专题导航。

本节介绍网络的用户指南:Service。 Service可为一个或一组Pod提供固定的IP地址，并为这些Pod做负载均衡。 Service支持如下类型： 1. ClusterIP：Service默认类型，用于集群内应用间访问，客户端可通过ClusterIP或内部Service域名访问后端Pod； 2. NodePort：用于集群外部访问集群内服务，将Service通过集群节点固定端口暴露，集群外部可通过任一集群节点IP和该固定端口来访问Serivce； 3. LoadBalancer：用于集群外部访问集群内服务，通过LoadBalancer实例访问NodePort或直通Pod，相对于NodePort方式，有更高的可用性和性能； 4. Headless：该类Service没有IP地址，可用于DNS负载均衡场景，客户端访问Service域名时会通过DNS返回该Service所有后端Pod的IP地址； 5. ExternalName：将集群外部域名映射到集群内部Service上，使得集群内可通过Service名访问外部域名。 关于Service详细配置和管理，请详见Service管理