git - 设置一个 git post-receive 钩子(Hook)

Question

我正在尝试按照说明进行操作 http://jekyllrb.com/docs/deployment-methods/为 Jekyll 部署设置一个 git post-receive Hook ，但是，我发现它们对我来说有点密集。在那个链接上，有一段说

To have a remote server handle the deploy for you every time you push changes using Git, you can create a user account which has all the public keys that are authorized to deploy in its authorized_keys file. With that in place, setting up the post-receive hook is done as follows:

问题 1:我不清楚“用户帐户”应该在哪里创建(在 Github 上？在远程服务器上)，以及(问题 2)这个 authorized_keys 文件应该在哪里。我在本地计算机的主目录中有一个 known_hosts 文件，其中包含 github 等的 key 。这是 authorized_keys 文件吗？

接下来的说明会告诉您像这样设置一个接收后 Hook

laptop$ ssh deployer@myserver.com
server$ mkdir myrepo.git
server$ cd myrepo.git
server$ git --bare init
server$ cp hooks/post-receive.sample hooks/post-receive
server$ mkdir /var/www/myrepo

mkdir myrepo.git 指令对我来说有点不清楚。例如，我将我的 Jekyll 站点放入本地计算机上的 git 版本控制中，它给了我这个路径 /Users/me/Sites/nginxjekyll/_site/.git/

问题 3) 那么，这是否意味着，按照 mkdir myrepo.git 指令，我应该在我的远程服务器？继续前进，它说，

   cp hooks/post-receive.sample hooks/post-receive

但是，我没有要复制的 hooks/post-receive.sample 文件？在我本地机器上的 git 存储库中，我有一个 post-update.sample 但没有 post-receive.sample。此外，当我在我的远程服务器上创建目录 mkdir/Users/me/Sites/nginxjekyll/_site/.git/时，它没有在其中创建 post-update.sample 文件。

如果你有时间，你能为我解释一下这些说明吗？先感谢您。

Answer 1

问题 1:它们指的是远程服务器上的用户。

问题 2: 这取决于两种情况: 1. 您需要添加本地用户的公钥才能推送到远程服务器。 2. 如果需要 ssh 部署到另一台服务器，您将需要向运行接收后 Hook 的本地用户添加公钥。很可能只有 1 是您关心的问题，而 2 不是因为远程服务器将容纳远程 git 存储库和 www 服务器。

这意味着您将公钥添加到 linux/unix 环境中的 authorized_keys 文件中。此文件通常位于/home/$USER/.ssh/authorized_keys 中 authorized_keys 文件位于与用户的 known_hosts 文件相同的目录中。

问题 3: 他们正在解释如何设置远程 git 存储库。它不需要与您的本地存储库位于同一路径。

好的 - 现在来澄清这里到底发生了什么。本教程教您如何设置远程存储库，每次推送到该存储库时都会部署 jekyll 安装。

这意味着如果你有一个 github 仓库，你不能在那里设置服务器端 Hook 。相反，您会在远程服务器上设置一个新的远程服务器。假设您登录到您的服务器(通常使用 ssh)，运行 pwd 以了解您的完整路径或将其设置在环境变量中:

$DIR=`pwd`

现在您可以在此服务器上创建一个裸仓库:

git init --bare $DIR/<SOMEDIRNAME>.git

现在您的服务器上有一个远程裸 git 存储库。接下来，您需要添加 Hook ，以允许它在收到推送后部署您的 Jekyll 站点。你列出的网站有一个相当简单的部署，但基本上它所做的就是将 _site 目录制作为服务的 html 页面，你可以通过多种方式做到这一点，我建议你尽可能不打扰你的用户，在这里是一个示例脚本，可能会做这样的事情:

#!/bin/bash
# Assuming a directory structure for www:
# $www_root/releases 
# $www_root/shared
# $www_root/current
# all releases go in releases dir as timestamps dirs
# any logs or other shared items go in shared dir - shared/logs
# current is a symlink to latest release
unset GIT_DIR
WWW_ROOT=/PATH/TO/WWW
REPO_PATH=/PATH/TO/REPO
REPO_BRANCH=master
SITE_DIR=/PATH/TO/_SITE/DIR/IN/REPO
DATE=$(date +"%Y%m%d%H%M")

# get code
if [ ! -d $WWW_ROOT/shared/git_maint ]; then 
  mkdir -p $WWW_ROOT/shared/git_maint
  cd $WWW_ROOT/shared/git_maint
  git clone $REPO_PATH $WWW_ROOT/shared/git_maint
  git checkout master
else
  cd $WWW_ROOT/shared/git_maint
  git pull
  git checkout master
fi

# do deploy
if [ ! -d $WWW_ROOT/releases/$DATE ]; then mkdir $WWW_ROOT/releases/$DATE; fi 
cp -ar $WWW_ROOT/shared/git_maint/$SITE_DIR $WWW_ROOT/releases/$DATE
ln -snf $WWW_ROOT/releases/$DATE $WWW_ROOT/current

exit 0

类似的东西将是一个很好的部署。如果您将此脚本保存在远程服务器上的裸 repo Hook /接收后文件中，那么它会在每次将存储库推送到时运行。请记住使其可执行:chmod 755 hooks/post-receive 因此，如果您将这个新的 Remote 添加到您的 git 存储库中:

git remote add DEPLOY_PROD user@remote.server.com:/path/to/bare/repo

然后 git push DEPLOY_PROD - 它将推送到您的远程仓库，然后您的远程仓库将触发其接收后 Hook ，然后将裸仓库复制到一个维护目录，该目录可以在几乎任何一点。然后使用此目录将站点目录 cp 到发布目录，然后将其链接到主目录。

当然，所有这些很可能是矫枉过正，您可以创建一个从本地主机运行的部署脚本，通过 ssh 完成所有这些操作。

问题是对于这种方法，您无法直接从 github 运行服务器端 Hook ，因此您必须解决这个问题。我建议您检查 capistrano 作为部署策略 - 当前/发布/共享目录和 git_maint 目录取自他们的架构，它运行良好。

如果您在这里需要任何帮助，请告诉我，我在开发部署和自动部署策略方面拥有丰富的经验，因此根据您的情况，情况会有所不同。