# Fuel

## Fuel

## What is Fuel?

Fuel 是由 Mirantis 公司开发的一个开源的 OpenStack 部署和管理工具，也是最为流行和易用的 OpenStack 部署管理工具。Mirantis 使用 Fuel 来快速的给客户交付一套生产可用的 OpenStack。Fuel 使用了 Puppet/Cobbler/Mcollective 等开源工具，同时使用 Python/Ruby 开发了部分自有服务，Fuel 的最大特点是它能提供 Web 界面用于安装部署和管理 OpenStack，除此之外它还有如下特点：

* 硬件的自动发现
* 通过 WebUI 对硬件进行配置，如网络配置，磁盘分区配置
* 可以管理多个 OpenStack 集群
* 完善的 HA  架构支持
* 部署前的检查和网络连通性验证
* 部署后的集群健康性检查

### Online demo

如果想快速的体验 Fuel，可以去 [http://demo.fuel-infra.org:8000/](http://demo.fuel-infra.org:8000/) 体验 Fuel 的 demo 版本。

## Fuel 架构

Fuel 的架构包含：

* **Fuel Master Node,** 安装了 Fuel 的服务器，用于完成 Provisioning, Configuration 以及 Fuel Slave 的 PXE booting 等功能。
* **Fuel Slave Node,**&#x46;uel Slave Node 就是用于部署控制，计算，存储服务的服务器。

![](https://2621780720-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LeYyjXKLqsEkcgIGSdJ%2F-LeYynO6GuaTj35NkSgs%2F-LeYywGHaQGC71XJoC84%2Ffuel-arch.png?generation=1557529348275558\&alt=media)

Fuel 内部由众多组件组成，其中一些是 Fuel 自研发的(Nailgun, OSTF, Astute)，一些是第三方的开源组件(Puppet, Cobbler, MCollective)。

* Fuel 的 UI 是一个单页应用（JS）。
* **Nailgun** 是 Fuel 的核心组件，使用 Python 开发，它对外提供 REST API，它的主要功能是管理和保存配置数据，并处理部署的编排逻辑。它通过数据库来保存配置数据，通过 AMQP 来下发指令。
* **Astute** 相当于 Nailgun 的 worker，它接收 Nailgun 下发的指令，并完成对应的工作，它主要的工作主要是与 Cobbler/Puppet 等进行交互，使得这些服务对外提供一个抽象的异步接口。它通过 XML-RPC 来对 Cobller 进行管理和调用，通过 MCollective 来进行在节点上运行 Puppet 或者执行脚本。Astute 与 Nailgun 之间通过 AMQP 来进行数据通信。
* **Cobbler** 提供 provisioning 服务，Fuel 正在测试使用 Ironic 来替换 Cobbler（POC 阶段）
* **Puppet** 提供软件的部署服务。
* **Mcollective Agent** 用于执行脚本，运行 Puppet 等任务。
* **OSTF**(OpenStack Testing Framwork, or Health Check) 是 Fuel 的健康检查组件，它是一个独立的组件，可以脱离 Fuel 单独使用。它的主要作用是 OpenStack 的部署后功能性校验。

Fuel 架构中最核心的部分就是 Fuel Master Node。它包含了所有用于管理其他节点的所有服务，包括安装操作系统，创建 OpenStack 云环境等等。其中 Nailgun 是最重要的服务。它是一个 RESTful 的应用，包含了所有的业务逻辑。用户通过 Fuel Web 接口或者 CLI 接口来与它进行交互。例如创建新的环境，编辑配置，将节点与角色关联，并开始 OpenStack 集群的部署等等。

Nailgun 将所有的配置数据存储在 PostgreSQL 中，其中包含了节点的硬件配置，角色，环境等配置，以及当前的部署状态信息等等。

### 服务器发现 <a href="#fuel-jia-gou-fu-wu-qi-fa-xian" id="fuel-jia-gou-fu-wu-qi-fa-xian"></a>

被管理节点启动时（PXE）会通过 master 节点上的 PXE 服务器提供的一个特殊的 bootstrap 镜像启动。这个镜像会运行一个特殊的脚本，即 Nailgun agent。nailgun-agent.rb 会收集节点的硬件信息并通过 REST API 将这些信息注册到 Nailgun 中，这样就完成了服务器的自动发现，可以在面板中给这些被发现的主机分配角色。

![](https://2621780720-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LeYyjXKLqsEkcgIGSdJ%2F-LeYynO6GuaTj35NkSgs%2F-LeYywGJuz-3h1XigUSa%2Fnailgun.png?generation=1557529348329580\&alt=media)

### 集群部署 <a href="#fuel-jia-gou-ji-qun-bu-shu" id="fuel-jia-gou-ji-qun-bu-shu"></a>

当用户配置了一个新环境后，部署过程就开始了。Nailgun 服务会创建一个带有环境配置信息的 JSON 文件，并将这个文件发送到 RabbitMQ 上。这个信息应该由进行部署的进程收到，这个进程叫做 Astute。

![](https://2621780720-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LeYyjXKLqsEkcgIGSdJ%2F-LeYynO6GuaTj35NkSgs%2F-LeYywGLHWe_2_IgfucM%2Fastute-1.png?generation=1557529348211377\&alt=media)

Astute 工作进程会监听 RabbitMQ 队列。它使用它的 Astute 库来完成所有的部署工作。首先，它会对环境的节点提供 provisioning 服务。Astute 使用 XML-RPC 来在 Cobbler 中设置节点的配置，并通过 MCollective agent 来重启节点来让 Cobbler 安装操作系统。Cobbler 是一个批量部署系统，它通过 DHCP 和 TFTP 服务来提供 PXE 服务。

Astute 把被管理节点需要执行的操作发送到 RabbitMQ 中。MCollective server 会在所有安装完操作系统的节点上启动并监听 MQ 中的消息，当收到消息后，会执行响应的操作并传递接收到的对应参数。MCollective agent 就是一些 Ruby 脚本，这些脚本用于完成相应的操作。

当被管理节点的操作系统安装完成后，Astute 就会开始部署 OpenStack 服务。首先，它使用 **uploadfile agent** 将节点的配置文件分发到每个节点上，文件路径为 **/etc/astute.yaml。**&#x8FD9;个文件包含了用于部署此节点的所有的变量和配置。

接下来，Astute 使用 **puppetsync** agent 来同步所有的 Puppet 模块和 manifest 文件。同步是通过 rsync 连接到 Master 节点的 rsync server 完成的，它会下载最新版本的 Puppet 模块和 manifest 文件。

![](https://2621780720-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LeYyjXKLqsEkcgIGSdJ%2F-LeYynO6GuaTj35NkSgs%2F-LeYywGNHOOFWwv7EV-P%2Fastute-puppet.png?generation=1557529348716110\&alt=media)

当模块同步完成后，Astute 会通过运行 Puppet 的 **site.pp** 来进行部署工作。MCollective agent 通过 **daemonize** 工具来运行 puppet，类似于这种命令：

| `deamonize puppet apply /etc/puppet/manifests/site.pp` |
| ------------------------------------------------------ |

Astute 会周期性的检查 agent 的执行进度，如果部署完成，它会通过 RabbitMQ 将状态报告至 Nailgun。

Puppet 会读取 **astute.yaml** 文件的内容作为 fact 变量，并将其解析到 **$fuel\_settings** 这个变量中。

当 Puppet 运行结束后，Astute 获取 Puppet 运行结果的概要文件，并将结果汇报至 Nailgun。用户可以通过 Fuel Web 或者 CLI 来查看运行的进度和结果。

Fuel 还提供 **puppet-pull** 脚本，开发者可以使用这个脚本来手动从 Master 同步 manifest 并在节点上运行。

Astute 还会完成一些其他的操作，例如：

* 生成和上传 SSH key
* 使用 **net\_verify.py** 来验证网络的连通性
* 部署完成后上传 CirrOS 镜像到 Glance 中
* 当有新的节点加入时，更新所有节点的 **/etc/hosts**
* 当 Ceph 节点部署后更新 RadosGW map

当一个环境被删除时，Astute 通过 Mcollective agent 来删除所有点的的启动删除，并重启节点，这些节点会通过 bootstrap 镜像重新引导，可以用于新环境的部署。
