使用「mvn site-deploy」部署站點(WebDAV例子)

這裏有一個指南,向您展示如何使用「mvn site:deploy」來自動部署生成的文檔站點到服務器,這裏通過WebDAV機制說明。

P.S 在這篇文章中,我們使用的是Apache服務器2.x的WebDAV功能。

1. 啓用 WebDAV

請參見本指南,瞭解 如何啓用WebDAV訪問Apache 2.x服務器。

2. 配置在何處部署

在 pom.xml 中,配置在 「distributionManagement」 標籤部署你的網站。

yiibaiserver dav:http://127.0.0.1/sites/


「dav」前綴是HTTP協議之前添加的,這意味着通過WebDAV機制部署您的網站。或者,可以用「scp」取代它,如果您的服務器支持「scp」訪問。

告訴Maven來使用「wagon-webdav-jackrabbit」擴展部署。

org.apache.maven.wagon wagon-webdav-jackrabbit 1.0-beta-7

wagon-webdav
一些人說可以使用「wagon-webdav」,但這不是我試了不能正常工作,所以這裏用「wagon-webdav-jackrabbit」代替。

org.apache.maven.wagon wagon-webdav 1.0-beta-2

pom.xml 整個文件內容:


4.0.0
com.yiibai.core
yiibai-core
jar
1
yiibai-core
http://maven.apache.org



org.apache.maven.wagon
wagon-webdav-jackrabbit
1.0-beta-7





yiibaiserver
dav:http://127.0.0.1/sites/


3. 配置WebDAV身份驗證

通常情況下,WebDAV是需要認證的訪問。所以需要把相關的認證細節(用戶名和密碼)%MAVEN_PATH%/conf/settings.xml.

File : settings.xml

yiibaiserver admin 123456

「yiibaiserver」 是什麼 ?
在Maven的「的settings.xml」文件服務器ID將在「的pom.xml」文件被網站引用。

4. mvn site:deploy

「mvn site:deploy」 命令執行:

C:\worksp\yiibai-core>mvn site:deploy
... ...
Transfer finished. 11622 bytes copied in 0.021 seconds
十一月 03, 2015 9:00:07 下午 org.apache.commons.httpclient.auth.AuthChallengePro
cessor selectAuthScheme
信息: digest authentication scheme selected
Uploading: .//project-info.html to http://127.0.0.1/sites/

##十一月 03, 2015 9:00:07 下午 org.apache.commons.httpclient.auth.AuthChallengeP
rocessor selectAuthScheme
信息: digest authentication scheme selected
##http://127.0.0.1/sites//./project-info.html - Status code: 201

Transfer finished. 11170 bytes copied in 0.035 seconds
十一月 03, 2015 9:00:07 下午 org.apache.commons.httpclient.auth.AuthChallengePro
cessor selectAuthScheme
信息: digest authentication scheme selected
Uploading: .//project-summary.html to http://127.0.0.1/sites/

##十一月 03, 2015 9:00:07 下午 org.apache.commons.httpclient.auth.AuthChallengeP
rocessor selectAuthScheme
信息: digest authentication scheme selected
##http://127.0.0.1/sites//./project-summary.html - Status code: 201

Transfer finished. 10190 bytes copied in 0.021 seconds
http://127.0.0.1/sites/ - Session: Disconnecting
http://127.0.0.1/sites/ - Session: Disconnected
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 28.737 s
[INFO] Finished at: 2015-11-03T21:00:07+08:00
[INFO] Final Memory: 14M/156M
[INFO] ------------------------------------------------------------------------

所有站點文件夾和文件,在項目文件夾- 「target/site」會被自動部署到服務器。

5. 輸出

在本例中,可以通過這個網址訪問該部署的站點:http://127.0.0.1/sites/,見下圖:

使用「mvn

完成.

參考

  1. http://maven.apache.org/plugins/maven-site-plugin/usage.html
  2. http://mojo.codehaus.org/wagon-maven-plugin/usage.html
  3. http://maven.apache.org/plugins/maven-site-plugin/deploy-mojo.html
  4. http://maven.40175.n5.nabble.com/site-deploy-using-DAV-with-digest-auth-td125042.html
  5. http://www.sonatype.com/books/maven-book/reference/site-generation-sect-deploy-site.html