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