chieftan frontend

Frontend da Chieftan

Um aplicativo da Web Aurelia que consome a API Chieftan para automação de tarefas

Começando

Para configurar um ambiente de desenvolvimento, você precisará de Node.js instalado em sua máquina local. Você pode baixá -lo aqui.

Uma vez feito, clone o repositório Chieftan e execute npm install para instalar as várias dependências exigidas pelo Chieftan.

Desenvolvimento

O ambiente de desenvolvimento é construído em torno do WebPack com o recarregamento do módulo quente ativado, permitindo (quase) atualizações em tempo real das folhas de estilo e código (se ainda não tiver sido executado) sem recarregar uma página. Você pode iniciar o servidor de desenvolvimento executando npm run server:dev na pasta do projeto e acessando http://localhost:3002 no seu navegador.

Implantação

A implantação envolve a criação de um pacote de produção do aplicativo e, em seguida, a colocação do conteúdo da pasta dist no seu servidor. Para construir o pacote de produção, basta executar npm build e aguarde a conclusão do WebPack.

Se você deseja ativar o relatório de erros de Sentry para erros de front -end, defina a variável de ambiente SENTRY_DSN para um Sentry Public DSN. Você também pode marcar a versão de liberação configurando a variável de ambiente VERSION .

Exemplo de criação de script

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

Este script de compilação marcará a versão usando o Git SHA atual e configurará o relatório de erros de sentinela.

Belos URLs

Vale a pena notar que, se você desejar usar a API do HTML5 Push State para URLs agradáveis, precisará configurar seu servidor da Web para servir o arquivo index.html para todos os 404s.

Com o Nginx, isso pode ser facilmente realizado usando a diretiva try_files .

Exemplo de configuração 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;
  }
}

Imagens do Docker

Você também pode implantar o frontend Chieftan usando o Docker, para criar a imagem, basta executar npm build && docker build . Para criar uma imagem de contêiner com o mais recente pacote de aplicativos compilados.

Este contêiner é baseado no nginx:alpine , tornando -o muito leve e ouvirá na porta 3000 por padrão. Você pode seguir as instruções na página de imagem do Nginx Docker para configurá -la de maneira diferente ou colocá -la atrás de um proxy reverso nas implantações de produção.