容器服务（VKE）集群支持使用 Annotation 配置 Pod 的 QoS 带宽限制，防止由于单个大流量 Pod 拖慢整个集群网络传输效率。本文介绍如何配置 Pod QoS 带宽限制。

背景信息

用户通常会在集群中部署各种类型的业务，包括在线业务和离线业务。其中，在线业务对网络响应较为敏感，对网络延迟要求较高。为避免由于高流量 Pod（如大数据传输、异常请求）占用过多带宽，导致其他 Pod 网络延迟、超时。保障核心业务（如支付、交易 Pod）的网络优先级，避免非核心任务抢占带宽，您可以在部署 Pod 时使用 Annotation 限制单 Pod 的带宽上限，防止网络拥塞，同时避免跨节点通信时，单个 Pod 拖慢整个集群网络传输效率，确保网络资源公平分配。

容器服务集群中支持通过 Kubernetes 标准 Pod Annotation 配置 Pod 带宽限制。

Annotation	说明
kubernetes.io/egress-bandwidth: 1M	Pod 出方向的带宽限制，示例值为1Mbps。

使用限制

该特性仅支持在 VPC-CNI 容器网络模型的集群中使用。

集群已安装 vpc-cni 组件，并升级至 v1.7.10 及以上版本。详情请参见升级组件。

配置示例

创建工作负载的 YAML 文件。示例文件deployment-demo.yaml代码如下：

apiVersion: apps/v1
kind: Deployment
metadata:
name: deployment-demo
namespace: default
spec:
replicas: 1
selector:
matchLabels:
app: demo
template:
metadata:
labels:
app: demo
annotations:
kubernetes.io/egress-bandwidth: 1M # 配置 Pod 出方向限速，示例值为 1m
spec:
containers:
- name: demo
image: doc-cn-beijing.cr.volces.com/vke/nginx-demo:v1.0
ports:
- containerPort: 80
command: ["sleep", "3600"] # 保持 Pod 运行 1 小时，方便测试

执行以下命令，创建工作负载。

kubectl apply -f deployment-demo.yaml

登录 Pod 控制台，执行以下命令，使用 iperf 测试 Pod 的带宽。其中-c表示使用客户端模式，192.168.1.126为 iperf 服务端的 IP 地址，本文中仅为示例。

iperf3 -c 192.168.1.126

预期结果如下，Pod 出方向带宽被限制到 1M，Pod QoS 限速功能生效。

Connecting to host 192.168.1.126, port 5201
[ 5] local 192.168.1.131 port 57792 connected to 192.168.1.126 port 5201
[ ID] Interval Transfer Bitrate Retr Cwnd
[ 5] 0.00-1.00 sec 226 KBytes 1.85 Mbits/sec 0 29.7 KBytes
[ 5] 1.00-2.00 sec 127 KBytes 1.04 Mbits/sec 0 29.7 KBytes
[ 5] 2.00-3.00 sec 127 KBytes 1.04 Mbits/sec 0 29.7 KBytes
[ 5] 3.00-4.00 sec 127 KBytes 1.04 Mbits/sec 0 29.7 KBytes
[ 5] 4.00-5.00 sec 127 KBytes 1.04 Mbits/sec 0 29.7 KBytes
[ 5] 5.00-6.00 sec 127 KBytes 1.04 Mbits/sec 0 29.7 KBytes
[ 5] 6.00-7.00 sec 63.6 KBytes 521 Kbits/sec 0 29.7 KBytes
[ 5] 7.00-8.00 sec 127 KBytes 1.04 Mbits/sec 0 29.7 KBytes
[ 5] 8.00-9.00 sec 127 KBytes 1.04 Mbits/sec 0 29.7 KBytes
[ 5] 9.00-10.00 sec 127 KBytes 1.04 Mbits/sec 0 29.7 KBytes
- - - - - - - - - - - - - - - - - - - - - - - - -
[ ID] Interval Transfer Bitrate Retr
[ 5] 0.00-10.00 sec 1.28 MBytes 1.07 Mbits/sec 0 sender
[ 5] 0.00-10.03 sec 1.14 MBytes 956 Kbits/sec receiver

iperf Done.