Comment déployer un site avec “mvn site-deploy”

Comment déployer un site avec «mvn site-deploy» - exemple WebDAV

Voici un guide pour vous montrer comment utiliser «mvn site:deploy» pour déployer automatiquement vosgenerated documentation site sur le serveur, via le mécanismeWebDAV.

P.S In this article, we are using Apache server 2.x with WebDAV enabled.

1. WebDAV activé

Consultez ce guide pour savoir comment activerWebDAV access on Apache server 2.x.

2. Configurer où déployer

Danspom.xml, configurez où déployer votre site dans la balise «distributionManagement».


    
      exampleserver
      dav:http://127.0.0.1/sites/

Note
Le préfixe «dav» est ajouté avant le protocole HTTP, cela signifie déployer votre site via le mécanismeWebDAV. Vous pouvez également le remplacer par «scp» si votre serveur est compatible avec l'accès «scp».

Dites à Maven d'utiliser l'extension «wagon-webdav-jackrabbit» pour le déploiement.


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

wagon-webdav
Certains ont prétendu utiliser «wagon-webdav», mais cela ne fonctionne pas pour moi, alors utilisez plutôt «wagon-webdav-jackrabbit».


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

Voir un fichier pom.xml complet.


  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. Configurer l'authentification WebDAV

Normalement,WebDAV est un accès d'authentification requis. Vous devez donc mettre les détails d'authentification associés (nom d'utilisateur et mot de passe) dans%MAVEN_PATH%/conf/settings.xml.

Fichier: settings.xml


    
        exampleserver
        USERNAME
        PASSWORD

What is “exampleserver” id ?
L'identifiant du serveur dans le fichier «settings.xml» de Maven sera référencé par l'ID du site dans le fichier «pom.xml».

4. site mvn: déployer

Problème «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>

Tous les dossiers et fichiers de votre site, sous le dossier du projet - «target/site» seront déployés automatiquement sur le serveur.

5. Sortie

Dans ce cas, vous pouvez accéder au site déployé via cette URL:http://127.0.0.1/sites/, voir la figure suivante:

auto deploy site with Maven

Terminé.

TOC

Comment déployer un site avec “mvn site-deploy” - exemple WebDAV