bellsoft/alpaquita-linux-gcc 镜像文档

镜像概述与主要用途

bellsoft/alpaquita-linux-gcc 是基于 Alpaquita Linux Stream 的 Docker 镜像，集成了 GCC 编译器、开发工具及库，专为 C/C++ 应用开发设计。该镜像依托 Alpaquita Linux 的轻量级特性与性能优化，提供高效、兼容的开发环境。

核心功能与特性

Alpaquita Linux 基础特性

• 轻量级设计：基础镜像大小仅 3.22MB，适合构建小型高效容器
• 优化的 C 标准库：提供 musl perf 实现，兼具体积小与高性能特性，100% 兼容标准 musl
• 多内存分配器：内置四种 malloc 实现，适应不同 workload 需求
• 低资源占用：运行时资源消耗低，适合云原生环境部署
• 广泛兼容性：支持 Docker 与 QEMU，可无缝集成至容器化工作流

镜像核心功能

• 完整 GCC 工具链：包含 GCC 编译器、链接器及开发库，满足 C/C++ 开发需求
• musl 兼容性：与 Alpine 等 musl 系统完全兼容，支持从 Alpine 平滑迁移
• 高性能 glibc 版本：提供基于 glibc 的镜像变体，部分场景性能优于主流 glibc 系统
• 版本灵活选择：通过标签区分 GCC 版本及 libc 类型（musl/glibc）

使用场景与适用范围

• C/C++ 开发环境：快速搭建轻量级编译环境，适合本地开发或 CI/CD 流水线
• 轻量级容器构建：作为基础镜像构建资源占用低的容器化应用
• Alpine 迁移项目：从 Alpine Linux（musl 基础）迁移的 C/C++ 项目，无需修改代码
• 高性能 glibc 需求：需使用 glibc 但追求更高性能的场景（如计算密集型应用）

标签说明（Tags）

镜像标签用于区分 GCC 版本及 libc 类型，格式如下：

使用方法与配置说明

基础使用（docker run）

通过以下命令启动容器并进入交互式终端，用于临时开发或编译：

bash
# 使用最新 musl 版本（默认 latest 标签）
docker run -it --rm bellsoft/alpaquita-linux-gcc

# 使用指定版本（如 GCC 12.2，musl 库）
docker run -it --rm bellsoft/alpaquita-linux-gcc:12.2-musl

# 使用 glibc 版本
docker run -it --rm bellsoft/alpaquita-linux-gcc:glibc

C/C++ 编译示例

在容器内创建并编译 C 程序：

bash
# 进入容器后，创建测试文件
echo '#include <stdio.h>
int main() { printf("Hello, Alpaquita Linux!\n"); return 0; }' > test.c

# 使用 GCC 编译
gcc test.c -o test

# 运行编译产物
./test  # 输出：Hello, Alpaquita Linux!

安装额外依赖

通过 Alpaquita 的 apk 包管理器安装开发依赖（如 make、cmake 等）：

bash
# 在容器内执行
apk update && apk add make cmake

Docker Compose 配置示例

创建 docker-compose.yml，挂载本地代码目录进行开发：

yaml
version: '3'
services:
  dev-env:
    image: bellsoft/alpaquita-linux-gcc:musl
    volumes:
      - ./src:/app  # 挂载本地 src 目录至容器内 /app
    working_dir: /app
    tty: true  # 保持终端交互

启动服务：

bash
docker-compose up -d
docker-compose exec dev-env sh  # 进入容器终端

许可证信息

本镜像包含的软件（含 GCC 及 Alpaquita Linux 组件）可能受不同许可证约束。完整的已安装软件及其许可证信息可通过容器内执行以下命令查看：

bash
apk list -I

使用本镜像时，用户需自行确保对包含软件的使用符合相关许可证要求。GCC 编译器的许可证信息参见 ***文档。

Alpaquita Linux 由 BellSoft 开发维护，更多信息参见 ***文档。