Sign inSign up

kgrv/alpaquita

By kgrv

•Updated 5 months ago
Archived

(ARCHIVED) An alpaquita image with 'init' and 'user'

Image
Operating systems
0

2.0K

kgrv/alpaquita repository overview

⁠NOTICE - ARCHIVED

Important

There is no current plan to develop nor support this image, may change as needed.

⁠DESCRIPTION

An alpaquita⁠ image with init, user based on kgrv/mini⁠.

⁠SUPPORTED TAGS

⁠SUPPORTED ARCHITECTURES

OS/ARCHDescription
linux/amd6464-bit x86 architecture for Linux operating systems
linux/arm6464-bit ARM architecture for Linux operating systems

⁠PARAMETERS

TypeContainerFunction
EnvironmentEUIDOptional Effective User ID
EnvironmentEGIDOptional Effective Group ID
EnvironmentUMASKOptional Default permissions
EnvironmentSUGGESTOptional Set suggestion messages
EnvironmentFALLBACK_CMDOptional Set command when empty
Volume/mntOptional Bind mount volume

⁠OVERVIEW

⁠Dockerfile

KeywordConfiguration
STOPSIGNALSIGHUP
SHELL[ "/bin/ash", "-euxo", "pipefail", "-c" ]
ENVLD_LIBRARY_PATH=/app/lib:/usr/local/lib
ENVPATH_APP=/app
ENVPATH_CONFIG=/config
ENVPATH_DATA=/data
ENVPATH_MNT=/mnt
WORKDIR${PATH_MNT} -> /mnt
ENTRYPOINT[ "tini", "--", "enpt" ]
CMD[ "/bin/ash" ]

⁠User / Group ID

  • EUID / EGID environment variables
  • mini:mini as default

⁠Mask

  • UMASK defaults to 0022

⁠Suggestion

  • SUGGEST defaults to true

⁠USAGE

⁠Dockerfile

FROM kgrv/alpaquita
⁠Init / Principle of Least Privilege
  • Utilize tini by using CMD without overriding ENTRYPOINT
FROM kgrv/alpaquita AS develop
...
CMD [ "nreq", "--debug" ]
  • Override ENTRYPOINT with "tini", "--", "enpt"
FROM kgrv/alpaquita AS develop
...
ENTRYPOINT [ "tini", "--", "enpt", "nreq" ]
CMD [ "--debug" ]

⁠Application Init/Entrypoint Script

enpt loads the first ash script found in the following orders:

  • /app/init.sh
  • /app/docker-entrypoint.sh

⁠Time Zone

  • Mount system /etc/localtime or /usr/share/zoneinfo
docker run -it -v /etc/localtime:/etc/localtime:ro kgrv/alpaquita

docker run -it -v /usr/share/zoneinfo/US/Eastern:/etc/localtime:ro kgrv/alpaquita

⁠Docker CLI

docker run -it kgrv/alpaquita
⁠Start container with bind mount
docker run -it -v $(pwd):/mnt kgrv/alpaquita
⁠Start container with UID / GID

Important

Argument --user is not supported, please use EUID/EGID.

docker run -it -e EUID=$(id -u) -e EGID=$(id -g) kgrv/alpaquita
⁠Start container as ROOT
docker run -it kgrv/alpaquita --BECOME_ROOT

⁠Custom Commands

⁠arcm
  • Map different architecture keywords for CI/CD
    A script to map different architecture keywords.

    USAGE: arcm ARCH

    ARGUMENTS:
        ARCH    returns ARCH when no match:
                    aarch64, arm64, x86_64, amd64
                    amd64-n, amd64-x

    RETURNS:
        arm64   <->  aarch64
        amd64   <->  x86_64
        amd64-n  ->  x64
        amd64-x  ->  x86_64
  • Particularly helpful in Dockerfile
...
RUN ARCH="$(arcm ${TARGETARCH})" && \
    wget -nv "https://static.rust-lang.org/rustup/dist/${ARCH}-unknown-linux-musl/rustup-init" && \
...
⁠enpt

Important

Ensure that root (0) user is executing the command.

  • Entrypoint script to be used in Dockerfile
FROM kgrv/mini:sh AS develop
...
ENTRYPOINT [ "tini", "--", "enpt", "nreq" ]
CMD [ "--debug" ]
⁠os-release
  • Display information
    BellSoft Alpaquita Linux stream
    + mini 0.5.0
    Build 2026-04-19T07:59:00Z (aarch64)

    mini 0.5.0
    + busybox 1.37.0
    + ca-certificates 20260413
    + su-exec 0.3
    + tini 369448a1
    Build ca_2026-04-19T07:46:05Z (aarch64)

⁠Custom Scripts

⁠ansi-colors
  • Add ANSI colors to shell scripting
#!/bin/ash
set -euo pipefail
source ansi-colors
...

Tag summary

Content type

Image

Digest

sha256:7f93ff97b…

Size

7.3 MB

Last updated

5 months ago

docker pull kgrv/alpaquita