dokku-event-listener

Service that listens to docker events and runs dokku commands.

Requirements

• golang 1.22+

Background

This package tails the Docker event stream for container events and performs specific actions depending on those events.

• Container restarts that result in IP address changes will result in call to dokku nginx:build-config for the related app.
• Container restarts that exceed the maximum restart policy retry count for the given container will result in a call to dokku ps:rebuild for the related app.

Note that this is only performed for Dokku app containers with the docker label com.dokku.app-name. If the container is missing that label, then no action will be performed when that container emits events on the Docker event stream. Use docker inspect <container> to verify see Docker object labels.

Installation

Debian packages are available via packagecloud

For a prebuilt binaries, see the github releases page.

Building from source

A make target is provided for building the package from source.

make build

In addition, builds can be performed in an isolated Docker container:

make build-docker-image build-in-docker

Usage

# watch dokku containers
dokku-event-listener