lagosta

lagosta

Lagosta es la interfaz de usuario de Krill.

El proyecto utiliza Vue.js como marco de Javascript y Element como marco de interfaz de usuario.

Requisitos

• Nodo.js
• hilo o npm

Tenga en cuenta que Yarn requiere la instalación de una dependencia adicional, mientras que npm se incluye con node.js. OTOH, si usa npm, debe asegurarse de enviar package-lock.json al repositorio.

Configuración del proyecto

Para obtener todas las bibliotecas js requeridas, ejecute

yarn install

o

npm install

Ejecutar un servidor de desarrollo

Vue utiliza webpack y webpack-dev-server para ejecutar un servidor de desarrollo autocompilado y recargable en caliente y Krill no es una excepción.

Puede iniciar el servidor de desarrollo emitiendo:

npm run serve

La mayoría de las configuraciones para el servidor de desarrollo se especifican en el archivo /vue.config.js .

Puede elegir la dirección IP y el puerto para ejecutar el servidor de desarrollo de Krill:

    port: "3003",
    https: true

Puede utilizar la configuración proxy para webpkack-dev-server para redirigir las solicitudes HTTP a su instancia local de Krill. Edite el archivo /vue.config.js especificando la opción proxy .

Esto reenviará las solicitudes para ese punto final en particular a su instancia local de Krill. Tenga en cuenta que tendrá que redirigir los puntos finales /api , /auth y /stats a Krill.

Por ejemplo:

...
  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" }
    } ,
...

En este ejemplo, se ejecuta una instancia local de Krill en https://localhost:3000 (el valor predeterminado en la configuración de krill).

Puede leer más sobre webpack-dev-server aquí.

Crear una compilación para la implementación

Para compilar y minimizar todo en la carpeta /dist , puede ejecutar:

 yarn run build

o

 npm run build

Esto compilará y minimizará todos los JS y CSS. Nuevamente, dado que Vue usa webpack, puedes modificar muchas configuraciones para el proceso de compilación.

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

Enrutamiento de solicitudes de API en producción

Hay dos formas de ejecutar la aplicación en producción:

• Configure su servidor web para enviar todas las llamadas a /api , /stats y /auth al demonio Krill.
• Utilice el 'server.js' proporcionado para activar un servidor HTTP simple que represente las llamadas API (NO RECOMENDADO).

Para utilizar este último, primero cree un archivo .env con los parámetros que se adapten a su entorno.

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

y luego correr

 node server.js

Construyendo en un contenedor Docker

Solo una vez, cree la imagen de Docker localmente:

 docker build -t lagosta-builder .

Una vez que tengas eso, puedes hacer:

 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

Ahora que su imagen de Docker y el directorio de compilación local de Lagosta están listos, en el futuro podrá ejecutar yarn build de esta manera:

 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 salida estará en la carpeta ${PWD}/dist en el host.