一、开发环境与工具说明
本文以 Ambari 3.0.0 为目标版本，介绍 Ambari-Web 的本地启动流程。
1、IDE 与开发方式选择
这里使用 WebStorm 作为 Ambari-Web 二次开发的主要 IDE，原因如下：
- 对 Node / Yarn / NVM 支持完善
- 对前端项目运行配置友好
- 日志、断点、控制台集成度高
说明
Ambari-Web 本质是一个 Ember.js 前端工程，与 ambari-server 后端解耦，
本地启动不依赖 Java、Maven 或 Ambari Server。
二、获取 Ambari-Web 源码
1、源码仓库说明
Ambari 官方仓库地址：
https://github.com/apache/ambari
本文不再赘述 Git Clone 的基础操作。
2、选择 3.0.0 Release 版本
优先选择 Release 包，而非 master 分支：
https://github.com/apache/ambari/releases/tag/release-3.0.0
三、打开 Ambari-Web 子工程
1、目录选择原则
下载并解压完成后，不要直接打开 Ambari 根目录。
在 WebStorm 中，只需要选择：
ambari/ambari-web
原因说明
Ambari 根目录同时包含：ambari-server（Java）ambari-agent（Python）ambari-web（前端）
前端二开只需要 ambari-web，避免 IDE 索引大量无关内容。
四、Node 与 Yarn 环境准备
1、Node 版本选择
这里使用 nvm 管理 Node 版本。
nvm install 18
nvm use 18
注意
Ambari-Web 对 Node 版本较敏感，Node 20+ 在部分依赖场景下会触发构建异常，
建议直接使用 Node 18 LTS。
2、启用 corepack 与 Yarn
corepack enable
npm install -g yarn
3、配置国内镜像（强烈建议）
yarn config registry https://registry.npmmirror.com
npm config registry https://registry.npmmirror.com
