Cette page n'est plus actualisée. À partir de BlueMind 4.8, veuillez consulter la nouvelle documentation BlueMind |
VM avec Bluemind en version 3.5 ou supérieure prête à l'utilisation. |
NodeJS installé depuis le site officiel (version 8 ou supérieure). NPM est installé avec NodeJS. Yarn installlé depuis le site officiel (version 1.12 ou supérieure). |
Pour lancer le serveur de développement :
package.json
(normalement il est à la racine du plugin Vue.js)yarn dev
" (ou "npm run dev
" si vous n'êtes pas dans le repo bluemind-all) : un serveur de développement (live-reload enabled) est alors exécuté. Le serveur est lancé sur http://*:9180/Éditeur VSCode (conseillé)
{ "settings": { "prettier.eslintIntegration": true, "editor.tabSize": 4, "eslint.autoFixOnSave": true, "eslint.validate": [ { "autoFix": true, "language": "javascript" }, { "autoFix": true, "language": "vue" } ], }, "extensions": { "recommendations": [ "formulahendry.auto-close-tag", "formulahendry.auto-rename-tag", "msjsdiag.debugger-for-chrome", "dbaeumer.vscode-eslint", "eg2.vscode-npm-script", "christian-kohler.npm-intellisense", "esbenp.prettier-vscode", "dariofuzinato.vue-peek", "octref.vetur", ] }, } |
|
Eclipse Oxygen ou Photon installé. |
Installation :
Pour lancer le serveur de développement :
|
|
Pour lancer le serveur de développement :
plovr.sh
|
Configurer son environnement de développement pour que le bon fichier JS (celui en cours de développement) soit consommé par le webserver du Bluemind installé sur sa VM. |
Avantage : ne nécessite pas de reverse proxy sur la machine de développement.
Paquet bm-plugin-webserver-devfilter installé sur sa VM. Si vous n'avez pas accès au devmode il suffit de compiler le paquet en se rendant dans le dossier "devmode/". |
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é)
IP_DE_VOTRE_HOST_SUR_RESEAU_VM dev.bluemind.test
" dans le /etc/hosts
de votre hostRemarques :
active
' des filtres pour les activer.En cas de problème avec HTTPS / Mixed Content Security :
Deux solutions sont possibles :
security.mixed_content.block_active_content
à falsePar 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 :
add_header Strict-Transport-Security max-age=15768000;
dans la configuration nginx : /etc/nginx/sites-enabled/bm-client-access
nginx -s reload
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 :
Au choix le reverse proxy Nginx ou Apache doit être installé sur sa machine de développement. |
Remarques :
bluemind.host
: URL pour accéder au server BM installé sur sa VMbluemind.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)./etc/hosts
(pour un Linux) :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; } } |
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] |