/apm-server-docker

Official Docker image for the Elastic APM Server

Primary LanguagePythonApache License 2.0Apache-2.0

Description

This repository contains the official APM Server Docker image from Elastic.

Requirements

A full build requires:

  • Docker
  • GNU Make
  • Python 3.3+ (3.5+ for tests)

Supported Docker versions

The images have been tested on Docker 17.03.1-ce

Running a build

To build an image with a released version of APM Server, check out the corresponding branch for the version and run Make while specifying the exact version desired. Like this:

git checkout 6.3
ELASTIC_VERSION=6.3.1 make

To build an image with the latest nightly snapshot of APM Server, run:

make from-snapshot

Contributing, issues and testing

Acceptance tests for the image are located in the test directory, and can be invoked with make test. Python 3.5 is required to run the tests. They are based on the excellent testinfra, which is itself based on the wonderful pytest.

apm-server-docker is developed under a test-driven workflow, so please refrain from submitting patches without test coverage. If you are not familiar with testing in Python, please raise an issue instead.

The images are built on CentOS 7.