ofabry/vpp-base repository overview

⁠vpp-base

The vpp-base provides code used for building docker images with VPP.

⁠Introduction

The goal of vpp-base is to provide images with VPP that can be used as base image in projects working with VPP. This is mainly because there are no official images provided by the FD.io/VPP.

⁠Use Cases

• Use as base image in docker images that work with VPP.
• Quickly test some feature in specific VPP version.
• Distribute .deb packages for VPP where needed.
• Generate VPP binary API using installed .api.json files.

The vpp-base is already being used by the vpp-agent⁠ project.

⁠Quickstart

To get the latest vpp-base image that contains recent VPP version from the master repository⁠ on packagecloud.io

# get the latest image
➢ docker pull ligato/vpp-base

# print the VPP version
➢ docker run --rm ligato/vpp-base cat /vpp/version
19.08-rc0~235-gfe52dea08~b2798

⁠Images

The vpp-base images are built continuously⁠ and published on DockerHub to ligato/vpp-base⁠.

⁠Available Versions

In addition to the latest image built from master, there are other images. For example images containing stable VPP version are tagged with a release they provide: ligato/vpp-base:YYMM.

Here's list of currently published images available:

Image	Details	VPP source

The complete list of available image tags can be found on DockerHub⁠.

⁠Image Contents

The vpp-base image contains the following pieces:

• Installed VPP ready for use with default config - /etc/vpp/startup.conf
• Download script for getting VPP packages - /vpp/get-vpp.sh
• All .deb packages that come with VPP - /vpp/*.deb
• Version file that contains VPP version - /vpp/version

⁠Building Images

To build custom vpp-base image you can simply use docker build command with without cloning this git repository:

# Latest VPP
➢ docker build github.com/ligato/vpp-base

# Stable VPP 19.04
➢ docker build --build-arg REPO='1904' github.com/ligato/vpp-base

# With specific VPP version
➢ docker build --build-arg VPP_VERSION='19.08-rc0~196-g7fe470a54' github.com/ligato/vpp-base

# With specific VPP commit
➢ docker build --build-arg VPP_VERSION='19.04[^ ]*-g7fe470a54' github.com/ligato/vpp-base