UPG implements a GTP-U user plane based on 3GPP TS 23.214 and 3GPP TS 29.244 Release 15. It is implemented as an out-of-tree plugin for FD.io VPP.
The possible uses for UPG are:
UPG is used in production in conjunction with erGW as GGSN/PGW in multiple installation in several telecom operators (Tier 1 and smaller).
For the list of known issues, see KNOWN_ISSUES document.
Design rationale for the development environment is this:
Relevant parts of the source tree layout:
hack/
contains helper scripts most of which are wrapped in make
commandsMakefile
provides user interface for the environmentupf/
contains the source code of the plugin1upf/test/
contains the integration tests1vpp.spec
contains the info on VPP-base repo, branch and commit to useThere's a simple dockerized environment wrapped in 'make' commands.
The "build image" which is used for the devenv is tagged with a hash
of Dockerfile.build
as well as VPP's external dependencies.
The following make
commands are supported:
make image
builds UPG Docker imagemake test
build VPP and run UPG integration tests. The compilation
results are retained under vpp/
make retest
run UPG integration tests without building VPP. These
can be run under make test
to re-run the tests quickly if there
were no UPG / VPP code changesmake ensure-build-image
checks if the build image exists or can be
pulled and builds it otherwisemake update-build-image-tag
updates the build image tag in
the Dockerfiles according to the hash calculated
from Dockerfile.build
and VPP external dependenciesmake install-hooks
installs git hooks in the repo which prevent
the user from making commits that contain ZZZZZ:
substring. This
is handy for debug print like clib_warning("ZZZZZ: i %d", i);
make update-vpp
re-clones VPP into vpp/
directorymake buildenv
runs an interactive shell inside the build
environment with UPG and VPP sources mounted into the containermake e2e
build UPG and run E2E tests for it. For more information,
see E2E test documentationmake checkstyle
performs style checks on the source codeCommands for building images and running tests default to debug builds.
To do release build instead, pass BUILD_TYPE=release
to make
:
make e2e BUILD_TYPE=release
If docker is used, one should set the following environment variable to enable wrapping the internally run commands in a docker container:
export UPG_BUILDENV=docker
It is also possible to use a k8s cluster to run the build container in a pod:
export UPG_BUILDENV=k8s
# optional: specify the node to run the build pod
export UPG_BUILDENV_NODE=somenode
In this case, the buildenv is run as statefulset inside the cluster. It can be removed using
hack/buildenv.sh clean
The CI for UPG-VPP is based on GitHub Actions. Currently, the CI only runs for pushes to branches in the repository itself. The jobs include:
prepare
: make sure build image is available for the commitbuild
(debug + release): build the docker images and binaries / packagescheckstyle
: check for style errors in the codetest
: unit and e2e tests for release and debug buildsconclude
: intermediate job used for sync by the release workflowslack
: internal notification jobThe images built per-commit expire within 7 days.
When a tag is pushed, the release
workflow is also run for it,
re-tagging the images built as part of normal build process
(preserving the old tags too). In case if the tag doesn't have test
substring in it, it is also published as a release. The release notes
list the PRs with the following tags:
feature
, enhancement
: featuresfix
: fixestest
: testsThe releases for tags that contain pre
substring are marked as
pre-releases.
1: Historically, the project was named simply "UPF". There may be more UPF->UPG renames later
It is possible to attach to running buildenv container with VS Code to get full intellisense.
To do that run make code
.
Note: this command leaves the buildenv running in the background.
After attaching for the first time, some vscode plugins may not be enabled.
To fix that open: F1 -> "Dev Containers: Open Named Container Configuration File"
And specify what plugins you'd like loaded at start.
Here are some nice plugins to work with this repo:
{
"workspaceFolder": "/src",
"extensions": [
"eamodio.gitlens",
"EditorConfig.EditorConfig",
"golang.go",
"ms-azuretools.vscode-docker",
"ms-vscode.cmake-tools",
"ms-vscode.cpptools",
"ms-vscode.cpptools-extension-pack",
"ms-vscode.cpptools-themes",
"ms-vscode.makefile-tools",
"llvm-vs-code-extensions.vscode-clangd",
"xaver.clang-format",
"twxs.cmake",
],
}