Skip to content

Latest commit

 

History

History
52 lines (33 loc) · 3.11 KB

README.md

File metadata and controls

52 lines (33 loc) · 3.11 KB

alpine-base

A Docker image for running just about anything within a container, based on Alpine Linux. This image belongs to a suite of images documented here.

Image size is ~20.1 MB.

Features

This image features:

  • [Alpine Linux][alpinelinux]
  • [s6][s6] and [s6-overlay][s6overlay]
  • go-dnsmasq

Versions

See VERSIONS.md for image contents.

Usage

To use this image include FROM smebberson/alpine-base at the top of your Dockerfile. Starting from smebberson/alpine-base provides you with the ability to easily start any service using s6. s6 will also keep it running for you, restarting it when it crashes.

Read more about extending this image with your own services.

DNS

Alpine Linux does not support the domain or search directives in resolv.conf. This breaks many tools that rely on DNS service discovery, in particular, Kubernetes, Docker Cloud, Consul, Rancher. You can read more about it.

To overcome these issues, alpine-base includes the lightweight container-only DNS server go-dnsmasq to resolve these issues.

That means that any image extending this image will now work with Docker Cloud service discovery and links and Kubernetes service discovery.

In some environments, go-dnsmasq won't be allowed to bind to port 53. In this instance, you can set the ENV variable GO_DNSMASQ_RUNAS to root. While not ideal, that should resolve the issue.

Example

An example of using this image can be found in examples/user-alpine.