Ligato/vpp agent介绍和使用

Ligato/vpp agent介绍和使用

介绍

• Ligato 是一个 Golang 框架，用于开发 APP 控制和管理云原生网络功能（cloud native virtual network function, CNF）。
• 现在云提供商逐步转型以云原生的方式来开发、部署、管理应用。应用被实现为微服务，打包为容器的方式，并以 Pod 的方式动态部署到物理或虚拟机上。
• Kubernetes调度并编排容器的启停、部署、扩展、容错等，自动管理应用和服务的生命周期。
• 网络在云原生的环境中发挥这非常重要的作用，很多的网络功能，比如L2/L3 交换和路由、IPsec VPN 网关、NAT 和负载均衡等都以容器的形式部署，形成云原生的网络功能（CNF），Kubernetes可以通过不同的网络配置来满足不同 CNF的功能需求，借助 CNF 来增强各种应用对网络的需求。

安装步骤如下：

• 安装 VPP agent
• 安装并启动 etcd
• 运行 VPP agent 容器
• 使用 REST、CLI etcdctl 和 agentctl 来操作 VPP agent

1.环境准备

• Docker（安装docker ce）
• etcd
• Postman 和 curl 工具（安装 postman）

2.下载镜像

下载 vpp-agent 镜像（该镜像中就包含 VPP）从 dockerhub：

docker pull ligato/vpp-agent

查看下载的镜像

docker images

3.etcd

etcd 作为 KV 数据库用来存储 VPP 的配置信息
（1）下载 etcd 镜像并启动

docker run --rm --name etcd -p 2379:2379 -e
ETCDCTL_API=3 quay.io/coreos/etcd /usr/local/bin/etcd -
advertise-client-urls http://0.0.0.0:2379 -listen-clienturls http://0.0.0.0:2379

该操作如果没有 etcd 镜像会首先下载，然后启动服务端监听在172.17.0.1:2379 。

显示如下是运行成功，注意容器运行是一直运行下去，不能ctrl+c退出

重新打开一个终端查看etcd容器运行情况

docker ps -f name=etcd

（2）etcdctl
etcdctl 是 etcd 的客户端工具，可以增删查改 etcd 中的 KV 数据。
安装：

yum install etcd-client

etcd 镜像中就包含 etcdctl 工具，推荐和 etcd 使用：

docker exec -it etcd etcdctl version

使用 etcdctl 验证 etcd 服务端是否工作正常：

docker exec -it etcd etcdctl endpoint health

4.启动 VPP agent

VPP agent 和 VPP 都一起运行在一个容器里：

docker run -it --rm --name vpp-agent -p 5002:5002 -p 9191:9191 --privileged ligato/vpp-agent

5002 端口是 vpp 控制端口，如 vppctl 可以连接使用，9191 是 REST API 开放的端口。

验证 VPP agent 是否工作正常(同样是打开新的终端)：

5.管理 VPP agent

这一部分将介绍

• 如何配置 VPP 数据面，通过 etcdctl 工具
• 如何读取 VPP 配置数据，通过 VPP agent REST API
• 如何连接到 VPP CLI 并且显示配置
• 如何使用 agentctl 来管理 VPP agent 和 Ligato 组件
  （1）etcdctl
  VPP agent 的配置项在 etcd 数据库中以 /vnf-agent 为前缀，可以通过下面的命令来列出 VPP agent 的所有配置项：

docker exec -it etcd etcdctl get --prefix /vnf-agent/

为一个 loopback 接口配置 IP 进 etcd 数据库，可以：

docker exec etcd etcdctl put /vnf-agent/vpp1/config/vpp/v2/interfaces/loop1 \
'{"name":"loop1","type":"SOFTWARE_LOOPBACK","enabled":true,"ip_addresses":["192.168.1.1/24"]}'

验证该 loopback 接口配置在 etcd 数据库中：

docker exec etcd etcdctl get /vnf-agent/vpp1/config/vpp/v2/interfaces/loop1

配置一个 bridge domain：

docker exec etcd etcdctl put /vnf-agent/vpp1/config/vpp/l2/v2/bridge-domain/bd1 \
'{"name":"bd1","forward":true,"learn":true,"interfaces":
[{"name":"loop1"}]}'

验证 bridge domain 在 etcd 数据库中：

docker exec etcd etcdctl get /vnf-agent/vpp1/config/vpp/l2/v2/bridge-domain/bd1

（2）REST API
使用 cURL 来运行 REST API，比如：
获取 VPP 接口：

curl -X GET http://localhost:9191/dump/vpp/v2/interfaces

这将会显示两个接口，一个是 “name”: “UNTAGGED-local0”，VPP 默认，一个是 “name”: “loop1”，之前创建的，如下：

获取 bridge domain 信息：

curl -X GET http://localhost:9191/dump/vpp/v2/bd

（3） VPP CLI
在 VPP-agent 容器中使用 VPP CLI：

docker exec -it vpp-agent vppctl -s localhost:5002

（4）agentctl
agentctl 用于管理 VPP 的 CLI 工具。
帮助命令：

docker exec -it vpp-agent agentctl --help