The base image for the bfren ecosystem, containing Alpine Linux and various helper executables.
Source files (GitHub) Container images (Docker Hub)
Docker Alpine is a tiny distribution of Linux designed specifically for use in containers.
esh is a lightweight templating engine using POSIX-compatible syntax.
x.x and x.x.x refer to the bfren image versions.
In addition, you can add -dev and -beta suffixes to access development / test builds (see Docker Hub for further details).
If you need to build the image with a different timezone to the default ("Europe/London"), you can do so by setting the TZ ARG, or by installing the tzdata package. (Please note this is only possible if you are building the image yourself - otherwise you will need to use .)
As well as the standard repositories, the edge repos are tagged with @edgemain and @edgecomm. This means you can, for example, do apk add curl@edgemain or apk add php8@edgecomm to add the edge versions of packages.
This image contains only one service: cron, which is enabled by default. If you want to add scripts or executables to the cron you have two options.
/etc/periodic/The simplest way to add tasks to the cron in Alpine Linux is to place an executable file in one of the directories under /etc/periodic/ (remember to set the executable attribute in /etc/fix-attrs.d/):
It's pretty obvious how frequently they run! An example of this method can be found in the image.
/etc/crontabs/rootIf you want more control over your cron tasks you can create a normal crontab file:
However, if you do this, remember you will be overriding the default file when your /overlay/ is copied over the image files, so you need to include the if you don't want to break the cron further down the line.
The image comes pre-installed with , a simple shell-based templating engine. It is extremely lightweight, and very easy to use.
All dynamic configuration files in the bfren ecosystem are built using esh, and the default location for those templates is /etc/bf/templates.
3.12
alpine3.12, alpine3.12.9, alpine3.12-x.x, alpine3.12-x.x.x
3.13
alpine3.13, alpine3.13.7, alpine 3.13-x.x, alpine3.13-x.x.x
3.14
alpine3.14, alpine3.14.3, alpine3.14-x.x, alpine3.14-x.x.x
3.15
latest, alpine3, alpine3.15, alpine3.15.0, alpine3.15-x.x, alpine3.15-x.x.x
edge
alpineedge, alpineedge-x.x, alpineedge-x.x.x
BF_DEBUG
0 or 1
Set to 0 to disable debug log output messages.
1
$ ls /etc/periodic/
1min 15min daily hourly monthly weekly$ head -n 1 /etc/crontabs/root
0 */8 * * * db-backup > /dev/null 2>&1Various helper executables for providing standard output and simplifying common tasks.
Echoes "$1: $2" to stdout in grey with prefix (see ) - but only if BF_DEBUG is set to "1".
Text to output
[Optional] Script / executable name
Echoes 'done.' to stdout in green with prefix (see ).
[Optional] Script / executable name
Echoes $3 to stdout in colour $2 with prefix:
"[$1] %Y-%m-%d %H:%M:%S".
Namespace (default value for other output helper executables is 'bf')
ANSI colour code (see e.g. )
Text to output
[Optional] Script / executable name
Echoes "$1: $2" to stdout in default colour with prefix (see ).
Text to output
[Optional] Script / executable name
Echoes "$1: $2" to stdout in red with prefix (see ), and returns 1. This will end execution of the calling script if you use, e.g. set -euo pipefail at the top of your scripts (recommended).
Text to output
[Optional] Script / executable name
Like echoes "$1: $2" to stdout in red with prefix, but doesn't end execution of calling script.
Text to output
[Optional] Script / executable name
Echoes "$1: $2" to stdout in green with prefix.
Text to output
[Optional] Script / executable name
Create user with id $2, group with id $3, both with name $1, and no password.
User and group name
[Optional] User ID (default: 1000)
[Optional] Group ID (default: UID)
Changes ownership and/or permissions of file / directory glob.
Required (one or both):
-o X use chown to set ownership to "X"
-m Y use chmod to set permissions to "Y"
Optional:
-t f|d apply only to files ("f") or directories ("d")
-rif -t is not specified, applies action recursively to all files and directories
Clears contents of /tmp and apk cache.
Calls esh in a consistent manner.
Path to input (template) file
Path to output (generated) file
Display name and version of the current image, and a link to the GitHub repository.
Run install /tmp/install and then perform cleanup (see ). Within the ecosystem this would normally be used in a Dockerfile
This is the basic structure of Dockerfiles based on the Alpine S6 image, copying overlay and then running the standard installation.
Runs rm -rf $1 safely: doing nothing if $1 is empty. This is handy if the path you are deleting is contained in a variable (it effectively stops rm -rf /!).
Folder path / file glob to delete.
Generates a string of random letters and numbers of length $1.
[Optional] Number of characters to return
Uses wget to test URL $1.
URL to test
Sets the container's timezone to $1. (Installs tzdata package, changes timezone and then removes tzdata).
Valid timezone (e.g. Europe/London)
Note the change in time on line 12.
$ bf-debug "Hi"
[bf] 2021-09-19 18:00:00 | Hi # (in grey)
$ bf-debug "Hi" "alpine-s6/docs"
[bf] 2021-09-19 18:00:00 | alpine-s6/docs: Hi # (in grey)$ bf-done
[bf] 2021-09-19 18:00:00 | done. # (in green)
$ bf-done "alpine-s6/docs"
[bf] 2021-09-19 18:00:00 | alpine-s6/docs: done. # (in green)$ bf-e "docs" "\e[91m" "Hi"
[docs] 2021-09-19 18:00:00 | Hi # (in red)
$ bf-e "docs" "\e[92m" "Hi" "alpine-s6"
[docs] 2021-09-19 18:00:00 | alpine-s6: Hi # (in green)$ bf-echo "Hi"
[bf] 2021-09-19 18:00:00 | Hi # (in black / white)
$ bf-echo "Hi" "docs"
[bf] 2021-09-19 18:00:00 | docs: Hi # (in black / white)$ bf-error "Die"
[bf] 2021-09-19 18:00:00 | Die # (in red)
$ bf-error "Die" "docs"
[bf] 2021-09-19 18:00:00 | docs: Die # (in red)$ bf-notok "Error"
[bf] 2021-09-19 18:00:00 | Error # (in red)
$ bf-notok "Error" "docs"
[bf] 2021-09-19 18:00:00 | docs: Error # (in red)$ bf-ok "Hi"
[bf] 2021-09-19 18:00:00 | Hi # (in green)
$ bf-ok "Hi" "docs"
[bf] 2021-09-19 18:00:00 | docs: Hi # (in green)$ bf-adduser "fred"
[bf] 2021-09-19 18:00:00 | bf-adduser: Adding user and group 'fred'...
[bf] 2021-09-19 18:00:00 | bf-adduser: done. 'fred'... # (in green)
$ cat /etc/passwd
...
fred:x:1000:1000:Linux User,,,:/home/fred:/bin/ash
$ bf-adduser "fred" 1001
[bf] 2021-09-19 18:00:00 | bf-adduser: Adding user and group 'fred'...
[bf] 2021-09-19 18:00:00 | bf-adduser: done. 'fred'... # (in green)
$ cat /etc/passwd
...
fred:x:1001:1001:Linux User,,,:/home/fred:/bin/ash
$ bf-adduser "fred" 1002 1003
[bf] 2021-09-19 18:00:00 | bf-adduser: Adding user and group 'fred'...
[bf] 2021-09-19 18:00:00 | bf-adduser: done. 'fred'... # (in green)
$ cat /etc/passwd
...
fred:x:1002:1003:Linux User,,,:/home/fred:/bin/ash$ bf-ch -o "fred" -m 777 -t f /tmp
[bf] 2021-09-19 18:00:00 | bf-ch: Applying chown fred to /tmp.
[bf] 2021-09-19 18:00:00 | bf-ch: .. type f.
[bf] 2021-09-19 18:00:00 | bf-ch: Applying chmod 777 to /tmp.
[bf] 2021-09-19 18:00:00 | bf-ch: .. type f.
$ bf-ch -o "fred" -m 777 -r /tmp
[bf] 2021-09-19 18:00:00 | bf-ch: Applying chown fred to /tmp.
[bf] 2021-09-19 18:00:00 | bf-ch: .. recursively.
[bf] 2021-09-19 18:00:00 | bf-ch: Applying chmod 777 to /tmp.
[bf] 2021-09-19 18:00:00 | bf-ch: .. recursively.$ bf-clear
[bf] 2021-09-19 18:00:00 | bf-clear: Clearing /tmp...
[bf] 2021-09-19 18:00:00 | bf-clear: done.
[bf] 2021-09-19 18:00:00 | bf-clear: Clearing caches...
[bf] 2021-09-19 18:00:00 | bf-clear: done.$ bf-esh /path/to/template /path/to/output
[bf] 2021-09-19 18:00:00 | bf-esh: /path/to/output created.$ bf-image
[bf] 2021-09-19 18:00:00 | bf-image: bfren alpine 1.2.0.
[bf] 2021-09-19 18:00:00 | bf-image: https://github.com/bfren/docker-alpine.FROM quay.io/bfren/alpine-s6:alpine3.14
COPY ./overlay /
RUN bf-install$ bf-rmrf ""
[bf] 2021-09-19 18:00:00 | bf-rmrf: Cannot remove ''.
bf-rmrf /tmp/*
[bf] 2021-09-19 18:00:00 | bf-rmrf: Removing /tmp/*.$ bf-rnd
7ceeezFaFzbuaHujA2ST2s3ACPAnAEoUqqVXBcdk
$ bf-rnd 10
D8ORzTX56m
$ RND=$(bf-rnd)
$ echo ${RND}
cm1HuNlkQwbqd5TeApoHsxfYE6X1MWxKnuiBbjFr$ bf-test-url https://fake.url
[bf] 2021-09-19 18:00:00 | bf-test-url: Loading https://fake.url.
wget: bad address 'fake.url'
$ bf-test-url https://bbc.co.uk
[bf] 2021-09-19 18:00:00 | bf-test-url: Loading https://bbc.co.uk.
Connecting to bbc.co.uk (151.101.0.81:443)
Connecting to www.bbc.co.uk (212.58.237.254:443)
remote file exists$ bf-tz UTC
[bf] 2021-09-19 18:00:00 | bf-tz: Installing tzdata packages.
fetch https://dl-cdn.alpinelinux.org/alpine/v3.14/main/x86_64/APKINDEX.tar.gz
fetch https://dl-cdn.alpinelinux.org/alpine/v3.14/community/x86_64/APKINDEX.tar.gz
fetch https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz
fetch https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz
(1/2) Installing tzdata (2021a-r0)
(2/2) Installing .tz (20210923.092854)
Executing busybox-1.33.1-r3.trigger
OK: 9 MiB in 17 packages
[bf] 2021-09-19 18:00:00 | bf-tz: Setting timezone to UTC...
[bf] 2021-09-19 17:00:00 | bf-tz: Removing tzdata packages.
(1/2) Purging .tz (20210923.092854)
(2/2) Purging tzdata (2021a-r0)
Executing busybox-1.33.1-r3.trigger
OK: 6 MiB in 15 packages
[bf] 2021-09-19 17:00:00 | bf-tz: done.
$ cat /etc/localtime
TZif2UTCTZif2UTC
UTC0