创建预接收挂钩环境

GitHub Enterprise Server 的预接收环境是 Linux chroot 环境。 由于预接收挂钩会在每个推送事件上执行，因此它们应该快速且轻量化。 这类检查需要的环境通常极少。

GitHub Enterprise Server 提供了一个默认环境，其中包括以下包：awk、bash、coreutils、curl、find、gnupg、grep、jq、sed。

如果您具有此环境未满足的特定要求（例如对特定语言的支持），则可以创建并上传您自己的 64 位 Linux chroot 环境。

本文内容

• 使用 Docker 创建预接收挂钩环境
• 使用 chroot 创建预接收挂钩环境
• 在 GitHub Enterprise Server 上上传预接收挂钩环境
• 通过管理 shell 上传预接收挂钩环境

使用 Docker 创建预接收挂钩环境

您可以使用 Linux 容器管理工具来构建预接收挂钩环境。 此示例使用 Alpine Linux 和 Docker。

1. 确保本地安装了 Docker。

2. 创建包含此信息的文件 Dockerfile.alpine-3.3：

   FROM gliderlabs/alpine:3.3
   RUN apk add --no-cache git bash

3. From the working directory that contains Dockerfile.alpine-3.3, build an image:

   $ docker build -f Dockerfile.alpine-3.3 -t pre-receive.alpine-3.3 .
   > Sending build context to Docker daemon 12.29 kB
   > Step 1 : FROM gliderlabs/alpine:3.3
   >  ---> 8944964f99f4
   > Step 2 : RUN apk add --no-cache git bash
   >  ---> Using cache
   >  ---> 0250ab3be9c5
   > Successfully built 0250ab3be9c5

4. 创建一个容器：

   $ docker create --name pre-receive.alpine-3.3 pre-receive.alpine-3.3 /bin/true

5. 将 Docker 容器导出到 gzip 压缩的 tar 文件：

   $ docker export pre-receive.alpine-3.3 | gzip > alpine-3.3.tar.gz

   此文件 alpine-3.3.tar.gz 已准备好上传到 GitHub Enterprise Server 设备。

使用 chroot 创建预接收挂钩环境

1. 创建 Linux chroot 环境。

2. 创建 chroot 目录的 gzip 压缩 tar 文件：

   $ tar -czf pre-receive-environment.tar.gz /path/to/chroot

   For more information about creating a chroot environment see "Chroot" from the Debian Wiki, "BasicChroot" from the Ubuntu Community Help Wiki, or "Installing Alpine Linux in a chroot" from the Alpine Linux Wiki.

在 GitHub Enterprise Server 上上传预接收挂钩环境

1. In the upper-right corner of any page, click .

   

2. In the left sidebar, click Business.

   

3. Under your business account's name, click Settings.

   

4. 在左侧侧边栏中，单击 Hooks。

   

5. 单击 Manage environments。

   

6. 单击 Add environment。

   

7. 在 Environment name 字段中输入所需的名称。

   

8. 输入包含您的环境的 * .tar.gz 文件的 URL。

   

9. 单击 Add environment。

   

通过管理 shell 上传预接收挂钩环境

1. 将包含您的环境的可读 * .tar.gz 文件上传到 web 主机并复制 URL 或通过 scp 将文件传送到 GitHub Enterprise Server 设备。 使用 scp 时，您可能需要调整 * .tar.gz 文件权限，以使该文件全局可读。

2. 连接到管理 shell。

3. 使用 ghe-hook-env-create 命令并输入所需的环境名称作为第一个参数，然后将包含环境的 * .tar.gz 文件的完整本地路径或 URL 作为第二个参数。

   admin@ghe-host:~$ ghe-hook-env-create AlpineTestEnv /home/admin/alpine-3.3.tar.gz
   > Pre-receive hook environment 'AlpineTestEnv' (2) has been created.