前提

通常情况下，您可以通过 本地源码启动手册 来打包工程。如果您需要在本地独立启动或打包前端服务，请参考以下手册。

在进行以下的步骤之前，首先确保您已经安装了 node。如已安装，可以通过在终端执行 node -v 来获取到 node 版本，项目推荐使用 node v12 版本运行（例如 node v12.22.12）。

另外，windows 用户请在 git bash 下运行下面的命令。

一、进入 km-console 目录

在终端执行以下步骤时，需要先进入 KnowStreaming/km-console 目录。

二、安装项目依赖（必须）

1. 安装 lerna（可选，安装后可以直接通过 lerna 的全局指令管理项目，如果不了解 lerna 可以不安装）

npm install -g lerna

2. 安装项目依赖

npm run i

我们默认保留了 package-lock.json 文件，以防止可能的依赖包自动升级导致的问题。依赖默认会通过 taobao 镜像 https://registry.npmmirror.com/ 服务下载（如需修改下载源，请见当前目录下 package.json 文件）。

三、启动项目（可选，打包构建请直接看步骤三）

npm run start

该指令会启动 packages 目录下的所有应用，如果需要单独启动应用，其查看下方 QA。

多集群管理应用会启动在 http://localhost:8000，系统管理应用会占用 http://localhost:8001。 请确认 8000 和 8001 端口没有被其他应用占用。

后端本地服务启动在 http://localhost:8080，请求通过 webpack dev server 代理访问 8080 端口，需要启动后端服务后才能正常请求接口。

如果启动失败，可以参见另外一种本地启动方式 本地源码启动手册

四、构建项目

npm run build

项目构建成功后，会存放到 km-rest/src/main/resources/tamplates 目录下。

目录结构

• packages
  • layout-clusters-fe: 基座应用 & 多集群管理（其余应用启动需要首先启动该应用）
  • config-manager-fe: 子应用 - 系统管理
• ...

QA

Q: 在 km-console 目录下执行 npm run start 时看不到应用构建和热加载过程？如何启动单个应用？

A: 需要到具体的应用中执行 npm run start，例如 cd packages/layout-clusters-fe 后，执行 npm run start。

如遇到其它问题，请见 faq。