Running Heartbeat on Dockeredit

Docker images for Heartbeat are available from the Elastic Docker registry. You can retrieve an image with a docker pull command.

docker pull docker.elastic.co/beats/heartbeat:6.2.4

The base image is centos:7 and the source code can be found on GitHub.

Configure Heartbeat on Dockeredit

The Docker image provides several methods for configuring Heartbeat. The conventional approach is to provide a configuration file via a bind mount, but it’s also possible to create a custom image with your configuration included.

Bind-mounted configurationedit

One way to configure Heartbeat on Docker is to provide heartbeat.yml via a bind mount. With docker run, the bind mount can be specified like this:

docker run \
  --mount type=bind,source="$(pwd)"/heartbeat.yml,target=/usr/share/heartbeat/heartbeat.yml \
  docker.elastic.co/beats/heartbeat:6.2.4
Custom image configurationedit

It’s possible to embed your Heartbeat configuration in a custom image. Here is an example Dockerfile to achieve this:

FROM docker.elastic.co/beats/heartbeat:6.2.4
COPY heartbeat.yml /usr/share/heartbeat/heartbeat.yml
USER root
RUN chown heartbeat /usr/share/heartbeat/heartbeat.yml
USER heartbeat