p4lang/pi

PI库仓库

![构建状态]([***]

本仓库包含子模块；克隆后应运行 git submodule update --init --recursive。

依赖项

基础依赖项

• Judy

基于配置标志的依赖项

根据您打算提供给 configure 的命令行标志，需要安装不同的依赖项。

CI测试额外依赖项

• libtool 二进制文件；构建系统使用libtool，运行部分生成的二进制文件（在valgrind下）需libtool二进制文件
• valgrind，部分测试用于检查内存错误
• Boost库，用于部分C++测试：需boost/optional.hpp和boost/functional/hash.hpp

从包仓库安装依赖项

从源码安装其他依赖项

部分依赖项无Debian包或可用版本不适用：

• https://github.com/p4lang/behavioral-model%E5%8F%8A%E6%89%80%E6%9C%89%E4%BE%9D%E8%B5%96%E9%A1%B9%EF%BC%9A%E6%8C%89https://github.com/p4lang/behavioral-model/blob/master/README.md%E8%AF%B4%E6%98%8E%E6%93%8D%E4%BD%9C
• https://github.com/nanomsg/nanomsg/releases/tag/1.0.0
• https://github.com/google/protobuf/releases/tag/v3.6.1%EF%BC%9A

git clone --depth=1 -b v3.6.1 https://github.com/google/protobuf.git
cd protobuf/
./autogen.sh
./configure
make
[sudo] make install
[sudo] ldconfig

• https://github.com/grpc/grpc/releases/tag/v1.17.2%EF%BC%9A

git clone --depth=1 -b v1.17.2 https://github.com/google/grpc.git
cd grpc/
git submodule update --init --recursive
make
[sudo] make install
[sudo] ldconfig

• https://github.com/sysrepo/sysrepo%E5%8F%8A%E6%89%80%E6%9C%89%E4%BE%9D%E8%B5%96%E9%A1%B9%EF%BC%9A%E5%8F%82%E8%A7%81proto/README.md

可使用其他版本的Protobuf/gRPC或更新版本的nanomsg，但上述版本用于开发和CI测试。使用--with-proto运行configure时，脚本会验证Protobuf >= 3.0.0和gRPC >= 1.3.0。

构建p4runtime.proto

要在构建中包含p4runtime.proto，使用--with-proto运行configure：

./autogen.sh
./configure --with-proto
make
make check
[sudo] make install

Bazel支持

提供对Bazel构建系统的试验性支持，便于其他Bazel项目导入。大多数用户建议使用基于autotools的构建系统。

使用https://github.com/bazelbuild/bazelisk%E5%9C%A8CI%E4%B8%AD%E5%AE%89%E8%A3%85Bazel%EF%BC%8C%E4%BC%9A%E5%AE%89%E8%A3%85%E6%9C%80%E6%96%B0%E5%AE%98%E6%96%B9%E7%89%88%E6%9C%AC%E3%80%82

构建P4Runtime PI前端并运行测试

bazel build //proto/frontend:pifeproto
bazel test //proto/tests:pi_proto_tests

在其他Bazel项目中使用PI

在WORKSPACE文件中：

1. 导入本项目（如使用git_repository）
2. 导入依赖项：

load("//bazel:deps.bzl", "PI_deps")
PI_deps()

# 传递依赖项

load("@com_github_p4lang_p4runtime//:p4runtime_deps.bzl", "p4runtime_deps")
p4runtime_deps()

load("@com_google_protobuf//:protobuf_deps.bzl", "protobuf_deps")
protobuf_deps()

load("@rules_proto//proto:repositories.bzl", "rules_proto_dependencies", "rules_proto_toolchains")
rules_proto_dependencies()
rules_proto_toolchains()

load("@com_google_googleapis//:repository_rules.bzl", "switched_rules_by_language")
switched_rules_by_language(
    name = "com_google_googleapis_imports",
    grpc = True,
    cc = True,
    python = True,
)

load("@com_github_grpc_grpc//bazel:grpc_deps.bzl", "grpc_deps")
grpc_deps()
load("@com_github_grpc_grpc//bazel:grpc_extra_deps.bzl", "grpc_extra_deps")
grpc_extra_deps()
load("@com_github_grpc_grpc//bazel:grpc_python_deps.bzl", "grpc_python_deps")
grpc_python_deps()

load("@rules_python//python:pip.bzl", "pip_import", "pip_repositories")
pip_repositories()
pip_import(
    name = "grpc_python_dependencies",
    requirements = "@com_github_grpc_grpc//:requirements.bazel.txt",
)

load("@grpc_python_dependencies//:requirements.bzl", "pip_install")
pip_install()

load("@com_github_nelhage_rules_boost//:boost/boost.bzl", "boost_deps")
boost_deps()

PI CLI

PI CLI支持实验性table_add和table_delete，可结合bmv2 simple_switch测试。系统安装bmv2后，通过./configure --with-bmv2 --with-cli && make构建PI和CLI，尝试以下命令：

simple_switch tests/testdata/simple_router.json  // 启动交换机
./CLI/pi_CLI_bmv2 -c tests/testdata/simple_router.json  // 启动CLI
PI CLI> assign_device 0 0 -- port=9090  // 0 0:设备ID+配置ID
PI CLI> table_add ipv4_lpm 10.0.0.1/24 => set_nhop 10.0.0.1 1
PI CLI> table_dump ipv4_lpm
PI CLI> table_delete ipv4_lpm <table_add返回的句柄>

贡献

参见CONTRIBUTING.md。