# ambari-env

**Repository Path**: tt-bigdata/ambari-env

## Basic Information

- **Project Name**: ambari-env
- **Description**: Ambari+Bigtop 一站式编译和部署解决方案
- **Primary Language**: PowerShell
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://doc.janettr.com
- **GVP Project**: No

## Statistics

- **Stars**: 49
- **Forks**: 5
- **Created**: 2024-07-13
- **Last Updated**: 2025-12-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: ambari, Bigtop, Kylin, HDP, Ubuntu

## README

# Ambari+Bigtop 一站式编译和部署解决方案 🚀✨

<p align="center">
  <a href="https://gitee.com/tt-bigdata/ambari-env">
    <img src="https://img.shields.io/badge/dynamic/json?color=red&label=Gitee%20Stars&query=%24.stargazers_count&suffix=%20stars&url=https%3A%2F%2Fgitee.com%2Fapi%2Fv5%2Frepos%2Ftt-bigdata%2Fambari-env" alt="Gitee Stars">
  </a>
  <a href="https://opensource.org/licenses/Apache-2.0">
    <img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="Apache 2.0 License">
  </a>
  <br>
  <img src="https://img.shields.io/badge/Ambari-2.8.0-orange" alt="Ambari 2.8.0">
  <img src="https://img.shields.io/badge/Ambari-3.0.0-yellow" alt="Ambari 3.0.0">
  <img src="https://img.shields.io/badge/Bigtop-3.2.0-green" alt="Bigtop 3.2.0">
</p>


---

## 最新公告

## 🚀 ambari-env 2.2.1 发布｜Kerberos 策略全面优化

大家好，我是 **小饕**，也是 **TTBigdata 团队的创始人**。
今天👉 **`ambari-env 2.2.1` 小版本正式发布**

这次更新主要面向 **需要在 Ambari 环境中启用 Kerberos 的同学**，尤其是从 2.x 升级到 3.x 后遇到各种莫名问题的用户。

## 一、本次更新了啥？

最近有小伙伴反馈，在 **Ambari 2.8.0** 中 Kerberos 可以正常开启，但 **升级到 Ambari 3.0.0 后却无法启用**。

排查后发现：
由于历史版本迁移中存在疏漏，与 **Kerberos 认证相关的部分逻辑从 2.x 向 3.x 的迁移并未完整适配**，
导致 **2.2.0 及之前的 ambari-env 版本中** 存在以下影响：

* 开启 Kerberos 时失败
* 不同组件的 kinit 无法兑换凭证
* 组件 Start/Stop 后拓扑顺序混乱
* 无法正常添加或移除组件
* zkMigration 在 JDK 判定过程中报错

这些问题在生产环境中都非常痛苦，因此我们在 2.2.1 中进行了集中修复。



## 二、本次更新的核心优化内容

### 1. 完整适配 Ranger + Kerberos 的双认证场景

很多集群都要求 Ranger 与 Kerberos 同时启用。
旧版本下两者会互相干扰，2.2.1 已对相关流程进行了修复和补全。

### 2. 修复 Ambari 3.0.0 下多处历史问题

包括但不限于：

* 启用 Kerberos 后组件无法正常 Add/Delete
* 部分组件回滚、启动时拓扑顺序错乱
* 部分服务的 kinit 无法正确兑换凭证
* zkMigration 中 JDK 判断异常导致初始化失败
* 极少数组件因 Kerberos 模板缺失而报错

同时补充了各类 Kerberos 模板、流程中的缺失字段与兼容逻辑。

![image-20251128152823108](https://img.janettr.com/872211a09bfff67d59a782a219e05a4b-6f2ed5.png)

### 3. 更完善的组件级 Kerberos 适配

针对不同组件的 krb5 配置、principal、keytab 使用方式进行校准，
确保在 2.2.1 版本中可以顺利与上游 Ambari 3.x 匹配。

更多变更内容可查看更新页：
👉 [https://doc.janettr.com/update](https://doc.janettr.com/update)

## 三、成功启用 Kerberos 的界面展示

以下是升级到 2.2.1 后成功启用 Kerberos 的示例环境（测试环境组件未全部安装，仅用于展示效果）：

![image-20251128153904571](https://img.janettr.com/d1fc4fa649ba8d327a3878abe3e4e031-6e1394.png)



## 四、配套教程：如何正确开启/关闭 Kerberos？

网上关于 **Ambari 开启 Kerberos 的实战资料很少**，很多同学都是踩坑之后才知道顺序的重要性。

因此我们同步整理了：

* 开启流程（含 UI + 实际流程解读）
* 关闭流程
* 关键参数说明
* 常见错误的排查方式
* 各组件的 Kerberos 适配说明

教程地址如下：
👉 [https://doc.janettr.com/install/kerberos/](https://doc.janettr.com/install/kerberos/)

![image-20251128154054661](https://img.janettr.com/8c415a6709ade9dae61997635b6cacb7-b80de6.png)




------

## 📚 项目简介

> 建议优先访问（更新更快 + 源头首发）  
> 🧭 **[官方文档站](https://doc.janettr.com)**  
> 🚀 [Gitee 镜像站（同步更新）](https://gitee.com/tt-bigdata/ambari-env)

本项目基于以下版本进行魔改与增强，提供一站式编译、部署、管理解决方案：

- **Ambari 2.8.0 & Ambari 3.0.0**
- **Bigtop 3.2.0**

提供 **开箱即用** 的大数据组件部署方案，简化运维，支持多种主流组件，致力于打造稳定、可靠、高效的大数据生态环境。


---

## 🚀 版本说明

|   **版本**   |     **组件名称**     |    **组件版本**    | **env 版本** |             **环境适配**             |
|:----------:|:----------------:|:--------------:|:----------:|:--------------------------------:|
| **v2.2.0** |      Ambari      |     3.0.0      |   2.2.0    | el7 & el8 & ubuntu22 & Kylin V10 |
|            |      下面所有组件      |  1.0.0-1.0.7   |   2.2.0    | el7 & el8 & ubuntu22 & Kylin V10 |
| **v2.1.0** |      Ambari      |     3.0.0      |   2.1.0    |       el7 & el8 & ubuntu22       |
|            |      下面所有组件      |  1.0.0-1.0.7   |   2.1.0    |       el7 & el8 & ubuntu22       |
| **v2.0.0** |      Ambari      |     3.0.0      |   2.0.0    |            el7 & el8             |
|            |      下面所有组件      |  1.0.0-1.0.7   |   2.0.0    |            el7 & el8             |
| **v1.0.7** |     Superset     |     4.1.2      |   1.0.7    |              仅 el7               |
|            |      Atlas       |     2.4.0      |   1.0.7    |              仅 el7               |
|            |      Spark       |  3.5.5（版本升级）   |   1.0.7    |              仅 el7               |
|            |      Flink       |  1.17.2（版本升级）  |   1.0.7    |              仅 el7               |
| **v1.0.6** |      Trino       |      474       |   1.0.6    |              仅 el7               |
|            |       Hudi       |     1.1.0      |   1.0.6    |              仅 el7               |
|            |      Paimon      |     1.0.1      |   1.0.6    |              仅 el7               |
| **v1.0.5** |      Ozone       |     1.4.1      |   1.0.5    |              仅 el7               |
|            |      Impala      |     4.4.1      |   1.0.5    |              仅 el7               |
|            |   Nightingale    |     7.7.2      |   1.0.5    |              仅 el7               |
|            |     Categraf     |     0.4.1      |   1.0.5    |              仅 el7               |
|            | VictoriaMetrics  |    1.109.1     |   1.0.5    |              仅 el7               |
|            |   Cloudbeaver    |     24.3.3     |   1.0.5    |              仅 el7               |
|            |     Celeborn     |     0.5.3      |   1.0.5    |              仅 el7               |
| **v1.0.4** |      Doris       |     2.1.7      |   1.0.4    |              仅 el7               |
| **v1.0.3** |     Phoenix      |     5.1.2      |   1.0.3    |              仅 el7               |
|            | Dolphinscheduler |     3.2.2      |   1.0.3    |              仅 el7               |
| **v1.0.2** |      Redis       |     7.4.0      |   1.0.2    |              仅 el7               |
| **v1.0.1** |      Sqoop       |     1.4.7      |   1.0.1    |              仅 el7               |
|            |      Ranger      |     2.4.0      |   1.0.1    |              仅 el7               |
| **v1.0.0** |    Zookeeper     |     3.5.9      |   1.0.0    |              仅 el7               |
|            |      Hadoop      |     3.3.4      |   1.0.0    |              仅 el7               |
|            |    ~~Flink~~     |   ~~1.15.3~~   |   1.0.0    |              仅 el7               |
|            |      HBase       |     2.4.13     |   1.0.0    |              仅 el7               |
|            |       Hive       |     3.1.3      |   1.0.0    |              仅 el7               |
|            |      Kafka       |     2.8.1      |   1.0.0    |              仅 el7               |
|            |    ~~Spark~~     |   ~~3.2.3~~    |   1.0.0    |              仅 el7               |
|            |       Solr       |     8.11.2     |   1.0.0    |              仅 el7               |
|            |       Tez        |     0.10.1     |   1.0.0    |              仅 el7               |
|            |     Zeppelin     |     0.10.1     |   1.0.0    |              仅 el7               |
|            |       Livy       |     0.7.1      |   1.0.0    |              仅 el7               |
|            |    ~~Ambari~~    | ~~branch-2.8~~ |   1.0.0    |              仅 el7               |
|            |  Ambari Metrics  |   branch-3.0   |   1.0.0    |              仅 el7               |
|            |   Ambari Infra   |     master     |   1.0.0    |              仅 el7               |

---

## 🔧 快速上手

[参考文档](https://doc.janettr.com)

教你如何安装，如何卸载，并提供了一键安装脚本

## 效果图

![img.png](.docs/img_66.png)
![img.png](.docs/img_15.png)

---

## ❤️ 支持本项目

如果你觉得本项目对你有帮助，可以通过以下方式支持：

1. ⭐ **Star** 本项目，帮助它被更多人看到 🚀
2. 📢 **分享** 本项目，帮助更多开发者受益
3. 🍵 **打赏**，请作者喝一杯茶 ☕（见下方二维码）

|                    微信赞赏                    |                          微信号                           |                        QQ 群                        |                
|:------------------------------------------:|:------------------------------------------------------:|:--------------------------------------------------:|
| <img  src='.docs/img_3.png' width="150" /> | <img src='.docs/img_23.png' alt="WeChat QR" width=150> | <img src='.docs/img_24.png' alt="QQ QR" width=150> |

---

## 📜 许可证

本项目采用 [Apache 2.0](LICENSE) 许可证。

---