nomad-driver-containerd

Nomad task driver for launching containers using containerd.

Containerd (containerd.io) is a lightweight container daemon for running and managing container lifecycle.
Docker daemon also uses containerd.

dockerd (docker daemon) --> containerd --> containerd-shim --> runc

nomad-driver-containerd enables nomad client to launch containers directly using containerd, without docker!
Docker daemon is not required on the host system.

nomad-driver-containerd architecture

Requirements

• Nomad >=v0.11
• Go >=v1.11
• Containerd >=1.3

Building nomad-driver-containerd

$ mkdir -p $GOPATH/src/github.com/Roblox
$ cd $GOPATH/src/github.com/Roblox
$ git clone git@github.com:Roblox/nomad-driver-containerd.git
$ cd nomad-driver-containerd
$ make build (This will build your containerd-driver binary)

Wanna try it out!?

./setup.sh

The setup script will setup containerd 1.3.4 and nomad server + nomad-driver-containerd (nomad server/client should already be installed on your system, and setup.sh only builds the driver) on your system, so you can try out example jobs.

Once setup.sh is complete and the nomad server is up and running, you can check the registered task drivers (which will also show nomad-driver-containerd) using:

$ nomad node status (Note down the <node_id>)
$ nomad node status <node_id>

Run Example jobs.

There are few example jobs in the example directory.

$ nomad job run <job_name.nomad>

will launch the job. NOTE: You need to run setup.sh before trying out the example jobs. More detailed instructions are in the example README.md

Tests

$ make test

NOTE: These are destructive tests and can leave the system in a changed state.
It is highly recommended to run these tests either as part of a CI/CD system or on a immutable infrastructure e.g VMs.

Cleanup

make clean

This will delete your binary: containerd-driver.