fpco/stack-build

Haskell Stackage构建环境镜像

镜像概述

本镜像专为Haskell开发者设计，集成了构建所有Stackage包所需的完整环境。包含带补丁的GHC编译器、Haskell构建工具链（stack、cabal-install等）、代码生成工具（happy、alex等）以及必要的系统开发库，可直接用于Stackage包的编译与构建工作。

该镜像与https://github.com/commercialhaskell/stack/wiki/Docker%E5%85%BC%E5%AE%B9%EF%BC%8C%E5%85%B6Dockerfile%E5%8F%8A%E6%9E%84%E5%BB%BA%E8%84%9A%E6%9C%AC%E6%BA%90%E7%A0%81%E6%89%98%E7%AE%A1%E4%BA%8Ehttps://github.com/commercialhaskell/stack/tree/master/etc/dockerfiles/stack-build%E3%80%82

核心功能与特性

核心组件

• GHC编译器：包含经过补丁的GHC（Glasgow Haskell Compiler），确保对Stackage包的兼容性
• 构建工具链：
  • stack：Haskell项目构建工具，支持依赖管理与多版本GHC
  • cabal-install：Cabal构建系统的命令行工具
• 代码生成工具：
  • happy：Haskell解析器生成器
  • alex：Haskell词法分析器生成器
• 系统开发库：预安装构建Stackage包所需的系统级依赖库（如libc-dev、zlib-dev等）

特性

• 完整性：覆盖Stackage全量包构建需求，无需额外手动安装依赖
• 兼容性：与stack工具链深度集成，符合Stackage包构建标准
• 开箱即用：预装所有必要组件，拉取后可直接启动构建流程

使用场景与适用范围

适用场景

• Haskell开发者本地构建、测试Stackage包
• CI/CD流水线中自动化编译Stackage项目
• 跨平台一致的Stackage包构建环境

适用人群

• Haskell库开发者
• Stackage包维护人员
• 需要标准化Haskell构建环境的团队

使用方法

镜像拉取

可通过Docker Hub或直接从源码构建获取镜像（具体镜像标签请参考GitHub仓库说明）：

bash
docker pull docker.xuanyuan.run/<镜像名称>:<标签>  # 需替换为实际镜像名称及标签

基础使用示例

本地构建Stackage包

通过docker run启动容器，挂载项目目录并执行构建命令：

bash
docker run -v /path/to/your/haskell/project:/workspace \
  -w /workspace \
  <镜像名称>:<标签> \
  stack build

• -v：挂载本地项目目录到容器内/workspace
• -w：设置工作目录为/workspace
• stack build：执行项目构建（可替换为cabal build等其他命令）

与stack集成使用

参考https://github.com/commercialhaskell/stack/wiki/Docker%EF%BC%8C%E5%9C%A8%60stack.yaml%60%E4%B8%AD%E9%85%8D%E7%BD%AE%E4%BD%BF%E7%94%A8%E6%9C%AC%E9%95%9C%E5%83%8F%E4%BD%9C%E4%B8%BA%E6%9E%84%E5%BB%BA%E7%8E%AF%E5%A2%83%EF%BC%9A

yaml
docker:
  enable: true
  image: docker.xuanyuan.run/<镜像名称>:<标签>

配置说明

环境变量

本镜像未定义额外环境变量，可通过docker run -e参数传入自定义环境变量（如STACK_ROOT指定stack数据目录等）：

bash
docker run -e STACK_ROOT=/custom/stack/root ...

自定义构建

如需调整镜像内容，可从GitHub仓库获取Dockerfile源码进行修改和构建：

bash
git clone https://github.com/commercialhaskell/stack.git
cd stack/etc/dockerfiles/stack-build
docker build -t custom-stack-build .

参考链接

• https://github.com/commercialhaskell/stack/wiki/Docker
• https://github.com/commercialhaskell/stack/tree/master/etc/dockerfiles/stack-build
• https://www.stackage.org/