git

描述

git 將 git 儲存庫複製到網站。這使得能夠透過簡單的 git push 來部署你的區域。

git 外掛程式啟動一個服務常式，該常式在伺服器的生命週期內執行。當服務啟動時，它會複製儲存庫。當伺服器仍在運作時，它會定期拉取最新的內容。你也可以設定一個 webhook，以便在 push 之後立即拉取。在一般的 git 方式中，pull 只會包含變更，因此非常有效率。

如果 pull 失敗，服務會重試最多三次。如果到那時 pull 仍然不成功，它將在下一個間隔時間之前不會再次嘗試。

此外掛程式需要系統上已安裝 git。

不支援 Webhook，這是一個純粹的 pull 模型。

語法

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 是 pull 之間的秒數；預設為 3600（1 小時），最小值為 5。間隔時間為 -1 會停用定期 pull。

• 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 外掛程式。