GOLLUM: Serveur PlantUML auto-hébergé

Apache Maven est un outil de gestion et d'automatisation de production des projets logiciels Java en général et Java EE en particulier. Il est utilisé pour automatiser l'intégration continue lors d'un développement de logiciel.

sudo apt-get install maven graphviz openjdk-7-jdk git-core

Configurer un proxy à utiliser pour tout ou partie des requêtes HTTP avec Maven. Le nom d'utilisateur et le mot de passe ne sont requis que si le proxy nécessite une authentification de base (les versions ultérieures peuvent prendre en charge le stockage des mots de passe dans un magasin de clés sécurisé - en attendant, il faut s'aassurer que le fichier settings.xml (généralement ${user.home}/.m2/settings.xml) est sécurisé avec les autorisations appropriées au système d'exploitation).

Le paramètre nonProxyHosts accepte les caractères génériques et chaque hôte à ne pas proxy est séparé par le | . Cela correspond à l'équivalent de configuration JDK.

    <settings>
      <proxies>
       <proxy>
          <id>example-proxy</id>
          <active>true</active>
          <protocol>http</protocol>
          <host>proxy.example.com</host>
          <port>8080</port>
          <username>proxyuser</username>
          <password>somepassword</password>
          <nonProxyHosts>www.google.com|*.example.com</nonProxyHosts>
        </proxy>
      </proxies>
    </settings>

Ces instructions ont été testées sur les distributions Debian Jessie et Ubuntu 14.04 LTS.

git clone https://github.com/plantuml/plantuml-server.git
cd plantuml-server
mvn package

Une fois le package créé, on peut démarrer un serveur local à l’aide du serveur Jetty intégré:

mvn jetty:run

Le serveur sera alors disponible sur http://localhost:8080/plantuml.

Créer un fichier plantuml.war à partir du code source:

sudo apt-get install tomcat7 
git clone https://github.com/plantuml/plantuml-server.git
cd plantuml-server
mvn package

Copier le fichier plantuml.war généré lors de la construction du package (package mvn) dans le dossier des applications Tomcat:

sudo cp plantuml.war /var/lib/tomcat7/webapps/plantuml.war
sudo chown tomcat7:tomcat7 /usr/share/jetty/webapps/plantuml.war
sudo service restart tomcat7

Après avoir redémarré Tomcat, l'application sera exécutée sur le port du serveur 8080. On peut modifier le port et d'autres paramètres dans le fichier /etc/tomcat7/server.xml.

Par défaut, gollum-lib s'attend à ce que le serveur PlantUML soit situé sur http://localhost:8080/plantuml/png. Si le serveur PlantUML se trouve à un autre emplacement, On peut modifier la valeur par défaut en ajoutant l'option de configuration suivante à l'objet wiki_options dans le fichier config.rb pour gollum (utiliser l'option –config lors du démarrage de gollum!):

wiki_options = {
  :plantuml_url  => "http://yourplantumlserver.com/plantuml/png"
}

<l'URL du serveur ne doit pas comporter de barre oblique

On peut utiliser un serveur PlantUML https simplement en définissant config.url dans l'extrait de code ci-dessus sur une URL “https” valide. Cependant, cela peut échouer si gollum ne peut pas vérifier le certificat SSL du serveur PlantUML. Pour contourner ce problème, soit:

• (Recommandé) Définir les fichiers d'autorité de certification que la bibliothèque Net/HTTP de ruby ​​doit utiliser depuis le fichier config.rb.
• Désactiver la vérification du certificat SSL en ajoutant ce qui suit au fichier config.rb:

Gollum::Filter::PlantUML.configure do |config|
    config.url = "http://my-own-plantuml.com:8080/plantuml/png"
    config.verify_ssl = false
end