NiFi Registry入门

Apache NiFi Registry 入门

本指南适用于谁？

本指南是为具有 NiFi 基本经验但对 NiFi Registry 不太熟悉的用户编写的。本指南并非详尽的说明手册或参考指南。该NiFi注册用户指南和NiFi用户指南提供有关使用注册表，并与NiFi它集成了大量的信息。相比之下，本指南旨在为用户提供所需的信息，以了解如何配置 NiFi Registry、连接 NiFi 并开始使用版本化的 NiFi 数据流。

本指南中使用的术语

为了谈论 NiFi Registry，有几个关键术语读者应该熟悉：

Flow : 一个进程组级别的 NiFi 数据流，已置于版本控制之下并保存到注册表中。

Bucket：存储和组织流的容器。

下载并安装 NiFi 注册表

NiFi 注册表可以从NiFi 注册表页面下载。有两种可用的打包选项：tarball 和 zip 文件。支持的操作系统包括 Linux、Unix 和 Mac OS X。

对于未运行 OS X 的用户，下载 NiFi Registry 后，只需将存档解压缩到您希望从中运行应用程序的位置即可。默认情况下，注册表是不安全的。

有关如何配置 NiFi Registry 实例的信息（例如，实施安全性或更改运行 NiFi Registry 的端口），请参阅系统管理员指南。

启动 NiFi 注册表

如上所述下载并安装 NiFi Registry 后，就可以使用适合您操作系统的机制启动它。

对于 Linux/Unix/Mac OS X 用户

使用终端窗口导航到安装 NiFi Registry 的目录。要在前台运行 NiFi Registry，请运行bin/nifi-registry.sh run. 这将使应用程序一直运行，直到用户按下 Ctrl-C。届时，它将启动应用程序的关闭。

要在后台运行 NiFi Registry，请运行bin/nifi-registry.sh start. 这将启动应用程序以开始运行。要检查状态并查看 NiFi Registry 当前是否正在运行，请执行命令bin/nifi-registry.sh status。NiFi Registry 可以通过执行命令关闭bin/nifi-registry.sh stop。

作为服务安装

要将应用程序安装为服务，请导航到终端窗口中的安装目录并执行命令bin/nifi-registry.sh install以使用默认名称安装服务nifi-registry。要为服务指定自定义名称，请使用可选的第二个参数（即服务名称）执行命令。例如，要将 NiFi Registry 安装为名称为 的服务flow-registry，请使用命令bin/nifi-registry.sh install flow-registry。

安装后，可以使用适当的命令（例如sudo service nifi-registry start和 ）启动和停止服务sudo service nifi-registry stop。此外，还可以通过 来查看运行状态sudo service nifi-registry status。

我启动了 NiFi Registry。怎么办？

现在 NiFi Registry 已经启动，我们可以调出用户界面 (UI)。首先，打开 Web 浏览器并导航到 http://localhost:18080/nifi-registry。可以通过编辑nifi-registry.propertiesNiFi Registry conf目录中的文件来更改端口，但默认端口是18080.

这将打开注册表 UI，此时它是空的，因为尚无可共享的流资源：

创建存储桶

我们的注册表中需要一个存储桶来存储和组织 NiFi 数据流。要创建一个，请选择设置图标屏幕右上角的设置图标 ( )。在“存储桶”窗口中，选择“新建存储桶”按钮。

输入存储桶名称“Test”并选择“Create”按钮。

创建“测试”存储桶：

默认情况下没有配置权限，因此任何人都可以在此实例中查看、创建和修改存储桶。有关保护系统的信息，请参阅系统管理员指南。

将 NiFi 连接到注册表

现在是时候告诉 NiFi 有关本地注册表实例的信息了。

如果一个 NiFi 实例尚未运行，请启动一个 NiFi 实例并调出 UI。从右上角的菜单转到控制器设置：

选择 Registry Clients 选项卡并添加一个新的 Registry Client，为其提供名称和 URL http://localhost:18080：

在进程组上启动版本控制

将 NiFi 连接到 NiFi Registry，可以在进程组级别对数据流进行版本控制。

右键单击进程组并从上下文菜单中选择“版本→启动版本控制”：

默认情况下选择本地注册表实例和“测试”存储桶来存储您的流，因为它们是唯一已连接的注册表和可用存储桶。输入流名称、流描述、注释并选择“保存”：

如最新图标组件左上角的版本状态图标所示，流程组现在在注册表中保存为版本化流。

返回注册表 UI 并返回主页面以查看您刚刚保存的版本化流程（可能需要刷新）：

保存对版本化流程的更改

可以查看、恢复或保存对版本化进​​程组所做的更改。

例如，如果对 ABCD 流程进行了更改，则版本状态将更改为“本地修改”( 本地修改图标)。右键单击菜单现在将显示“提交本地更改”、“显示本地更改”或“还原本地更改”选项：

选择“显示本地更改”以查看所做更改的详细信息：

选择“提交本地更改”，输入注释并选择“保存”以保存更改：

流程的第 2 版已保存：

导入版本化流程

通过注册表中存在的流，我们可以使用它来说明如何导入版本化进程组。

在 NiFi 中，从 Components 工具栏中选择 Process Group 并将其拖到画布上：

不要输入名称，而是单击“导入”链接：

选择要导入的流程版本并选择“导入”：

现在添加了第二个相同的 PG：