Environnement Closure

Pour lancer le serveur de développement :

• Dans open/ui exécuter le script plovr.sh
• Sur http://localhost:9810 sont listé les différentes configurations (~applications) gérées par plovr

Configurer le reverse proxy

Via le plugin devmode (méthode conseillée)

Avantage : ne nécessite pas de reverse proxy sur la machine de développement.

Mise en œuvre :

• Un fichier de conf est automatiquement créé (/etc/bm/dev.json) lors de l'installation du paquet (seulement si aucun fichier de conf existant n'est détecté)

• Ajouter "IP_DE_VOTRE_HOST_SUR_RESEAU_VM dev.bluemind.test" dans le /etc/hosts de votre host
• Toujours sur l'host, démarrer le serveur de développement

Remarques :

• Dans le fichier de conf, modifier le champ 'active' des filtres pour les activer.
• À chaque modification du fichier de conf, redémarrer bm-webserver ou ajouter "?reload-devmode" à l'URL (par exemple : /cal/index.html?reload-devmode )
• Deux filtres particuliers qui peuvent être laisser toujours actifs pour développer en Closure : celui pour désactiver les appcache et l'autre sur /input/
• Vous pouvez consulter ou télécharger sur le lien suivant la configuration par défaut du devmode

En cas

de problème avec HTTPS / Mixed Content Security :

Deux solutions sont possibles :

• Lancer le navigateur en "mode unsecure" :
  • Pour Firefox, depuis la page "about:config" passer le paramètre security.mixed_content.block_active_content à false
  • Pour Chrome, à priori, ils ne permettent plus d'autoriser le mixed content (voir https://support.google.com/chrome/thread/25175839?hl=en et https://docs.adobe.com/content/help/en/target/using/experiences/vec/troubleshoot-composer/mixed-content.html)

• Passer en mode full HTTP :

Par défault Bluemind redirige le HTTP vers HTTPS. Il faut donc ajouter la configuration suivante à votre nginx (sur votre VM).

Dans cet exemple, bluemind.virt est l'URL utilisée pour accéder à votre VM et bluemind-dev.virt sera l'URL pour accéder en HTTP

server {
   listen 80;
   server_name bluemind-dev.virt;

  location / {
    proxy_pass https://bluemind.virt;
  }
}

En cas de problème de CSP :

La CSP de Bluemind bloque la requête ?

Il vous suffit de faire un touch /root/dev-no-csp et de redémarrer HPS

Impossible de s'authentifier avec HTTP:// ?

Vider le cache de l'application, en particulier les cookies, créér le fichier /root/dev-unsecure-cookies et redémarrer HPS.

En cas de problème avec HSTS :

• Sur la VM, il faut supprimer la ligne qui ajoute le header add_header Strict-Transport-Security max-age=15768000; dans la configuration nginx : /etc/nginx/sites-enabled/bm-client-access
• Puis redémarrer nginx : nginx -s reload
• Dans google-chrome/chromium, il est nécessaire de vider le cache HSTS (chrome://net-internals / Domain Security Policy / Delete domain security policies)

Debug :

Si le devmode ne fonctionne pas, c'est probablement à cause des 2 problèmes ci-dessus.

Sinon, tentez les étapes suivants pour qualifier votre problème :

• Est-ce que la VM est ok ?
• Serveur de développement bien lancé ?
• Ping l'host depuis la VM ?
• Curl le JS recherché depuis la VM (problème de pare-feu ?)
• règles définies dans /etc/bm/dev.json correctes ?

Via un reverse proxy

Remarques :

• bluemind.host : URL pour accéder au server BM installé sur sa VM
• bluemind.virt : URL utilisée pour avoir le bon JS actif (celui qu'on modifie sur sa machine de dev, compilé et servi en live-reload par webpack-dev-server).
• Exemple de /etc/hosts (pour un Linux) :
  Image Added

Nginx

Remarque : la configuration modifiée est celle du Nginx sur la machine de développement, pas sur la VM.

Exemple :

upstream core2 {
  server bluemind.virt:443;
}

server {  
  	listen 80;
  	server_name bluemind.host;
	
	# SIGNATURE
	location /signature/js/compile/net.bluemind.ui.signature.application.js {    
		proxy_pass http://127.0.0.1:8080/signature/js/compile/net.bluemind.ui.signature.application.js;
	}
}

Apache

RewriteEngine On

# SIGNATURE
RewriteRule "^/signature/js/compile/net.bluemind.ui.signature.application.js$" "http://127.0.0.1:8080/signature/js/compile/net.bluemind.ui.signature.application.js" [R]
 

• in der nginx-Konfiguration hinzufügt: /etc/nginx/sites-enabled/bm-client-access

• Starten Sie dann nginx neu: nginx -s reload

Debuggen:

Wenn der Devmode nicht funktioniert, liegt es wahrscheinlich an den 2 oben genannten Problemen.

Wenn nicht, versuchen Sie die folgenden Schritte, um Ihr Problem zu erkennen:

• Ist die VM in Ordnung?
• Ist der Entwicklungsserver gestartet ?
• Host wird von der VM gepingt?
• Curl für das gesuchte JS ab der VM (Firewall-Problem?) ausführen
• Stimmen die in

• /etc/bm/dev.json

• definierten Regeln?

Über einen Reverse Proxy

Anmerkungen

:

• bluemind.host: URL

• für den Zugriff auf den BM-Server, der auf seiner VM installiert ist
• bluemind.virt:

• Verwendete URL, um das richtige JS aktiv zu haben (dasjenige, das Sie auf Ihrem Dev-Rechner modifizieren, kompilieren und im Live-Reload von webpack-dev-server geliefert wird).

• Beispiel für /etc/hosts (

• Linux):
  Image Modified

Nginx

Hinweis: Die geänderte Konfiguration ist die Nginx-Konfiguration auf dem Entwicklungsrechner, nicht auf der VM.

Beispiel:

upstream core2 {
  server bluemind.virt:443;
}

server {  
  	listen 80;
  	server_name bluemind.host;
	
	# SIGNATURE
	location /signature/js/compile/net.bluemind.ui.signature.application.js {    
		proxy_pass http://127.0.0.1:8080/signature/js/compile/net.bluemind.ui.signature.application.js;
	}
}

Apache

RewriteEngine On

# SIGNATURE
RewriteRule "^/signature/js/compile/net.bluemind.ui.signature.application.js$" "http://127.0.0.1:8080/signature/js/compile/net.bluemind.ui.signature.application.js" [R]