文档中心
文档
备案
控制台
登录
立即注册
导航
容器服务
搜索目录或文档标题
搜索目录或文档标题
产品动态
新功能发布记录
历史功能发布记录
历史功能发布记录（2023 年）
历史功能发布记录（2022 年）
产品公告
【产品变更】容器服务正式开放亚太东南（柔佛）地域
【产品变更】容器服务上报至云监控事件中心的云产品事件部分格式与字段变更
【产品变更】容器服务停止新建「性能型 SSD」云盘类型的存储
【集群版本】Kubernetes 1.20 版本集群停止维护公告
【产品变更】SLA 修改公告
【产品变更】容器服务停止支持新建 g2i、c2i、r2i、ebmg2i 规格族云服务器
【产品变更】容器日志键值索引字段变更说明
【产品变更】旧版本 API 迁移通知
【产品变更】容器服务停止支持新建 g1、c1、r1、i1 规格族云服务器
【产品变更】跨服务授权权限策略收敛公告
【产品变更】容器服务新增支持和适配部分 ECS 实例规格
【产品变更】容器服务正式开放华东 2 (上海) 地域
【产品变更】容器服务正式开放华南 1 (广州)地域
【产品变更】容器服务正式商业化公告
【产品变更】容器服务全量适配新规格的云服务器
【产品变更】容器服务调整「性能型SSD」云盘类型的存储为白名单功能
安全公告
Kubernetes 安全漏洞公告（CVE-2024-10220）
NVIDIA Container Toolkit 安全漏洞公告（CVE-2024-0132）
Ingress-nginx 插件安全漏洞公告（CVE-2024-7646）
Kubernetes 安全漏洞公告（CVE-2024-21626）
Kubernetes 安全漏洞公告（CVE-2020-8554）
Ingress-nginx 插件安全漏洞公告（CVE-2021-25745）
Ingress-nginx 插件安全漏洞公告（CVE-2021-25746）
Kubernetes 版本发布记录
容器服务发布 Kubernetes v1.28 版本说明
容器服务发布 Kubernetes v1.26 版本说明
容器服务发布 Kubernetes v1.24 版本说明
（停止维护）容器服务发布 Kubernetes v1.20 版本说明
Kubernetes 版本支持策略
组件发布记录
概述
网络组件
vpc-cni
flannel
ingress-nginx
rdma-device-plugin
存储组件
csi-ebs
csi-nas
csi-tos
csi-vepfs
csi-cloudfs
snapshot-controller
监控组件
log-collector
metrics-collector
prometheus-agent
prometheus-adapter
finops-kube-collector
finops-kube-recommender
node-problem-detector
metrics-server
调度组件
cluster-autoscaler
cronhpa
katalyst
vci-virtual-kubelet
descheduler
DNS 组件
node-local-dns
core-dns
安全组件
security-scan
application-inspector
镜像组件
cr-credential-controller
p2p-accelerator
image-accelerator
GPU 组件
mgpu
nvidia-device-plugin
产品简介
什么是容器服务
产品优势
产品功能
应用场景
地域和可用区
使用限制
高危操作及恢复方案
基本概念
原生 Kubernetes 名词对照
云服务依赖关系
CIS Kubernetes 基准支持状态
产品计费
快速入门
入门指引
准备工作
通过控制台使用容器服务
通过 kubectl 使用容器服务
通过应用模板快速部署应用
用户指南
使用须知
集群
集群概述
创建集群
创建无 ECS 节点集群
集群扩容
连接集群
弹性伸缩
删除集群
集群监控
升级集群
运维配置
集群基本信息
修改 API Server 子网
节点池
节点池概述
创建节点池
创建托管节点池
管理节点池
扩缩容节点池
弹性预约扩容
配置节点 kubelet 参数
节点检查自愈
节点
节点概述
新增节点
添加已有节点
管理节点
节点预留资源策略
节点的 Pod 调度密度计算说明
系统标签和污点
镜像
操作系统镜像概述
基于 Docker 制作自定义镜像
基于 ECS 制作自定义镜像
项目管理
命名空间
命名空间概述
创建命名空间
设置资源配额
设置资源限制
管理命名空间
网络
网络概述
集群网络
集群子网扩展
安全组设置
集群访问规则
API Server 访问控制
容器网络
为 Pod 绑定独立 EIP
为 Pod 配置固定 IP
基于 Trunk ENI 支持 Pod 独占弹性网卡
使用 NetworkPolicy 进行网络访问控制
服务（Service）
服务概述
集群内访问（ClusterIP）
节点端口访问（NodePort）
负载均衡（LoadBalancer）
负载均衡服务概述
负载均衡服务使用注意事项
通过控制台创建负载均衡服务
通过 kubectl 创建负载均衡服务
使用 Annotation 配置负载均衡服务
管理服务
路由（Ingress）
路由规则概述
ALB Ingress
通过控制台创建 ALB Ingress
通过 kubectl 创建 ALB Ingress
使用 Annotation 配置 ALB Ingress
使用 ALB Ingress 实现业务发布
ALB Ingress 配置 HTTPS 协议
CLB Ingress
通过控制台创建 CLB Ingress
通过 kubectl 创建 CLB Ingress
使用 Annotation 配置 CLB Ingress
CLB Ingress 配置 HTTPS 协议
Nginx Ingress
通过控制台创建 Nginx Ingress
通过 kubectl 创建 Nginx Ingress
Nginx ingress 常用注解
Nginx Ingress 配置 HTTPS 协议
Nginx Ingress 使用 HTTPS 对接后端服务
Nginx Ingress 配置重定向规则
Nginx Ingress 配置 URL 重写规则
Nginx Ingress 使用一致性哈希均衡负载
Nginx Ingress 配置流量复制
使用 Nginx Ingress 实现灰度发布和蓝绿发布
部署多套 Nginx Ingress Controller
APIG Ingress
通过控制台创建 APIG Ingress
通过 kubectl 创建 APIG Ingress
使用 Annotation 配置 APIG Ingress
使用 APIG Ingress 实现业务发布
使用 APIG Ingress 实现灰度发布和蓝绿发布
管理路由规则
域名解析（DNS）
使用 NodeLocal DNSCache 缓存代理
工作负载
工作负载概述
无状态负载
创建无状态负载
管理无状态负载
有状态负载
创建有状态负载
管理有状态负载
任务
创建任务
管理任务
定时任务
创建定时任务
管理定时任务
Cron 语句
守护进程
创建守护进程
管理守护进程
容器组
创建容器组
管理容器组
查看容器组信息
对象浏览器
使用免密组件拉取私有镜像创建工作负载
使用 Init 容器初始化应用
存储管理
存储概述
EBS 云盘存储卷
使用云盘静态存储卷
使用云盘动态存储卷
动态扩容云盘数据卷
静态扩容云盘数据卷
云盘快照
快照概述
使用云盘快照
TOS 对象存储卷
使用对象存储静态存储卷
NAS 文件存储卷
使用 NAS 文件存储静态存储卷
使用 NAS 文件存储动态存储卷
vePFS 文件存储卷
使用 vePFS 文件存储静态存储卷
使用 vePFS 文件存储动态存储卷
通过协议服务 NFS 使用 vePFS
CloudFS 大数据文件存储卷
使用大数据文件存储静态存储卷
本地存储卷
使用 LVM 类型的本地存储动态存储卷
使用独占盘类型的本地存储动态存储卷
通过临时卷方式使用本地存储 LVM 卷
配置管理
创建配置项
管理配置项
在容器中使用配置项
创建保密字典
在容器中使用保密字典
管理保密字典
弹性伸缩
弹性伸缩概述
节点弹性伸缩
节点伸缩原理
创建节点弹性伸缩
工作负载弹性伸缩
工作负载伸缩原理
指标伸缩（HPA）
创建指标伸缩
使用 GPU 和网络指标实现弹性伸缩
使用自定义指标实现弹性伸缩
管理指标伸缩
定时伸缩（CronHPA）
创建定时伸缩
管理定时伸缩
智能伸缩（IHPA）
智能伸缩概述
创建智能伸缩
组件管理
组件概述
安装组件
升级组件
卸载组件
组件变更配置差异说明
组件占用节点 IP 说明
GPU
NVIDIA GPU 调度
容器共享 GPU 调度
mGPU 概述
mGPU 使用方法
配置 mGPU 算力分配策略
mGPU 多卡共享
GPU 调度标签说明
自动安装 GPU 驱动
自定义安装 GPU 驱动
优化 GPU 时钟频率配置
调度管理
任务调度
Gang 调度
Capacity 调度
弹性资源优先级调度
负载感知调度
NUMA 拓扑感知调度
RDMA 拓扑感知调度
配置调度器自定义参数
使用 Pod CPU Burst 能力
可观测性
可观测性概述
日志管理
日志概述
采集容器日志
使用环境变量采集容器日志
采集 ingress 组件日志
采集控制面组件日志
事件管理
事件监控
事件监控概述
事件类型汇总
事件持久化
配置和查看持久化事件
开启观测
基础观测
基础观测概述
服务发现
自定义指标标签
容器服务观测
控制面服务观测
DNS 服务观测
Ingress 服务观测
CNI 网络观测
镜像加速观测
AI 资源观测
镜像仓库观测
CSI 存储观测
检查自愈观测
全栈观测
全栈观测概述
开启全栈观测
资源检索
节点
无状态负载
有状态负载
容器组
守护进程
服务
路由规则
集群拓扑
云监控
AIOps 套件
AIOps 套件概述
集群巡检
配置集群巡检
巡检项说明和修复建议
故障诊断
节点池诊断
节点诊断
容器组诊断
Ingress 诊断
成本套件
成本套件概述
开通成本套件
成本洞察
集群用量洞察
集群成本洞察
应用分析
成本优化
批量计算套件
批量计算套件概述
批量计算套件使用说明
开通批量计算套件
任务管理
队列管理
队列
队列组
套件运维
套件配置
组件运维
队列任务资源配额抢占策略说明
预加载镜像缓存
云原生 AI 套件
AI 套件概述
开通 AI 套件
AI 套件组件管理
AI 数据加速
AI 数据加速概述
CloudFS 目的端数据加速
VKE 目的端数据加速
通过 AI 交互式工作站进行镜像构建
安全管理
集群审计
基线巡检
应用巡检
授权管理
授权概述
配置 IAM 用户权限
配置 RBAC 权限
RBAC 权限角色说明
IRSA 机制
IRSA 概述
集群中使用 IRSA 能力
VKE 服务关联角色说明
应用中心
应用模板
创建 Helm 应用
管理应用
镜像缓存
稳定性
基础稳定性能力配置
工作负载稳定性优化
Kubernetes 集群稳定性优化
通过 Terraform 使用容器服务
概述
管理通过 Terraform 创建的集群
使用 Terraform 创建无 ECS 节点的 VKE 集群
使用 Terraform 管理已有的集群
管理通过 Terraform 创建的节点池
使用 Terraform 管理默认节点池中的已有节点
使用 Terraform 管理自定义节点池中的已有节点
注册集群
注册集群概述
集群管理
通过代理方式注册现有集群
连接注册集群
注销注册集群
配置注册集群 RBAC 授权
节点管理
命名空间
工作负载
无状态负载
有状态负载
守护进程
任务
定时任务
容器组
服务与路由
服务
路由规则
配置管理
配置项
保密字典
存储管理
弹性伸缩
指标伸缩
自定义资源
对象浏览器
弹性容器实例
最新动态
新功能发布记录
产品公告
【停售公告】弹性容器实例停止售卖 n1、n2i 规格族
【产品变更】VCI Pod 驱逐和防护策略对资源状态的影响说明
【产品变更】弹性容器实例日志采集能力解耦 Metadata Server 通知
【产品变更】弹性容器日志键值索引字段变更说明
【产品变更】弹性容器实例支持华南 1 (广州) 地域
【产品变更】弹性容器实例支持华东 2 (上海) 地域
【产品变更】弹性容器实例正式商业化公告
产品介绍
什么是弹性容器实例
产品优势
实例规格族
VCI 实例规格介绍
通用型
GPU 计算型
使用限制
地域和可用区
产品计费
计费概述
计费方式
按量计费
预留实例券
欠费说明
标签分账
项目分账
快速入门
VCI 入门指引
VCI 准备工作
通过控制台使用弹性容器实例
通过 kubectl 使用弹性容器
对接 VCI
在 VPC-CNI 网络模型集群中使用 VCI
在 Flannel 网络模型集群中使用 VCI
通过配置 vci-profile 使用 VCI
Virtual Kubelet 和虚拟节点
创建虚拟节点
创建实例
通用型实例
指定容器 vCPU 和内存创建通用型实例
GPU 计算型实例
指定容器 GPU 资源创建 GPU 计算型实例
指定 VCI 规格创建 GPU 计算型实例
忽略特定容器资源需求创建实例
创建实例并配置远端代理仓
网络
指定子网创建实例
指定安全组创建实例
配置 IPv4/IPv6 双栈网络
存储
容器 rootfs 持久化
日志
概述
通过日志服务采集 VCI 容器日志
通过 Sidecar 方式采集 VCI 容器日志
监控
使用托管 Prometheus 监控 VCI
使用自建 Prometheus 监控 VCI
通过虚拟节点获取 VCI 监控指标
VCI GPU 监控指标
配置 VCI 磁盘使用率监控与告警
事件
VCI 事件监控概述
VCI 事件类型汇总
运维
容器 coredump 持久化
VCI Pod 驱逐及防护
调度
VCI 实例库存感知调度
容器配置
配置安全上下文
设置容器启动和退出顺序
VCI Pod 原地重启
实例元数据
实例元数据概述
实例元数据项
查看实例元数据
VCI 镜像缓存
概述
使用自动镜像缓存创建 VCI 实例
使用手动镜像缓存创建 VCI 实例
使用 CRD 管理 VCI 镜像缓存
Pod Annotation 说明
VCI 支持的 kubectl 命令列表
最佳实践
授权
IAM 授权最佳实践
集群
通过 VKE 搭建 IPv4/IPv6 双栈集群
使用 KubeCm 管理多集群 KubeConfig
集群升级最佳实践
节点和节点池
ECS 选型最佳实践
增强容器资源可见性
自定义集群 kubelet 参数
网络
集群内应用对外暴露服务
集群内应用互访
CoreDNS 最佳实践
Nginx Ingress 最佳实践
通过 Ingress 获取真实客户端 IP 地址
自定义 Nginx Ingress Controller 观测最佳实践
配置节点池级别 Pod 安全组和子网
VKE 集群中使用 RDMA 资源
通过 IPv6 访问 API Server
容器网络内核参数优化
数据面
正确使用容器网络
正确使用容器存储
正确使用运行时与操作系统
控制面
Kubernetes 开发者最佳实践
存储
存储选型最佳实践
存储多可用区部署推荐配置
云盘持久化存储最佳实践
NAS 持久化存储最佳实践
调度
将节点 Label/Annotation 注入到 Pod
可观测性
集群监控实践和常用大盘
监控集群中的 Golang 应用
监控集群中部署的应用实例
通过 PodMonitor 配置服务发现
通过 ServiceMonitor 配置服务发现
弹性伸缩
Cluster Autoscaler 最佳实践
安全
安全下线节点
云原生容器安全解决方案
安全组配置最佳实践
迁移
火山引擎云原生迁移解决方案
云原生 AI
AI 训练任务监控
使用 AI 容器镜像
镜像加速
P2P 镜像加速方案
容器镜像懒加载方案
弹性容器实例
使用 VCI 运行 Spark 数据处理任务
自建/跨云 Kubernetes 集群弹性使用 VCI 方案
在容器中合理定义 Java 8 堆栈内存
解决方案
大规模并发业务系统云上架构解决方案
云原生场景基础资源使用成本优化方案
基于 Argo Workflows 和 Serverless Kubernetes 搭建精细化用云工作流
API 参考
API 发布历史
使用前必读
API 列表
调用方式
请求结构
公共参数
签名机制
返回结果
集群管理
CreateCluster
ListClusters
UpdateClusterConfig
ListSupportedResourceTypes
DeleteCluster
CreateKubeconfig
ListKubeconfigs
DeleteKubeconfigs
节点池管理
CreateNodePool
CreateDefaultNodePool
UpdateNodePoolConfig
ListNodePools
DeleteNodePool
节点管理
CreateNodes
ListNodes
DeleteNodes
虚拟节点
CreateVirtualNode
ListVirtualNodes
DeleteVirtualNode
组件管理
ListSupportedAddons
CreateAddon
UpdateAddonConfig
UpdateAddonVersion
DeleteAddon
ListAddons
标签管理
TagResources
UntagResources
ListTagsForResources
访问策略管理
GrantPermission
ListPermissions
RevokePermission
弹性容器实例
镜像缓存
CreateImageCache
UpdateImageCache
ListImageCaches
DeleteImageCache
UpdateImageCacheRetentionDays
全局配置管理
SetGlobalDefaultDeleteOption
GetGlobalDefaultDeleteOption
通用数据结构
请求数据结构
返回数据结构
附录
公共错误码
资源状态说明
SDK 参考
简介
Go SDK
Java SDK
Python SDK
常见问题
通用 FAQ
使用容器服务运行应用的大致流程是怎样的？
容器服务目前使用的容器运行时是什么？
容器服务访问 RDS MySQL 数据库时如何设置白名单？
如何申请使用邀测功能？
使用命令行进行 Base64 编码的常见问题
集群 FAQ
集群管理
如何查看集群的 Kubernetes 版本？
无法删除创建失败的集群？
如何修改创建集群过程中 API Server 关联创建的 CLB 的规格？
创建集群过程中，自动创建的 CLB 有什么用途？
如何使用集群创建持续交付私有资源池？
集群网络
如何手动开启集群的公网访问？
容器服务集群目前支持哪种网络方式？
如何获取集群的公网 IP？
如何获取集群公网流量出口的 EIP 地址？
集群升级
升级集群前升级网络组件会出现流量中断吗？
升级集群控制面是否会导致业务流量中断？
升级集群时正常运行的业务 Pod 是否会重启？
升级集群大概需要多长时间？
数据面节点升级的方式是什么？
注册集群 FAQ
通过代理方式注册集群时，因缺少 Agent 导致集群失联，该怎么处理？
节点与节点池 FAQ
如何查看节点 Containerd 版本？
如何打包和使用自定义镜像？
GPU A100/A800 多卡机型 RDMA 网络连通异常如何处理？
通过云服务器（ECS）控制台修改节点对应的 ECS 实例配置后节点未同步变更？
什么是默认节点池？
如何查询节点的可分配资源？
节点无法自动缩容？
如何查看节点资源使用情况？
如何清理已有节点数据盘残留数据？
工作负载 FAQ
创建工作负载后 Pod 实例状态一直显示“ContainerCreating”？
如何获取容器初始化日志？
部署工作负载失败，提示“0/16 nodes are available”错误如何解决？
Pod 异常排查
Pod 处于 Pending 状态，未被成功调度
Pod 处于 CrashLoopBackOff 状态
Pod 处于 ImagePullBackOff 状态
Pod 健康检查失败
服务与路由 FAQ
通过 Annotation 配置四层负载均衡时出现“lb is provisioning”事件
通过 Annotation 配置四层负载均衡时出现“loadbalancer for service not found”事件
删除 Service 时出现“InvalidServerGroupListener.InUse”事件
已关联工作负载的服务，解绑工作负载后，通过服务访问地址仍然能够访问到原工作负载？
如何批量创建服务？
创建 Ingress 时，Webhook 校验报错找不到 Service？
LoadBalancer 类型 Service 中的会话保持与 CLB 监听器的会话保持有什么区别？
无法访问 Ingress Controller 自身，该如何解决？
Ingress 无法访问 TCP、UDP 服务，该怎么办？
HTTPS 访问报错 “SSL_ERROR_RX_RECORD_TOO_LONG”，该怎么处理？
集群中添加或修改了 TLS 证书，但是访问时还是默认证书或旧证书
创建 Ingress 时报错 "failed calling webhook"，该如何处理？
已经添加了 Ingress，但并没有生效，该如何排查？
Ingress Pod 中无法保留源 IP
无法连接到通过 Ingress 暴露的 gRPC 服务
灰度规则不生效
灰度规则错误或影响到别的流量，该怎么处理？
无法连接到后端 HTTPS 服务
出现常见 HTTP 错误码
配置了 rewrite-target，资源访问时出现 404 报错
资源访问时报错“net::ERR_HTTP2_SERVER_REFUSED_STREAM”
业务通过 ingress-nginx 对外暴露，下载大文件超过 1 min 时会话超时断开
Ingress 配置跨域访问失效
HTTP 请求中 Header 丢失，该怎么处理？
Nginx Ingress 插件安装失败
配置修改后不生效或不完全生效
长链接断开，该怎么处理？
请求 Ingress 无响应，该如何处理？
大规模业务 ConfigMaps 导致 Ingress Nginx Controller 无法启动
存储 FAQ
集群同时存在多种规格的云服务器节点时，如何使用云盘存储卷？
Kubernetes 集群无法挂载已经存在数据的 PV/PVC 云盘，该如何处理？
PV 挂载对象存储桶的根目录后创建容器报错，该怎么处理？
如何修改 TOS 存储的挂载配置，允许其他用户读写 TOS 存储卷？
GPU FAQ
进程 SM 使用率和 mGPU 配置的算力比例不匹配？
GPU 实例硬件相关问题
弹性伸缩 FAQ
HPA 滚动发布时出现扩容多余 Pod 现象
可观测性 FAQ
无法查询 kube_namespace_label 指标
授权 FAQ
如何为 IAM 用户授权 Cluster 级别资源的权限？
IAM 用户无法访问 ALB ingress
操作集群资源，提示“AccessDenied,Code:403”错误如何解决？
为什么有集群管理员权限的子用户无法创建 YAML 资源？
配额 FAQ
如何提升配额（Quota）？
组件 FAQ
如何处理组件调度失败？
如何处理组件安装失败，提示资源名称冲突？
组件长时间处于安装中/更新中/卸载中，该如何处理？
如何处理组件卸载失败？
如何确认使用了 node-local-dns 组件？
如何处理组件启动失败？
如何处理处于镜像拉取失败状态的组件？
系统必装组件处于异常状态，如何恢复？
容器镜像 FAQ
如何关闭公共镜像中的 GSP 配置？
故障排查
CentOS 6.X 镜像运行异常退出问题排查
VCI FAQ
集群存在多个可用区子网情况下如何处理 VCI Pod 的调度？
如何让创建的 VCI Pod 调度到指定可用区？
出现 FailedCreateSystemDisk 事件时如何处理？
使用带分区的数据盘时 Pod 无法正常运行
创建 Pod 时出现 ProviderFailed 如何处理？
创建 Pod 报错 exec user process caused: exec format error 如何处理？
使用镜像缓存后，如何避免拉取镜像？
VCI Pod 一直处于 Pending 状态且未出现拉取镜像相关事件如何处理？
技术服务 FAQ
相关协议
容器服务产品/服务专用条款
容器服务托管版产品服务等级协议
弹性容器实例服务等级协议
文档首页
/
容器服务
/
用户指南
/
网络
/
路由（Ingress）
/
CLB Ingress
CLB Ingress
通过控制台创建 CLB Ingress
通过 kubectl 创建 CLB Ingress
使用 Annotation 配置 CLB Ingress
CLB Ingress 配置 HTTPS 协议