[译] Hexo git deployer 删除了提交历史记录该怎么整？

原文：Hexo git deployer removes commits history? Let's do something about that!

我发现 Hexo 是构建博客和应用许多知名的软件开发原则的好工具，其中之一是自动化。这就是我决定将此博客与 Travis CI 集成以执行 GitHub pages 部署的缘由。但几天以后我注意到一个重要问题 - 从 CI 服务器部署新版本的博客致使从 master 分支中删除全部提交并从一次又一次地初始化提交开始。我花了一段时间才找到解决这个问题的工做方案。这篇博文解释了这个问题的简单解决方案。

<!--more-->

为何 hexo deploy 会首先删除历史记录？

让咱们从了解实际发生的事情开始。当你为 git 部署选项运行 hexo deploy [1]命令时，Hexo 会建立一个名为 .deploy_git 的隐藏文件夹，并将生成的文件从 public 文件夹复制到该文件夹​​。接下来，它初始化目标为 Hexo 远程部署分支的git存储库（若是它尚不存在），并从该文件夹执行 git push --force 到仓库和你在 _config.yml [2]文件中定义的分支。

清单1. 博客的部署配置

deploy:
  type: git
  repo: git@github.com:wololock/wololock.github.io.git
  branch: master

若是你从本地计算机构建和部署博客，而且永远不会删除（或意外丢失）你的博客源代码，你可能永远不会遇到此问题。当你从未被擦除的工做空间执行此操做时，则存在具备完整历史记录的文件夹 .deploy_git，而且 hexo deploy 仅推送实际修改的那些文件。当你迁移到像 Travis CI 这样的 CI 服务器时，这就变了，由于它使用干净的工做区和仓库的新克隆执行构建。在这种状况下，.deploy_git 文件夹根本不存在，将从头开始从新建立。

那么如何部署和保存历史呢？

我发现解决方案很是简单。之前我负责部署的 .travis.yml 文件部分看起来像这样：

清单2. 之前的 Travis CI 部署配置

deploy:
  skip_cleanup: true
  provider: script
  script: hexo deploy
  on:
    branch: develop

只要我将更改推送到 develop 分支，它就会触发 hexo deploy。在这种状况下，它最终建立了一个新的 .deploy_git 文件夹并强制将初始提交推送到 GitHub 仓库。而后，我作了一个小改进 - 我建立了一个简短的 bash 脚本。

清单3. 部署博客使用的脚本

#!/bin/bash

# 使用已部署文件初始化目标
git clone --depth 1 --branch=master https://github.com/wololock/wololock.github.io.git .deploy_git

cd .deploy_git

＃从 ../public/ 复制以前删除全部文件
# 这样 git 能够跟踪上次提交中删除的文件
find . -path ./.git -prune -o -exec rm -rf {} \; 2> /dev/null

cd ../

# 部署
hexo clean
hexo deploy

这个脚本彻底按照它在注释中所说的那样作：

• 它将 master 分支从远程存储库克隆到 .deploy_git 以获取现有提交历史记录。
• 而后它从 .deploy_git 中删除全部非 git 对象存储库文件，所以从 public 文件夹复制文件将跟踪已删除的文件。
• 最后 - 它执行常规部署的 hexo deploy 命令。

最后，这是在引入部署bash脚本后的部署配置部分：

清单4. 当前的 Travis CI 部署配置

deploy:
  skip_cleanup: true
  provider: script
  script: sh deploy.sh
  on:
    branch: develop

因为这个解决方案，我可以保留站点更新的历史记录，并跟踪使用给定站点更新实际修改的文件的更改。

最后的话

我但愿你发现这篇文章颇有用。它描述了 Hexo + Travis CI + GitHub 用例的解决方案，但它能够解决从 CI 服务器环境运行时其余相似静态站点生成器可能遇到的问题。

参考

1. Documentation: https://hexo.io/docs/deployment
2. https://github.com/wololock/w...