alpine-plus-plus

A lightweight Docker container for shell scripting with git and GNU tools on Alpine Linux.

Website for our GitHub Actions and tools for developing them: https://actions.cicirello.org/

Docker Hub	Docker Image Version (latest by date)	Docker Pulls
GitHub	GitHub release (latest by date)
Image Stats	Docker Image Size (latest by date)
Build Status	build
License	GitHub
Support	GitHub Sponsors Liberapay Ko-Fi

Summary

The alpine-plus-plus Docker image is designed for shell scripting with bash and GNU tools like gawk, as well as git, while keeping the image size small. It is based on Alpine Linux but adds git, bash, findutils, coreutils, and gawk.

For more information, see my blog post on DEV: gnu-on-alpine and alpine-plus-plus: Two Lightweight Containers for Implementing GitHub Container Actions with Shell Scripting.

Multiplatform Image

alpine-plus-plus supports the following platforms: linux/386, linux/amd64, linux/arm/v6, linux/arm/v7, linux/arm64, linux/ppc64le, linux/s390x.

Source Repository and Builds

The source repository is maintained on GitHub. The images are built on Github and pushed to Docker Hub, as well as the Github Container Registry using Github Actions.

Docker Tags and Versioning Scheme

Each image pushed to Docker Hub and the Github Container Registry is tagged as follows:

• The tag "latest" indicates the latest image.
• Tags in the form MAJOR.MINOR.PATCH (e.g., 3.13.5) correspond to the SemVer of the base Alpine image used.
• Tags in the form MAJOR.MINOR (e.g., 3.13) correspond to the most recent patch level of the base Alpine image used.
• Tags in the form MAJOR (e.g., 3) correspond to the most recent patch level of the base Alpine image used, with major corresponding to the major version.

Installation and Usage

You can use the pre-built image from Docker Hub or the Github Container Registry.

Docker Pull Command:

docker pull cicirello/alpine-plus-plus:latest

Pull from the Github Container Registry:

docker pull ghcr.io/cicirello/alpine-plus-plus:latest

Use as a base image in a Dockerfile:

FROM cicirello/alpine-plus-plus:latest

# Rest of the Dockerfile goes here

Or use as a base image (via the Github Container Registry):

FROM ghcr.io/cicirello/alpine-plus-plus:latest

# Rest of the Dockerfile goes here

For a specific example usage, refer to the Dockerfile of the generate-sitemap GitHub action.

License

Source Code License: The source code, including the Dockerfile, is licensed under the MIT License.

Image Licenses: The pre-built Docker image contains software covered by various licenses, including licenses of the components of Alpine, GNU tools, and git. If you build and distribute an image containing your software using alpine-plus-plus as the base image, it's your responsibility to follow the licenses of all the software contained within the image.