chieftan frontend

Jefe de la interfaz

Una aplicación web de Aurelia que consume la API de jefes para la automatización de tareas

Empezando

Para configurar un entorno de desarrollo, necesitará Node.js instalado en su máquina local. Puedes descargarlo desde aquí.

Una vez hecho esto, clone el repositorio de Chieftan y ejecute npm install para instalar las diversas dependencias requeridas por Chieftan.

Desarrollo

El entorno de desarrollo se construye alrededor de Webpack con la recarga del módulo caliente habilitada, lo que permite (cerca) actualizaciones en tiempo real de las hojas de estilo y el código (si aún no se ha ejecutado) sin una recarga de páginas. Puede iniciar el servidor de desarrollo ejecutando npm run server:dev desde la carpeta del proyecto y luego accediendo http://localhost:3002 en su navegador.

Despliegue

La implementación implica construir un paquete de producción de la aplicación y luego colocar el contenido de la carpeta dist en su servidor. Para construir el paquete de producción, simplemente ejecute npm build y espere a que se complete Webpack.

Si desea habilitar el informe de error de Sentry para los errores de frontend, debe establecer la variable de entorno SENTRY_DSN en un DSN Public Sentry. También puede etiquetar la versión de lanzamiento configurando la variable de entorno VERSION .

Ejemplo de construcción de script

SENTRY_DSN= " https://[email protected]/1 " VERSION= " $( git rev-parse HEAD ) " npm run build

Este script de compilación etiquetará la versión utilizando el GIT actual SHA y Configurar informes de error de Sentry.

Bonitas URLS

Vale la pena señalar que, si desea utilizar la API de estado de Push HTML5 para URL agradables, deberá configurar su servidor web para servir el archivo index.html para los 404.

Con Nginx esto se puede lograr fácilmente usando la directiva try_files .

Ejemplo de configuración Nginx

 server {
  listen :80 default;
  hostname chieftan.emss.co.za;

  root /var/www/chieftan/dist;

  # Serve the frontend
  location / {
    try_files $url $url.html index.html;
  }

  # Pass API requests to the application instance (basic)
  location /api {
    proxy_pass http://127.0.0.1:8000;
  }
}

Imágenes de Docker

También puede implementar el frontend de Chieftan usando Docker, para construir la imagen simplemente ejecute npm build && docker build . Para construir una imagen de contenedor con el último paquete de aplicaciones compiladas.

Este contenedor se basa en nginx:alpine , lo que lo hace muy ligero y escuchará en el puerto 3000 de forma predeterminada. Puede seguir las instrucciones en la página de imagen de Nginx Docker para configurarla de manera diferente, o colocarla detrás de un proxy inverso en las implementaciones de producción.