lagosta

Lagosta

Lagosta est l'interface utilisateur de Krill.

Le projet utilise Vue.js comme framework Javascript et Element comme framework UI.

Exigences

• Noeud.js
• fil ou npm

Notez que Yarn nécessite l'installation d'une dépendance supplémentaire, alors que npm est inclus avec node.js. OTOH si vous utilisez npm, vous devez vous assurer de valider package-lock.json dans le référentiel.

Configuration du projet

Pour obtenir toutes les bibliothèques js requises, exécutez

yarn install

ou

npm install

Exécuter un serveur de développement

Vue utilise webpack et webpack-dev-server pour exécuter un serveur de développement à compilation automatique et rechargeable à chaud et Krill ne fait pas exception.

Vous pouvez démarrer le serveur de développement en émettant :

npm run serve

La plupart des paramètres du serveur de développement sont spécifiés dans le fichier /vue.config.js .

Vous pouvez choisir l'adresse IP et le port sur lesquels exécuter le serveur de développement Krill :

    port: "3003",
    https: true

Vous pouvez utiliser le paramètre proxy pour webpkack-dev-server pour rediriger les requêtes HTTP vers votre instance Krill locale. Modifiez le fichier /vue.config.js en spécifiant l'option proxy .

Cela transmettra les demandes pour ce point de terminaison particulier à votre instance Krill locale. Notez que vous devrez rediriger les points de terminaison /api , /auth et /stats vers Krill.

Par exemple:

...
  devServer : {
    // Krill proxy instance (for API calls).
    // see: https://webpack.js.org/configuration/dev-server/#devserverproxy
    proxy : {
      "/api" : { target : "https://localhost:3000" } ,
      "/auth" : { target : "https://localhost:3000" } ,
      "/stats" : { target : "https://localhost:3000" }
    } ,
...

Dans cet exemple, une instance locale de Krill s'exécute sur https://localhost:3000 (valeur par défaut dans la configuration de krill).

Vous pouvez en savoir plus sur webpack-dev-server ici.

Création d'une build pour le déploiement

Pour que tout soit compilé et minifié dans le dossier /dist , vous pouvez exécuter :

 yarn run build

ou

 npm run build

Cela compilera et réduira tous les JS et CSS. Encore une fois, puisque Vue utilise Webpack, vous pouvez modifier de nombreux paramètres pour le processus de construction.

Voir https://webpack.js.org/concepts/.

Routage des requêtes API en production

Il existe deux manières d'exécuter l'application en production :

• Configurez votre serveur Web pour qu'il envoie par proxy tous les appels pour /api , /stats et /auth au démon Krill.
• Utilisez le "server.js" fourni pour lancer un simple serveur HTTP qui proxy les appels d'API (NON RECOMMANDÉ).

Pour utiliser ce dernier, créez d'abord un fichier .env avec les paramètres adaptés à votre environnement

 PROXY_BASE_URL=https://your-host
SERVE_FOLDER=dist

puis cours

 node server.js

Construire dans un conteneur Docker

Une seule fois, créez l'image Docker localement :

 docker build -t lagosta-builder .

Une fois que vous avez cela, vous pouvez alors faire :

 docker run -it --rm --name lagosta-builder -v ${PWD}:/tmp/src lagosta-builder /bin/bash
root@06a45bcc9a3e:/tmp/src# yarn install
root@06a45bcc9a3e:/tmp/src# exit

Maintenant que votre image Docker et votre répertoire de build Lagosta local sont prêts, à l'avenir, vous pourrez simplement exécuter yarn build comme ceci :

 docker run -it --rm --name lagosta-builder -v ${PWD}:/tmp/src lagosta-builder /bin/bash
root@06a45bcc9a3e:/tmp/src# yarn build
...
 DONE  Build complete. The dist directory is ready to be deployed.
 INFO  Check out deployment instructions at https://cli.vuejs.org/guide/deployment.html
                                  
Done in 19.66s.

La sortie sera dans le dossier ${PWD}/dist de l'hôte.