说明
git 会将 git 仓库克隆到站点中。这样就可以通过简单的 git 推送部署区域。
git 插件会在服务器生命周期内启动一项服务例程。此项服务在启动时会克隆仓库。当服务器仍处于运行状态时,此服务会定期拉取最新代码。你还可以设置 Webhook,以便在推送后立即拉取。与常规的 git 操作方式类似,拉取仅包含更改,因此效率很高。
如果拉取失败,此项服务会重试最多三次。如果到那时仍未成功拉取,服务就不会再尝试,直到下一个间隔。
此插件需要在系统上安装 git
。
不支持 Webhook,这是一个纯拉取模型。
语法
git REPO [PATH]
-
REPO 是指向仓库的 URL;支持 SSH 和 HTTPS URL
-
PATH 是仓库的克隆路径,相对于站点根目录;默认是站点根目录
该简化语法每 3600 秒(1 小时)从 master 分支拉取一次,并且仅适用于公共仓库。
如果需要更多控制或使用私有仓库,请使用以下语法
git [REPO PATH] {
repo REPO
path PATH
branch BRANCH
interval INTERVAL
args ARGS
pull_args PULL_ARGS
}
-
REPO 是指向仓库的 URL;仅支持 HTTPS URL。
-
PATH 是要将仓库克隆到的路径;默认是站点根目录(如果已设置)。它可以是绝对路径,也可以是相对路径(相对于站点根目录)。请参阅root 插件。
-
BRANCh 是要拉取的分支或标签;默认是 master 分支。
{latest}
是最新标签的占位符,可确保始终拉取最新的标签。 -
INTERVAl 是两次拉取之间的秒数;默认是 3600(1 小时),最小值为 5。-1 表示禁用定期拉取。
-
ARGS 是要传递给
git clone
的其他 cli 参数,例如--depth=1
。当首次获取源时,会调用git clone
。 -
PULL_ARGS 是要传递给
git pull
的其他 cli 参数,例如-s recursive -X theirs
。在更新源时使用git pull
。
示例
每小时将公共仓库拉取到站点根目录
git github.com/user/myproject
将公共仓库拉取到站点根目录中的 “subdir” 目录
git github.com/user/myproject subdir
另请参阅
用于设置根目录的root 插件。