arsscriptum/baseimage repository overview

⁠A minimal docker baseimage to ease creation of long-lived application containers

This is a docker baseimage that can be used to create containers for any long-lived application.

⁠Images

Multiple docker images, based on different Linux distributions, are available:

⁠Content

Here are the main components of the baseimage:

• An init system.
• A process supervisor, with proper PID 1 functionality (proper reaping of processes).
• Useful tools to ease container building.
• Environment to better support dockerized applications.

⁠Versioning

Images are versioned. Version number follows the semantic versioning⁠. The version format is MAJOR.MINOR.PATCH, where an increment of the:

• MAJOR version indicates that a backwards-incompatible change has been done.
• MINOR version indicates that functionality has been added in a backwards-compatible manner.
• PATCH version indicates that a bug fix has been done in a backwards-compatible manner.

⁠Tags

The baseimage is available under multiple tags. A tag is made from the corresponding Linux distribution and the release version.

⁠Getting started

The Dockerfile for your application can be very simple, as only three things are required:

• Instructions to install the application.
• A script that starts the application (stored at /startapp.sh in container).
• The name of the application.

Here is an example of a docker file that would be used to run a simple web NodeJS server. In Dockerfile:

# Pull base image.
FROM arsscriptum/baseimage:alpine-3.15-v3

# Install http-server.
RUN add-pkg nodejs-npm && \
    npm install http-server -g

# Copy the start script.
COPY startapp.sh /startapp.sh

# Set the name of the application.
RUN set-cont-env APP_NAME "http-server"

# Expose ports.
EXPOSE 8080

In startapp.sh:

#!/bin/sh
exec /usr/bin/http-server

Then, build your docker image:

docker build -t docker-http-server .

And run it:

docker run --rm -p 8080:8080 docker-http-server

You should be able to access the HTTP server by opening in a web browser:

http://[HOST IP ADDR]:8080