minidocks/base

minidocks/base 镜像文档

镜像概述和主要用途

minidocks/base 是一款基于Alpine的极小Docker基础镜像，总大小小于8MB，专为开发者设计。该镜像注册了多个版本的Alpine仓库，集成了多种实用工具，并支持主机用户ID/组ID映射、SSH服务、进程管理等功能，可作为轻量级开发环境或构建其他应用容器的基础。

核心功能和特性

Alpine仓库

所有镜像已注册以下apk仓库：

• @edge（包含https://dl-cdn.alpinelinux.org/alpine/edge/main、https://dl-cdn.alpinelinux.org/alpine/edge/community、https://dl-cdn.alpinelinux.org/alpine/edge/testing）
• @320（包含https://dl-cdn.alpinelinux.org/alpine/v3.20/main、https://dl-cdn.alpinelinux.org/alpine/v3.20/community）
• @319（包含https://dl-cdn.alpinelinux.org/alpine/v3.19/main、https://dl-cdn.alpinelinux.org/alpine/v3.19/community）
• @318（包含https://dl-cdn.alpinelinux.org/alpine/v3.18/main、https://dl-cdn.alpinelinux.org/alpine/v3.18/community）

实用工具

镜像包含以下额外软件包：

• https://github.com/krallin/tini：轻量级容器init系统
• monit：UNIX系统进程管理与监控工具
• https://github.com/rvoicilas/inotify-tools：inotify的命令行接口工具
• dropbear：适用于小内存环境的SSH 2客户端/服务器
• envsubst：替换shell格式字符串中的环境变量
• https://www.mozilla.org/en-US/about/governance/policies/security-group/certs/：通用CA证书PEM文件
• https://github.com/ncopa/su-exec：切换用户/组ID、设置组并执行命令
• https://github.com/eficode/wait-for：等待其他服务可用的工具
• https://musl.libc.org/：glibc兼容库
• flock：util-linux提供的文件锁定工具

核心特性

主机用户ID和组ID映射

镜像在运行时可匹配容器内用户ID/组ID与主机用户ID/组ID，确保权限一致性。

灵感来源：

• https://github.com/Graham42/mapped-uid-docker
• https://github.com/reduardo7/docker-host-user

rootfs

支持自定义根文件系统配置（具体细节未详述）。

SSH服务

集成SSH服务功能，支持远程访问（具体细节未详述）。

进程管理（Supervise）

集成以下进程管理工具：

• https://github.com/bahamas10/vsv
• https://github.com/SwagDevOps/sv-utils
• https://github.com/cheshirecode/alpine-runit

使用场景和适用范围

• 开发者环境：作为轻量级基础镜像用于开发和测试
• 基础镜像构建：减少最终应用镜像大小，适用于微服务、CLI工具等场景
• 轻量级部署：需要极小运行环境的服务部署，如资源受限环境

使用方法和配置说明

基本运行命令

bash
docker run --rm -it docker.xuanyuan.run/minidocks/base

运行GUI应用示例

bash
xhost +
docker run --rm -it -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix -v `pwd`:/app -w /app docker.xuanyuan.run/minidocks/gimp

环境变量

以下环境变量用于配置容器行为：

• ALIAS_*：设置别名（具体用法未详述）
• CLEAN：清理操作开关（具体用法未详述）
• ENV_FILE：指定环境变量文件路径
• AUTO_CHOWN：自动修改文件所有者
• PATH_PREFIX：添加到PATH的前缀路径
• PATH_SUFFIX：添加到PATH的后缀路径
• CRON_USER_*：cron任务执行用户
• CRON_SCHEDULE_*：cron任务调度时间
• CRON_COMMAND_*：cron任务执行命令
• STARTUP_COMMAND_*：容器启动时执行的命令
• FILE_*_PATH：文件路径
• FILE_*_CONTENT：文件内容
• SUEXEC：su-exec相关配置（具体用法未详述）
• ID：用户ID相关标识（具体用法未详述）
• USER_NAME：用户名，可使用$USERNAME获取当前用户名
• USER_ID：用户ID，可使用$UID获取当前用户ID
• GROUP_NAME：用户组名，可使用$(id -g -n $USERNAME)获取当前用户组名
• GROUP_ID：用户组ID，可使用$(id -g $USERNAME)获取当前用户组ID
• USER_SHELL：用户shell，默认值：/bin/bash
• USER_PASSWORD：用户密码，默认值：password
• USER_MASK：用户权限掩码

标签信息

灵感来源

• https://github.com/just-containers/s6-overlay
• [***]
• http://www.projectatomic.io/docs/docker-image-author-guidance/
• https://github.com/nimmis/docker-alpine-micro
• https://github.com/dockage/alpine
• https://github.com/docker-suite/alpine-base/

替代方案

• https://github.com/CraftDock/alpine-base
• https://github.com/thecodingmachine/docker-images-php
• https://github.com/bash-suite
• https://github.com/QuantumObject/docker-alpine

参考链接：

• https://ypereirareis.github.io/blog/2015/12/01/docker-container-external-links-alias-hosts-unavailable/
• [***]