P4 Fusion 是一個(gè)使用 Perforce Helix Core C++ API 和 Libgit2 用 C++ 編寫的快速 Perforce 到 Git 的轉(zhuǎn)換工具，試圖緩解git-p4.py的性能瓶頸。

這個(gè)項(xiàng)目是作為一個(gè)內(nèi)部項(xiàng)目的概念驗(yàn)證開始的，它需要將P4倉庫轉(zhuǎn)換為Git倉庫。Git內(nèi)部也有一個(gè)類似的解決方案，叫做git-p4.py。然而，它在處理任何超過1GB大小的倉庫時(shí)有性能問題，而且它使用Python2在單線程中運(yùn)行，這給git-p4.py在更大的使用場景中的使用增加了一系列限制。

該工具通過以下方式解決了 git-p4.py 中一些最有影響的擴(kuò)展和性能限制：

• 使用Helix Core C++ API來處理下載 CL，從而更好地控制內(nèi)存以及如何將其提交到 Git 存儲(chǔ)庫，而無需進(jìn)行不必要的內(nèi)存復(fù)制和文件 I/O。
• 使用libgit2將從 Perforce 服務(wù)器接收到的文件內(nèi)容按原樣轉(zhuǎn)發(fā)到 Git 存儲(chǔ)庫，同時(shí)盡可能避免內(nèi)存復(fù)制。該庫允許從內(nèi)存中簡單存在的文件內(nèi)容創(chuàng)建提交。
• 使用在 C++11 中實(shí)現(xiàn)的自定義基于喚醒的線程池，該線程池運(yùn)行 Helix Core C++ API 的線程本地庫上下文，以對(duì)變更列表下載過程進(jìn)行大量多線程處理。

值得注意的是，P4 Fusion?的速度快到足以在你的Perforce服務(wù)器上瞬間產(chǎn)生巨大的負(fù)載（如果以中等數(shù)量的線程運(yùn)行，在幾分鐘內(nèi)超過15萬個(gè)請(qǐng)求）。因此，它需要仔細(xì)監(jiān)測以確保Perforce服務(wù)器不受影響。這個(gè)工具將繼續(xù)產(chǎn)生負(fù)載，沒有任何速率限制（除了這個(gè)工具提供的運(yùn)行時(shí)選項(xiàng)外），直到轉(zhuǎn)換過程完成。然而，沒有速率限制，用幾百個(gè)網(wǎng)絡(luò)線程（如果可能的話，甚至更多）來運(yùn)行這個(gè)工具，是在轉(zhuǎn)換過程中實(shí)現(xiàn)最大速度的理想情況。

網(wǎng)絡(luò)線程的數(shù)量應(yīng)設(shè)置為一般多于邏輯CPU的數(shù)量，因?yàn)樽詈臅r(shí)的步驟是下載CL數(shù)據(jù)，這主要是網(wǎng)絡(luò)I/O的限制。

官方研究表明，這個(gè)工具的運(yùn)行速度比 git-p4.py 快 100 倍以上。在一個(gè)包含約3393個(gè)中等規(guī)模變更列表的倉庫路徑內(nèi)，使用 200 個(gè)并行連接進(jìn)行歷史轉(zhuǎn)換的平均時(shí)間為 26 秒，而 git-p4.py 轉(zhuǎn)換同一倉庫路徑需要接近 42 分鐘。如果Perforce服務(wù)器有完整的文件緩存，那么這些轉(zhuǎn)換時(shí)間可能是可重復(fù)的，否則如果文件緩存是空的，那么前幾次運(yùn)行預(yù)計(jì)會(huì)花費(fèi)更多時(shí)間。

對(duì)于更大的倉庫（數(shù)百萬個(gè) CL 或更多），這些執(zhí)行時(shí)間預(yù)計(jì)會(huì)按預(yù)期擴(kuò)展。該工具提供了在轉(zhuǎn)換過程中控制內(nèi)存利用率的選項(xiàng)，因此這些選項(xiàng)將有助于更大的用例。

? ./build/p4-fusion/p4-fusion
[ PRINT @ Main:24 ] Running p4-fusion from: ./build/p4-fusion/p4-fusion
[ PRINT @ Main:43 ] Usage:
[Required] --port
        Specify which P4PORT to use.

[Required] --path
        P4 depot path to convert to a Git repo

[Required] --lookAhead
        How many CLs in the future, at most, shall we keep downloaded by the time it is to commit them?

[Required] --src
        Local relative source path with P4 code. Git repo will be created at this path. This path should be empty before running p4-fusion.

[Required] --client
        Name/path of the client workspace specification.

[Required] --user
        Specify which P4USER to use. Please ensure that the user is logged in.

[Optional, Default is false] --includeBinaries
        Do not discard binary files while downloading changelists.

[Optional, Default is false] --fsyncEnable
        Enable fsync() while writing objects to disk to ensure they get written to permanent storage immediately instead of being cached. This is to mitigate data loss in events of hardware failure.

[Optional, Default is 10] --retries
        Specify how many times a command should be retried before the process exits in a failure.

[Optional, Default is 16] --networkThreads
        Specify the number of threads in the threadpool for running network calls. Defaults to the number of logical CPUs.

[Optional, Default is -1] --maxChanges
        Specify the max number of changelists which should be processed in a single run. -1 signifies unlimited range.

[Optional, Default is 1] --printBatch
        Specify the p4 print batch size.

[Optional, Default is 100] --refresh
        Specify how many times a connection should be reused before it is refreshed.