Confluence 6 管理協同編輯

時間 2019-11-12

原文原文鏈接

協同編輯可以讓項目小組中的協同合做達到下一個高度。這個頁面對相關協同編輯中的問題進行了討論，可以提供給你全部但願瞭解的內容。html

進入 Collaborative editing 頁面來得到項目小組是如何進行實時的協同工做的，這些協同工做包括在軟件需求，會議記錄，歷史查看和任何你任務須要進行協同工做的地方。java

關於 Synchrony

協同編輯是經過 Synchrony 進行的，這個可以實時的同步數據。Synchrony 是一個可執行的進程，這個進程是在 Confluence 以外運行的，可是又是由 Confluence 自動進行管理的。在通常的狀況下，這個進程是不須要 Confluence 的管理員進行手動管理的。web

但願檢查 Synchrony 是否在運行，進入 > 基本配置（General Configuration） > 協同編輯（Collaborative editing）。數據庫

這裏，你能夠檢查 Synchrony 的運行狀態和當前的配置狀況，包括當前的端口，數據庫驅動和 Synchrony 使用的最大的 heap 大小。這些信息在你對 Synchrony 進行問題排除的時候很是有用。apache

Synchrony 在默認的狀況下是運行在 8091 端口的，在一個內部的 Synchrony 代理意思是你不須要打開其餘的端口。api

修改編輯模式

編輯模式肯定了你站點全部用戶使用協同編輯的體驗，這個是你對協同編輯進行啓用和關閉的地方。服務器

但願修改編輯模式：app

進入 > 基本配置（General Configuration） > 協同編輯（Collaborative editing）。
選擇 編輯模式（Change mode）。
選擇一個模式，而後選擇 修改（Change）。

修改編輯模式實際上是不重要的，一些修改可能會致使你的用戶丟失他們的草稿，所以針對某個模式，你最好須要知道修改將會致使那些問題。負載均衡

有下面的模式可用：eclipse

啓用（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 使用的內存大小。

若是你使用的是 Confluence 6.0.3 及其早期的版本，你須要使用 reza.memory.max 來替代 synchrony.memory.max。

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

針對 Confluence 數據庫中，運行 Synchrony 的方式有些不一樣。請參考 Configuring Synchrony for Data Center 頁面中的內容來得到更多信息。

請參考 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 的上下文）。

下面的一些指南是有關反向代理的配置相關的一些文章。目錄的順序是很重要的，請查看咱們的一些示例。