BCI Pod Annotation
更新时间：2024-09-25
在Kubernetes集群中创建BCI类型的Pod（即BCI实例）时，为充分使用BCI提供的功能，在不改变Kubernetes语义的前提下，您可以根据需求为Pod添加Annotation。
本文为您介绍创建BCI Pod时支持添加的Annotation。
BCI Pod支持的annotation
注意：
- annotation需要配置在Pod Spec中，而不是DeploymentSpec中。
- 配置网络、安全组和可用区相关annotation时，需要保证相互之间的一致性：如子网与安全组应该同属一个VPC，子网与可用区参数需匹配等。如未在Pod中单独配置，则默认使用虚拟节点本身的配置。
- 如通过annotation指定子网参数，则必须同时通过annotation指定可用区参数，可用区参数的值为子网所属可用区。
通过在Pod metadata中指定annotation，可以为对应Pod开启特定的特性，或者覆盖虚拟节点上的原有配置。
| annotation | 含义 | 示例 |
|---|---|---|
| bci.virtual-kubelet.io/bci-logical-zone | BCI实例所在可用区 | "bci.virtual-kubelet.io/bci-logical-zone": "zoneB" |
| bci.virtual-kubelet.io/bci-subnet-id | BCI实例所在子网短id | "bci.virtual-kubelet.io/bci-subnet-id": "sbn-wiheujsumeqc" |
| bci.virtual-kubelet.io/bci-security-group-id | BCI实例使用的安全组id | "bci.virtual-kubelet.io/bci-security-group-id": "g-0c25zsii79hv" |
| bci.virtual-kubelet.io/bci-create-eip | 自动为BCI实例创建并绑定EIP | "bci.virtual-kubelet.io/bci-create-eip": "true" |
| bci.virtual-kubelet.io/bci-create-eip-bandwidth | 自动为BCI实例创建的EIP带宽，单位Mbps，默认100Mbps | "bci.virtual-kubelet.io/bci-create-eip-bandwidth": "100" |
| bci.virtual-kubelet.io/bci-create-eip-route-type | 自动为BCI实例设置EIP的线路类型。不指定时，默认为标准BGP类型。 取值范围： BGP：标准型BGP BGP_S：增强型BGP ChinaMobile：中国移动 ChinaUnicom：中国联通 ChinaTelcom：中国电信 （如果选择移动、联通、电信线路，需要先申请单线EIP白名单。） |
"bci.virtual-kubelet.io/bci-create-eip-route-type": "BGP_S" |
| bci.virtual-kubelet.io/bci-create-eip-paymethod | 计费方式： ByTraffic：流量 ByBandwidth：带宽 |
"bci.virtual-kubelet.io/bci-create-eip-paymethod": "ByBandwidth" |
| bci.virtual-kubelet.io/kube-proxy-enabled | 为BCI实例注入kube-proxy sidecar，用于访问ClusterIP | "bci.virtual-kubelet.io/kube-proxy-enabled": "true" |
| bci.virtual-kubelet.io/pod-delay-release-duration-minute | 设置延迟销毁时长，只针对job任务类型Pod(即restartPolicy为never)生效 | "bci.virtual-kubelet.io/pod-delay-release-duration-minute": '30' |
| bci.virtual-kubelet.io/pod-delay-release-succeeded | 延迟销毁默认只对Failed状态的Pod生效，变更此字段可将延迟销毁也应用于 Succeeded状态的Pod | "bci.virtual-kubelet.io/pod-delay-release-succeeded": 'true' |
| bci.virtual-kubelet.io/resource-tag | 绑定的标签（Tag）字符串，最多可以绑定10个标签。标签键和标签值之间用半角冒号隔开，多个标签之间用半角逗号隔开。 | bci.virtual-kubelet.io/resource-tag: "key1:value1,key2:value2" |
配置示例:
apiVersion: apps/v1
kind: Deployment
metadata:
name: nginx
labels:
app: nginx
spec:
replicas: 2
selector:
matchLabels:
app: nginx
template:
metadata:
labels:
app: nginx
annotations:
bci.virtual-kubelet.io/bci-create-eip: "true" # 自动为BCI Pod创建并绑定EIP
bci.virtual-kubelet.io/bci-create-eip-bandwidth: "150" # 自动创建的EIP带宽为150Mbps
bci.virtual-kubelet.io/bci-create-eip-route-type: "BGP_S" # 自动创建EIP的线路类型为增强型BGP
spec:
containers:
- name: nginx
image: nginx:1.7.9
ports:
- containerPort: 80