weaveworks/build-haskell

Haskell代码构建镜像

镜像概述

本Docker镜像专为Haskell代码构建设计，集成Haskell编译器（GHC）及主流构建工具（如Cabal、Stack），提供隔离、统一的Haskell项目构建环境。通过预配置必要的工具链，简化Haskell项目的编译、打包流程，避免因系统依赖差异导致的构建问题，适用于开发、测试及CI/CD场景。

核心功能与特性

• 完整工具链集成：包含GHC（Glasgow Haskell Compiler）、Cabal（Haskell包管理器）、Stack（Haskell项目构建工具）等核心组件，满足Haskell项目构建全流程需求。
• 多版本支持：提供多种Haskell版本标签（如9.6、9.4、9.2、8.10等），可根据项目需求选择对应GHC版本。
• 隔离构建环境：基于Docker容器隔离特性，避免构建过程中与宿主系统依赖冲突，确保跨环境构建一致性。
• 轻量级优化：在集成完整工具链的同时优化镜像体积，减少资源占用，提升构建效率。

使用场景

• 本地Haskell项目构建：开发者无需在本地系统手动配置Haskell环境，通过镜像快速构建项目。
• CI/CD流程集成：作为持续集成/部署流程中的构建环节，确保不同环境下构建结果一致。
• 多版本项目兼容：针对依赖不同Haskell版本的项目，通过切换镜像标签快速适配构建环境。
• 项目打包分发：编译Haskell项目后，可直接从容器导出可执行文件或包，用于后续分发部署。

使用方法与配置说明

基本构建命令（docker run）

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

bash
# 示例：使用9.2版本镜像构建Cabal项目
docker run -v $(pwd)/my-haskell-project:/app -w /app haskell-build-image:9.2 cabal build

• 参数说明：
  • -v $(pwd)/my-haskell-project:/app：将本地项目目录挂载至容器内/app目录
  • -w /app：设置工作目录为/app（项目根目录）
  • haskell-build-image:9.2：指定镜像及版本标签（标签对应GHC版本）
  • cabal build：构建命令（根据项目工具选择cabal或stack）

构建产物导出

构建完成后，将产物复制到本地目录：

bash
# 示例：构建并导出Cabal产物
docker run -v $(pwd)/my-haskell-project:/app -w /app haskell-build-image:9.2 sh -c "cabal build && cp -r dist-newstyle /app/dist"

docker-compose配置示例

创建docker-compose.yml简化构建流程：

yaml
version: '3'
services:
  haskell-builder:
    image: haskell-build-image:9.2
    volumes:
      - ./my-haskell-project:/app           # 挂载项目目录
      - ~/.cabal/store:/root/.cabal/store   # 挂载Cabal缓存（加速重复构建）
    working_dir: /app
    command: cabal build --enable-optimization  # 带优化参数的构建命令
    environment:
      - CABAL_UPDATE=true  # 构建前更新Cabal包索引（可选）

执行构建：docker-compose up

环境变量配置

支持的镜像标签

注意事项

• 权限问题：确保本地项目目录具备读写权限，避免容器内工具访问失败。
• 缓存优化：挂载工具缓存目录（如~/.cabal/store、~/.stack）可大幅提升重复构建速度。
• 构建工具选择：Cabal项目使用cabal build，Stack项目使用stack build，需根据项目配置调整命令。
• 版本兼容性：选择与项目cabal.project或stack.yaml中GHC版本匹配的镜像标签。