Minimal Node.js Docker Images built on Alpine Linux with support for DNS service discovery
A port of mhart/alpine-node to use janeczku/alpine-kubernetes as its base image to provide DNS support for micro-services containers in Kubernetes, Consol, Tutum or other Docker cluster environments that use DNS-based service discovery and rely on the containers being able to use the search domains from resolv.conf for resolving service names.
All versions use the one quay.io/republicwealth/docker-alpine-dnsmasq-node
repository, but each version aligns with the following tags (ie, republicwealth/docker-alpine-node-kubernetes:<tag>
, size is full/compressed):
- Full install built with npm (2.14.15 unless specified):
latest
,5
,5.5
,5.5.0
– 37.01 MB (npm 3.5.3)4
,4.2
,4.2.5
– 36.42 MB0.12
,0.12.9
– 33.11 MB0.10
,0.10.41
– 28.46 MB
- Base install with node built as a static binary with no npm:
base
,base-5
,base-5.5
,base-5.5.0
– 26.01 MBbase-4
,base-4.2
,base-4.2.5
– 25.63 MBbase-0.12
,base-0.12.9
– 22.31 MBbase-0.10
,base-0.10.41
– 18.5 MB
$ docker run quay.io/republicwealth/alpine-node-kubernetes node --version
v5.4.0
$ docker run quay.io/republicwealth/alpine-node-kubernetes:4 node --version
v4.2.2
$ docker run quay.io/republicwealth/alpine-node-kubernetes npm --version
3.4.0
$ docker run quay.io/republicwealth/alpine-node-kubernetes:base node --version
v5.4.0
If you don't have any native dependencies, ie only depend on pure-JS npm
modules, then my suggestion is to run npm install
locally before running
docker build
(and make sure node_modules
isn't in your .dockerignore
) –
then you don't need an npm install
step in your Dockerfile and you don't need
npm
installed in your Docker image – so you can use one of the smaller
base*
images.
It is recommended you setup you process to run using s6
as s6 is using ENTRYPOINT
to run its init
. Example usage can be found in
janeczku/alpine-kubernetes.
FROM quay.io/republicwealth/alpine-node-kubernetes:base
# FROM quay.io/republicwealth/alpine-node-kubernetes:base-0.10
# FROM quay.io/republicwealth/alpine-node-kubernetes
WORKDIR /src
# Copy the s6 service.d file(s)
# S6 requires and executable (755) runfile to be deployed to:
# /etc/services.d/{APPLICATION NAME}/run
COPY rootfs /
# Copy the application
COPY bin ./bin
# If you have native dependencies, you'll need extra tools
# RUN apk add --update make gcc g++ python
# If you need npm, don't use a base tag
# RUN npm install
# If you had native dependencies you can now remove build tools
# RUN apk del make gcc g++ python && \
# rm -rf /tmp/* /var/cache/apk/* /root/.npm /root/.node-gyp
EXPOSE 3000
# If you don't want to use s6, you must use CMD
# CMD ["node", ".bin/index.js"]
As Alpine Linux uses musl, you may run into some issues with environments expecting glibc-like behaviour (for example, Kubernetes). Some of these issues are documented here:
Inspired by: