lagosta

Lagosta

Lagosta é a interface do usuário do Krill.

O projeto usa Vue.js como estrutura Javascript e Element como estrutura de UI.

Requisitos

• Node.js
• fio ou npm

Observe que o fio requer a instalação de uma dependência extra, enquanto o npm está incluído no node.js. OTOH, se você usar npm, certifique-se de enviar package-lock.json para o repositório.

Configuração do projeto

Para obter todas as bibliotecas js necessárias, execute

yarn install

ou

npm install

Executando um servidor de desenvolvimento

Vue usa webpack e webpack-dev-server para executar um servidor de desenvolvimento de compilação automática e recarregável a quente e o Krill não é exceção.

Você pode iniciar o servidor de desenvolvimento emitindo:

npm run serve

A maioria das configurações do servidor de desenvolvimento são especificadas no arquivo /vue.config.js .

Você pode escolher o endereço IP e a porta para executar o servidor de desenvolvimento Krill:

    port: "3003",
    https: true

Você pode usar a configuração proxy para webpkack-dev-server para redirecionar as solicitações HTTP para sua instância local do Krill. Edite o arquivo /vue.config.js especificando a opção proxy .

Isso encaminhará as solicitações desse endpoint específico para sua instância local do Krill. Observe que você terá que redirecionar os endpoints /api , /auth e /stats para o Krill.

Por exemplo:

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

Neste exemplo, uma instância local do Krill está sendo executada em https://localhost:3000 (o padrão na configuração do krill).

Você pode ler mais sobre webpack-dev-server aqui.

Criando uma compilação para implantação

Para compilar e reduzir tudo na pasta /dist , você pode executar:

 yarn run build

ou

 npm run build

Isso irá compilar e reduzir todo JS e CSS. Novamente, como o Vue usa webpack, você pode modificar muitas configurações para o processo de construção.

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

Roteando solicitações de API em produção

Existem duas maneiras de executar o aplicativo em produção:

• Configure seu servidor web para fazer proxy de todas as chamadas de /api , /stats e /auth para o daemon Krill.
• Use o 'server.js' fornecido para criar um servidor HTTP simples que faça proxy das chamadas de API (NÃO RECOMENDADO).

Para usar este último, primeiro crie um arquivo .env com os parâmetros adequados ao seu ambiente

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

e então corra

 node server.js

Construindo em um contêiner Docker

Apenas uma vez, crie a imagem Docker localmente:

 docker build -t lagosta-builder .

Depois de fazer isso, você pode fazer:

 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

Agora que sua imagem Docker e o diretório local de construção do Lagosta estão prontos, no futuro você pode simplesmente executar yarn build assim:

 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.

A saída estará na pasta ${PWD}/dist no host.