bellsoft/alpaquita-linux-go repository overview

⁠bellsoft/alpaquita-linux-go

⁠What is Alpaquita Linux?

Alpaquita Linux is a lightweight operating system optimized for the deployment of cloud native applications. It is an optimal solution for running applications with various workloads and is characterized by

• Userspace binaries protection
• Four malloc implementations in total
• Optimized standard C library implementation ‘musl perf’, both small and performant
• Base image size of 3.22MB, which is perfect for running small and performant containers
• Docker and QEMU support

Alpaquita Linux requires a small amount of resources to run. The extra modules and additional packages can be installed from Alpaquita apk repository depending on the project requirements. Alpaquita comes in two versions: one based on optimized Musl libc, and the other one on Glibc libc.

Developer and maintainer: BellSoft⁠

For documentation and support information, refer to the official page⁠.

⁠What’s in this repository?

This repository contains Alpaquita Linux images for building Go applications.

It's recommended to use these images as the 'builder' image in multi-stage builds, and use a bellsoft/alpaquita-linux-base image as a runtime for the application.

For example, if the current directory contains a Go application source code, the following Dockerfile will build it with the Go image and produce an Alpaquita image with the application:

FROM bellsoft/alpaquita-linux-go:glibc AS builder

COPY . /app
RUN cd /app && go build -o app .

FROM bellsoft/alpaquita-linux-base:glibc
COPY --from=builder /app/app /usr/local/bin/
ENTRYPOINT ["/usr/local/bin/app"]

Unless your application strictly depends on Glibc features, please consider using Musl-based builder and runtime images, as it may lead to a smaller final image size.

Images come with the GODEBUG environment variable set to tarinsecurepath=0,zipinsecurepath=0 (see Go 1.20 Release Notes⁠). This can be overridden by setting GODEBUG explicitly.

⁠Tags

Alpaquita Linux supports the latest major Go release, and there are tags for each libc type:

• 1.X-glibc, 1.X.Y-glibc - specified version of Go with Glibc
• 1.X-musl, 1.X.Y-musl - specified version of Go with Musl
• glibc - latest Go version with Glibc
• musl, latest - latest Go version with Musl

⁠License

As with all Docker images, these also contain other software, which may be distributed under other licenses.

The list of installed software components and their licenses can be retrieved by executing the apk list -I command in the image.

As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.