library/haskell

快速参考

• 维护者：
  https://github.com/haskell/docker-haskell

• 获取帮助：
  https://dockr.ly/comm-slack、Server Fault、https://unix.stackexchange.com/help/on-topic 或 https://stackoverflow.com/help/on-topic

支持的标签及对应的 Dockerfile 链接

• https://github.com/haskell/docker-haskell/blob/c34f97738d08a138ef07878a4a1402b***f87b/9.12/bookworm/Dockerfile

• https://github.com/haskell/docker-haskell/blob/c34f97738d08a138ef07878a4a1402b***f87b/9.12/slim-bookworm/Dockerfile

• https://github.com/haskell/docker-haskell/blob/c34f97738d08a138ef07878a4a1402b***f87b/9.10/bullseye/Dockerfile

• https://github.com/haskell/docker-haskell/blob/c34f97738d08a138ef07878a4a1402b***f87b/9.10/slim-bullseye/Dockerfile

• https://github.com/haskell/docker-haskell/blob/c34f97738d08a138ef07878a4a1402b***f87b/9.8/bullseye/Dockerfile

• https://github.com/haskell/docker-haskell/blob/c34f97738d08a138ef07878a4a1402b***f87b/9.8/slim-bullseye/Dockerfile

• https://github.com/haskell/docker-haskell/blob/c34f97738d08a138ef07878a4a1402b***f87b/9.6/bullseye/Dockerfile

• https://github.com/haskell/docker-haskell/blob/c34f97738d08a138ef07878a4a1402b***f87b/9.6/slim-bullseye/Dockerfile

快速参考（续）

• 提交issue地址：
  https://github.com/haskell/docker-haskell/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/haskell/、https://hub.docker.com/r/arm64v8/haskell/

• 已发布镜像 artifact 详情：
  https://github.com/docker-library/repo-info/blob/master/repos/haskell（https://github.com/docker-library/repo-info/commits/master/repos/haskell）
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fhaskell
  https://github.com/docker-library/official-images/blob/master/library/haskell（https://github.com/docker-library/official-images/commits/master/library/haskell）

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/haskell（https://github.com/docker-library/docs/commits/master/haskell）

什么是 Haskell？

http://www.haskell.org 是一种http://en.wikibooks.org/wiki/Haskell/Laziness、函数式、静态类型编程语言，具有高级类型系统特性，如高阶、高kind多态性、单子效应、广义代数数据类型（GADT）、灵活的类型类、关联类型族等。

Haskell 的 http://www.haskell.org/ghc 是一款https://gitlab.haskell.org/ghc/ghc/-/wikis/platforms的优化编译器，支持外部函数接口（FFI）、LLVM 后端，以及对并发、显式/隐式并行、运行时分析等的复杂运行时支持。其他 Haskell 工具如 criterion、quickcheck、hpc 和 haddock 提供高级基准测试、基于属性的测试、代码覆盖率和文档生成功能。

大量生产级 Haskell 库可从 https://hackage.haskell.org 以 https://www.haskell.org/cabal/ 包的形式获取。传统的 cabal 工具或较新的 http://docs.haskellstack.org/en/stable/README.html 工具（7.10.3+ 版本中可用）可用于简化 Cabal 包的使用。

关于本镜像

本镜像包含最小化的 Haskell 工具链（ghc 和 cabal-install）以及可能的 stack 工具（https://www.haskellstack.org/）。由于 https://github.com/commercialhaskell/stack/issues/2103，因此该架构不包含 stack。

ARM64 支持为新增功能，目前处于实验阶段。自 8.10.7、9.0.2 和 9.2.1 版本起已添加该支持。

注意：GHC 开发者不支持旧版本分支（如 7.8.x）。仅最近两个次要版本会接收更新或显示在本页面顶部的“支持的标签”部分。

此外，我们旨在支持 Debian 的两个最新版本（stable 和 oldstable）作为变体，未指定时默认使用最新版本。

注意：当前 Debian stable 版本为 11 bullseye，但 Haskell 工具链尚未完全支持。在此之前，默认仍为 Debian 10 buster。我们已停止支持 Debian 9 stretch。

如何使用本镜像

使用 ghci 启动交互式解释器会话：

console
$ docker run -it --rm haskell:9
GHCi, version 9.0.1: http://www.haskell.org/ghc/  :? for help
Prelude>

使用 stack 容器化应用：

dockerfile
FROM docker.xuanyuan.run/haskell:8.10
RUN stack install --resolver lts-17.14 pandoc citeproc
ENTRYPOINT ["pandoc"]

使用 cabal 容器化应用：

dockerfile
FROM docker.xuanyuan.run/haskell:8.10
RUN cabal update && cabal install pandoc citeproc
ENTRYPOINT ["pandoc"]

使用利用构建缓存的 Dockerfile 迭代开发 Haskell 应用：

dockerfile
FROM docker.xuanyuan.run/haskell:8

WORKDIR /opt/example

RUN cabal update

# 仅添加 .cabal 文件以捕获依赖
COPY ./example.cabal /opt/example/example.cabal

# Docker 会将此命令缓存为一层，允许修改源代码而无需重新安装依赖
#（除非 .cabal 文件更改！）
RUN cabal build --only-dependencies -j4

# 添加并安装应用代码
COPY . /opt/example
RUN cabal install

CMD ["example"]

关于 happy、alex 等工具的注意事项

自 haskell:8.2.2 和 haskell:8.4.3 版本起，本镜像不再包含部分同时作为构建依赖的包（如 happy 和 alex）。这些工具可能被假设为已安装，从而导致引导问题。如果遇到未在 Cabal 包中明确声明的依赖缺失错误，需显式标记安装它们。

关于 Stack 的注意事项

Stack 工具主要设计为直接在主机上运行，具有 GHC 引导、Docker 集成等高级功能。在容器镜像环境中，部分功能（如 stack docker）可能与 Docker 抽象冲突，应避免使用。

另一个常见混淆场景是默认 Stackage 快照。Stackage 快照是一组固定版本的 Haskell 包，与特定 GHC 版本兼容。当要求 Stack 解析依赖时，它通过 resolver 值引用特定快照。虽然项目中应显式指定 resolver，但也可使用自动生成的默认值。该默认值由请求时从 https://www.stackage.org/ 获取，指向最新的“LTS”快照。如果快照引用的 GHC 版本与 Docker 镜像提供的版本不同，可能会看到类似以下消息：

console
Step 2/3 : RUN stack install pandoc
 ---> Running in e20466d52060
Writing implicit global project config file to: /root/.stack/global-project/stack.yaml
Note: You can change the snapshot via the resolver field there.
Using latest snapshot resolver: lts-11.11
Downloading lts-11.11 build plan ...
Downloaded lts-11.11 build plan.
Compiler version mismatched, found ghc-8.4.3 (x86_64), but expected minor version match with ghc-8.2.2 (x86_64) (based on resolver setting in /root/.stack/global-project/stack.yaml).
To install the correct GHC into /root/.stack/programs/x86_64-linux/, try running "stack setup" or use the "--install-ghc" flag.

此时，haskell Docker 镜像中的 GHC 版本已超前于 Stack 默认解析器预期的 GHC 版本。如输出所示，推荐在项目中显式设置解析器（通常通过 stack.yml）：

console
Step 2/3 : RUN stack install --resolver ghc-8.4.3 pandoc
 ---> Running in 0bd7f1fcc8b2
Writing implicit global project config file to: /root/.stack/global-project/stack.yaml
Note: You can change the snapshot via the resolver field there.
Using resolver: ghc-8.4.3 specified on command line
Updating package index Hackage (mirrored at https://s3.amazonaws.com/hackage.fpcomplete.com/) ...
Selected mirror https://s3.amazonaws.com/hackage.fpcomplete.com/

使用 --install-ghc 在 Docker 镜像环境中无意义，因此自 haskell:8.2.2 和 haskell:8.4.3 版本起，全局 install-ghc 标志已设为 false，以避免在容器中引导新 GHC 的默认行为。

镜像变体

haskell 镜像有多种变体，每种针对特定用例设计。

haskell:<version>

这是默认镜像。如果不确定需求，建议使用此版本。它既可用作临时容器（挂载源代码并启动容器运行应用），也可用作构建其他镜像的基础。

部分标签可能包含 bookworm 或 bullseye 等名称，这些是 https://wiki.debian.org/DebianReleases 的版本代号，指示镜像基于哪个发行版。如果镜像需要安装除自带包外的其他包，建议显式指定这些代号，以减少 Debian 新版本发布时的兼容性问题。

haskell:<version>-slim

此镜像不包含默认标签中的常见包，仅包含运行 ghc、cabal-install 和 stack 所需的最小包。此外，不包含https://downloads.haskell.org/~ghc/latest/docs/html/users_guide/profiling.html，可节省约 700MB 空间。

如果关注镜像大小，建议使用 slim 镜像。

许可证

本镜像根据 MIT 许可证授权（https://github.com/haskell/docker-haskell/blob/master/LICENSE），并包含根据 BSD 许可证授权的软件：https://www.haskell.org/ghc/license、https://github.com/commercialhaskell/stack/blob/master/LICENSE。

与所有 Docker 镜像一样，这些镜像可能还包含其他软件，可能受其他许可证约束（如基础发行版中的 Bash 等，以及主要软件的任何直接或间接依赖）。

部分可自动检测的附加许可证信息可能位于 https://github.com/docker-library/repo-info/tree/master/repos/haskell。

对于任何预构建镜像的使用，镜像用户有责任确保对本镜像的任何使用符合其中包含的所有软件的相关许可证。