Skip to main content

Managing pre-receive hooks on your instance

Configure how people will use pre-receive hooks on 你的 GitHub Enterprise Server 实例.

Creating pre-receive hooks

  1. 在 GitHub Enterprise Server 的右上角,单击你的个人资料照片,然后单击“企业设置”****。

    单击 GitHub Enterprise Server 上的个人资料照片时显示的下拉菜单的屏幕截图。 “企业设置”选项以深橙色边框突出显示。

  2. 在企业帐户边栏中,单击“设置”。

  3. 在“ 设置”下,单击“挂钩”。

  4. Click Add pre-receive hook.

  5. In the "Hook name" field, enter the name of the hook that you want to create.

  6. Select the Environment dropdown menu, then click the environment on which you want the hook to run.

  7. Under "Script," select the Select hook repository dropdown menu, then click the repository that contains your pre-receive hook script.

  8. Select the Select file drop-down menu, then click the filename of the pre-receive hook script.

  9. To enforce your script, select Use the exit-status to accept or reject pushes. Deselecting this option allows you to test the script while the exit-status value is ignored. In this mode, the output of the script will be visible to the user in the command-line but not on the web interface.

  10. If you want the pre-receive hook to run on all repositories, select Enable this pre-receive hook on all repositories by default.

  11. To allow organization members with admin or owner permissions to select whether they wish to enable or disable this pre-receive hook, select Administrators can enable and disable this hook.

Editing pre-receive hooks

  1. 在 GitHub Enterprise Server 的右上角,单击你的个人资料照片,然后单击“企业设置”****。

    单击 GitHub Enterprise Server 上的个人资料照片时显示的下拉菜单的屏幕截图。 “企业设置”选项以深橙色边框突出显示。

  2. 在企业帐户边栏中,单击“设置”。

  3. 在“ 设置”下,单击“挂钩”。

  4. Next to the pre-receive hook that you want to edit, click Edit.

Deleting pre-receive hooks

  1. 在 GitHub Enterprise Server 的右上角,单击你的个人资料照片,然后单击“企业设置”****。

    单击 GitHub Enterprise Server 上的个人资料照片时显示的下拉菜单的屏幕截图。 “企业设置”选项以深橙色边框突出显示。

  2. 在企业帐户边栏中,单击“设置”。

  3. 在“ 设置”下,单击“挂钩”。

  4. Next to the pre-receive hook that you want to delete, click Delete.

Configure pre-receive hooks for an organization

An organization owner can only configure hook permissions for an organization if the site administrator selected the Administrators can enable or disable this hook option when they created the pre-receive hook. To configure pre-receive hooks for a repository, you must be an organization owner.

  1. 在 GitHub 的右上角,选择个人资料照片,然后单击“你的组织”。
  2. 在组织旁边,单击“设置”。
  3. In the left sidebar, click Hooks.
  4. Next to the pre-receive hook that you want to configure, select the Hook permissions dropdown menu, then click an option.

Configure pre-receive hooks for a repository

A repository owner can only configure a hook if the site administrator selected the Administrators can enable or disable this hook option when they created the pre-receive hook. In an organization, the organization owner must also have selected the Configurable hook permission. To configure pre-receive hooks for a repository, you must be a repository owner.

  1. 在 GitHub Enterprise Server 的右上角,单击你的个人资料照片,然后单击“你的个人资料”。

  2. Navigate to the repository that you want to configure pre-receive hooks for.

  3. 在存储库名称下,单击 “设置”。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

    存储库标头的屏幕截图,其中显示了选项卡。 “设置”选项卡以深橙色边框突出显示。

  4. In the left sidebar, click Hooks.

  5. Next to the pre-receive hook that you want to configure, select the Hook permissions dropdown menu, then click whether to enable or disable the pre-receive hook.