協同編輯能夠讓項目小組中的協同合作達到下一個高度。這個頁面對相關協同編輯中的問題進行了討論,能夠提供給你所有希望了解的內容。
進入 Collaborative editing 頁面來獲得項目小組是如何進行實時的協同工作的,這些協同工作包括在軟件需求,會議記錄,歷史查看和任何你任務需要進行協同工作的地方。
關於 Synchrony
協同編輯是通過 Synchrony 進行的,這個能夠實時的同步數據。Synchrony 是一個可執行的進程,這個進程是在 Confluence 之外運行的,但是又是由 Confluence 自動進行管理的。在一般的情況下,這個進程是不需要 Confluence 的管理員進行手動管理的。
希望檢查 Synchrony 是否在運行,進入
這里,你可以檢查 Synchrony 的運行狀態和當前的配置情況,包括當前的端口,數據庫驅動和 Synchrony 使用的最大的 heap 大小。這些信息在你對 Synchrony 進行問題排除的時候非常有用。
Synchrony 在默認的情況下是運行在 8091 端口的,在一個內部的 Synchrony 代理意思是你不需要打開其他的端口。
修改編輯模式
編輯模式確定了你站點所有用戶使用協同編輯的體驗,這個是你對協同編輯進行啟用和關閉的地方。
希望修改編輯模式:
- 進入
- 選擇 編輯模式(Change mode)。
- 選擇一個模式,然后選擇 修改(Change)。
修改編輯模式其實是不重要的,一些修改可能會導致你的用戶丟失他們的草稿,因此針對某個模式,你最好需要知道修改將會導致那些問題。
有下面的模式可用:
啟用(On) | 這個模式允許你的小組可用同時進行編輯和分享操作,同時實時的能夠看到其他用戶的修改。 這是推薦的編輯模式。 |
限制(Limited) | 如果你需要對 Synchrony 進行問題排除的話,這個模式將會包含你用戶分享草稿。建議僅僅在當你覺得你的系統在編輯和發布的時候遇到問題了,選擇這個模式。 你用戶的編輯體驗將會受限:
當 Synchrony 再次運行后,我們推薦你將協同編輯設置回啟用模式。 |
關閉(Off) | 這個模式意味着你的小組僅僅可以編輯自己的頁面草稿。Confluence 將會嘗試在保存的時候合並有沖突的編輯。這個模式與 Confluence 5 編輯使用的模式相同。 這個模式在你不能在你的系統中成功運行 Synchrony 的時候有用,或者你決定協同編輯模式並不適用你的環境(例如,你現在正在審計需求,你不希望頁面被編輯,在這個情況下,協同編輯對你並不合適)。 在你將協同編輯模式修改為關閉的時候,你應該確保你的用戶保存的所有草稿都已經被發布了。 |
最大編輯者的限制
我們限制為最多 12 個用戶可以同時對一個頁面進行編輯。這個意味着當一個頁面已經有 12 個用戶正在編輯了,13 個用戶是不能進入編輯界面的,直到 12 個用戶中有一個用戶已經離開了。
系統管理員可以使用 Configuring System Properties 頁面中描述的配置來增加或者減少這個限制。當你覺得在多個用戶進行協同編輯的時候遇到了性能問題,你應該考慮降低允許協同編輯的用戶數量。
審計的考慮
我們知道一些客戶對審計是主要考慮的方面。我們不能保證在協同編輯的時候具有審計,審查功能。所有頁面的修改當前附加到用戶發布頁面的屬性中而不是用戶的特定修改。
如果這個對你來說是一個問題的話,我們建議你在你的站點中關閉協同編輯。
在未發布的草稿中沒有版本歷史
我們現在保存了在系統編輯中的所有時間的編輯,但是我們不會保存沒有發布修改的的版本。當你恢復到早期頁面的版本的時候,你僅僅可以恢復到一個已經存在的發布版本中。當你恢復到前一個版本的時候,所有未發布的的修改都會丟失。
匿名用修改的內容是否可見
當你為匿名用戶賦予 添加(Add )頁面權限的時候有其他的一些事情你需要注意(和全局權限的 可以使用(Can use))。
當一個為發布頁面是由匿名用戶創建的時候,關閉一個編輯或者發布一個頁面的時候你不會收到警告。這個可能會導致登錄的用戶的編輯會被中斷和打擾。
他們自己的修改是可以在頁面中可見,但是通常警告對話框將不會出現,如果是沒有登錄用戶做的修改的話。
針對登錄的用戶和匿名用戶都有未發布的修改,這個對話框將會顯示,但是僅僅是登錄的用戶才能看到對話框。所有用戶的修改(包括匿名用戶)將會被包括進來,當你從對話框中查看修改的內容進行查看的話。
修改你的 Synchrony 配置
你不能通過 Confluence UI 修改 Synchrony 的配置。配置的修改是通過系統屬性進行修改的。在絕大部分情況下,你不需要對默認的配置進行修改。
請參考 Recognized System Properties 頁面中的內容來獲得所有有關 Synchrony 的系統屬性。
如果你需要針對 Synchrony 虛擬機傳遞其他的參數,創建一個名為 synchrony-args.properties
的屬性文件。這個文件位於 Confluence 的 home 目錄中,然后在這個文件中輸入你希望傳遞進去的參數,每行一個參數。
property1=value1
property2=value2
|
這個將會添加 -Dproperty1=value1 -Dproperty2=value2
到 Synchrony 命令行中。這個功能只能在 Confluence 6.0.2 及其后續版本中有效。
你不能使用這個方法傳遞在系統數據中已經有的值,例如端口, Xmx 或 Xss 等。請參考 Configuring System Properties 頁面中的內容來獲得所有的屬性列表。
代理和 SSL 的考慮
對於你如何連接 Synchrony 是與你的環境有關的。我們知道絕大部分的 Confluence 站點是運行在反向代理后面的,同時還使用了 SSL。這里是幫助你在你環境中識別正確的配置的一些信息和一些針對你環境需要做的一些協同合作方面的修改。
SSL
Synchrony 運行在一個獨立的 JVM,這個並不需要支持直接的 HTTPS 連接。如果你沒有使用反向代理,SSL 應該在 Tomcat 中定義,如果你使用了方向代理或者負載均衡。那么 SSL 應該在你的反向代理和負載均衡中進行配置和定義。
Proxies
在下面的圖表中,我們使用 Confluence 運行的環境下通常的代理和反向代理配置,同時 Confluence 也運行在 /confluence 上下文路徑,(例如, www.mysite.com/confluence)。如果你的 Confluence 沒有使用上下文,那么這個概念和配置也是一樣的(例如,www.myconfluence.com)。
下面的配置只是特定於 Confluence 服務器,如果你使用的是數據中心,請參考 Configuring Synchrony for Data Center 頁面中的內容來獲得更多信息。
沒有反向代理
如果你沒有在 Confluence 中使用反向代理,那么你的會通過 Confluence 的內部 Synchrony 代理連接到 Synchrony。如果使用了 SSL 的話,那么這個是通過 Tomcat 決定的。這個是默認的配置,針對這個情況你在啟用協同編輯的時候不需要進行任何進一步的修改。
使用一個反向代理
如果你的 Confluence 是運行在一個反向代理后面的話,你需要通過 Confluence 內部 Synchrony 代理來連接 Synchrony 。這個是反向代理的默認設置,如果你不希望開發 8091 端口的話,這個也是一個很好的選擇。SSL 應該通過你的額反向代理服務器來配置和確定。
針對 Synchrony 配置你不需要做任何進一步的反向代理配置,但是在最好的情況下,你的反向代理應該支持 WebSocket 連接(你需要在你的代理中手動啟動這個)。
為了告訴 Confluence 你希望使用內部代理,設置 synchrony.proxy.enabled
system property 中的配置設置為 true
。(這個是可選的,但是這個可以避免 Confluence 在通過內部代理之前來通過 /synchrony 來找到 synchrony)。
如果 Synchrony 不能訪通過 /synchrony-proxy 進行訪問,我們將會自動的嘗試 /confluence/synchrony-proxy (/confluence 是你 Confluence 的上下文)。
Synchrony 使用一個反向代理目錄
如果你的 Confluence 是運行在一個反向代理的后面,但是你在通過 Confluence 的內部 Synchrony 代理進行連接的時候遇到了問題或者無法連接的情況,你可以選擇連接目錄到 Synchrony。這個是最佳的設置,但是不需要你環境做一些改變。你需要打開 8091 端口,同時添加 /synchrony 到你的反向代理配置中。SSL 還是通過你反向代理服務器決定和定義的,Synchrony 還不能接受 HTTPS 的連接。
如果 Synchrony 不能訪通過 /synchrony-proxy 進行訪問,我們將會自動的長沙 /confluence/synchrony-proxy (/confluence 是你 Confluence 的上下文)。
下面的一些指南是有關反向代理的配置相關的一些文章。目錄的順序是很重要的,請查看我們的一些示例。
-
- Using Apache with mod_proxy
- Running Confluence behind NGINX with SSL
- Proxying Atlassian server applications with Apache HTTP Server (mod_proxy_http)
- Proxying Atlassian server applications with Microsoft Internet Information Services (IIS)
- How to configure Amazon Web Service Elastic Load Balancer with Confluence 6.0
XHR fallback
當一個通過通過 WebSocket 連接到 Confluence 的時候,我們將會返回一個 XML HTTP Request (XHR),這個能夠允許用戶成功的對頁面進行編輯。為了讓用戶獲得最佳的編輯體驗,我們強烈建議你在你的環境中配置允許 WebSocket 連接。
XHR fallback 在默認的情況下是啟用的,但是必要的話,可以通過 system property 進行禁用。你應該不需要對這些進行修改。
https://www.cwiki.us/display/CONF6ZH/Administering+Collaborative+Editing