Redmine管理員手冊.doc

1、Redmine管理員手冊Redmine 管理員手冊作者 :北京群英匯信息技術(shù)有限公司網(wǎng)址 :版本 :1.0.0-8+日期 :2010-07-29 12:23:45版權(quán)信息 :目錄? 1 說明? 2 項目管理? 3 用戶管理? 4 用戶組管理? 5 LDAP 認(rèn)證? 6 角色和權(quán)限? 7 問題跟蹤系統(tǒng)? 8 自定義屬性? 9 枚舉值? 10 配置? 11 高級配置o11.1版本庫配置o11.2發(fā)送郵件配置o11.3接收郵件?11.3.1方案?11.3.2各種方案的詳細(xì)說明?從郵件服務(wù)器轉(zhuǎn)發(fā)郵件? 從 IMAP 服務(wù)器讀取郵件? 從 POP3 服務(wù)器

2、讀取郵件?從標(biāo)準(zhǔn)輸入讀取郵件?11.3.3開啟匿名用戶通過郵件提交問題?11.3.4工作原理?11.3.5例子演示o11.4發(fā)送提醒郵件o11.5LDAP認(rèn)證o11.6配置單點登錄o11.7從 LDAP 同步賬號o11.8Subversion基于路徑授權(quán)1 說明關(guān)于手冊中方框標(biāo)記部分的說明?Note是需要注意的部分。? Hint 是群英匯為 Redmine 擴展的部分。2 項目管理?項目列表默認(rèn)情況下 , 項目列表顯示所有活動的項目。 要想瀏覽所有項目 ( 包括活動和歸檔項目), 需要調(diào)整項目狀態(tài)過濾器為 全部 。項目列表截圖?新建 / 編輯項目?項目存檔在項目列表頁面點擊 存

3、檔 鏈接 , 可將該項目存檔。存檔項目對用戶不可見。管理員可以取消存檔。當(dāng)父項目存檔 , 它的所有子項目也都自動存檔。?復(fù)制現(xiàn)有項目在項目列表頁面, 點擊 復(fù)制 鏈接復(fù)制你想要復(fù)制的項目。復(fù)制項目的表單將會預(yù)填原項目的設(shè)置 ( 如: 跟蹤標(biāo)簽 , 自定義屬性 .) 。 在該表單的底部 , 你可以選擇復(fù)制原項目的哪些內(nèi)容。?刪除項目在項目列表頁面, 點擊 刪除 鏈接 , 界面將跳到刪除頁面, 選中 是 復(fù)選框 , 然后點擊 刪除 按鈕 , 該項目以及子項目的所有數(shù)據(jù)都將被刪除。Note存檔與刪除的區(qū)別:?存檔只是隱藏項目及子項目, 而項目的數(shù)據(jù)還存在。?刪除則是將項目以及子項目的數(shù)據(jù)一同刪除,

4、無法恢復(fù)。3 用戶管理?用戶列表用戶列表截圖默認(rèn)情況下顯示活動的用戶 , 你可以調(diào)節(jié)用戶狀態(tài)過濾器, 選擇瀏覽不同狀態(tài)的用戶。通過點擊右側(cè) 鎖定 鏈接 , 可將用戶從 活動的 狀態(tài)變?yōu)?已鎖定 狀態(tài)。同樣點擊 解鎖 鏈接 , 可以將用戶從 已鎖定 狀態(tài)變?yōu)?活動的 狀態(tài)。?添加用戶點擊右上角的 新建用戶 鏈接 , 跳轉(zhuǎn)到新建用戶頁面:必填字段 :o 登錄名o 名字o 姓氏o 郵件地址o 管理員選中之后 , 該用戶將是管理員的身份。o 認(rèn)證如果你已經(jīng)配置了LDAP,那么認(rèn)證區(qū)域?qū)霈F(xiàn)一個 認(rèn)證模式 的下拉選擇框。Redmine提供了兩種認(rèn)證機制? 內(nèi)部認(rèn)證將用戶的密碼經(jīng)過加密后存入數(shù)據(jù)庫中。?

5、 外部認(rèn)證 ( 如 LDAP)用戶的密碼存儲在一些外部認(rèn)證中, 如LDAP。o 給用戶發(fā)送賬號信息選中它 , 創(chuàng)建賬號后 , 新建的用戶將收到一封關(guān)于賬號信息的郵件。Hint從 LDAP同步賬號Redmine的 LDAP 認(rèn)證模式是 :首先管理員配置好LDAP 認(rèn)證, 并且選中即時用戶生成 選項 , 然后當(dāng)用戶用LDAP 賬號第一次登錄Redmine時, 系統(tǒng)自動將LDAP里的用戶信息存入數(shù)據(jù)庫, 為用戶創(chuàng)建Redmine賬號。但這樣會有一個問題 : 如果管理員想批量給某一項目添加項目成員 , 這時不得不一一通知這些人 , 讓他們都立馬登錄一下 Redmine( 因為只有這樣 , 他們才擁有

6、Redmine 賬號 , 管理員才能給這些用戶劃分角色 , 授予權(quán)限 ) 。顯然這很麻煩 , 給管理人員帶來不必的煩惱, 似乎管理人員的權(quán)利需要員工給予。群英匯給 Redmine的管理人員帶來了福音, 我們添加了管理人員可以直接從LDAP服務(wù)器同步賬號到Redmine的功能。實際上，如果配置了外部的認(rèn)證源（LDAP 或者單點登錄），點擊“新建用戶 ”，會直接跳轉(zhuǎn)到LDAP帳號同步界面。操作步驟 , 參見從 LDAP 同步賬號。?編輯用戶想要編輯用戶信息, 只需點擊用戶名, 就跳轉(zhuǎn)到修改該用戶信息的頁面了。o 一般屬性和新建用戶界面的屬性一樣。o 組如果你創(chuàng)建了組, 在這里會顯示組選項卡。o 項

7、目在這里可以給該用戶指定項目。4 用戶組管理用戶組列表截圖從 Redmine-0.9 開始 , 管理員可以定義用戶組。用戶組可以像添加常規(guī)用戶一樣添加到項目中去。當(dāng)把用戶添加到一個已存在的用戶組里, 該用戶將擁有該組的一切權(quán)限。5LDAP 認(rèn)證在 1.0以前，新建LDAP 需要一系列繁雜的操作：管理-配置-認(rèn)證-LDAP 認(rèn)證（右下角處）。為了方便用戶操作，固將LDAP 操作置于管理員界面右邊欄。6 角色和權(quán)限角色決定用戶在項目中擁有的權(quán)限。 每個項目成員在項目中可以有一個或者多個角色。 每個用戶在不同的項目中可以有不同的角色。管理員可以創(chuàng)建新的角色 ; 也可以編輯已經(jīng)存在的角色 ; 只有當(dāng)某

8、一角色下沒有用戶時, 該角色才能被刪除。?角色的屬性o 名稱o 問題可指派給此角色如果不選 , 問題就不能指派給該角色里的成員。o 從以下選項復(fù)制工作流程新建的角色可以從已經(jīng)存在的角色中復(fù)制工作流, 如果不選則新建角色的工作流為空。?權(quán)限當(dāng)編輯一個角色的時候 , 你可以通過 ( 選中 / 取消 ) 那些不同的行為給該角色定義權(quán)限。權(quán)限描述項目權(quán)限新建項目允許非管理用戶創(chuàng)建根項目編輯項目允許用戶編輯項目的屬性權(quán)限描述選擇項目模允許用戶開啟 / 禁用項目的模塊塊管理成員允許用戶添加 / 刪除項目組成員或者改變項目組成員的角色管理版本允許用戶添加 / 刪除項目的版本新建子項目允許用戶為該項目創(chuàng)建子項

9、目討論區(qū)權(quán)限管理討論區(qū)允許用戶添加 / 編輯 / 刪除項目的討論區(qū)發(fā)表貼子允許用戶在討論區(qū)發(fā)表貼子編輯貼子允許用戶編輯任何貼子、刪除貼子的附件編輯自己的僅允許用戶編輯自己的貼子貼子刪除貼子允許用戶刪除任何貼子和回復(fù)刪除自己的僅允許用戶刪除自己的貼子和回復(fù)貼子文檔權(quán)限權(quán)限描述管理文檔允許用戶添加 / 編輯 / 刪除項目的文檔查看文檔允許用戶查看文檔文件權(quán)限管理文件允許用戶添加 / 編輯 / 刪除項目的文件查看文件允許用戶查看文件問題跟蹤權(quán)限管理問題類別允許用戶添加 / 編輯 / 刪除問題類別查看問題允許用戶查看問題新建問題允許用戶新建問題更新問題允許用戶編輯問題管理問題關(guān)聯(lián)允許用戶添加 / 刪除

10、問題之間的關(guān)聯(lián)管理子任務(wù)允許用戶給問題（ issues ）添加 / 刪除子任務(wù)權(quán)限描述添加說明允許用戶給已存在的問題添加說明編輯說明允許用戶編輯任何的問題說明編輯自己的僅允許用戶編輯自己添加的問題說明說明移動問題允許用戶將已存在的問題移動到別的項目中刪除問題允許用戶刪除問題管理公開的允許用戶添加 / 編輯 / 刪除公開的問題查詢查詢保存查詢允許用戶保存自定義問題查詢查看甘特圖允許用戶瀏覽甘特圖查看日歷允許用戶瀏覽日歷查看跟蹤者允許用戶查看問題的跟蹤者列表添加跟蹤者允許用戶給已存在的問題添加跟蹤者刪除跟蹤者允許用戶刪除問題的跟蹤者權(quán)限描述新聞權(quán)限管理新聞允許用戶添加 / 編輯 / 刪除項目的新聞

11、為新聞添加允許用戶給新聞添加評論評論版本庫權(quán)限管理版本庫允許用戶配置項目的版本庫瀏覽版本庫允許用戶瀏覽并查看項目版本庫的內(nèi)容查看變更允許用戶查看變更集訪問提交信給予 Redmine.pm具有訪問項目版本庫寫的權(quán)限息時間跟蹤權(quán)限登記工時允許用戶給項目登記工時查看耗時允許用戶查看項目的耗時歷史編輯耗時允許用戶編輯任何耗時記錄權(quán)限描述編輯自己的僅允許用戶編輯自己的耗時記錄耗時管理項目活允許用戶添加/ 編輯 / 刪除活動動Wiki權(quán)限允許用戶創(chuàng)建/ 刪除項目的Wiki刪除 Wiki 頁面是不可恢復(fù)的操管理 Wiki作 , 它會刪除所有相關(guān)的頁面及附件重命名 Wiki允許用戶重命名Wiki頁面 , 或者

12、指定Wiki頁面的父頁面頁面刪除 Wiki頁允許用戶刪除Wiki頁面 , 此操作是不可恢復(fù)的 , 頁面以及修改面歷史將被統(tǒng)統(tǒng)刪除查看 Wiki允許用戶查看Wiki頁面導(dǎo)出 Wiki頁允許用戶將Wiki 頁面導(dǎo)出為各種格式（pdf,html,.)面查看 Wiki歷允許用戶老版本的Wiki頁面 , 或者查看不同版本之間的差別史記錄編輯 Wiki頁允許用戶編輯沒有保護(hù)的Wiki頁面權(quán)限描述面刪除附件允許用戶刪除Wiki頁面的附件保護(hù) Wiki頁允許用戶鎖定/ 解鎖 Wiki頁面 , 并具有編輯已鎖定的WIki頁面的面權(quán)限?系統(tǒng)角色在 Redmine共有 2 種系統(tǒng)角色 , 他們供 Redmine內(nèi)部

13、使用 , 因此不能被刪除。o Non member非項目成員角色, 用于定義那些不屬于該項目成員的用戶的權(quán)限。o Anonymous匿名角色 , 用于定義匿名用戶在項目中的權(quán)限。Note? 這兩個角色僅被用于公開項目, 因此匿名用戶和非私有項目成員用戶不能看到它。? 一些權(quán)限不能賦給這兩個角色。例如 管理成員 7 問題跟蹤系統(tǒng)?跟蹤標(biāo)簽新建跟蹤標(biāo)簽截圖跟蹤標(biāo)簽代表不同的問題類型。 默認(rèn)情況下有三種標(biāo)簽 : 錯誤 , 功能和支持。管理員可以新建跟蹤標(biāo)簽 :o 名稱o 在路線圖中顯示問題o 從以下選項復(fù)制工作流程新建的跟蹤標(biāo)簽可以從已經(jīng)存在的跟蹤標(biāo)簽中復(fù)制工作流。如果不選, 那么新建的跟蹤標(biāo)簽的工

14、作流為空。o項目可以指定新建的跟蹤標(biāo)簽用于哪些項目中。?問題狀態(tài)管理員可以根據(jù)需要自由地添加和刪除問題狀態(tài)。問題狀態(tài)含有的屬性:o名稱o已關(guān)閉的問題如果選中 , 則表示處于該狀態(tài)的問題屬于已經(jīng)關(guān)閉的問題( 可以聲明多個狀態(tài)屬于已關(guān)閉的狀態(tài)) 。o 默認(rèn)值指定新建問題的默認(rèn)狀態(tài)( 只能有一個狀態(tài)屬于默認(rèn)狀態(tài)) 。?完成度該選項（即問題狀態(tài)一覽表中的完成度列）只有在計算問題完成度選項設(shè)置為使用問題的狀態(tài)時才顯示。?更新問題的完成度該鏈接只有在計算問題完成度選項設(shè)置為使用問題的狀態(tài)時才顯示。當(dāng)點擊該鏈接后，系統(tǒng)將根據(jù)問題的狀態(tài)更改問題的完成度。以后每當(dāng)問題的狀態(tài)更新，系統(tǒng)自動根據(jù)這里設(shè)置的完成度更改

15、完成度字段的值。設(shè)置問題狀態(tài)對應(yīng)的完成度? 工作流工作流使你可以定義不同角色的項目成員對不同類型的問題所能做的問題狀態(tài)變更。定制工作流截圖在工作流設(shè)置頁面 , 選擇你想要編輯的角色和跟蹤標(biāo)簽 , 點擊 編輯 按鈕 , 跳轉(zhuǎn)到編輯頁面 , 此頁面可以編輯該角色對該標(biāo)簽所能做的變更狀態(tài)。 左側(cè)列出了該跟蹤標(biāo)簽所有的狀態(tài) , 你可以在右側(cè)選擇針對該狀態(tài)該角色可以變更的狀態(tài)。Note要改變問題的狀態(tài)， 用戶需要具有更新問題或者 添加說明的權(quán)限。（參見權(quán)限）。8 自定義屬性自定義屬性截圖Redmine允許管理員給以下實體添加屬性, 從而給這些實體添加額外的描述信息:? 問題? 耗時? 項目? 版本庫?

16、用戶? 組? 活動 ( 時間跟蹤 )? 問題優(yōu)先級? 文檔類別自定義的屬性有以下幾種數(shù)據(jù)類型:?整數(shù)?字符串單行輸入框?文本多行輸入文本域?日期?布爾值復(fù)選框?列表下拉列表自定義屬性的約束條件:?最小 - 最大長度決定自定義屬性的字段長度(0 表示沒有限制) 。?正則表達(dá)式通過指定的正則表達(dá)式, 對自定義屬性的內(nèi)容進(jìn)行驗證。?默認(rèn)值自定義屬性的默認(rèn)值?跟蹤標(biāo)簽設(shè)置該自定義屬性可以在哪些跟蹤標(biāo)簽中使用?必填該自定義屬性是否是必填字段?用于所有項目該自定義屬性是否用于所有項目中?作為過濾條件該自定義屬性是否作為過濾器的過濾條件?可用作搜索條件該自定義屬性是否可以用作搜索時的搜索條件9 枚舉值枚舉值

17、截圖Redmine允許管理員對以下實體添加枚舉值, 從而擴充這些實體可選擇的值:? 活動 ( 時間跟蹤 )? 問題優(yōu)先級? 文檔類別這些枚舉值是跨項目的管理員可以任意地添加/修改 /刪除。枚舉值包含的字段:?名稱?活動只有活動的枚舉值才能被使用?默認(rèn)值如果選中 , 那么在使用同類枚舉值時該枚舉值默認(rèn)被選中同一類枚舉值的默認(rèn)值只能設(shè)置一個10 配置?一般o 應(yīng)用程序標(biāo)題顯示在應(yīng)用程序頭部的文字o 歡迎文字這些文本將顯示在項目概述頁面o附件大小限制上傳文件的最大值。默認(rèn)為 5120KBo每頁顯示條目個數(shù)的設(shè)置這個主要用于分頁顯示, 在這里可以填入你想要每頁顯示的記錄數(shù), 多個值之間用逗號分開。默認(rèn)

18、值 :25,50,100o在項目活動中顯示的天數(shù)在這里可以設(shè)置每頁顯示多少天之內(nèi)的活動默認(rèn)值 :30表示顯示30 天之內(nèi)的活動o主機名稱在這里設(shè)置Redmine服務(wù)的主機名稱和路徑。Redmine用這個值生成郵件簽名里的URL,從而收件人通過點擊郵件簽名里的URL 訪問系統(tǒng)。o協(xié)議協(xié)議指郵件通知里生成的鏈接打開方式。默認(rèn)值 :http郵件里的鏈接是 “guessed”，因此不會診斷你使用的是不安全的 Http 協(xié)議還是安全的 https 協(xié)議。o 文本格式格式文本用于問題, 新聞 , 文檔 , Wiki等等的描述字段。默認(rèn)只有textile一種文本過濾器。o緩存格式化文本(1.0加入的功能)每

19、次向瀏覽器發(fā)送格式化文本 （例如： 問題描述， wiki 頁面 . ）時都需要將原始的文本轉(zhuǎn)換成 HTML 。如果文本過于龐大，那么這個過程將會很慢。該設(shè)置允許你開啟緩存格式化文本。緩存的文本存儲方案取決于緩存策略的設(shè)置（可以功過 config.action_controller.cache_store設(shè)置）。默認(rèn)情況下，緩存策略為MemoryStore如果你需要開啟緩存，強烈建議你使用另一種緩存策略，像MemCacheStore或者FileStore（在內(nèi)存有限情況下）。更多關(guān)于Rails 的緩存策略可參考手冊：/caching_wit

20、h_rails.html#cache-stores? 壓縮 Wiki 歷史文檔對 Wiki歷史進(jìn)行壓縮 ( 減小數(shù)據(jù)庫的存儲大小) 。 默認(rèn)值 : 禁用? RSS Feed 內(nèi)容條數(shù)限制RSS feeds內(nèi)容條數(shù)的最大值。默認(rèn)值 :15? 允許直接顯示的最大文本文件限制可直接顯示的文本文件的最大尺寸默認(rèn)值 :512KB? 查看差別頁面上顯示的最大行數(shù)限制可最多顯示差異行數(shù)的最大值, 多于最大行數(shù)的內(nèi)容將被Redmine自動截斷默認(rèn)值 :1500?顯示o 主題可供選擇的主題樣式Redmine除默認(rèn)主題外還提供了另外兩個備用主題:? alternate該主題的最大特點是根據(jù)問題的優(yōu)先級在問題列表頁

21、面為問題著色。? classic該主題追溯到Redmine 0.5.1,給人一種經(jīng)典的感覺o 默認(rèn)語言當(dāng)應(yīng)用程序不能識別用戶瀏覽器的語言時,默認(rèn)語言將被作為客戶端語言。當(dāng)發(fā)送郵件時也會根據(jù)默認(rèn)語言作為給用戶發(fā)送郵件的語種。默認(rèn)值 :eno 日歷開始于設(shè)置星期的開始日期, 提供的選項有:? 根據(jù)用戶的語言? 星期一? 星期天默認(rèn)值 : 根據(jù)用戶的語言o 日期格式設(shè)置日期顯示格式 :? 根據(jù)用戶的語言根據(jù)用戶語言定義的格式顯示? 其他格式默認(rèn)值 : 根據(jù)用戶的語言o時間格式設(shè)置時間顯示格式:?根據(jù)用戶的語言?其他格式默認(rèn)值 : 根據(jù)用戶的語言o用戶顯示格式設(shè)置用戶名的顯示格式o使用Gravatar

22、用戶頭像如果開啟,在應(yīng)用程序的一些地方可以看到用戶的Gravatar頭像o默認(rèn)的Gravatar頭像設(shè)置那些沒有Gravatar圖片的用戶顯示的圖片?認(rèn)證o 要求認(rèn)證如果選中 , 匿名用戶將不能訪問系統(tǒng), 用戶必須登錄后才能訪問。o 自動登錄o 允許自注冊設(shè)置是否允許用戶注冊 :? 禁用不允許用戶注冊? 通過郵件認(rèn)證激活賬號用戶注冊后將收到一封激活賬號的郵件, 里面含有一個激活賬號的鏈接,點擊那個鏈接就能激活剛注冊的賬號。? 手動激活賬號 默認(rèn)值用戶注冊后需要經(jīng)管理員審核批準(zhǔn)。用戶注冊后 , 管理員會收到一封激活賬號的郵件。? 自動激活賬號用戶注冊成功后, 直接就能用剛注冊的賬號登錄系統(tǒng)。?

23、最短密碼長度設(shè)置密碼的最短長度 默認(rèn)值 :4o 忘記密碼如果選中 , 在登錄界面上將顯示一個 忘記密碼 的鏈接。默認(rèn)值 : 開啟o允許使用OpenID登錄和注冊設(shè)置是否允許使用OpenID登錄和注冊Note使用該功能需要安裝ruby-openid包 , 一條簡單的gem安裝命令就能搞定( 安裝后需要重啟服務(wù)生效):gem isntall ruby-openido 啟用 REST web service設(shè)置是否啟用REST web service在和外部系統(tǒng)集時才需要開啟該選項?項目o 新建項目默認(rèn)為公開項目默認(rèn)情況下 , 新建的項目為公開項目你可以在創(chuàng)建項目時不選中該選項, 從而創(chuàng)建非公開項目

24、, 也可以修改已創(chuàng)建的公開項目為非公開項目。o 新建項目默認(rèn)啟用的模塊設(shè)置新建項目默認(rèn)開啟的模塊o 順序產(chǎn)生項目標(biāo)識選中之后 , Redmine將為你提供連續(xù)的項目標(biāo)識符。該標(biāo)識符用于Redmine REST架構(gòu)的 URL 標(biāo)識用o 非管理員用戶新建項目時將被賦予的（在該項目中的）角色該選項用于指定非管理用戶在新建項目中的角色。如果你不指定 , 系統(tǒng)自動把該用戶指定為新建項目的管理員角色 。Note前提是你必須在權(quán)限設(shè)置界面為非管理員用戶賦予創(chuàng)建項目的權(quán)限?問題跟蹤o 允許不同項目之間的問題關(guān)聯(lián)如果選中 , 那么不同項目之間的問題可以建立關(guān)聯(lián)。默認(rèn)值 : 禁用o 在項目頁面上默認(rèn)顯示子項目的問

25、題如果選中 , 在瀏覽父項目的問題列表示, 日歷和甘特圖時子項目的問題也顯示出來。默認(rèn)值 : 開啟? 計算問題完成度設(shè)置計算問題完成度的方案 :o 使用問題 ( 的完成度 ) 屬性 默認(rèn)值 ：用戶手動設(shè)置完成度o 使用問題的狀態(tài)：每個問題的狀態(tài)可以被設(shè)置一個完成度。該設(shè)置會開啟問題狀態(tài)設(shè)置頁面的 完成度 和 更新問題的完成度 設(shè)置。? 問題輸出條目的限制設(shè)置導(dǎo)出問題條目的最大值( 包括 CSV 和 PDF) 。 默認(rèn)值 :500? 問題列表中顯示的默認(rèn)列設(shè)置默認(rèn)情況下 , 問題的哪些列被顯示。用戶自定義的屬性只有標(biāo)記為用于所有項目才會在這里列出供選擇?郵件通知o 郵件發(fā)件人地址設(shè)置 Redmi

26、ne發(fā)送郵件的發(fā)件人地址o使用密件抄送 (bcc)密件抄送即郵件頭部隱藏接接收者的地址o 純文本 ( 無 HTML)如果選中 , 則郵件僅發(fā)送純文本格式, 不發(fā)送 HTML 格式o 選擇需要發(fā)送郵件通知的動作設(shè)置 Redmine的哪些活動事件會觸發(fā)郵件通知o 郵件簽名如何配置發(fā)送郵件, 參見配置郵件發(fā)送?接收郵件o 在這些行之后截斷郵件這些設(shè)置可以刪除接收郵件的簽名部分o 啟用用于接收郵件的服務(wù)從 0.8之后 , Redmine支持通過發(fā)送郵件創(chuàng)建問題和評論。想要使用此功能, 你需要開啟接收郵件的API 。 默認(rèn)值 : 禁用? API key點擊 生成一個key 鏈接 , 系統(tǒng)自動生成一個ke

27、y,這是 Redmine通過接收郵件創(chuàng)建問題的密鑰。?如何配置通過接收郵件提交問題, 參見Redmine接收郵件配置?版本庫o 自動獲取程序變更如果選中 , 當(dāng)用戶瀏覽版本庫時應(yīng)用程序會自動抓取版本庫新的變更默認(rèn)值 :開啟管理員可以關(guān)閉此選項, 通過使用cron在后臺定期執(zhí)行Repository#fetch_changesets命令抓取版本庫新的變更。例如 :ruby script/runner Repository.fetch_changesets -e production你也可以通過版本庫的post-commit或者 post-receive鉤子調(diào)用這個任務(wù) , 從而使每次提交之后, 變

28、更集自動被抓取。o啟用用于版本庫管理的Web Service該選項只有在你安裝了自動創(chuàng)建SVN 版本庫的腳本時開啟。默認(rèn)值 : 禁用o啟用SCM設(shè)置開啟的SCM 類型o 版本庫編碼設(shè)置版本庫里文件的編碼方式 ( 多個值之間用逗號分開 ) 。 這些編碼用于將文件的內(nèi)容和 diff 轉(zhuǎn)換成 UTF-8, 從而確保瀏覽版本庫時正確顯示。當(dāng)填寫多個編碼方式時, 第一個編碼是文件使用的編碼o 提交注釋的編碼o在文件變更記錄頁面上顯示的最大修訂版本數(shù)量默認(rèn)值 :100o 在提交信息中引用和解決問題當(dāng)版本庫抓取變更集時, 會掃描提交信息中引用和解決的問題ID 。o 在這里管理員可以定義提交注釋中引用和解決問

29、題的關(guān)鍵字, 從而通過使用這些關(guān)鍵字自動使該次修訂引用或者解決某些問題。同樣可以設(shè)置使用解決問題的關(guān)鍵字后問題狀態(tài)的變更, 以及完成度的變更 *默認(rèn)的關(guān)鍵字有 :? 引用: refs, references, IssueID? 解決: fixes, closes?用于解決問題的關(guān)鍵字后問題的變更設(shè)置:? 應(yīng)用后的狀態(tài)? 完成度? 示例This commit refs #1, #2 and fixes #3說明 :?這次代碼提交引用了問題1,2同時解決了問題3? 每個關(guān)鍵字和問題 ID 之間可以用空格 , 逗號或者 & 分開11 高級配置11.1版本庫配置?常規(guī)信息Redmine一直以來支持不同

30、的版本控制工具集成: Subversion, CVS, Mercurial,Darcs, Git和 Bazaar 。首先你要在Redmine主機上安裝合適的二進(jìn)制包, 并確保這些二進(jìn)制文件在PATH環(huán)境變量中可用:SCM已測試過的版本說明Subversion1.3 & 1.4 & 1.5 & 1.6需要 1.3 或者更高的版本SCM已測試過的版本說明CVS1.12.12需要 1.12,不能同時使用CVSNTMercurial0.9.3Bazaarl.0.0.candidate.1 & 2.0.4Darcs1.0.7Git比如 , 如果你想用Redmine訪問 Subverion版

31、本庫 , 你必須在 Redmine主機上安裝 SVN 二進(jìn)制文件。?給項目添加一個已經(jīng)存在的版本庫在項目配置選項卡下有版本庫子選項庫 , 在這里可以為項目添加版本庫。選擇你所使用的版本庫類型, 并輸入版本庫路徑或者URLNote當(dāng)配置完版本庫第一次訪問時, Redmine將抓取版本庫中已經(jīng)存在的所有提交信息,并存入數(shù)據(jù)庫。所以如果你的版本庫特別大, 那么該過程將會很長。為了避免這種情況, 你可以將該過程放在后臺執(zhí)行。在配置完版本庫后, 運行下面的命令:$ ruby script/runner Repository.fetch_changesets -e production所有的提交將會被存入

32、數(shù)據(jù)庫從 Redmine0.9之后 , 你還可以通過一個鏈接給某一項目或者所有項目執(zhí)行fetch_changesets: (給所有活動的項目取回變更集 ) (僅給 foo項目取回變更集 )?Subversion版本庫Redmine支持的協(xié)議有 ( http:,svn:,file:),只需要輸入版本庫的URL例如 :http:/host/path/to/the/repository如果版本庫需要身份認(rèn)證, 你需要額外輸入用戶名和密碼Note如果你想要用svn+ssh:/訪問版本庫 , 你必須把 svn+ssh 配置為非交互的方式。同時需要設(shè)置ssh 認(rèn)證的 public/private鑰對Hin

33、tSubversion基于路徑的授權(quán)Redmine 對 Subversion授權(quán)是這樣處理的:在配置 Subversion版本庫時 , 除了輸入 URL 外 , 還需填寫一個擁有Subversion讀權(quán)限的賬戶信息( 如果你的Subversion不允許匿名訪問 ) 。顯然很多商業(yè)公司的代碼有很高的嚴(yán)密性, 大多是不允許匿名訪問的 ,看來是必填了。而 Redmine對 Subversion認(rèn)證不嚴(yán)格也是從這里開始的。 填寫了這個賬戶之后, 不管哪個用戶登錄 Redmine瀏覽版本庫 , 看到的版本庫信息都是該賬戶應(yīng)該能看到的, 而不是當(dāng)前登錄用戶應(yīng)該看到的。也就是說, 在這種情況下 , 如果你想

34、對代碼瀏覽嚴(yán)加控制, 那么就需要創(chuàng)建一個很低權(quán)限的Subversion賬號 , 用這個賬號作為Redmine訪問 Subversion的賬號。 但這樣一來, 那些具有高權(quán)限的用戶就不樂意了 ( 他們本來是能看到很多代碼的 , 但這樣一來他們的權(quán)限無形之中被剝奪了 ) 。為了滿足商業(yè)軟件公司的需求, 群英匯對 Redmine關(guān)于 Subversion授權(quán)的部分進(jìn)行了擴展 ,采用 Subversion本身的授權(quán)模式。我們添加了解析 Subversion授權(quán)文件的組件 , 可以很好地解析每個用戶的權(quán)限, 從而保證 Redmine瀏覽權(quán)限和Subversion定義的權(quán)限一致 , 完美解決了 Redmi

35、ne中 Subversion授權(quán)不嚴(yán)格的問題 , 實現(xiàn)了 Subversion基于路徑的授權(quán)。配置步驟 ,參見 Subversion基于路徑授權(quán)? CVS 版本庫輸入 :o版本庫的URL ( 也可以輸入路徑或者鏈接字符串, 例如:pserver)o 模組名稱示例 :pserver:login:passwordhost:/path/to/the/repository以下幾種版本庫輸入版本庫的路徑即可? Git 版本庫? Mercurial 版本庫Hint解決了中文版Mercurial版本庫無法使用的問題由于 Redmine在匹配 Mercurial版本信息時是基于英語匹配的,所以當(dāng)我們使用中文

36、Mercurial時 , 它會拋出匹配失敗的異常, 造成中文用戶不能使用。?Bazaar版本庫? Darcs 版本庫11.2發(fā)送郵件配置首先將config/email.yml.example重命名為config/email.yml然后配置發(fā)送郵件需要的參數(shù):production:delivery_method: :smtpsmtp_settings:address: mail.foo.barport: 25domain: foo.bar# authentication: :login# user_name: xxx# password: xxx注意 : 用 # 注銷掉的那三行信息，是郵件服務(wù)器

37、身份驗證信息。但是如果你的用戶已經(jīng)使用了域驗證，就不需要那三行信息。訪問 redmine ，以管理員的身份登錄系統(tǒng)， 點擊 管理 - 配置 - 郵件通知 ，然后點擊右下角的 發(fā)送測試郵件 ，就可以測試你的郵件服務(wù)配置是否成功了。Note當(dāng) delivery_method設(shè)置為 :smtp 時 , 它的處理流程是這樣的 :在觸發(fā)郵件發(fā)生的事件發(fā)生后, 首先發(fā)送郵件, 直到郵件發(fā)送完畢, 頁面才跳轉(zhuǎn)。 這就是說在發(fā)送郵件的過程中, 頁面一直處于等待狀態(tài)。那么有沒有一種異步發(fā)送郵件機制呢?在 Redmien 0.9之后 , 可通過將delivery_method設(shè)置為 : async_smtp,這時

38、發(fā)送郵件和頁面跳轉(zhuǎn)屬于不同的線程, 當(dāng)觸發(fā)郵件的事件發(fā)生后, 發(fā)送郵件將會通過消息隊列在后臺執(zhí)行 , 而頁面繼續(xù)向下執(zhí)行, 不用等到郵件發(fā)送完畢。11.3接收郵件從 Redmien-0.8.0開始 , 通過配置 , 你可以以發(fā)送郵件的方式創(chuàng)建或者評論問題(issue)。11.3.1方案你可以通過以下幾種方式配置Redmine接收郵件的功能:? 從郵件服務(wù)器轉(zhuǎn)發(fā)郵件o優(yōu)點 :與遠(yuǎn)程郵件服務(wù)器協(xié)作，郵件處理即時，快速( 無環(huán)境重載 )o 缺點 : 需要一些郵件傳輸代理 (MTA) 的配置 (如 Postfix ， Sendmail.)? 從 IMAP 或者 POP3 服務(wù)器讀取郵件o優(yōu)點 :易于安裝,不需要配置郵件傳輸代理(MTA),與遠(yuǎn)程郵件服務(wù)器協(xié)作o缺點 :郵件處理不即時( 需要添加一個定期讀取郵件的con job)? 從標(biāo)準(zhǔn)輸入讀取郵件o 優(yōu)點 : 用于測試的最佳選項o 缺點 : 慢 ( 每次讀取郵件時都要重新載入環(huán)境), 需要配置郵件傳輸代理 (MTA)11.3.2各種方案的詳細(xì)說明從郵件服務(wù)器轉(zhuǎn)發(fā)郵件用一個獨立的腳本轉(zhuǎn)發(fā)郵件服務(wù)