接口列表
表 1 kata-runtime网络相关的命令行接口
命令
|
子命令
|
文件示例
|
字段
|
含义
|
备注
|
|---|
kata-network
说明： - kata-network命令需成组使用。不经过kata-runtime kata-network添加的网络设备，无法使用kata-runtime kata-network删除或者列出。反之亦然。
- kata-runtime kata-network通过文件或stdin传入配置参数。
|
add-iface
说明： - 一个interface只能添加到1个容器中。
- 执行结果以返回值为准（非零返回值）。
|
{
“device”:“tap1”,
“name”:“eth1”,
“IPAddresses”:[{“address”:“172.17.1.10”,“mask”:“24”}],
“mtu”:1300,
“hwAddr”:“02:42:20:6f:a2:80”
“vhostUserSocket”:“/usr/local/var/run/openvswitch/vhost-user1”
}
|
device
|
设置网卡的主机端名称
|
必选。支持字母、数字、下划线“_”、“-” 以及“.”字符，必须以字母开头，且长度不超过15。需要确保同一个宿主机上device不能重复。
|
name
|
设置网卡的容器内名称
|
必选。支持字母、数字、下划线“_”、“-” 以及“.”字符，必须以字母开头，且长度不超过15。需要确保同一个Sandbox内name不能重复。
|
IPAddresses
|
设置网卡的IP地址
|
可选。
暂时支持一张网卡配置一个IP，如果不配置IP，则不会在容器内部配置IP。
|
mtu
|
设置网卡的mtu值
|
必选。
有效范围46~9600。
|
hwAddr
|
设置网卡的mac值
|
必选。
|
vhostUserSocket
|
设置dpdk轮循socket路径
|
可选。
路径最大长度128字节，命名规则支持数字、字母、“-”。必须以字母开头。
|
del-iface
|
{
“name”:“eth1”
}
|
无
|
删除容器内的一个网卡
|
说明： 删除网卡时，仅根据网卡容器内名称（name字段）来删除。即便填写其他字段，kata也不会使用。
|
list-ifaces
|
无
|
无
|
查询容器内的网卡列表
|
无
|
add-route
|
{
“dest”:“172.17.10.10⁄24”,
“gateway”:“”,
“device”:“eth1”
}
|
dest
|
设置路由对应的网段
|
格式为<ip>/<mask>，<ip>必选。
分三种情况：
1. 配置<ip>/<mask>；
2. 只配置<ip>，则默认掩码为32；
3. 配置”dest”:“default”，默认无dest，需传入gateway。
|
gateway
|
设置路由的下一跳网关
|
设置”dest”:“default”时，gateway必选；其他情况可选。
|
device
|
设置路由对应的网卡名称
|
必选。
最长支持15字符。
|
del-route
|
{
“dest”:“172.17.10.10⁄24”
}
|
无
|
删除容器的路由规则
|
dest为必选，device/gateway均为可选。
说明： kata根据不同字段进行模糊匹配，删除对应的路由规则。
|
list-routes
|
无
|
无
|
查询容器内的路由列表
|
无
|
表 2 kata-ipvs命令行接口
命令
|
子命令
|
字段
|
参数
|
子参数
|
含义
|
备注
|
|---|
kata-ipvs
|
ipvsadm
|
–parameters
|
-A, –add-service
|
-t, –tcp-service
-u, –udp-service
|
虚拟服务类型
|
必选项。–tcp-service、–udp-service，两个参数只能选择其一。格式为“ip:port”，port取值[1,65535]。
举例：
kata-runtime kata-ipvs ipvsadm –parameters “–add-service –tcp-service 172.17.0.7:80 –scheduler rr –persistent 3000” <container-id>
|
-s, –scheduler
|
负载均衡调度算法
|
必选项。取值范围：rr|wrr|lc|wlc|lblc|lblcr|dh|sh|sed|nq。
|
-p, –persistent
|
持续服务时间
|
必选项。取值范围[1, 2678400]，单位s。
|
-E, –edit-service
|
-t, –tcp-service
-u, –udp-service
|
虚拟服务类型
|
必选项。–tcp-service、–udp-service，两个参数只能选择其一。格式为“ip:port”，port取值[1,65535]。
|
-s, –scheduler
|
负载均衡调度算法
|
必选项。取值范围：rr|wrr|lc|wlc|lblc|lblcr|dh|sh|sed|nq。
|
-p, –persistent
|
持续服务时间
|
必选项。取值范围[1, 2678400]，单位s。
|
-D, –delete-service
|
-t, –tcp-service
-u, –udp-service
|
虚拟服务类型
|
必选项。–tcp-service、–udp-service，两个参数只能选择其一。格式为“ip:port”，port取值[1,65535]。
|
-a, –add-server
|
-t, –tcp-service
-u, –udp-service
|
虚拟服务类型
|
必选项。–tcp-service、–udp-service，两个参数只能选择其一。格式为“ip:port”，port取值[1,65535]。
举例：
kata-runtime kata-ipvs ipvsadm –parameters “–add-server –tcp-service 172.17.0.7:80 –real-server 172.17.0.4:80 –weight 100” <container-id>
|
-r, –real-server
|
真实服务器地址
|
必选项。格式为“ip:port”，port取值[1,65535]。
|
-w, –weight
|
权重
|
可选项，取值[0,65535]。
|
-e, –edit-server
|
-t, –tcp-service
-u, –udp-service
|
虚拟服务类型
|
必选项。–tcp-service、–udp-service，两个参数只能选择其一。格式为“ip:port”，port取值[1,65535]。
|
-r, –real-server
|
真实服务器地址
|
必选项。格式为“ip:port”，port取值[1,65535]。
|
-w, –weight
|
权重
|
可选项，取值[0,65535]。
|
-d, –delete-server
|
-t, –tcp-service
-u, –udp-service
|
虚拟服务类型
|
必选项。–tcp-service、–udp-service，两个参数只能选择其一。格式为“ip:port”，port取值[1,65535]。
|
-r, –real-server
|
真实服务器地址
|
必选项。格式为“ip:port”，port取值[1,65535]。
|
-L, –list
|
-t, –tcp-service
-u, –udp-service
|
指定查询虚拟服务信息
|
可选项。
举例：
kata-runtime kata-ipvs ipvsadm –parameters “–list –tcp-service ip:port” <container-id>
|
–set
|
–tcp
|
tcp超时
|
必选项，取值[0, 1296000]。
举例：
kata-runtime kata-ipvs ipvsadm –parameters “–set 100 100 200” <container-id>
|
–tcpfin
|
tcpfin超时
|
必选项，取值[0, 1296000]。
|
–udp
|
udp超时
|
必选项，取值[0, 1296000]。
|
–restore
|
-
|
标准输入批量导入
可指定规则文件
|
举例：
kata-runtime kata-ipvs ipvsadm –restore - < <规则文件路径> <container-id>
说明： 单条添加时默认使用NAT模式，批量导入时添加真实服务器需手动添加-m参数使用NAT模式。
规则文件内容示例：
-A -t 10.10.11.12:100 -s rr -p 3000
-a -t 10.10.11.12:100 -r 172.16.0.1:80 -m
-a -t 10.10.11.12:100 -r 172.16.0.1:81 -m
-a -t 10.10.11.12:100 -r 172.16.0.1:82 -m
|
cleanup
|
–parameters
|
-d, –orig-dst
|
ip信息
|
必选项。
举例：
kata-runtime kata-ipvs cleanup –parameters “–orig-dst 172.17.0.4 –protonum tcp” <container-id>
|
-p, –protonum
|
协议类型
|
必选项，取值为tcp|udp 。
|
意见反馈