arm64v8/haskell

注意：这是 https://hub.docker.com/_/haskell 的 arm64v8 架构构建的“每架构”仓库——更多信息请参见官方镜像文档中的“https://github.com/docker-library/official-images#architectures-other-than-amd64%E2%80%9D%E4%BB%A5%E5%8F%8A%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84%E2%80%9Chttps://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E2%80%9D%E3%80%82

快速参考

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

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应的 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/%E3%80%81https://hub.docker.com/r/arm64v8/haskell/

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

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

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/haskell%EF%BC%88https://github.com/docker-library/docs/commits/master/haskell%EF%BC%89

什么是Haskell？

Haskell 是一种惰性、函数式、静态类型编程语言，具有高级类型系统特性，如高阶、高类阶参数化多态、单子效应、广义代数数据类型（GADTs）、灵活的类型类、关联类型族等。

Haskell 的 ghc 是一款可移植的优化编译器，具有外部函数接口（FFI）、LLVM 后端，以及对并发、显式/隐式https://simonmar.github.io/pages/pcph.html%E3%80%81%E8%BF%90%E8%A1%8C%E6%97%B6%E5%88%86%E6%9E%90%E7%AD%89%E7%9A%84%E5%A4%8D%E6%9D%82%E8%BF%90%E8%A1%8C%E6%97%B6%E6%94%AF%E6%8C%81%E3%80%82%E5%85%B6%E4%BB%96 Haskell 工具如 criterion、quickcheck、hpc 和 haddock 提供高级基准测试、基于属性的测试、代码覆盖率和文档生成功能。

大量生产级质量的 Haskell 库可从 Hackage 以 Cabal 包的形式获取。传统的 cabal 工具或较新的 stack 工具（7.10.3 及以上版本可用）可用于简化 Cabal 包的使用。

!https://raw.githubusercontent.com/docker-library/docs/53e03448d5c2c33124ce24609f6179ddc94873f4/haskell/logo.png

关于本镜像

本镜像包含最小化的 Haskell 工具链（ghc 和 cabal-install）以及尽可能包含的 stack 工具（[***] stack。

ARM64 支持是新增的，目前应视为实验性阶段。从 8.10.7、9.0.2 和 9.2.1 版本开始添加了 ARM64 支持。

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

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

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

如何使用本镜像

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

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

使用 stack 容器化应用：

dockerfile
FROM arm64v8/haskell:8.10
RUN stack install --resolver lts-17.14 pandoc citeproc
ENTRYPOINT ["pandoc"]

使用 cabal 容器化应用：

dockerfile
FROM arm64v8/haskell:8.10
RUN cabal update && cabal install pandoc citeproc
ENTRYPOINT ["pandoc"]

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

dockerfile
FROM arm64v8/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 等工具的注意事项

一些同时作为构建依赖的包（如 happy 和 alex）不再包含在本镜像中（从 arm64v8/haskell:8.2.2 和 arm64v8/haskell:8.4.3 版本开始）。存在一个引导问题，即可能会假设这些工具中的一个或多个已可用。如果遇到有关 Cabal 包中未明确列出的依赖项缺失的错误，你需要显式标记它们进行安装。

关于 Stack 的注意事项

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

另一个常见的易混淆场景是默认的 Stackage 快照。Stackage 快照是一组固定到特定版本的 Haskell 包集合，以确保与特定 GHC 版本的兼容性。当你要求 Stack 解析依赖项时，它会通过 resolver 值引用特定快照。虽然你应在项目中显式指定 resolver，但也可能使用自动生成的默认值。该默认值由请求时从上游 Stackage 服务器获取的值确定，并指向最新的“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.

在这种情况下，arm64v8/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 镜像上下文中没有意义，因此（从 arm64v8/haskell:8.2.2 和 arm64v8/haskell:8.4.3 版本开始）全局 install-ghc 标志已设置为 false，以避免在容器中引导新 GHC 的默认行为。

镜像变体

arm64v8/haskell 镜像有多种版本，每种版本设计用于特定用例。

arm64v8/haskell:<version>

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

其中一些标签可能包含 bookworm 或 bullseye 等名称。这些是 Debian 发行版的代号，表示镜像所基于的发行版。如果你的镜像需要安装除镜像自带包之外的其他包，你可能需要显式指定其中一个代号，以最大程度减少 Debian 新版本发布时的中断。

arm64v8/haskell:<version>-slim

此镜像不包含默认标签中的常见包，仅包含运行 ghc、cabal-install 和 stack 所需的最小包。此外，不包含分析支持，可节省约 700MB 空间。

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

许可证

本镜像根据 MIT 许可证授权（https://github.com/haskell/docker-haskell/blob/master/LICENSE%EF%BC%89%EF%BC%8C%E5%B9%B6%E5%8C%85%E5%90%AB%E6%A0%B9%E6%8D%AE BSD 许可证授权的软件：Glasgow Haskell Compiler 许可证、https://github.com/commercialhaskell/stack/blob/master/LICENSE%E3%80%82

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

一些能够自动检测到的其他许可证信息可能位于 https://github.com/docker-library/repo-info/tree/master/repos/haskell%E4%B8%AD%E3%80%82

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