極狐GitLab 是 GitLab 在中國的發行版，關于中文參考文檔和資料有：

• 極狐GitLab 中文文檔
• 極狐GitLab 中文論壇
• 極狐GitLab 官網

導入導出設置 (BASIC SELF)

導入和導出相關功能的設置。

配置允許的導入源

在從其他系統導入項目之前，必須為該系統啟用導入源。

1.以具有管理員訪問級別的用戶身份登錄極狐GitLab。
2.在左側導航欄底部，選擇 管理中心。
3.選擇 設置 > 通用。
4.展開 導入和導出設置 部分。
5.選擇每個允許的 導入源。
6.選擇 保存更改。

啟用項目導出

啟用導出項目及其數據：

1.以具有管理員訪問級別的用戶身份登錄極狐GitLab。
2.在左側導航欄底部，選擇 管理中心。
3.選擇 設置 > 通用。
4.展開 導入和導出設置部分。
5.滾動到 項目導出。
6.選擇 啟用 復選框。
7.選擇 保存更改。

通過直接傳輸啟用群組和項目的遷移

• 引入于極狐GitLab 15.8。

WARNING:在極狐GitLab 16.1 或更早版本中，您不應該使用具有計劃掃描執行策略的直接傳輸功能。如果使用直接傳輸，請先升級到極狐GitLab 16.2，并確保在您要執行策略的項目中啟用安全策略機器人。

WARNING:此功能在 beta，可能會在沒有通知的情況下發生更改。此功能并為生產就緒。

您可以使用 UI 通過直接傳輸來啟用群組遷移。

要通過直接傳輸啟用群組遷移：

1.以具有管理員訪問級別的用戶身份登錄極狐GitLab。
2.在左側導航欄底部，選擇 管理中心。
3.選擇 設置 > 通用。
4.展開 導入和導出設置 部分。
5.滾動到 允許通過直接傳輸遷移極狐GitLab 群組和項目。
6.選擇 啟用 復選框。
7.選擇 保存更改。

API 中的設置與 bulk_import_enabled 屬性的設置相同。

開啟靜默管理導出

• 自極狐GitLab 17.0 引入并使用名為 export_audit_events 的開關默認禁用。
• 在極狐GitLab 17.1 GA。功能開關 export_audit_events 已移除。
• 自極狐GitLab 17.1 引入文件導出下載。

檔實例管理員觸發了項目或群組文件導出或下載導出文件時，將生成審計事件。開啟靜默管理導出是為了阻止審計事件。非管理員導出依舊會生成審計事件。

要開啟靜默管理項目和群組文件導出：

1.在左側導航欄底部，選擇 管理中心。
2.選擇 設置 > 通用，然后展開 導入和導出設置。
3.滾動到 Silent exports by admins。
4.選擇 啟用 勾選框。

允許貢獻映射到管理員

• 自極狐GitLab 17.5 引入并使用名為 importer_user_mapping 的開關。默認禁用。

允許映射導入的用戶貢獻到管理員。

如要開啟此功能：

1.在左側導航欄底部，選擇 管理中心。
2.選擇 設置 > 通用，然后展開 導入和導出設置。
3.滾動到 允許貢獻映射到管理員。
4.選擇 啟用 勾選框。

最大導出大小

• 引入于極狐GitLab 15.0。

要修改極狐GitLab 中導出的最大文件大小：

1.在左側導航欄底部，選擇 管理中心。
2.選擇 設置 > 通用，然后展開 導入和導出設置。
3.通過更改 最大導出大小 (MiB) 中的值來增加或減少。

最大導入大小

• 從 50 MB 更改為無限制于極狐GitLab 13.8。

要修改極狐GitLab 中導入的最大文件大小：

1.在左側導航欄底部，選擇 管理中心。
2.選擇設置 > 通用。
3.展開 導入和導出設置。
4.通過更改 最大導入大小 (MiB) 中的值來增加或減少。

此設置僅適用于倉庫從極狐GitLab 導出文件導入。

如果您選擇的大小大于 Web 服務器的配置值，則可能會收到錯誤。有關更多詳細信息，請參閱故障排除。

有關 JihuLab.com 倉庫大小限制，請閱讀賬戶和限制設置。

導入的最大遠端文件大小

• 引入于極狐GitLab 16.3。

您可以在極狐GitLab 中修改從外部對象存儲（例如 AWS）導入的最大遠端文件的大小。

要修改最大導入遠端文件端大小：

1.在左側導航欄底部，選擇 管理中心。
2.選擇 設置 > 通用。
3.展開 導入和導出設置。
4.通過更改 最大導入遠程文件大小 (MiB) 中的值來增加或減少。設置為 0 可設置無文件大小限制。

通過直接傳輸導入的最大下載文件大小

• 引入于極狐GitLab 16.3。

您可以在極狐GitLab 中修改直接傳輸導入的最大下載文件大小。
要修改通過直接傳輸導入的最大下載文件大小：

1.在左側導航欄底部，選擇 管理中心。
2.選擇 設置 > 通用。
3.展開 導入和導出設置。
4.通過更改 直接傳輸最大下載文件大小 (MiB) 中的值來增加或減少。設置為 0 可設置無下載文件大小限制。

導入歸檔的最大解壓文件大小

• 引入于極狐GitLab 16.3。
• 從 最大解壓大小 重命名為 導入歸檔的最大解壓文件大小 于極狐GitLab 16.4。

當您使用文件導出或直接傳輸導入項目時，您可以指定導入歸檔的最大解壓文件大小。默認值為 25 GB。

導入壓縮文件時，解壓后的大小不能超過最大解壓文件大小限制。如果解壓后的大小超過配置的限制，則返回以下錯誤：

Decompressed archive size validation failed.

要修改極狐GitLab 中導入的最大解壓文件大小：

1.在左側導航欄底部，選擇 管理中心。
2.選擇 設置 > 通用。
3.展開 導入和導出設置。
4.為 導入歸檔的最大解壓縮文件大小 (MiB) 設置其他值。

解壓歸檔文件超時

• 引入于極狐GitLab 16.4。

當您導入項目時，您可以指定解壓導入檔案的最大超時時間。默認值為 210 秒。

要修改極狐GitLab 中導入的最大解壓文件大小：

1.在左側導航欄底部，選擇 管理中心。
2.選擇 設置 > 通用。
3.展開 導入和導出設置。
4.為 解壓歸檔文件的超時時間（秒） 設置其他值。

同時導入的最大作業數

• 自極狐GitLab 16.11 引入。

您可以為以下導入器指定同時執行的最大導入作業數：

• GitHub 導入器
• Bitbucket Cloud 導入器
• Bitbucket Server 導入器

當導入合并請求時，此作業限制并不生效，因為為了避免服務器過載，我們已經設置了硬編碼限制。

默認的作業限制為：

• GitHub 導入器，為1000。
• 對 Bitbucket Cloud 和 Bitbucket Server 導入器，為 100。Bitbucket 導入器有一個較低的默認限制，因為我們還沒有確定一個好的默認限制。私有化部署的管理員可以通過實驗來測試一個較高的限制值。

要想修改此設置：

1.在左側導航欄底部，選擇 管理中心。
2.選擇 設置 > 通用。
3.展開 導入和導出設置。
4.將期望導入器的 同時導入的最大作業數 設置其他值。

同時批處理導出作業的最大值

• 自極狐GitLab 17.6 引入。

直接遷移導出會消耗大量的資源。為了防止耗盡數據庫或 Sidekiq 進程，管理員可以配置 concurrent_relation_batch_export_limit 設置。

默認值為 8 個作業，對應于最多 40 RPS 或 2,000 個用戶的參考架構。

如果您遇到了 PG::QueryCanceled: ERROR: canceling statement due to statement timeout 錯誤或者由于 Sidekiq 內存限制而中斷作業，您可以減少此數字。如果您有足夠的資源，您可以增加此數字以處理更多的并發導出作業。

要修改此設置，使用 concurrent_relation_batch_export_limit 發送 API 請求到 /api/v4/application/settings。更多詳情可以查看應用程序設置 API 。

故障排查

錯誤: Help page documentation base url is blocked: execution expired

當開啟諸如導入源之類的應用程序設置時，可能會收到 Help page documentation base url is blocked: execution expired 錯誤。要解決此錯誤：

1.將 docs.gitlab.cn 或重定向幫助文檔頁面 URL添加到等候列表中。
2.選擇 保存更改。