/docker-base-image

This is a docker base image that can be used as a baseline for future containers that will be utilized for long-term deployments.

Primary LanguageShellGNU General Public License v3.0GPL-3.0

chris102994/docker-base-image

This is a docker base image that can be used as a baseline for future containers that will be utilized for long-term deployments.

CI

Build Status Image Pulls GitHub tag Version

Images

Base Distribution Tag Size
Ubuntu Bionic (18) ubuntu-18-latest
Alpine 3.10 alpine-3.10-latest
Debian Bullseye (11) debian-11-latest

Custom Scripts

  • /usr/local/bin
    • log - This is used to print neat messages out to the docker console.
      • Usage: log $(basename $0) MESSAGE...
    • pkg-manager - This is used by inst-pkg and rm-pkg to get the package manager.
      • Usage: . pkg-manager which then sets the $MANAGER env variable in the calling script.
    • inst-pkg - This is a install script which allows me to use common syntax across debian and alpine images. It's especially handy since apt-get doesn't include the nice --virtual tag that apk does to easily install build dependencies not needed for further use.
      • Usage: inst-pkg [--virtual NAME ] PKG [PKG...]
    • rm-pkg - This is a remove script which allows me to use common syntax across debian and alpine images. It's especially handy since apt-get doesn't include the nice --virtual tag that apk does to easily remove build dependencies not needed for further use.
      • Usage: rm-pkg PKG [PKG...]
    • check_and_terminate_process - Since Alpine Linux provides a minimal install and the s6-overlay doesn't provide a traditional method of verifying services this is a basic but powerful script I have written that is an all-in-one solution to find, terminate and possibly force kill processes. This utilizes the minimized pgrep provided by busybox in Alpine Linux.
      • Usage: check_and_terminate_process "name_of_service"

Outside Packages

Docker

docker run \
	--name=base-image \
	-e PUID=1000 `Optional` \
	-e PGID=1000 `Optional` \
	-v </path/to/appdata/config>:/config \
	--restart unless-stopped \
	christopher102994/docker-base-image:alpine-3.10-latest

Parameters

Container specific parameters passed at runtime. The format is <external>:<internal> (e.g. -p 443:22 maps the container's port 22 to the host's port 443).

Parameter Function
-e USERNAME The Username you wish to run as. (Optional)
-e GROUPNAME The Groupname you wish to run as. (Optional)
-e PUID The UID you wish to run and save files as. (Optional)
-e PGID The GID you wish to run and save files as. (Optional)
-v /config All the config files for your app.