天天看點

Confluence 6 管理協同編輯

協同編輯能夠讓項目小組中的協同合作達到下一個高度。這個頁面對相關協同編輯中的問題進行了讨論,能夠提供給你所有希望了解的内容。

進入 Collaborative editing 頁面來獲得項目小組是如何進行實時的協同工作的,這些協同工作包括在軟體需求,會議記錄,曆史檢視和任何你任務需要進行協同工作的地方。

關于 Synchrony

協同編輯是通過 Synchrony 進行的,這個能夠實時的同步資料。Synchrony 是一個可執行的程序,這個程序是在 Confluence 之外運作的,但是又是由 Confluence 自動進行管理的。在一般的情況下,這個程序是不需要 Confluence 的管理者進行手動管理的。

希望檢查 Synchrony 是否在運作,進入 

Confluence 6 管理協同編輯

 > 基本配置(General Configuration) > 協同編輯(Collaborative editing)。

這裡,你可以檢查 Synchrony 的運作狀态和目前的配置情況,包括目前的端口,資料庫驅動和 Synchrony  使用的最大的 heap 大小。這些資訊在你對 Synchrony 進行問題排除的時候非常有用。

Synchrony 在預設的情況下是運作在 8091 端口的,在一個内部的 Synchrony  代理意思是你不需要打開其他的端口。

Confluence 6 管理協同編輯

修改編輯模式

編輯模式确定了你站點所有使用者使用協同編輯的體驗,這個是你對協同編輯進行啟用和關閉的地方。

希望修改編輯模式:

  1. 進入 
    Confluence 6 管理協同編輯
  2. 選擇 編輯模式(Change mode)。
  3. 選擇一個模式,然後選擇 修改(Change)。

修改編輯模式其實是不重要的,一些修改可能會導緻你的使用者丢失他們的草稿,是以針對某個模式,你最好需要知道修改将會導緻那些問題。

有下面的模式可用:

啟用(On)

這個模式允許你的小組可用同時進行編輯和分享操作,同時實時的能夠看到其他使用者的修改。

這是推薦的編輯模式。

限制(Limited)

如果你需要對 Synchrony 進行問題排除的話,這個模式将會包含你使用者分享草稿。建議僅僅在當你覺得你的系統在編輯和釋出的時候遇到問題了,選擇這個模式。

你使用者的編輯體驗将會受限:

  • 隻有一個使用者可以編輯一個共享的草稿,而且僅僅隻有這個使用者可以編輯。
  • 你不可以在頁面的曆史中恢複到早期的版本。
  • 你不可以移動頁面。
  • 你不可以在頁面中進行行标注。
當 Synchrony 再次運作後,我們推薦你将協同編輯設定回啟用模式。
關閉(Off)

這個模式意味着你的小組僅僅可以編輯自己的頁面草稿。Confluence 将會嘗試在儲存的時候合并有沖突的編輯。這個模式與 Confluence 5 編輯使用的模式相同。

這個模式在你不能在你的系統中成功運作 Synchrony 的時候有用,或者你決定協同編輯模式并不适用你的環境(例如,你現在正在審計需求,你不希望頁面被編輯,在這個情況下,協同編輯對你并不合适)。

在你将協同編輯模式修改為關閉的時候,你應該確定你的使用者儲存的所有草稿都已經被釋出了。

最大編輯者的限制

我們限制為最多 12 個使用者可以同時對一個頁面進行編輯。這個意味着當一個頁面已經有 12 個使用者正在編輯了,13 個使用者是不能進入編輯界面的,直到 12 個使用者中有一個使用者已經離開了。

系統管理者可以使用 Configuring System Properties 頁面中描述的配置來增加或者減少這個限制。當你覺得在多個使用者進行協同編輯的時候遇到了性能問題,你應該考慮降低允許協同編輯的使用者數量。

審計的考慮

我們知道一些客戶對審計是主要考慮的方面。我們不能保證在協同編輯的時候具有審計,審查功能。所有頁面的修改目前附加到使用者釋出頁面的屬性中而不是使用者的特定修改。

如果這個對你來說是一個問題的話,我們建議你在你的站點中關閉協同編輯。

在未釋出的草稿中沒有版本曆史

我們現在儲存了在系統編輯中的所有時間的編輯,但是我們不會儲存沒有釋出修改的的版本。當你恢複到早期頁面的版本的時候,你僅僅可以恢複到一個已經存在的釋出版本中。當你恢複到前一個版本的時候,所有未釋出的的修改都會丢失。

匿名用修改的内容是否可見

當你為匿名使用者賦予 添加(Add )頁面權限的時候有其他的一些事情你需要注意(和全局權限的 可以使用(Can use))。

當一個為釋出頁面是由匿名使用者建立的時候,關閉一個編輯或者釋出一個頁面的時候你不會收到警告。這個可能會導緻登入的使用者的編輯會被中斷和打擾。

他們自己的修改是可以在頁面中可見,但是通常警告對話框将不會出現,如果是沒有登入使用者做的修改的話。

針對登入的使用者和匿名使用者都有未釋出的修改,這個對話框将會顯示,但是僅僅是登入的使用者才能看到對話框。所有使用者的修改(包括匿名使用者)将會被包括進來,當你從對話框中檢視修改的内容進行檢視的話。

修改你的 Synchrony 配置

你不能通過 Confluence UI 修改 Synchrony 的配置。配置的修改是通過系統屬性進行修改的。在絕大部分情況下,你不需要對預設的配置進行修改。

修改 Synchrony 運作的端口...

在預設情況下 Synchrony 運作在 8091 端口。如果這個端口在你的系統中已經被其他應用占用了,你可使用 ​

​synchrony.port​

​ 系統屬性來将端口修改到其他可用的端口上。

如果你使用的是 Confluence 6.0.3 及其早期的版本,你需要使用 ​

​reza.port​

​ 來替代 ​

​synchrony.port。​

請可參考 Configuring System Properties 頁面中的内容來獲得如何進行修改的幫助。

針對 Confluence 資料庫中,運作 Synchrony 的方式有些不同。請參考 Configuring Synchrony for Data Center 頁面中的内容來獲得更多資訊。

修改 Synchrony 的最大 heap 值

在預設情況下 Synchrony 的最大 heap 大小被設定為 1 GB。

如果你遇到了與 Synchrony 有關的記憶體溢出的錯誤,你可以通過修改 ​

​synchrony.memory.max​

​ 屬性來确定 Synchrony 使用的記憶體大小。

​reza.memory.max​

​synchrony.memory.max。​

請參考 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 上下文路徑, )。如果你的 Confluence 沒有使用上下文,那麼這個概念和配置也是一樣的  。

下面的配置隻是特定于 Confluence 伺服器,如果你使用的是資料中心,請參考 Configuring Synchrony for Data Center 頁面中的内容來獲得更多資訊。

沒有反向代理

如果你沒有在 Confluence 中使用反向代理,那麼你的會通過 Confluence 的内部 Synchrony 代理連接配接到 Synchrony。如果使用了 SSL 的話,那麼這個是通過 Tomcat 決定的。這個是預設的配置,針對這個情況你在啟用協同編輯的時候不需要進行任何進一步的修改。

Confluence 6 管理協同編輯

使用一個反向代理

如果你的 Confluence 是運作在一個反向代理後面的話,你需要通過 Confluence 内部 Synchrony 代理來連接配接 Synchrony 。這個是反向代理的預設設定,如果你不希望開發 8091 端口的話,這個也是一個很好的選擇。SSL 應該通過你的額反向代理伺服器來配置和确定。

針對 Synchrony 配置你不需要做任何進一步的反向代理配置,但是在最好的情況下,你的反向代理應該支援 WebSocket 連接配接(你需要在你的代理中手動啟動這個)。

為了告訴 Confluence 你希望使用内部代理,設定 ​

​synchrony.proxy.enabled​

​ system property 中的配置設定為 ​

​true​

​。(這個是可選的,但是這個可以避免 Confluence 在通過内部代理之前來通過 /synchrony 來找到 synchrony)。

Confluence 6 管理協同編輯

如果 Synchrony 不能訪通過 /synchrony-proxy 進行通路,我們将會自動的嘗試  /confluence/synchrony-proxy (/confluence 是你 Confluence 的上下文)。

Synchrony  使用一個反向代理目錄

如果你的 Confluence  是運作在一個反向代理的後面,但是你在通過 Confluence 的内部 Synchrony 代理進行連接配接的時候遇到了問題或者無法連接配接的情況,你可以選擇連接配接目錄到 Synchrony。這個是最佳的設定,但是不需要你環境做一些改變。你需要打開 8091 端口,同時添加 /synchrony  到你的反向代理配置中。SSL 還是通過你反向代理伺服器決定和定義的,Synchrony 還不能接受 HTTPS 的連接配接。

Confluence 6 管理協同編輯

如果 Synchrony 不能訪通過 /synchrony-proxy 進行通路,我們将會自動的長沙  /confluence/synchrony-proxy (/confluence 是你 Confluence 的上下文)。

XHR fallback

當一個通過通過 WebSocket 連接配接到 Confluence 的時候,我們将會傳回一個 XML HTTP Request (XHR),這個能夠允許使用者成功的對頁面進行編輯。為了讓使用者獲得最佳的編輯體驗,我們強烈建議你在你的環境中配置允許 WebSocket 連接配接。

XHR fallback 在預設的情況下是啟用的,但是必要的話,可以通過 system property 進行禁用。你應該不需要對這些進行修改。