README.md

containerd-packaging

Usage:

To build a distro-specific package (rpm or deb):

make clean
make docker.io/library/<distro>:<version> [docker.io/library/<distro>:<version> ...]

# for example:
# make quay.io/centos/centos:stream9
# make docker.io/library/ubuntu:24.04

After build completes, packages can be found in the build directory.

Specifying the version to build

By default, packages are built from HEAD of the release/1.7 branch, as defines in common/common.mk. The version of runc defaults to the version as specified by the containerd project through the script/setup/runc-version file in the containerd repository.

Use the REF and RUNC_REF make variables to specify the versions to build. The provided values must be a valid Git reference, which can be a commit (e.g., ae71819 or ae71819c4f5e67bb4d5ae76a6b735f29cc25774e), branch (e.g. main or release/1.7), or tag (e.g. v1.7.18).

The following example builds packages for containerd v1.7.18 with runc v1.1.12 for Ubuntu 24.04:

make REF=v1.7.18 RUNC_REF=v1.1.12 docker.io/library/ubuntu:24.04

Building a package from a local source directory

Specify the path to the local source directory using CONTAINERD_DIR and/or RUNC_DIR:

make REF=<git reference> CONTAINERD_DIR=<path to repository> docker.io/library/<distro>:<version>

For example:

make clean
make REF=HEAD CONTAINERD_DIR=/home/me/go/src/github.com/containerd/containerd docker.io/library/ubuntu:jammy

For package maintainers:

• deb package maintainers guide
• rpm package maintainers guide