smebberson/alpine-consul-base repository overview

⁠alpine-consul-base

A Docker image designed for extending from when you need to run Consul⁠, based on Alpine Linux. This image belongs to a suite of images documented here⁠.

This image is designed to be extended from, with specific services added to it via Consul, along with appropriate health checks.

Image size is ~49.4 MB.

⁠Features

This image features:

• Alpine Linux⁠
• s6⁠ and s6-overlay⁠
• Consul⁠ and consul-template⁠

⁠Versions

• 4.2.0, latest (Dockerfile)⁠
• 4.1.1 (Dockerfile)⁠
• 4.1.0 (Dockerfile)⁠
• 4.0.0 (Dockerfile)⁠
• 3.0.0 (Dockerfile)⁠
• 2.0.0 (Dockerfile)⁠
• 1.1.0 (Dockerfile)⁠
• 1.0.0 (Dockerfile)⁠

See VERSIONS.md for image contents.⁠

⁠Usage

To use this image include FROM smebberson/alpine-consul-base at the top of your Dockerfile, or simply docker run --name consul-base smebberson/alpine-consul-base.

This container has been setup to automatically connect to a Consul cluster, created with a service name of consul. Read more about it here⁠.

consul-template⁠ is automatically started if templates are available.

⁠Customisation

To use consul-template⁠:

1. Add your templates to root/etc/consul-template/templates/my-service/.
2. Make consul-template configuration aware of your templates by adding a configuration file in root/etc/consul-template/conf.d/my-service (use sub folders to make VOLUME /etc/consul-template/templates/my-service possible).
3. In your Dockerfile be sure to run mkfifo /etc/services.d/my-service/supervise/control and chmod g+w /etc/services.d/my-service/supervise/control in order to make it possible for consul-template to restart the service if needed.

⁠Example

An example of using this image can be found in examples/user-consul-nginx-nodejs⁠.