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

• • • • 簡(jiǎn)要說(shuō)明
      • docker部署安裝alfresco6.1
      • • 前提環(huán)境
        • • Java
          • maven
          • docker
        • 從原型生成項(xiàng)目
      • 集成onlyoffice在線(xiàn)文檔編輯插件
      • • 安裝第三方AMP
        • 效果預(yù)覽

簡(jiǎn)要說(shuō)明

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

docker部署安裝alfresco6.1

其實(shí)很簡(jiǎn)單，下面為官方wiki安裝文檔翻譯+補(bǔ)充版

前提環(huán)境

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

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

Java

ACS 6.0是使用Java 8編譯和執(zhí)行的，但強(qiáng)烈建議與使用Java 11的ACS 6.1+一起使用。
1.下載JDK 11，解壓縮并將其配置為默認(rèn)Java安裝。
2. 驗(yàn)證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.確保正確設(shè)置了JAVA_HOME，以便其他工具（例如Maven）將使用正確的版本。

maven

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

$ 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 倉(cāng)庫(kù)），否則有些依賴(lài)包無(wú)法下載：

<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的舊版本，則必須使用 存在一些已知問(wèn)題的Docker Toolbox。
1.下載并安裝Docker。
2.驗(yàn)證Docker的安裝。

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

從原型生成項(xiàng)目

1.成功配置Java和Maven之后，就該生成項(xiàng)目了。

mvn archetype:generate -Dfilter=org.alfresco:

系統(tǒng)將提示您選擇所需的原型。以前可用的原型，alfresco-amp-archetype和share-amp-archetype仍會(huì)顯示為一個(gè)選項(xiàng)，但是這些原型不是Alfresco SDK 4.1的一部分。

注意：如果使用Windows Powershell，則在過(guò)濾器部分周?chē)枰p引號(hào)：mvn archetype：generate“ -Dfilter = org.alfresco：”。

輸出看起來(lái)像這樣：

[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。要了解它們之間的區(qū)別可轉(zhuǎn)到說(shuō)明)

• 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。(我到這步?jīng)]有選擇的，默認(rèn)最新的了)

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.接下來(lái)，將提示您輸入其他值，例如groupId，artifactId和package，如下所示：(這里輸入自己需要的名稱(chēng)就好，或看第5步示例)

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

5.根據(jù)項(xiàng)目指定信息后，將出現(xiàn)最終確認(rèn)。

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

6.按Y，然后按Enter。
如果一切都已正確配置，則應(yīng)該看到類(lèi)似以下內(nèi)容：

[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.您已成功生成第一個(gè)SDK 4.1項(xiàng)目。

項(xiàng)目?jī)?nèi)部，您將找到run.bat和run.sh腳本。這些是便利腳本，可讓您快速編譯/測(cè)試/運(yùn)行項(xiàng)目。
在終端窗口中，使用：

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

第一次執(zhí)行上面命令過(guò)程會(huì)非常久非常久，請(qǐng)一定要耐心等待哈…
等項(xiàng)目跑完就可以訪(fǎng)問(wèn)如下地址：（不修改端口的情況下）
acs：http://localhost:8080/afresco 效果圖：

共享項(xiàng)目：http://localhost:8180/share/
登錄用戶(hù)名/密碼：admin/admin

有關(guān)如何使用項(xiàng)目的更多信息，請(qǐng)?jiān)L問(wèn)使用生成的項(xiàng)目。

集成onlyoffice在線(xiàn)文檔編輯插件

集成onlyoffice說(shuō)難不難，說(shuō)簡(jiǎn)單不簡(jiǎn)單。怎么這么說(shuō)呢？來(lái)，邊走邊說(shuō)，我們開(kāi)始來(lái)集成吧：

從官方文檔可知，我們要擴(kuò)展第三方插件，都是通過(guò)Alfresco模塊軟件包（AMP）這種定制包裝的方式來(lái)安裝的。Ok，onlyoffice-alfresco 這個(gè)插件已經(jīng)有大神寫(xiě)好了，我們來(lái)找到它onlyoffice-alfresco（👈對(duì)，就是它）。

我們點(diǎn)擊進(jìn)去，發(fā)現(xiàn)人家的文檔已經(jīng)很詳細(xì)了，我們直接按照它的文檔一步一步配置就好了，我這里就不重復(fù)寫(xiě)了哈，總結(jié)幾個(gè)要點(diǎn)：

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

安裝第三方AMP

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

這是如何安裝Florian Maul的Javascript控制臺(tái)的示例。

<?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>

好了，示例大家也看了，的確好簡(jiǎn)單呀。
開(kāi)開(kāi)心心的來(lái)到maven中央倉(cāng)庫(kù)搜索了下onlyoffice-alfresco amp包，結(jié)果如下：

一個(gè)一個(gè)點(diǎn)開(kāi)，壓根沒(méi)有我想要的AMP包呀，怎么辦怎么辦（我開(kāi)始慌了🥶）？我靈機(jī)一動(dòng)，咦，剛剛下載到本地有AMP包呀，那是否可以直接把它拖到本地的maven倉(cāng)庫(kù)下引用呀（心中狂喜😬）（其實(shí)，大家如果沒(méi)有想通這點(diǎn)，就一直卡在這兒了，想通就很簡(jiǎn)單啦）。嚇得我趕緊把那兩個(gè)amp包安裝到本地maven倉(cāng)庫(kù)，這是安裝命令：

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"

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

<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>

至此：重新構(gòu)建并啟動(dòng)alfresco登錄后，你會(huì)發(fā)現(xiàn)，世界如此美好😭~！

【廣告】推薦一個(gè)好玩有趣的在線(xiàn)工具網(wǎng)站，喜歡可以收藏一下哦：
在線(xiàn)工具

效果預(yù)覽

點(diǎn)擊Edit in ONLYOFFICE后：

總結(jié)

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

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。