首页 > 解决方案 > Stack (Haskell) 使用 GitHub Actions 构建源文件缓存

问题描述

在使用 本地构建我的 Haskell 项目时stack build,仅重新编译更改的源文件。不幸的是,我无法让 Stack 在 GitHub Actions 上表现得像这样。请问有什么建议吗?

例子

Lib.hs我用and创建了一个简单的例子Fib.hs,我什至检查了缓存的 .stack-work 文件夹是否在构建之间更新,但它总是编译这两个文件,即使只有一个文件被更改。

这是示例:

  1. (不使用缓存,构建Lib.hsFib.hs+ 依赖项):https ://github.com/MarekSuchanek/stack-test/runs/542163994
  2. (仅Lib.hs更改、构建Lib.hsFib.hs):https ://github.com/MarekSuchanek/stack-test/runs/542174351

我可以从日志(详细堆栈)中观察到缓存中的某些内容正在更新,但我完全不清楚是什么以及为什么。它正确地发现只有Lib.hs更改:“ stack-test-0.1.0.0: unregistering (local file changes: src/Lib.hs)”所以我不明白为什么所有都被编译。我注意到在 2.Fib.hi中没有更新,.stack-work但其他 ( Fib.oFib.dyn_hiFib.dyn_o) 是。

笔记

~/.stack 的缓存是可以的,当没有更改源文件时也可以不构建。当然,这是一个虚拟示例,但我们有不同的项目,其中包含更多源文件,这将显着加快构建速度。当非源文件被更改(例如 README 文件)时,没有按预期构建。

标签: haskellcachingcabalhaskell-stackgithub-actions

解决方案


这个问题的罪魁祸首是堆栈使用时间戳(就像许多其他工具一样)来确定源文件是否已更改。当您在 CI 上恢复缓存并正确执行时,不会重建任何依赖项,但源文件的问题是,当 CI 提供程序为您克隆存储库时,存储库中所有文件的时间戳都已设置到它被克隆的日期和时间。

希望重新编译未更改的源文件的原因现在是有意义的。我们如何解决这个问题。获得它的唯一真正方法是恢复更改特定文件的最后一次 git 提交的时间戳。我很久以前就注意到了这一点,并且在谷歌上搜索了一些关于 SO 的答案,这是我认为的其中一个:Restore a file's modify time in Git

A 对其进行了一些修改以适应我的需求,这就是我最终得到的结果:

  git ls-tree -r --name-only HEAD | while read filename; do
    TS="$(git log -1 --format="%ct" -- ${filename})"
    touch "${filename}" -mt "$(date --date="@$TS" "+%Y%m%d%H%M.%S")"
  done

那个工人在 Ubuntu CI 上对我来说有一段时间了,但是当我需要设置 Azure CI 时,我不想用 bash 以与操作系统无关的方式解决这个问题。出于这个原因,我编写了一个适用于所有 GHC-8.2 和更新版本的 Haskell 脚本,而不需要任何非核心依赖项。我将它用于我的所有项目,我将在这里嵌入它的精华,但也提供一个永久要点的链接

main = do
  args <- getArgs
  let rev = case args of
        [] -> "HEAD"
        (x:_) -> x
  fs <- readProcess "git" ["ls-tree", "-r", "-t", "--full-name", "--name-only", rev] ""
  let iso8601 = iso8601DateFormat (Just "%H:%M:%S%z")
      restoreFileModtime fp = do
        modTimeStr <- readProcess "git" ["log", "--pretty=format:%cI", "-1", rev, "--", fp] ""
        modTime <- parseTimeM True defaultTimeLocale iso8601 modTimeStr
        setModificationTime fp modTime
        putStrLn $ "[" ++ modTimeStr ++ "] " ++ fp
  putStrLn "Restoring modification time for all these files:"
  mapM_ restoreFileModtime $ lines fs

您将如何在没有太多开销的情况下使用它。诀窍是:

  • 使用stack自己来运行脚本
  • 使用与项目完全相同的解析器。

以上两点将确保不会安装多余的依赖项或 ghc 版本。总而言之,唯一需要的两件事是或stack类似的东西,它将跨平台工作:curlwget

# Script for restoring source files modification time from commit to avoid recompilation.
curl -sSkL https://gist.githubusercontent.com/lehins/fd36a8cc8bf853173437b17f6b6426ad/raw/4702d0252731ad8b21317375e917124c590819ce/git-modtime.hs -o git-modtime.hs
# Restore mod time and setup ghc, if it wasn't restored from cache
stack script --resolver ${RESOLVER} git-modtime.hs --package base --package time --package directory --package process

这是一个使用这种方法的真实项目,您可以深入研究它以了解它是如何工作的:massiv-io

在提到他无法在本地重现此问题的评论中编辑@Simon Michael。这样做的原因是,并非所有 CI 上的内容都与本地相同。绝对路径通常是不同的,例如,可能是我现在想不到的其他事情。这些东西,连同源文件时间戳一起导致源文件的重新编译。

例如,按照以下步骤操作,您会发现您的项目将被重新编译:

~/tmp$ git clone git@github.com:fpco/safe-decimal.git
~/tmp$ cd safe-decimal
~/tmp/safe-decimal$ stack build
safe-decimal> configure (lib)
[1 of 2] Compiling Main
...
Configuring safe-decimal-0.2.0.0...
safe-decimal> build (lib)
Preprocessing library for safe-decimal-0.2.0.0..
Building library for safe-decimal-0.2.0.0..
[1 of 3] Compiling Numeric.Decimal.BoundedArithmetic
[2 of 3] Compiling Numeric.Decimal.Internal
[3 of 3] Compiling Numeric.Decimal
...
~/tmp/safe-decimal$ cd ../
~/tmp$ mv safe-decimal safe-decimal-moved
~/tmp$ cd safe-decimal-moved/
~/tmp/safe-decimal-moved$ stack build
safe-decimal-0.2.0.0: unregistering (old configure information not found)
safe-decimal> configure (lib)
[1 of 2] Compiling Main
...

您会看到项目的位置触发了项目构建。尽管项目本身已经重建,但您会注意到没有重新编译任何源文件。现在,如果您将该过程与touch源文件的一个组合在一起,则该源文件将被重新编译。

把它们加起来:

  • 环境可能导致项目被重建
  • 源文件的内容可能会导致源文件(以及依赖它的其他文件)被重新编译
  • 环境与源文件内容或时间戳更改一起可能导致项目与该源文件一起被重新编译

推荐阅读