lagosta

拉戈斯塔

Lagosta 是 Krill 的用户界面。

该项目使用 Vue.js 作为 Javascript 框架，使用 Element 作为 UI 框架。

要求

• Node.js
• 纱线或 npm

请注意，yarn 需要安装额外的依赖项，而 npm 包含在 node.js 中。 OTOH 如果您使用 npm，您应该确保将package-lock.json提交到存储库。

项目设置

要获取所有必需的 js 库，请运行

yarn install

或者

npm install

运行开发服务器

Vue 使用 webpack 和 webpack-dev-server 来运行自动编译、可热重载的开发服务器，Krill 也不例外。

您可以通过发出以下命令来启动开发服务器：

npm run serve

开发服务器的大部分设置都在文件/vue.config.js中指定。

您可以选择运行 Krill 开发服务器的 IP 地址和端口：

    port: "3003",
    https: true

您可以使用 webpkack-dev-server 的proxy设置将 HTTP 请求重新路由到本地 Krill 实例。通过指定proxy选项来编辑/vue.config.js文件。

这会将对该特定端点的请求转发到您的本地 Krill 实例。请注意，您将把/api 、 /auth和/stats端点重新路由到 Krill。

例如：

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

在此示例中，本地 Krill 实例在https://localhost:3000 （krill 配置中的默认值）上运行。

您可以在此处阅读有关 webpack-dev-server 的更多信息。

创建用于部署的构建

要编译并缩小/dist文件夹中的所有内容，您可以运行：

 yarn run build

或者

 npm run build

这将编译并缩小所有 JS 和 CSS。同样，由于 Vue 使用 webpack，您可以修改构建过程的许多设置。

请参阅 https://webpack.js.org/concepts/。

在生产环境中路由 API 请求

有两种方法可以在生产中运行应用程序：

• 配置您的网络服务器以将/api 、 /stats和/auth的所有调用代理到 ​​Krill 守护程序。
• 使用提供的“server.js”启动一个简单的 HTTP 服务器来代理 API 调用（不推荐）。

要使用后者，首先使用适合您环境的参数创建一个 .env 文件

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

然后运行

 node server.js

在 Docker 容器中构建

仅一次性在本地构建 Docker 镜像：

 docker build -t lagosta-builder .

一旦你有了，你就可以这样做：

 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

现在您的 Docker 镜像和本地 Lagosta 构建目录已准备就绪，将来您可以像这样运行yarn build ：

 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.

输出将位于主机的${PWD}/dist文件夹中。