alfresco6.1（源碼版） + onlyoffice安裝部署

• • • • 簡要說明
      • docker部署安裝alfresco6.1
      • • 前提環境
        • • Java
          • maven
          • docker
        • 從原型生成項目
      • 集成onlyoffice在線文檔編輯插件
      • • 安裝第三方AMP
        • 效果預覽

簡要說明

本次使用alfresco sdk4.1 + docker 部署安裝alfresco6.1，并完美集成onlyoffice在線文檔編輯插件。

docker部署安裝alfresco6.1

其實很簡單，下面為官方wiki安裝文檔翻譯+補充版

前提環境

使用Alfresco SDK 4.1有許多軟件要求。

• Java開發工具包（JDK）-版本11
• Maven3.3 +
• Docker-最新的穩定版本
• JRebel（可選），用于熱重新加載Web資源，配置和類
• HotSwap代理（可選），用于熱重新加載Web資源，配置和類

Java

ACS 6.0是使用Java 8編譯和執行的，但強烈建議與使用Java 11的ACS 6.1+一起使用。
1.下載JDK 11，解壓縮并將其配置為默認Java安裝。
2. 驗證JDK和JRE的安裝。

$ javac -version javac 11.0.1$ java -version openjdk version "11.0.1" 2018-10-16 OpenJDK Runtime Environment 18.9 (build 11.0.1+13) OpenJDK 64-Bit Server VM 18.9 (build 11.0.1+13, mixed mode)

3.確保正確設置了JAVA_HOME，以便其他工具（例如Maven）將使用正確的版本。

maven

Alfresco建議您更新所有Maven版本。Linux發行版和軟件包管理器傾向于捆綁較舊的發行版，這是最常見的陷阱。
1.Alfresco SDK 4.1需要Maven 3.3.0+，但是建議您下載最新版本。
2.下載并安裝Apache Maven，并確保在您的路徑上正確配置了它。
3.驗證安裝。

$ mvn -v Apache Maven 3.3.9 (bb52d8502b132ec0a5a3f4c09453c07478323dc5; 2015-11-10T17:41:47+01:00) Maven home: /usr/local/Cellar/maven/3.3.9/libexec Java version: 11.0.1, vendor: Oracle Corporation Java home: /Library/Java/JavaVirtualMachines/jdk-11.0.1.jdk/Contents/Home Default locale: en_ES, platform encoding: UTF-8 OS name: "mac os x", version: "10.13.4", arch: "x86_64", family: "mac"

特別注意：
maven還需要修改path/apache-maven-3.6.3/conf/setttings.xml配置文件（添加alfresco 倉庫），否則有些依賴包無法下載：

<mirrors><mirror><id>alfresco-public</id><mirrorOf>central</mirrorOf><name>Alfresco public</name><url>https://artifacts.alfresco.com/nexus/content/groups/public</url></mirror></mirrors>

docker

Alfresco建議您更新所有Docker版本。如果您使用的是Windows或Mac的舊版本，則必須使用 存在一些已知問題的Docker Toolbox。
1.下載并安裝Docker。
2.驗證Docker的安裝。

$ docker -v Docker version 18.06.1-ce, build e68fc7a

從原型生成項目

1.成功配置Java和Maven之后，就該生成項目了。

mvn archetype:generate -Dfilter=org.alfresco:

系統將提示您選擇所需的原型。以前可用的原型，alfresco-amp-archetype和share-amp-archetype仍會顯示為一個選項，但是這些原型不是Alfresco SDK 4.1的一部分。

注意：如果使用Windows Powershell，則在過濾器部分周圍需要雙引號：mvn archetype：generate“ -Dfilter = org.alfresco：”。

輸出看起來像這樣：

[INFO] Generating project in Interactive mode [INFO] No archetype defined. Using maven-archetype-quickstart (org.apache.maven.archetypes:maven-archetype-quickstart:1.0) Choose archetype: 1: remote -> org.alfresco.maven.archetype:alfresco-platform-jar-archetype (Sample project with full support for lifecycle and rapid development of Platform/Repository JARs and AMPs (Alfresco Module Packages)) 2: remote -> org.alfresco.maven.archetype:alfresco-share-jar-archetype (Share project with full support for lifecycle and rapid development of JARs and AMPs (Alfresco ModulePackages)) 3: remote -> org.alfresco.maven.archetype:alfresco-allinone-archetype (Sample multi-module project for All-in-One development on the Alfresco platform. Includes modules for Platform/Repository JAR and Share JAR) ...

2.選擇以下原型之一：(我這里選擇：alfresco-allinone-archetype。要了解它們之間的區別可轉到說明)

• org.alfresco.maven.archetype:alfresco-allinone-archetype
• org.alfresco.maven.archetype:alfresco-platform-jar-archetype
• org.alfresco.maven.archetype:alfresco-share-jar-archetype

3.選擇最新版本，例如4.1.0。(我到這步沒有選擇的，默認最新的了)

Choose org.alfresco.maven.archetype:alfresco-allinone-archetype version: 1: 2.0.0-beta-1 2: 2.0.0-beta-2 3: 2.0.0-beta-3 4: 2.0.0-beta-4 5: 2.0.0 6: 2.1.0 7: 2.1.1 8: 2.2.0 9: 3.0.0 10: 3.0.1 11: 4.0.0 12: 4.1.0

4.接下來，將提示您輸入其他值，例如groupId，artifactId和package，如下所示：(這里輸入自己需要的名稱就好，或看第5步示例)

Define value for property 'groupId': Define value for property 'artifactId': [INFO] Using property: version = 1.0-SNAPSHOT Define value for property 'package':

5.根據項目指定信息后，將出現最終確認。

Confirm properties configuration: groupId: com.acme artifactId: my-all-in-one version: 1.0-SNAPSHOT package: com.acme Y: :

6.按Y，然后按Enter。
如果一切都已正確配置，則應該看到類似以下內容：

[INFO] ---------------------------------------------------------------------------- [INFO] Using following parameters for creating project from Archetype: alfresco-allinone-archetype:4.1.0-SNAPSHOT [INFO] ---------------------------------------------------------------------------- [INFO] Parameter: groupId, Value: com.acme [INFO] Parameter: artifactId, Value: my-all-in-one [INFO] Parameter: version, Value: 1.0-SNAPSHOT [INFO] Parameter: package, Value: com.acme [INFO] Parameter: packageInPathFormat, Value: com/acme [INFO] Parameter: package, Value: com.acme [INFO] Parameter: groupId, Value: com.acme [INFO] Parameter: artifactId, Value: my-all-in-one [INFO] Parameter: version, Value: 1.0-SNAPSHOT [INFO] Parent element not overwritten in /Users/Alfresco/my-all-in-one/my-all-in-one-platform/pom.xml [INFO] Parent element not overwritten in /Users/Alfresco/my-all-in-one/my-all-in-one-share/pom.xml [INFO] Parent element not overwritten in /Users/Alfresco/my-all-in-one/my-all-in-one-integration-tests/pom.xml [INFO] Parent element not overwritten in /Users/Alfresco/my-all-in-one/my-all-in-one-platform-docker/pom.xml [INFO] Parent element not overwritten in /Users/Alfresco/my-all-in-one/my-all-in-one-share-docker/pom.xml [INFO] Executing META-INF/archetype-post-generate.groovy post-generation script [INFO] Project created from Archetype in dir: /Users/Alfresco/my-all-in-one [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 04:11 min [INFO] Finished at: 2019-01-10T16:21:46+01:00 [INFO] Final Memory: 17M/1024M [INFO] ------------------------------------------------------------------------

7.您已成功生成第一個SDK 4.1項目。

項目內部，您將找到run.bat和run.sh腳本。這些是便利腳本，可讓您快速編譯/測試/運行項目。
在終端窗口中，使用：

• ./run.sh build_start 適用于Mac OS X或Linux。
• run.bat build_start 對于Windows。
  如果這是您第一次這樣做，那么Maven將需要一段時間來下載所有必需的依賴項，而Docker將需要一些時間來下載所有必需的映像。

第一次執行上面命令過程會非常久非常久，請一定要耐心等待哈…
等項目跑完就可以訪問如下地址：（不修改端口的情況下）
acs：http://localhost:8080/afresco 效果圖：

共享項目：http://localhost:8180/share/
登錄用戶名/密碼：admin/admin

有關如何使用項目的更多信息，請訪問使用生成的項目。

集成onlyoffice在線文檔編輯插件

集成onlyoffice說難不難，說簡單不簡單。怎么這么說呢？來，邊走邊說，我們開始來集成吧：

從官方文檔可知，我們要擴展第三方插件，都是通過Alfresco模塊軟件包（AMP）這種定制包裝的方式來安裝的。Ok，onlyoffice-alfresco 這個插件已經有大神寫好了，我們來找到它onlyoffice-alfresco（👈對，就是它）。

我們點擊進去，發現人家的文檔已經很詳細了，我們直接按照它的文檔一步一步配置就好了，我這里就不重復寫了哈，總結幾個要點：

• 安裝onlyoffice服務，推薦使用docker安裝就好啦（官方文檔有），源碼版太麻煩，也沒這個必要
• 獲取onlyoffice-alfresco AMP包有兩種方式：一種是把源碼拉下來編譯生成（麻煩）；另一種就是直接在Releases中下載（方便簡單），如下圖：
  
• 最后重點來了，我們怎么去安裝我們下載下來的AMP插件呢？要說難，就在這兒了。OK，那么問題來了，官方文檔難道沒有講如何安裝AMP包嗎？有，是有的。而且文檔上講，安裝AMP也非常簡單。來我們一起來看看吧👉如何使用AMP或者直接看下面，我把核心部分復制出來了

安裝第三方AMP

以下為官方文檔內容：
在項目中安裝第三方AMP非常簡單。唯一的要求是將依賴項添加到項目中。默認配置將在相應的Docker映像中安裝任何設置為maven依賴項的AMP。重要的是要記住，ACS和Share是分開的容器，因此如果是All-In-One項目，則需要在相應的docker模塊中添加依賴項。

這是如何安裝Florian Maul的Javascript控制臺的示例。

<?xml version="1.0" encoding="UTF-8"?> <project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"><modelVersion>4.0.0</modelVersion><artifactId>sample-module-platform-docker</artifactId><name>Alfresco Platform/Repository Docker Module</name><description>Platform/Repo Docker Module to generate the final Docker image</description><packaging>jar</packaging><parent><groupId>org.alfresco</groupId><artifactId>sample-module</artifactId><version>1.0-SNAPSHOT</version></parent><properties></properties><dependencies><dependency><groupId>org.alfresco</groupId><artifactId>sample-module-platform</artifactId><version>1.0-SNAPSHOT</version></dependency><!-- Javascript Console AMP --><dependency><groupId>de.fmaul</groupId><artifactId>javascript-console-repo</artifactId><version>0.6</version><type>amp</type></dependency></dependencies>... </project>

好了，示例大家也看了，的確好簡單呀。
開開心心的來到maven中央倉庫搜索了下onlyoffice-alfresco amp包，結果如下：

一個一個點開，壓根沒有我想要的AMP包呀，怎么辦怎么辦（我開始慌了🥶）？我靈機一動，咦，剛剛下載到本地有AMP包呀，那是否可以直接把它拖到本地的maven倉庫下引用呀（心中狂喜😬）（其實，大家如果沒有想通這點，就一直卡在這兒了，想通就很簡單啦）。嚇得我趕緊把那兩個amp包安裝到本地maven倉庫，這是安裝命令：

mvn install:install-file "-Dfile=onlyoffice-alfresco-share-1.4.1.amp" "-DgroupId=org.alfresco.onlyoffice" "-DartifactId=alfresco-share" "-Dversion=1.4.1" "-Dpackaging=amp"

都安裝成功會出現success字樣，圖就不截了，下面就差把它們按照官方文檔上的方式配置進去了：(platform和share兩個項目都要相應配置上去哦)

<dependency><groupId>org.alfresco.onlyoffice</groupId><artifactId>alfresco-repo</artifactId><version>1.4.1</version><type>amp</type></dependency><dependency><groupId>org.alfresco.onlyoffice</groupId><artifactId>alfresco-share</artifactId><version>1.4.1</version><type>amp</type></dependency>

至此：重新構建并啟動alfresco登錄后，你會發現，世界如此美好😭~！

【廣告】推薦一個好玩有趣的在線工具網站，喜歡可以收藏一下哦：
在線工具

效果預覽

點擊Edit in ONLYOFFICE后：

總結

以上是生活随笔為你收集整理的alfresco6.1（源码版） + onlyoffice安装部署的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。