「mvn site-deploy」でサイトをデプロイする方法– WebDAVの例
これは、「mvn site:deploy」を使用して、WebDAVメカニズムを介してgenerated documentation siteをサーバーに自動的にデプロイする方法を示すガイドです。
P.S In this article, we are using Apache server 2.x with WebDAV enabled.
1. WebDAVを有効化
WebDAV access on Apache server 2.xを有効にする方法については、このガイドを参照してください。
2. 展開先の構成
pom.xmlで、「distributionManagement」タグ内のサイトを展開する場所を構成します。
exampleserver dav:http://127.0.0.1/sites/
Note
「dav」プレフィックスはHTTPプロトコルの前に追加されます。これは、WebDAVメカニズムを介してサイトをデプロイすることを意味します。 または、サーバーが「scp」アクセスをサポートしている場合は、「scp」に置き換えることができます。
デプロイに「wagon-webdav-jackrabbit」拡張子を使用するようにMavenに指示します。
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.example.core example-core jar 1 example-core http://maven.apache.org org.apache.maven.wagon wagon-webdav-jackrabbit 1.0-beta-7 exampleserver dav:http://127.0.0.1/sites/
3. WebDAV認証を構成する
通常、WebDAVには認証アクセスが必要です。 したがって、関連する認証の詳細(ユーザー名とパスワード)を%MAVEN_PATH%/conf/settings.xmlに入力する必要があります。
ファイル:settings.xml
exampleserver USERNAME PASSWORD
What is “exampleserver” id ?
Mavenの「settings.xml」ファイルのサーバーIDは、「pom.xml」ファイルのサイトIDによって参照されます。
4. mvn site:deploy
「mvn site:deploy」を発行します:
D:\workspace-new\example-core>mvn site:deploy
[INFO] Scanning for projects...
[INFO] Searching repository for plugin with prefix: 'site'.
[INFO] ------------------------------------------------------------------------
[INFO] Building example-core
[INFO] task-segment: [site:deploy]
[INFO] ------------------------------------------------------------------------
[INFO] [site:deploy {execution: default-cli}]
http://127.0.0.1/sites/ - Session: Opened
//......
#http://127.0.0.1/sites//./css/maven-base.css - Status code: 201
Transfer finished. 4594 bytes copied in 0.044 seconds
18 April 2011 4:23:40 PM org.apache.commons.httpclient.auth.AuthChallengeProcessor
selectAuthScheme
INFO: digest authentication scheme selected
Uploading: ./css/maven-theme.css to http://127.0.0.1/sites/
//......
Transfer finished. 10120 bytes copied in 0.142 seconds
http://127.0.0.1/sites/ - Session: Disconnecting
http://127.0.0.1/sites/ - Session: Disconnected
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 5 seconds
[INFO] Finished at: Mon Apr 18 16:23:43 SGT 2011
[INFO] Final Memory: 9M/16M
[INFO] ------------------------------------------------------------------------
D:\workspace-new\example-core>
プロジェクトフォルダの下にあるすべてのサイトフォルダとファイル–「target/site」はサーバーに自動的に展開されます。
5. 出力
この場合、次のURLを介してデプロイされたサイトにアクセスできます:http://127.0.0.1/sites/、次の図を参照してください:

完了しました。
参考文献
-
http://maven.apache.org/plugins/maven-site-plugin/usage.html
-
http://maven.apache.org/plugins/maven-site-plugin/deploy-mojo.html
-
http://maven.40175.n5.nabble.com/site-deploy-using-DAV-with-digest-auth-td125042.html
-
http://www.sonatype.com/books/maven-book/reference/site-generation-sect-deploy-site.html
-
http://www.example.com/apache/how-to-enable-webdav-in-apache-server-2-2-x-windows/