Redmine 管理員手冊

1、【精品文檔】如有侵權，請聯(lián)系網站刪除，僅供學習與交流Redmine 管理員手冊.精品文檔.Redmine 管理員手冊 Redmine 管理員手冊作者:北京群英匯信息技術有限公司網址:版本:1.0.0-8+日期:2010-07-29 12:23:45版權信息:目錄· 1   說明 · 2   項目管理 · 3   用戶管理 · 4   用戶組管理 · 5   LDAP 認證 · 6

2、0;  角色和權限 · 7   問題跟蹤系統(tǒng) · 8   自定義屬性 · 9   枚舉值 · 10   配置 · 11   高級配置 o 11.1   版本庫配置 o 11.2   發(fā)送郵件配置 o 11.3   接收郵件 § 11.3.1   方案

3、 § 11.3.2   各種方案的詳細說明 §    從郵件服務器轉發(fā)郵件 §    從IMAP服務器讀取郵件 §    從POP3服務器讀取郵件 §    從標準輸入讀取郵件 § 11.3.3   開啟匿名用戶通過郵件提交問題 § 11.3.4   工作

4、原理 § 11.3.5   例子演示 o 11.4   發(fā)送提醒郵件 o 11.5   LDAP 認證 o 11.6   配置單點登錄 o 11.7   從LDAP同步賬號 o 11.8   Subversion 基于路徑授權 1   說明關于手冊中方框標記部分的說明· Note 是需要注意的部分。 · Hint 是群英匯為Redmine擴展的部分。 2&#

5、160;  項目管理· 項目列表默認情況下, 項目列表顯示所有活動的項目。 要想瀏覽所有項目(包括活動和歸檔項目), 需要調整項目狀態(tài)過濾器為"全部"。項目列表截圖· 新建/編輯項目· 項目存檔在項目列表頁面點擊"存檔"鏈接, 可將該項目存檔。存檔項目對用戶不可見。 管理員可以取消存檔。當父項目存檔, 它的所有子項目也都自動存檔。· 復制現(xiàn)有項目在項目列表頁面, 點擊"復制"鏈接復制你想要復制的項目。復制項目的表單將會預填原項目的設置(如:跟蹤標簽, 自定義屬性 .)。 在該

6、表單的底部, 你可以選擇復制原項目的哪些內容。· 刪除項目在項目列表頁面, 點擊"刪除"鏈接, 界面將跳到刪除頁面, 選中"是"復選框, 然后點擊"刪除"按鈕, 該項目以及子項目的所有數(shù)據都將被刪除。Note存檔與刪除的區(qū)別:· 存檔只是隱藏項目及子項目, 而項目的數(shù)據還存在。 · 刪除則是將項目以及子項目的數(shù)據一同刪除, 無法恢復 。 3   用戶管理· 用戶列表用戶列表截圖默認情況下顯示 活動的 用戶, 你可以調節(jié)用戶狀態(tài)過濾器, 選擇瀏覽不同狀態(tài)的用戶。通過點

7、擊右側"鎖定"鏈接, 可將用戶從 活動的 狀態(tài)變?yōu)?已鎖定 狀態(tài)。同樣點擊"解鎖"鏈接, 可以將用戶從 已鎖定 狀態(tài)變?yōu)?活動的 狀態(tài)。· 添加用戶點擊右上角的"新建用戶"鏈接, 跳轉到新建用戶頁面:必填字段:o 登錄名o 名字o 姓氏o 郵件地址o 管理員選中之后, 該用戶將是管理員的身份。o 認證如果你已經配置了LDAP, 那么認證區(qū)域將會出現(xiàn)一個"認證模式"的下拉選擇框。 Redmine 提供了兩種認證機制§ 內部認證將用戶的密碼經過加密后存入數(shù)據庫中。§ 外部認證(如LDAP)

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

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

10、#160;用戶組管理用戶組列表截圖從Redmine-0.9 開始, 管理員可以定義用戶組。用戶組可以像添加常規(guī)用戶一樣添加到項目中去。當把用戶添加到一個已存在的用戶組里, 該用戶將擁有該組的一切權限。5   LDAP 認證在1.0以前，新建LDAP需要一系列繁雜的操作：管理 -> 配置 -> 認證 -> LDAP認證（右下角處）。為了方便用戶操作，固將LDAP操作置于管理員界面右邊欄。6   角色和權限角色決定用戶在項目中擁有的權限。 每個項目成員在項目中可以有一個或者多個角色。 每個用戶在不同的項目中可以有不同的角

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

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

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

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

15、Wiki頁面, 此操作是 不可恢復 的, 頁面以及修改歷史將被統(tǒng)統(tǒng)刪除查看Wiki允許用戶查看Wiki頁面導出Wiki頁面允許用戶將Wiki頁面導出為各種格式（pdf,html,.)查看Wiki歷史記錄允許用戶老版本的Wiki頁面, 或者查看不同版本之間的差別編輯Wiki頁面允許用戶編輯沒有保護的Wiki頁面刪除附件允許用戶刪除Wiki頁面的附件保護Wiki頁面允許用戶鎖定/解鎖Wiki頁面, 并具有編輯已鎖定的WIki頁面的權限· 系統(tǒng)角色在Redmine共有2種系統(tǒng)角色, 他們供Redmine內部使用, 因此不能被刪除。o Non member非項目成員角色, 用于定義那些不屬于

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

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

18、以后每當問題的狀態(tài)更新，系統(tǒng)自動根據這里設置的完成度更改完成度字段的值。設置問題狀態(tài)對應的完成度· 工作流工作流使你可以定義不同角色的項目成員對不同類型的問題所能做的問題狀態(tài)變更。定制工作流截圖在工作流設置頁面, 選擇你想要編輯的角色和跟蹤標簽, 點擊"編輯"按鈕, 跳轉到編輯頁面, 此頁面可以編輯該角色對該標簽所能做的變更狀態(tài)。 左側列出了該跟蹤標簽所有的狀態(tài), 你可以在右側選擇針對該狀態(tài)該角色可以變更的狀態(tài)。Note要改變問題的狀態(tài)，用戶需要具有 更新問題 或者 添加說明 的權限。（參見 權限 ）。8   自定義屬性自定義屬性截圖

19、Redmine允許管理員給以下實體添加屬性, 從而給這些實體添加額外的描述信息:· 問題 · 耗時 · 項目 · 版本庫 · 用戶 · 組 · 活動(時間跟蹤) · 問題優(yōu)先級 · 文檔類別 自定義的屬性有以下幾種數(shù)據類型:· 整數(shù)· 字符串單行輸入框· 文本多行輸入文本域· 日期· 布爾值復選框· 列表下拉列表自定義屬性的約束條件:· 最小-最大長度決定自定義屬性的字段長度(0表示沒有限制)。· 正則表達式通過指定的正則表達

20、式, 對自定義屬性的內容進行驗證。· 默認值自定義屬性的默認值· 跟蹤標簽設置該自定義屬性可以在哪些跟蹤標簽中使用· 必填該自定義屬性是否是必填字段· 用于所有項目該自定義屬性是否用于所有項目中· 作為過濾條件該自定義屬性是否作為過濾器的過濾條件· 可用作搜索條件該自定義屬性是否可以用作搜索時的搜索條件9   枚舉值枚舉值截圖Redmine允許管理員對以下實體添加枚舉值, 從而擴充這些實體可選擇的值:· 活動(時間跟蹤) · 問題優(yōu)先級 · 文檔類別 這些枚舉值是跨項目的管理

21、員可以任意地添加/修改/刪除。枚舉值包含的字段:· 名稱· 活動只有活動的枚舉值才能被使用· 默認值如果選中, 那么在使用同類枚舉值時該枚舉值默認被選中同一類枚舉值的默認值只能設置一個10   配置· 一般o 應用程序標題顯示在應用程序頭部的文字o 歡迎文字這些文本將顯示在項目概述頁面o 附件大小限制上傳文件的最大值。 默認為5120KBo 每頁顯示條目個數(shù)的設置這個主要用于分頁顯示, 在這里可以填入你想要每頁顯示的記錄數(shù), 多個值之間用逗號分開。 默認值:25,50,100o 在項目活動中顯示的天數(shù)在這里可以設置每頁顯示多

22、少天之內的活動 默認值:30 表示顯示30天之內的活動o 主機名稱在這里設置Redmine服務的主機名稱和路徑。 Redmine用這個值生成郵件簽名里的URL, 從而收件人通過點擊郵件簽名里的URL訪問系統(tǒng)。o 協(xié)議協(xié)議指郵件通知里生成的鏈接打開方式。 默認值:http郵件里的鏈接是“guessed”，因此不會診斷你使用的是不安全的Http協(xié)議還是安全的https協(xié)議。o 文本格式格式文本用于問題, 新聞, 文檔, Wiki等等的描述字段。默認只有 textile 一種文本過濾器。o 緩存格式化文本(1.0加入的功能)每次向瀏覽器發(fā)送格式化文本（例如：問題描述，wiki頁面.）時都需要將原始的

23、文本轉換成HTML。如果文本過于龐大，那么這個過程將會很慢。該設置允許你開啟緩存格式化文本。緩存的文本存儲方案取決于緩存策略的設置（可以功過config.action_controller.cache_store設置）。默認情況下，緩存策略為 MemoryStore如果你需要開啟緩存，強烈建議你使用另一種緩存策略，像MemCacheStore或者FileStore（在內存有限情況下）。更多關于Rails的緩存策略可參考手冊： /caching_with_rails.html#cache-stores· 壓縮Wiki歷史文檔對Wi

24、ki歷史進行壓縮(減小數(shù)據庫的存儲大小)。 默認值:禁用· RSS Feed內容條數(shù)限制RSS feeds內容條數(shù)的最大值。 默認值:15· 允許直接顯示的最大文本文件限制可直接顯示的文本文件的最大尺寸 默認值:512KB· 查看差別頁面上顯示的最大行數(shù)限制可最多顯示差異行數(shù)的最大值, 多于最大行數(shù)的內容將被Redmine自動截斷 默認值:1500· 顯示o 主題可供選擇的主題樣式Redmine除默認主題外還提供了另外兩個備用主題:§ alternate該主題的最大特點是根據問題的優(yōu)先級在問題列表頁面為問題著色。§ classic該主

25、題追溯到Redmine 0.5.1, 給人一種經典的感覺o 默認語言當應用程序不能識別用戶瀏覽器的語言時, 默認語言將被作為客戶端語言。當發(fā)送郵件時也會根據默認語言作為給用戶發(fā)送郵件的語種。默認值:eno 日歷開始于設置星期的開始日期, 提供的選項有:§ 根據用戶的語言 § 星期一 § 星期天 默認值:根據用戶的語言o 日期格式設置日期顯示格式:§ 根據用戶的語言根據用戶語言定義的格式顯示§ 其他格式默認值:根據用戶的語言o 時間格式設置時間顯示格式:§ 根據用戶的語言 § 其他格式 默認值:根據用戶的語言o 用戶顯示格式設

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

27、活賬號的郵件。§ 自動激活賬號用戶注冊成功后, 直接就能用剛注冊的賬號登錄系統(tǒng)。§ 最短密碼長度設置密碼的最短長度 默認值:4o 忘記密碼如果選中, 在登錄界面上將顯示一個"忘記密碼"的鏈接。 默認值:開啟o 允許使用OpenID登錄和注冊設置是否允許使用OpenID登錄和注冊Note使用該功能需要安裝ruby-openid包, 一條簡單的gem 安裝命令就能搞定(安裝后需要重啟服務生效):gem isntall ruby-openido 啟用REST web service設置是否啟用REST web service在和外部系統(tǒng)集時才需要開啟該選項&#

28、183; 項目o 新建項目默認為公開項目默認情況下, 新建的項目為公開項目你可以在創(chuàng)建項目時不選中該選項, 從而創(chuàng)建非公開項目, 也可以修改已創(chuàng)建的公開項目為非公開項目。o 新建項目默認啟用的模塊設置新建項目默認開啟的模塊o 順序產生項目標識選中之后, Redmine將為你提供連續(xù)的項目標識符。該標識符用于Redmine REST架構的URL標識用o 非管理員用戶新建項目時將被賦予的（在該項目中的）角色該選項用于指定非管理用戶在新建項目中的角色。如果你不指定, 系統(tǒng)自動把該用戶指定為新建項目的 管理員角色 。Note前提是你必須在 權限 設置界面為非管理員用戶賦予創(chuàng)建項目的權限· 問

29、題跟蹤o 允許不同項目之間的問題關聯(lián)如果選中, 那么不同項目之間的問題可以建立關聯(lián)。 默認值:禁用o 在項目頁面上默認顯示子項目的問題如果選中, 在瀏覽父項目的問題列表示, 日歷和甘特圖時子項目的問題也顯示出來。 默認值:開啟· 計算問題完成度設置計算問題完成度的方案:o 使用問題(的完成度)屬性 默認值 ：用戶手動設置完成度 o 使用問題的狀態(tài)：每個問題的狀態(tài)可以被設置一個完成度。該設置會開啟問題狀態(tài)設置頁面的 完成度 和 更新問題的完成度 設置。 · 問題輸出條目的限制設置導出問題條目的最大值(包括CSV和PDF)。 默認值:500· 問題列表中顯示的默認列設

30、置默認情況下, 問題的哪些列被顯示。用戶自定義的屬性只有標記為 用于所有項目 才會在這里列出供選擇· 郵件通知o 郵件發(fā)件人地址設置Redmine發(fā)送郵件的發(fā)件人地址o 使用密件抄送(bcc)密件抄送即郵件頭部隱藏接接收者的地址o 純文本(無HTML)如果選中, 則郵件僅發(fā)送純文本格式, 不發(fā)送HTML格式o 選擇需要發(fā)送郵件通知的動作設置Redmine的哪些活動事件會觸發(fā)郵件通知o 郵件簽名如何配置發(fā)送郵件, 參見 配置郵件發(fā)送· 接收郵件o 在這些行之后截斷郵件這些設置可以刪除接收郵件的簽名部分o 啟用用于接收郵件的服務從 0.8 之后, Redmine支持通過發(fā)送郵件

31、創(chuàng)建問題和評論。想要使用此功能, 你需要開啟接收郵件的API。 默認值:禁用§ API key點擊"生成一個key"鏈接, 系統(tǒng)自動生成一個key, 這是Redmine通過接收郵件創(chuàng)建問題的密鑰。· 如何配置通過接收郵件提交問題, 參見 Redmine 接收郵件配置· 版本庫o 自動獲取程序變更如果選中, 當用戶瀏覽版本庫時應用程序會自動抓取版本庫新的變更 默認值:開啟管理員可以關閉此選項, 通過使用cron在后臺定期執(zhí)行 Repository#fetch_changesets 命令抓取版本庫新的變更。 例如:ruby script/runne

32、r "Repository.fetch_changesets" -e production你也可以通過版本庫的 post-commit 或者 post-receive 鉤子調用這個任務, 從而使每次提交之后, 變更集自動被抓取。o 啟用用于版本庫管理的Web Service該選項只有在你安裝了自動創(chuàng)建SVN版本庫的腳本時開啟。 默認值:禁用o 啟用 SCM設置開啟的SCM類型o 版本庫編碼設置版本庫里文件的編碼方式(多個值之間用逗號分開)。 這些編碼用于將文件的內容和diff轉換成UTF-8, 從而確保瀏覽版本庫時正確顯示。當填寫多個編碼方式時, 第一個編碼是文件使用的編碼

33、o 提交注釋的編碼o 在文件變更記錄頁面上顯示的最大修訂版本數(shù)量 默認值:100o 在提交信息中引用和解決問題當版本庫抓取變更集時, 會掃描提交信息中引用和解決的問題ID。o 在這里管理員可以定義提交注釋中引用和解決問題的關鍵字, 從而通過使用這些關鍵字自動使該次修訂引用或者解決某些問題。 同樣可以設置使用解決問題的關鍵字后問題狀態(tài)的變更,以及完成度的變更 * 默認的關鍵字有:§ 引用: refs, references, IssueID § 解決: fixes, closes § 用于解決問題的關鍵字后問題的變更設置:§ 應用后的狀態(tài) § 完

34、成度 § 示例This commit refs #1, #2 and fixes #3說明:§ 這次代碼提交引用了問題 1,2 同時解決了問題 3 § 每個關鍵字和問題ID之間可以用空格, 逗號或者&分開 11   高級配置11.1   版本庫配置· 常規(guī)信息Redmine一直以來支持不同的版本控制工具集成: Subversion, CVS, Mercurial, Darcs, Git和Bazaar。首先你要在Redmine主機上安裝合適的二進制包, 并確保這些二進制文件在PATH環(huán)境變

35、量中可用:SCM已測試過的版本說明Subversion1.3 & 1.4 & 1.5 & 1.6需要1.3或者更高的版本CVS1.12.12需要1.12,不能同時使用CVSNTMercurial0.9.3 Bazaarl.0.0.candidate.1 & 2.0.4 Darcs1.0.7 Git 比如, 如果你想用Redmine訪問Subverion版本庫, 你必須在Redmine主機上安裝SVN二進制文件。· 給項目添加一個已經存在的版本庫在項目配置選項卡下有 版本庫 子選項庫, 在這里可以為項

36、目添加版本庫。選擇你所使用的版本庫類型, 并輸入版本庫路徑或者URLNote當配置完版本庫第一次訪問時, Redmine將抓取版本庫中已經存在的所有提交信息, 并存入數(shù)據庫。所以如果你的版本庫特別大, 那么該過程將會很長。為了避免這種情況, 你可以將該過程放在后臺執(zhí)行。在配置完版本庫后, 運行下面的命令:$ ruby script/runner "Repository.fetch_changesets" -e production所有的提交將會被存入數(shù)據庫從Redmine0.9之后, 你還可以通過一個鏈接給某一項目或者所有項目執(zhí)行 fetch_changesets: (給所

37、有活動的項目取回變更集) (僅給foo項目取回變更集)· Subversion 版本庫Redmine支持的協(xié)議有(http:,svn:,file:), 只需要輸入版本庫的URL例如:http:/host/path/to/the/repository如果版本庫需要身份認證, 你需要額外輸入用戶名和密碼Note如果你想要用 svn+ssh:/ 訪問版本庫, 你必須把svn+ssh配置為非交互的方式。同時需要設置ssh認證的 public/private 鑰對HintSubversion 基于路徑的授權Redmine對Subversion授權是這樣處理的: 在配置Subversion版本庫

38、時, 除了輸入URL外, 還需填寫一個擁有Subversion讀權限的賬戶信息(如果你的Subversion不允許匿名訪問)。 顯然很多商業(yè)公司的代碼有很高的嚴密性, 大多是不允許匿名訪問的,看來是必填了。 而Redmine對Subversion認證不嚴格也是從這里開始的。 填寫了這個賬戶之后, 不管哪個用戶登錄Redmine瀏覽版本庫, 看到的版本庫信息都是該賬戶應該能看到的, 而不是當前登錄用戶應該看到的。 也就是說, 在這種情況下, 如果你想對代碼瀏覽嚴加控制, 那么就需要創(chuàng)建一個很低權限的Subversion賬號, 用這個賬號作為Redmine訪問Subversion的賬號。 但這樣一

39、來, 那些具有高權限的用戶就不樂意了(他們本來是能看到很多代碼的, 但這樣一來他們的權限無形之中被剝奪了)。為了滿足商業(yè)軟件公司的需求, 群英匯對Redmine關于Subversion授權的部分進行了擴展, 采用Subversion本身的授權模式。 我們添加了解析Subversion授權文件的組件, 可以很好地解析每個用戶的權限, 從而保證Redmine瀏覽權限和Subversion定義的權限一致, 完美解決了Redmine中Subversion授權不嚴格的問題, 實現(xiàn)了Subversion基于路徑的授權。配置步驟, 參見 Subversion基于路徑授權· CVS 版本庫輸入:o

40、版本庫的URL (也可以輸入路徑或者鏈接字符串, 例如 :pserver) o 模組名稱 示例:pserver:login:passwordhost:/path/to/the/repository以下幾種版本庫輸入版本庫的路徑即可· Git 版本庫· Mercurial 版本庫Hint解決了中文版Mercurial版本庫無法使用的問題由于Redmine在匹配Mercurial版本信息時是基于英語匹配的, 所以當我們使用中文Mercurial時, 它會拋出匹配失敗的異常, 造成中文用戶不能使用。· Bazaar 版本庫· Darcs 版本庫11.2

41、0;  發(fā)送郵件配置首先將 config/email.yml.example 重命名為 config/email.yml然后配置發(fā)送郵件需要的參數(shù):production: delivery_method: :smtp smtp_settings: address: mail.foo.bar port: 25 domain: foo.bar # authentication: :login # user_name: xxx # password: xxx注意: 用#注銷掉的那三行信息，是郵件服務器身份驗證信息。但是如果你的用戶已經使用了域驗證，就不需要那三行信息。訪問redm

42、ine，以管理員的身份登錄系統(tǒng)，點擊"管理"->""配置"->"郵件通知"，然后點擊右下角的"發(fā)送測試郵件"，就可以測試你的郵件服務配置是否成功了。Note當delivery_method設置為:smtp時, 它的處理流程是這樣的:在觸發(fā)郵件發(fā)生的事件發(fā)生后, 首先發(fā)送郵件, 直到郵件發(fā)送完畢, 頁面才跳轉。這就是說在發(fā)送郵件的過程中, 頁面一直處于等待狀態(tài)。 那么有沒有一種異步發(fā)送郵件機制呢?在Redmien 0.9 之后, 可通過將delivery_method設置為: async_smt

43、p, 這時發(fā)送郵件和頁面跳轉屬于不同的線程, 當觸發(fā)郵件的事件發(fā)生后, 發(fā)送郵件將會通過消息隊列在后臺執(zhí)行, 而頁面繼續(xù)向下執(zhí)行, 不用等到郵件發(fā)送完畢。11.3   接收郵件從Redmien-0.8.0 開始, 通過配置, 你可以以發(fā)送郵件的方式創(chuàng)建或者評論問題(issue)。11.3.1   方案你可以通過以下幾種方式配置Redmine接收郵件的功能:· 從郵件服務器轉發(fā)郵件 o 優(yōu)點: 與遠程郵件服務器協(xié)作，郵件處理即時，快速(無環(huán)境重載) o 缺點: 需要一些郵件傳輸代理(MTA)的配置(如Postfix，Sendm

44、ail.) · 從IMAP或者POP3服務器讀取郵件 o 優(yōu)點: 易于安裝, 不需要配置郵件傳輸代理(MTA), 與遠程郵件服務器協(xié)作 o 缺點: 郵件處理不即時(需要添加一個定期讀取郵件的 con job) · 從標準輸入讀取郵件 o 優(yōu)點: 用于測試的最佳選項 o 缺點: 慢(每次讀取郵件時都要重新載入環(huán)境), 需要配置郵件傳輸代理(MTA) 11.3.2   各種方案的詳細說明   從郵件服務器轉發(fā)郵件用一個獨立的腳本轉發(fā)郵件服務器發(fā)來的郵件。這個腳本從標準輸入讀取原始郵件并通過HTTP請求轉

45、發(fā)給Redmine。 該腳本在redmine目錄下: extra/mail_handler/rdm-mailhandler.rb· 使用這項功能之前, 你需要開啟接收郵件的API:開啟操作: "管理"->"配置"->"接收郵件", 選中開啟接收郵件服務的復選框,并點擊鏈接"生成一個key",產生一個密鑰。· 復制 rdm-mailhandler.rb 到你的郵件服務器, 確保該腳本有執(zhí)行的權限并配置你的郵件傳輸代理(MTA)。· rdm-mailhandler 用法:

46、83; rdm-mailhandler options -url=<Redmine URL> -key=<API key>· 必須選項:· -u, -url Redmine服務的URL· -k, -key Redmine API key· 常用可選選項:· -h, -help 顯示幫助信息· -v, -verbose 顯示額外的信息· -V, -version 顯示版本信息· 問題屬性可控的選項:· -p, -project=PROJECT 項目的標識符· -t, -tr

47、acker=TRACKER 跟蹤標簽的類型· -category=CATEGORY 問題類別的名稱· -priority=PRIORITY 優(yōu)先級的名稱· -o, -allow-override=ATTRS 允許在郵件里覆蓋先前已指定的屬性，多個屬性之間用逗號分開· 示例:· # 沒有指定項目，那么在郵件內容里必須包含“Project”關鍵字，否則Redmine將不處理該郵件· rdm-mailhandler -url http:/redmine.domain.foo -key secret· # 設置默認的項目和跟蹤標簽類

48、型，同時可以在郵件內容里覆蓋tracker和priority選項· rdm-mailhandler -url https:/domain.foo/redmine -key secret · -project foo · -tracker 錯誤 · -allow-override tracker,priority· 下面是一個Postfix的例子:· foo: "|/path/to/rdm-mailhandler.rb -url http:/redmine.domain -key secret -project foo&quo

49、t;   從IMAP服務器讀取郵件redmine提供了一個rake任務(redmine:email:receive_imap)負責從IMAP服務器讀取郵件。當cron 運行該rake命令時你需要使用選項 -f /path/to/redmine/appdir/Rakefile, 因為不這樣的話會出現(xiàn)找不到rakefile的異常。下面是一個定期每30分鐘讀取一次郵件的cron文件:*/30 * * * * redmineuser rake -f /path/to/redmine/appdir/Rakefile redmine:email:receive

50、_imap RAILS_ENV="production" host=imap.foo.bar username=redminesomenet.foo password=xxx如果你的設置正常工作，但經常收到cron daemon發(fā)送的郵件，你可以在rake命令后添加 -silent選項禁止執(zhí)行命令的輸出信息。下面是禁止每次執(zhí)行cron命令時發(fā)送郵件的示例:*/30 * * * * redmineuser rake -f /path/to/redmine/appdir/Rakefile -silent redmine:email:receive_imap RAILS_ENV=

51、"production" host=imap.foo.bar username=redminesomenet.foo password=xxx說明: 在 cron 文件中,這個命令必須位于一行上如果用Windows作為服務器, pycron可以用于調度讀取郵件的任務。 同時需要你修改防火墻設置, 打開同通過TCP鏈接IMAP的143端口?？捎玫腎MAP選項:host=HOST IMAP服務主機(*默認值: *)port=PORT IMAP服務端口(*默認值: 143*)ssl=SSL 是否使用SSL？(*默認值: false*)username=USERN

52、AME IMAP賬號password=PASSWORD IMAP密碼folder=FOLDER 將要讀取的IMAP文件夾(*默認值: INBOX*)move_on_success=MAILBOX 將已成功讀取的郵件移動到MAILBOX中， 而不是刪除掉move_on_failure=MAILBOX 將Redmine忽略的郵件移動到MAILBOX中問題(issue)屬性可控選項:project=PROJECT 項目標識符tracker=TRACKER 跟蹤標簽類型category=CATEGORY 問題類別名稱priority=PRIORITY 優(yōu)先級名稱allow_override=ATTRS

53、 允許在郵件內容里覆蓋先前已指定的屬性，多個屬性之間用逗號隔開rake命令的一個例子:# 沒有指定項目， 這時郵件內容里必須包含"Project"關鍵字rake redmine:email:receive_imap RAILS_ENV="production" host=imap.foo.bar username=redminesomenet.foo password=xxx# 指定默認的項目和跟蹤標簽類型， 同時允許在郵件里覆蓋tracker和priority屬性的值# both tracker and priority attributes:rake

54、 redmine:email:receive_imap RAILS_ENV="production" host=imap.foo.bar username=redminesomenet.foo password=xxx ssl=1 project=foo tracker=錯誤 allow_override=tracker,priority# 將成功處理的郵件轉移到"read"mailbox中，失敗的則轉移到"failed"mailbox中rake redmine:email:receive_imap RAILS_ENV="p

55、roduction" host=imap.foo.bar username=redminesomenet.foo password=xxx move_on_success=read move_on_failure=failed忽略的郵件（包括未知用戶、未知項目以及來自redmine禁用帳戶的郵件）被標記為'已讀'，而不是從IMAP服務器中刪除。選項 allow_override 不僅僅覆蓋rake的默認值, 而且可以覆蓋郵件里的所有屬性。 例如，你要覆蓋tracker, 你可以添加參數(shù): allow_override=tracker 

56、0; 從POP3服務器讀取郵件僅在trunk和1.0以后的版本可用redmine提供的rake任務(redmine:email:receive_pop3)可以用于從POP3讀取郵件POP3可用的選項: host=HOST POP3服務主機(*默認值: *) port=PORT POP3服務端口(*默認值: 110*) username=USERNAME POP3賬號 password=PASSWORD POP3密碼 apop=1 是否使用APOP認證(_默認值: false_) delete_unprocessed=1 從服務器上刪除不能成功處理的消息(*默認情況是

57、繼續(xù)保存在服務器上*)關于問題屬性的可控選項可以參考上面IMAP章節(jié)   從標準輸入讀取郵件redmine提供的rake任務(redmine:email:receive)用于從標準輸入讀取單個的原始郵件問題屬性可控的選項:project=PROJECT 項目標識符tracker=TRACKER 跟蹤標簽類型category=CATEGORY 問題類別名稱priority=PRIORITY 優(yōu)先級名稱allow_override=ATTRS 允許在郵件內容里覆蓋先前已指定的屬性，多個屬性之間用逗號隔開示例:# 沒有指定項目，這時郵件里必須包含“Pro

58、ject”關鍵rake redmine:email:read RAILS_ENV="production" < raw_email# 指定默認的項目和跟蹤標簽類型，并且允許在郵件里覆蓋tracker和priority選項# both tracker and priority attributes:rake redmine:email:read RAILS_ENV="production" project=foo tracker=錯誤 allow_override=tracker,priority < raw_email選項 allow_ove

59、rride 不僅僅覆蓋rake的默認值, 而且可以覆蓋郵件里的所有屬性。 例如，你要覆蓋tracker, 你可以添加參數(shù): allow_override=tracker。11.3.3   開啟匿名用戶通過郵件提交問題為了開啟該選項，需要添加額外參數(shù):unknown_user=ACTION 當收到未知用戶郵件時，應該采用哪種ACTION。以下是ACTION可用的值：ignore: 郵件將被忽略（默認值）accept: 作為匿名用戶接收create: 自動為該用戶創(chuàng)建一個賬號no_permission_check=1 當收到郵件時禁用權限檢查功能11.3.4   工作原理收到郵件后, Redmine從發(fā)件人地址中查找對應的賬號。 未知用戶和已鎖定的用戶將被忽略。如果郵件主題包含像這樣的內容" Re:xxxxxx #123", 那么該郵件將被作為問題(issue)#123的回復處理。否則將會以郵件主題為問題的標題，新建一個問題(issue)· 目標項目:目標項目可以通過接收郵件里的proje