簡介面向銀河麒麟國產(chǎn) Linux服務(wù)器運(yùn)維人員與研發(fā)環(huán)境搭建者的實(shí)踐文檔聚焦內(nèi)網(wǎng)或離線場景下從源碼編譯安裝 Subversion 及其依賴組件的完整流程幫助讀者解決系統(tǒng)軟件源缺失、自帶版本偏舊導(dǎo)致 SVN 難以直接部署的問題。資源為 docx 文檔壓縮包內(nèi)共 1 個文件約 202KB篇幅緊湊、按操作順序編排可直接對照執(zhí)行。內(nèi)容覆蓋 apr、apr-util、sqlite-amalgamation 與 subversion 指定版本的獲取途徑及 configure、make 編譯參數(shù)/etc/profile 環(huán)境變量追加與 source 生效驗(yàn)證版本庫根目錄規(guī)劃與 svnadmin create 建庫以及 svnserve.conf、passwd、authz 三個配置文件的具體寫法并特別提示首行頂格等易被忽略的配置錯誤此外還給出 svnserve 后臺啟動命令與寫入 rc.local 實(shí)現(xiàn)開機(jī)自啟的腳本做法。目前已有 2798 人學(xué)習(xí)下載適合需要快速在麒麟系統(tǒng)上落地 SVN 服務(wù)、規(guī)避權(quán)限與路徑問題的讀者參考。1. 內(nèi)網(wǎng)機(jī)器上的版本庫為什么我堅(jiān)持源碼編 subversion-1.8.14內(nèi)網(wǎng)里那臺銀河麒麟服務(wù)器長期被當(dāng)成共享盤用同事在文件名后綴里寫_final_v3_改改回滾只能靠翻聊天記錄。銀河麒麟 SVN 環(huán)境這件事真正難的不是svnserve那幾行命令而是發(fā)行版自帶源里的 subversion 常常缺胳膊少腿svnadmin能跑svnserve起來就報共享庫找不到或者版本對不上 sqlite。我一般走源碼路線把 apr-1.6.5、apr-util-1.6.1、subversion-1.8.14 和 sqlite-amalgamation-3071501 一起落到/usr/local好處是版本可控、依賴不污染系統(tǒng)、出問題刪目錄就干凈了。這套做法適合在內(nèi)網(wǎng)替小團(tuán)隊(duì)搭版本庫、又不想動系統(tǒng)包管理的運(yùn)維和開發(fā)。2. 依賴三板斧apr、apr-util、sqlite 的編譯順序與參數(shù)2.1 為什么 subversion 1.8 繞不開 apr 和 apr-utilSubversion 從誕生那天起就把 APRApache Portable Runtime當(dāng)成底座svnserve的網(wǎng)絡(luò)監(jiān)聽、內(nèi)存池、文件路徑處理全部走 APR 的接口apr-util則在 APR 之上補(bǔ)了數(shù)據(jù)庫抽象、XML 解析、Base64 編碼這些能力subversion 的 DAV 與認(rèn)證模塊會用到它。也就是說你編出來的svnserve二進(jìn)制和libapr-1.so、libaprutil-1.so是運(yùn)行期綁定的不是靜態(tài)塞進(jìn)去就完事。那為什么不直接yum install apr apr-util subversion了事兩條血淚經(jīng)驗(yàn)。第一系統(tǒng)源的 apr 版本是跟著發(fā)行版凍結(jié)的可能比 subversion 1.8 需要的還老或者干脆被別的組件鎖死你動它就可能把系統(tǒng)上別的服務(wù)帶崩。第二多數(shù)組件編譯時默認(rèn)會去/usr找apr-1-config一旦它和系統(tǒng)里已有的 apr 混用編出來的 subversion 在鏈接期就出現(xiàn)符號沖突報錯信息還特別繞。所以我選擇把依賴全部裝到獨(dú)立前綴下用--with-apr、--with-apr-util精確點(diǎn)名誰也不污染。這套組合的對應(yīng)關(guān)系是這樣的組件版本安裝前綴在鏈路里的角色apr1.6.5/usr/local/apr內(nèi)存池、文件、網(wǎng)絡(luò)抽象層apr-util1.6.1/usr/local/apr-utilXML、編碼、數(shù)據(jù)庫抽象依賴 aprsqlite amalgamation30715013.7.15.1編進(jìn) subversion 源碼樹版本庫工作隊(duì)列的本地庫subversion1.8.14/usr/local/svnsvnserve、svnadmin、svn 客戶端編譯順序有硬約束apr → apr-util → subversion。apr-util 的configure要拿 apr 的頭文件和apr-1-config腳本subversion 又要同時拿兩者的配置腳本順序錯了就只能在報錯里原地打轉(zhuǎn)。2.2 目錄約定與解壓先把工作區(qū)定死源碼包從外部拷進(jìn)內(nèi)網(wǎng)機(jī)器之后別急著解壓到/usr/local或者家目錄亂放。我習(xí)慣在一個目錄里把所有源碼鋪開編譯完保留著日后想換參數(shù)重編不用重新傳包。原文里用的是/home/dmdba/svn/這個約定挺好照抄就行。# 統(tǒng)一工作目錄所有源碼包都放這里 mkdir -p /home/dmdba/svn cd /home/dmdba/svn # 四個包按順序解壓解壓后各自成目錄 tar -xzf apr-1.6.5.tar.gz tar -xzf apr-util-1.6.1.tar.gz tar -xzf subversion-1.8.14.tar.gz unzip -q sqlite-amalgamation-3071501.zip # 確認(rèn)目錄都在避免后面 cd 到不存在的路徑 ls -d apr-1.6.5 apr-util-1.6.1 subversion-1.8.14 sqlite-amalgamation-3071501這段沒有技術(shù)含量但省掉了后面一半的「路徑寫錯」類翻車。tar -xzf里的z表示 gzipunzip是因?yàn)?sqlite 的 amalgamation 包給的是 zip 而不是 tar.gz這一點(diǎn)很多人第一次會順手敲tar -xzf sqlite-amalgamation-3071501.zip然后拿到一句 gzip: stdin: not in gzip format。全程用 root 操作避免make install階段因?yàn)槟夸洐?quán)限半途失敗、留下半套文件。2.3 apr-1.6.5--prefix是唯一必須想清楚的參數(shù)cd /home/dmdba/svn/apr-1.6.5 # 裝到獨(dú)立前綴不覆蓋系統(tǒng) /usr 下的 apr ./configure --prefix/usr/local/apr # 并行編譯加速裝完檢查返回碼 make -j$(nproc) make install--prefix/usr/local/apr決定了三件事頭文件去/usr/local/apr/include/apr-1庫文件去/usr/local/apr/lib配置腳本去/usr/local/apr/bin/apr-1-config。后面 apr-util 和 subversion 的--with-apr參數(shù)指的就是這個前綴不是bin目錄也不是include目錄。make -j$(nproc)用滿核數(shù)apr 本身不大幾秒就完如果你在虛擬機(jī)上碰到virtual memory exhausted之類的報錯把-j降成-j2或者干脆去掉并行別硬扛。裝完可以立刻驗(yàn)證一下前綴里到底落了什么這一步比事后 debug 便宜得多/usr/local/apr/bin/apr-1-config --version # 應(yīng)輸出 1.6.5 ls /usr/local/apr/lib/libapr-1.so* # 應(yīng)有 .so 和 .so.0 軟鏈apr-1-config --version能回出版本號說明--prefix生效了后面的組件就能靠這個腳本問出正確的頭文件與庫路徑。2.4 apr-util-1.6.1--with-apr必須精確指向前綴cd /home/dmdba/svn/apr-util-1.6.1 # --with-apr 指向剛裝好的 apr 前綴不能省 ./configure --prefix/usr/local/apr-util --with-apr/usr/local/apr make -j$(nproc) make install--with-apr/usr/local/apr是這一章最容易寫錯的一個參數(shù)。如果你省掉它c(diǎn)onfigure會自己去PATH里找apr-1-config找到的極可能是系統(tǒng)/usr/bin/apr-1-config于是 apr-util 一半頭文件來自/usr/include、一半來自/usr/local/apr/include編出來的.so里帶著兩套符號等到 subversion 鏈接時才會以undefined reference to apr_pool_create_ex這類面目出現(xiàn)排查成本極高。編譯 apr-util 時若報錯說找不到 expat屬于常見情況它的 XML 支持依賴 expat 開發(fā)包。常規(guī)做法是先把系統(tǒng)側(cè)的頭文件補(bǔ)齊再重跑configure# 麒麟系統(tǒng)一般自帶 yum新版可能是 dnf 的軟鏈兩者都試一下 yum install -y expat-devel zlib-devel openssl-devel # 裝完清掉上次的 configure 緩存重新來 cd /home/dmdba/svn/apr-util-1.6.1 make clean ./configure --prefix/usr/local/apr-util --with-apr/usr/local/apr make -j$(nproc) make install裝完同樣驗(yàn)一遍/usr/local/apr-util/bin/apu-1-config --version要能回出版本且ldd出來的 apr-util 庫文件指向的是/usr/local/apr/lib/libapr-1.so.0而不是/usr/lib64下的同名文件。2.5 sqlite amalgamation唯一不需要 configure 的依賴sqlite 的 amalgamation 包不是常規(guī)的 autotools 工程解壓出來只有一個sqlite3.c加一個sqlite3.h老版本包里還有shell.c沒有configure也沒有Makefile。它在 subversion 1.8 的構(gòu)建體系里扮演的是「源碼級依賴」的角色——subversion 自己的構(gòu)建腳本會去找源碼根目錄下的sqlite-amalgamation子目錄把sqlite3.c直接編進(jìn)libsvn_subr。所以正確的落地方式不是單獨(dú)編譯安裝而是把它放進(jìn) subversion 源碼樹cd /home/dmdba/svn # 目錄名必須是 sqlite-amalgamationsubversion 的構(gòu)建腳本按這個約定找 mv sqlite-amalgamation-3071501 sqlite-amalgamation cp -r sqlite-amalgamation subversion-1.8.14/ # 確認(rèn)關(guān)鍵文件在位 ls subversion-1.8.14/sqlite-amalgamation/sqlite3.c目錄名這一條是實(shí)打?qū)嵉目幽憬衧qlite-amalgamation-3071501configure 階段不報錯make到了鏈接svnserve的時候才給你一句找不到sqlite3_open之類的符號。因?yàn)榍懊?configure 只是「沒檢測到自帶 sqlite」于是它轉(zhuǎn)頭去找系統(tǒng)里已安裝的 sqlite3 庫系統(tǒng)的版本又可能不滿足 1.8 分支的要求報錯就發(fā)生在很靠后的位置。改成約定的名字等于把這條路走通。3. 編 subversion-1.8.14configure 參數(shù)與報錯的對應(yīng)關(guān)系3.1 configure 之前先確認(rèn)三件事第一件是編譯器與構(gòu)建工具。銀河麒麟桌面版和服務(wù)器版默認(rèn)不一定裝gcc最小化安裝的系統(tǒng)經(jīng)常只帶gcc-c或干脆沒有。# 逐個確認(rèn)缺什么裝什么 gcc --version | head -1 make --version | head -1 # 一次性補(bǔ)齊編譯期依賴避免 configure 反復(fù)中斷 yum install -y gcc make zlib-devel expat-devel openssl-devel第二件是/usr/local的寫權(quán)限和磁盤空間。/usr/local單獨(dú)掛載且配額很小的機(jī)器不是沒見過裝到一半No space left on device前面 apr、apr-util 全要重來。df -h /usr/local看一眼幾十兆就夠但心里有數(shù)。第三件是系統(tǒng)里有沒有裝過 subversion。如果之前yum install subversion過/usr/bin/svn和/usr/local/svn/bin/svn會同時存在PATH里誰在前誰生效日后運(yùn)維時會莫名其妙調(diào)用到舊版。要么先卸掉系統(tǒng)包要么在/etc/profile里把/usr/local/svn/bin放在PATH前面別用PATH$PATH:...的追加寫法。3.2 configure 參數(shù)逐項(xiàng)拆每個--with都指向一個具體前綴cd /home/dmdba/svn/subversion-1.8.14 ./configure \ --prefix/usr/local/svn \ --with-apr/usr/local/apr \ --with-apr-util/usr/local/apr-util \ --without-serf--prefix/usr/local/svn決定最終的bin、lib、include落點(diǎn)svnserve、svnadmin、svnlook、svn全部裝到/usr/local/svn/bin。--with-apr和--with-apr-util分別指向兩個前綴configure 會去前綴/bin下找apr-1-config、apu-1-config問出頭文件與庫的準(zhǔn)確路徑。這兩個參數(shù)寫錯一個字符configure 就會退回系統(tǒng)默認(rèn)路徑編出來的東西在運(yùn)行期報共享庫版本不匹配。--without-serf這一項(xiàng)要看你的用途。serf 是 HTTP/DAV 協(xié)議的客戶端庫svn走h(yuǎn)ttp://、https://訪問遠(yuǎn)端倉庫時才需要。本文這套環(huán)境只做svn://的 svnserve加上它反而要多裝一個依賴直接關(guān)掉最省事。不寫這個參數(shù)也不會編不過configure 檢測不到 serf 只是打一行警告然后禁用但那行警告埋在幾十行輸出里容易被忽略。至于 sqlite如果你已經(jīng)按 2.5 把目錄塞進(jìn)源碼樹configure 會自動接管輸出里能看到它采用內(nèi)置的 sqlite3.c。個別版本識別不到時可以顯式指定源碼目錄# 備選自動識別失敗時顯式指定 sqlite 源碼目錄 ./configure --prefix/usr/local/svn \ --with-apr/usr/local/apr \ --with-apr-util/usr/local/apr-util \ --with-sqlite/home/dmdba/svn/subversion-1.8.14/sqlite-amalgamation \ --without-serfconfigure 輸出最后會打印一份摘要重點(diǎn)看三行APR的版本與前綴、APR-UTIL的版本與前綴、SQLite的來源是internal還是系統(tǒng)路徑。三行都對上你再敲 make對不上現(xiàn)在改還來得及。3.3 make 階段報錯位置決定了排查方向cd /home/dmdba/svn/subversion-1.8.14 # 并行編譯失敗先看最后一個 error 而不是第一個 warning make -j$(nproc) make installsubversion 的源碼體量比 apr 大一個量級make會跑上幾分鐘。中途報錯時別從頭翻直接看最后一個error:。三類報錯各有對應(yīng)關(guān)系出現(xiàn)cannot find -lsqlite3或undefined reference to sqlite3_*說明內(nèi)置 sqlite 沒被識別回 2.5 檢查目錄名出現(xiàn)cannot find -lapr-1說明鏈接期找不到 apr 的庫目錄/usr/local/apr/lib可能沒進(jìn)ld的搜索路徑出現(xiàn)expat.h: No such file是系統(tǒng)側(cè)expat-devel沒裝補(bǔ)裝后make clean重來。make install完成后不要急著建庫先確認(rèn)二進(jìn)制本身的依賴是干凈的# 檢查 svnserve 動態(tài)鏈接到哪個 apr必須是 /usr/local/apr/lib 下的 ldd /usr/local/svn/bin/svnserve | grep -E apr|sqlite # 若輸出里指到 /usr/lib64/libapr-1.so.0說明前綴沒被 ld 找到這個ldd是整套流程里最有價值的一條自檢命令。它把「編譯期正確」和「運(yùn)行期正確」分開暴露——編譯通過不代表運(yùn)行期能找到庫找不到的那一刻通常發(fā)生在svnserve -d啟動時報error while loading shared libraries: libapr-1.so.0。3.4 環(huán)境變量與庫搜索路徑兩處都要配先解決庫路徑再解決命令路徑。庫路徑靠ldconfig的配置文件比改LD_LIBRARY_PATH更可靠因?yàn)樗鼘?systemd 拉起的進(jìn)程同樣生效。# 把兩個前綴的 lib 目錄登記進(jìn)動態(tài)鏈接器 cat /etc/ld.so.conf.d/svn-deps.conf EOF /usr/local/apr/lib /usr/local/apr-util/lib /usr/local/svn/lib EOF ldconfig再配命令路徑。原文用vim /etc/profile手工追加我用 heredoc好處是可重復(fù)執(zhí)行不會寫重復(fù)行也避免 vim 里手滑刪掉別的行。# 用 heredoc 追加PATH 前置保證 /usr/local/svn/bin 優(yōu)先 cat /etc/profile EOF # subversion 1.8.14 源碼安裝 export PATH/usr/local/svn/bin:$PATH EOF # 當(dāng)前會話立即生效 source /etc/profilePATH寫在前面而不是$PATH:后面是為了壓過可能存在的/usr/bin/svn。改完執(zhí)行source只是讓當(dāng)前 shell 生效新開的 SSH 會話會自動讀/etc/profile這一點(diǎn)在排錯時要記牢你改了文件卻沒重登報了command not found別急著重裝。驗(yàn)證環(huán)節(jié)用三條命令交叉確認(rèn)比單跑--version靠譜命令期望輸出說明which svnserve/usr/local/svn/bin/svnserve確認(rèn) PATH 生效不是系統(tǒng)舊版svnserve --version版本號 1.8.14確認(rèn)二進(jìn)制能加載全部動態(tài)庫svnadmin --version版本號 1.8.14建庫工具與 svnserve 同源svnserve --version能出來說明動態(tài)庫、PATH、前綴三者全對這套編譯就算真正完成了。出不來就看報錯是「找不到命令」還是「找不到共享庫」——前者是 PATH 問題后者是 3.4 上半段ldconfig的問題。4. 建庫與三件套配置svnserve.conf、passwd、authz 的權(quán)限模型4.1svnadmin create之后目錄里到底是什么# 版本庫根目錄注意這里只是容器不是倉庫本身 mkdir -p /home/svn # 項(xiàng)目目錄先建好再對其執(zhí)行 create mkdir -p /home/svn/project svnadmin create /home/svn/project # 看一下生成了什么 ls /home/svn/projectsvnadmin create會在一秒內(nèi)鋪出一整套骨架認(rèn)清楚每個目錄的職責(zé)后面配置時才不會改錯地方路徑作用要不要動conf/svnserve.conf、passwd、authz 三個配置文件必須改db/版本庫的真實(shí)數(shù)據(jù)Berkeley DB 或 FSFS 存儲只備份不手改hooks/提交前后觸發(fā)的鉤子腳本模板按需啟用locks/進(jìn)程鎖與數(shù)據(jù)庫鎖不動format版本庫存儲格式的版本號不動README.txt結(jié)構(gòu)說明可讀可不讀這里有個容易混淆的點(diǎn)/home/svn是版本庫的根目錄后面svnserve -d -r指向它/home/svn/project才是一個真正的版本庫。一個根目錄下可以放多個版本庫svnserve -r /home/svn之后客戶端用svn://IP/project訪問其中一個用svn://IP/another訪問另一個互不干擾。4.2 svnserve.conf配置項(xiàng)必須頂格寫這個文件的格式極其挑剔[general]段落下的鍵值對必須從行首開始前面多一個空格svnserve啟動時就給你一句svnserve.conf:20: Option expected。原文特別強(qiáng)調(diào)「首行不可以留空要頂行」說的就是這件事——行首空白比空行更容易翻車。[general] # 匿名用戶無任何權(quán)限必須登錄 anon-access none # 認(rèn)證用戶可讀可寫 auth-access write # 密碼文件相對 conf 目錄 password-db passwd # 權(quán)限文件相對 conf 目錄 authz-db authz # 認(rèn)證域客戶端緩存憑據(jù)時按這個區(qū)分 realm project四個參數(shù)里anon-access none和auth-access write決定認(rèn)證前后的能力邊界把a(bǔ)non-access設(shè)成read等于全網(wǎng)能讀到你的代碼內(nèi)網(wǎng)也一樣別這么干。password-db和authz-db寫相對路徑時基準(zhǔn)是conf目錄本身不是當(dāng)前工作目錄也不是版本庫根目錄寫絕對路徑也能用但日后整體搬遷版本庫就要改配置不如相對路徑省心。realm是給客戶端看的認(rèn)證域名字同一個realm下的多個倉庫共用一份憑據(jù)緩存不同realm會各彈一次登錄框多項(xiàng)目場景下按項(xiàng)目名區(qū)分更清晰。改這個文件用vi就行注意svnserve.conf里原有的注釋行以#開頭留著不礙事只要把需要的項(xiàng)取消注釋并頂格。改完別急著啟動先跑一次語法體檢# 用 svnserve 自己做一次啟動預(yù)演報錯會直接指出行號 svnserve -d -r /home/svn --foreground # 能正常阻塞在前臺說明配置無誤CtrlC 退出--foreground讓進(jìn)程留在前臺配置有錯時立刻打印到終端比后臺啟動再去翻日志快得多。這個參數(shù)不在原文里但排查配置問題時省的時間最多。4.3 passwd 與 authz用戶、群組、路徑權(quán)限的優(yōu)先級passwd只做一件事用戶名對密碼。格式簡單到幾乎沒有出錯空間真正的風(fēng)險在別處。[users] admin 123456密碼是明文存儲的所以文件權(quán)限要收緊chmod 600 /home/svn/project/conf/passwd屬主保持運(yùn)行 svnserve 的那個賬號。生產(chǎn)環(huán)境別用123456這種改成一個夠長的隨機(jī)串多人協(xié)作就一人一行別共用 admin。authz才是權(quán)限模型的核心它支持群組、路徑、讀寫分離三層。[groups] # 管理員組成員 admin g_admin admin # 版本庫根目錄的權(quán)限 [/] g_admin rw * # 若只想給某個子目錄更細(xì)的權(quán)限路徑寫全 [/docs] g_admin rw * r三個語法點(diǎn)必須說清楚。[/]表示版本庫根目錄不是某個叫 trunk 的目錄很多人被「trunk」這個詞帶偏寫成[/trunk]結(jié)果根目錄反而沒人有權(quán)限。g_admin rw里的表示引用群組去掉就變成用戶g_admin而它根本不存在權(quán)限自然不生效。* 等號后留空表示「無任何權(quán)限」注意別寫成* r那就成了全員可讀。優(yōu)先級規(guī)則記兩條就夠用路徑越具體優(yōu)先級越高所以[/docs]的規(guī)則會覆蓋[/]里的同名設(shè)置同一路徑下針對單個用戶的條目優(yōu)先于群組條目。也就是說給admin單獨(dú)寫一行admin rw會蓋過g_admin的設(shè)定。改完 authz 不需要重啟 svnserve下一次客戶端請求就會讀到新配置這一點(diǎn)比很多服務(wù)都友好。4.4 啟動與客戶端驗(yàn)證-d -r兩個參數(shù)的含義# -d 后臺運(yùn)行-r 指定版本庫根目錄路徑到 /home/svn 為止 svnserve -d -r /home/svn # 確認(rèn)進(jìn)程在 ps -ef | grep svnserve | grep -v grep # 確認(rèn) 3690 端口在監(jiān)聽 ss -lntp | grep 3690-r的路徑只到/home/svn不要寫成/home/svn/project。寫成后者的話客戶端地址就變成svn://IP/而不是svn://IP/project兩個項(xiàng)目共用一個 svnserve 也就無從談起。這是新手最常犯的一個配置錯誤表現(xiàn)是「服務(wù)明明在跑checkout 卻報倉庫不存在」?？蛻舳嗽L問地址按svn://服務(wù)器地址/項(xiàng)目名拼例如內(nèi)網(wǎng)地址是192.168.10.20就寫# Linux 客戶端驗(yàn)證先看 info 再 checkout svn info svn://192.168.10.20/project svn checkout svn://192.168.10.20/project ./project --username adminWindows 側(cè)用任意 SVN 客戶端填同一個地址即可首次連接會彈認(rèn)證框輸admin和對應(yīng)密碼。想快速確認(rèn)權(quán)限是否按預(yù)期生效用svn ls試讀、用一個新提交試寫兩步就能把 read 和 write 分開驗(yàn)證比翻配置文件快。5. 避坑與排查五條踩過的坑每條都有現(xiàn)場5.1 首行留空或鍵前有空格svnserve 直接拒絕啟動現(xiàn)象svnserve -d -r /home/svn敲下去沒反應(yīng)ps里也沒有進(jìn)程前臺跑會打印svnserve.conf:12: Option expected。原因svnserve.conf的解析器要求配置項(xiàng)頂格行首空白會被當(dāng)成非法續(xù)行空行本身在多數(shù)版本里是容忍的但行首空格一定會翻車。原文提醒的「首行不可以留空」落到實(shí)操就是別讓任何一行配置前面帶縮進(jìn)。解決grep -n ^[[:space:]] conf/svnserve.conf把所有帶前導(dǎo)空白的行列出來逐行頂格。改完用svnserve -d -r /home/svn --foreground預(yù)演一次能正常阻塞再放后臺。5.2 make 到鏈接階段才報 sqlite 符號找不到現(xiàn)象configure一路綠燈make跑到后半段突然undefined reference to sqlite3_open_v2。原因sqlite 的 amalgamation 目錄名不是 subversion 構(gòu)建腳本約定的sqlite-amalgamationconfigure 判定為「無內(nèi)置 sqlite」轉(zhuǎn)去找系統(tǒng)庫系統(tǒng)里又沒有可鏈接的 sqlite3 開發(fā)文件于是鏈接失敗。解決回到源碼樹ls subversion-1.8.14/sqlite-amalgamation/sqlite3.c目錄名不對就改名然后make clean重跑 configure。不要試圖用--with-sqlite指向原始解壓目錄名保持約定命名最省事。5.3 編譯通過、啟動報找不到 libapr-1.so.0現(xiàn)象svnserve --version報error while loading shared libraries: libapr-1.so.0: cannot open shared object file。原因apr 裝在/usr/local/apr/lib這個路徑?jīng)]進(jìn)動態(tài)鏈接器的搜索范圍編譯期的-L只影響鏈接不影響運(yùn)行期加載。解決在/etc/ld.so.conf.d/下新建配置文件寫入/usr/local/apr/lib和/usr/local/apr-util/lib執(zhí)行l(wèi)dconfig。臨時應(yīng)急可以用LD_LIBRARY_PATH但開機(jī)自啟的腳本和 systemd 服務(wù)讀不到你 shell 里的變量所以別把它當(dāng)長期方案。5.4 客戶端認(rèn)證一直失敗密碼明明是對的現(xiàn)象svn checkout反復(fù)彈認(rèn)證框輸admin和密碼始終提示認(rèn)證失敗服務(wù)端沒有任何日志。原因多數(shù)的鍋在authz。[groups]里寫了g_admin admin但權(quán)限段里漏了寫成g_admin rw解析器認(rèn)為你在給一個名叫g(shù)_admin的用戶授權(quán)而這個用戶不存在于是所有人被* 擋在門外。解決檢查authz里群組引用是否帶再把svnserve.conf里的realm寫上項(xiàng)目名避免客戶端拿舊憑據(jù)反復(fù)重試。客戶端側(cè)清一下本地憑據(jù)緩存刪掉~/.subversion/auth再試。5.5 重啟機(jī)器后 svnserve 不見了現(xiàn)象手工啟動正常重啟服務(wù)器后ps -ef | grep svnserve空空如也。原因svnserve -d是一次性命令沒有注冊成服務(wù)。原文用/etc/rc.d/rc.local掛腳本前提是那個腳本本身有可執(zhí)行權(quán)限且腳本里用的是svnserve的絕對路徑——開機(jī)時/etc/profile里的 PATH 往往還沒被非登錄 shell 加載。解決腳本里寫/usr/local/svn/bin/svnserve -d -r /home/svnchmod x腳本本身再確認(rèn)rc.local有執(zhí)行權(quán)限。更徹底的做法是寫一個 systemd unit見下一章。6. 開機(jī)自啟與備份讓這套環(huán)境能扛住下一次重啟6.1 兩種自啟寫法選一個就別混用rc.local的路子最直白適合不想碰 systemd 的老機(jī)器# 自啟腳本路徑與參數(shù)都用絕對路徑別指望 PATH cat /root/svn.sh EOF #!/bin/bash # 絕對路徑啟動開機(jī)階段環(huán)境變量尚未加載 /usr/local/svn/bin/svnserve -d -r /home/svn EOF chmod 755 /root/svn.sh # 掛到 rc.local 末尾注意該文件本身要有執(zhí)行權(quán)限 echo /root/svn.sh /etc/rc.d/rc.local chmod x /etc/rc.d/rc.local較新的發(fā)行版默認(rèn)不執(zhí)行rc.local這時候?qū)?unit 更靠譜# /etc/systemd/system/svnserve.service [Unit] DescriptionSubversion Protocol Daemon Afternetwork.target [Service] Typeforking ExecStart/usr/local/svn/bin/svnserve -d -r /home/svn Restarton-failure [Install] WantedBymulti-user.targetsystemctl daemon-reload systemctl enable --now svnserve systemctl status svnserve --no-pagerTypeforking是因?yàn)閟vnserve -d會自己 fork 到后臺用simple會讓 systemd 誤判主進(jìn)程已退出反復(fù)重啟。6.2 用 hotcopy 做每日備份并驗(yàn)證版本庫最大的風(fēng)險不是編譯失敗是磁盤寫滿或誤刪。svnadmin hotcopy能在不停止服務(wù)的前提下拷出一份一致的副本比cp -r安全得多。# 每日增量保留 7 天hotcopy 保證一致性 BACKUP/home/svnbackup mkdir -p $BACKUP/$(date %F) svnadmin hotcopy /home/svn/project $BACKUP/$(date %F)/project # 備份完立刻驗(yàn)一遍能 list 出來才算數(shù) svnlook youngest $BACKUP/$(date %F)/projectsvnlook youngest輸出的是當(dāng)前最新版本號這個數(shù)字和線上庫一致說明副本完整報錯則說明備份不可用別等真出事才發(fā)現(xiàn)。把它寫進(jìn) crontab每天凌晨跑一次順手find $BACKUP -maxdepth 1 -mtime 7 -exec rm -rf {} \;清舊副本。這套東西我是被一次磁盤寫滿教育出來的當(dāng)時只做了cp -r拷到一半空間不足副本里db/current和db/revs對不上真要用的時候才發(fā)現(xiàn)那份備份根本讀不出來。從那以后我每次配完 svnserve都強(qiáng)制先把 hotcopy 加進(jìn) crontab、跑一次svnlook youngest驗(yàn)一遍再交付給同事用。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取