引

在 Git 代碼管理工具使用過程中，經(jīng)常需要將一個(gè)文件夾作為倉(cāng)庫(kù)上傳到一個(gè)未創(chuàng)建的代碼倉(cāng)庫(kù)。如果 Git 服務(wù)端使用的是 Gitea，通常會(huì)推送失敗。

PS D:\tmp\git-test> git remote add origin http://192.1.1.1:3000/root/git-test.git
PS D:\tmp\git-test> git push --set-upstream origin master
remote: Push to create is not enabled for users.
fatal: unable to access 'http://192.1.1.1:3000/root/git-test.git/': The requested URL returned error: 403

因?yàn)?Gitea 默認(rèn)推送時(shí)不創(chuàng)建倉(cāng)庫(kù)。

開啟 Push To Create

Push To Create即推送創(chuàng)建， Gitea 提供了兩個(gè)參數(shù)開啟推送創(chuàng)建 ，分別是 ENABLE_PUSH_CREATE_USER 和 ENABLE_PUSH_CREATE_ORG 。[官方文檔介紹](推送 | Gitea Documentation)如下：

推送創(chuàng)建

推送創(chuàng)建是一項(xiàng)功能，允許您將提交推送到在 Gitea 中尚不存在的倉(cāng)庫(kù)。這對(duì)于自動(dòng)化和允許用戶創(chuàng)建倉(cāng)庫(kù)而無(wú)需通過 Web 界面非常有用。此功能默認(rèn)處于禁用狀態(tài)。

開啟推送創(chuàng)建

在 app.ini 文件中，將 ENABLE_PUSH_CREATE_USER 設(shè)置為 true，如果您希望允許用戶在自己的用戶帳戶和所屬的組織中創(chuàng)建倉(cāng)庫(kù)，將 ENABLE_PUSH_CREATE_ORG 設(shè)置為 true。重新啟動(dòng) Gitea 以使更改生效。您可以在 配置速查表 中了解有關(guān)這兩個(gè)選項(xiàng)的更多信息。

使用推送創(chuàng)建

假設(shè)您在當(dāng)前目錄中有一個(gè) git 倉(cāng)庫(kù)，您可以通過運(yùn)行以下命令將提交推送到在 Gitea 中尚不存在的倉(cāng)庫(kù)：

# 添加要推送到的遠(yuǎn)程倉(cāng)庫(kù)
git remote add origin git@{domain}:{username}/{尚不存在的倉(cāng)庫(kù)名稱}.git# 推送到遠(yuǎn)程倉(cāng)庫(kù)
git push -u origin main

這假設(shè)您使用的是 SSH 遠(yuǎn)程，但您也可以使用 HTTPS 遠(yuǎn)程。

推送創(chuàng)建將默認(rèn)使用 app.ini 中定義的可見性 DEFAULT_PUSH_CREATE_PRIVATE。

具體配置

以上官方章節(jié)說明了 Gitea 可以通過配置開啟推送創(chuàng)建功能，也給出了兩個(gè)具體的配置項(xiàng)，但打開開 app.ini （docker 容器啟動(dòng)實(shí)例中文件位置為： /data/gitea/conf/app.ini）文件后，你會(huì)發(fā)現(xiàn)不知道在哪里配置。

因?yàn)镚itea有很多功能域，以上文章并沒有交代開啟推送創(chuàng)建的功能項(xiàng)屬于哪個(gè)功能域。

配置說明 | Gitea Documentation文檔中詳細(xì)闡述了 Gitea 所有配置項(xiàng)，并且說明了配置項(xiàng)所屬的功能域。

通過查看，ENABLE_PUSH_CREATE_USER 和 ENABLE_PUSH_CREATE_RRG 都屬于 [repository] 功能域。因此配置如下：

重啟

配置完成后重啟 Gitea 即可。

附 ： Win 下 Docker 安裝 Gitea 實(shí)踐-CSDN博客