nakacli

CLI 客户端 for Nakadi - 用于与 Nakadi 交互的跨平台、无依赖的最小 CLI

安装

macOS

brew install amrhassan/macosapps/nakacli

Ubuntu

snap install --edge nakacli

Arch Linux

yaourt -S nakacli-bin   # Or substitute with your favorite AUR helper

其他平台

nakacli 编译成一个单个的可执行二进制文件，没有额外的运行时依赖，因此请在 发布版 中找到最新的版本，并在您的操作系统上以运行二进制文件的方式运行它。

功能

• 度量查询
• Zign 认证
• 创建事件类型
• 删除事件类型
• 发布事件
• 流式传输特定类型的事件
• 创建订阅
• 订阅事件流监听

使用方法

命令

nakacli event publish[标志] [选项] <事件-类型> <json-body>

发布一个或多个 <event-type> 类型的事件。 <json-body> 可以是一个 JSON 对象的单个事件的完整主体，或者一个包含每个要发布的事件对象的 JSON 数组。

您可以通过传递 @FILEPATH 作为 <json-body> 的值来指定文件路径以从其中读取事件主体。

数据更改事件

要发布数据更改事件，您必须提供以下选项之一：--data-create、--data-update、--data-delete 或 --data-snapshot，否则您的命令将不会被 Nakadi 服务器接受。

业务事件 要发布业务事件，您必须提供 --business 选项，否则您的命令将不会被 Nakadi 服务器接受。

nakacli event stream[标志] [选项] <事件-类型>

开始流式传输发布的事件类型为 <event-type> 的输出到 STDOUT。在用户中断或消耗了由 N 指定的事件数量（N 由 --take=N 选项提供）之前，它将一直阻塞。

nakacli 事件-类型 创建 [标志] [选项] <拥有-应用程序> <名称> <json-模式>

使用给定的参数创建一个事件类型。可选地接受 --partition-strategy=hash 参数，您需要指定一个或多个 --partition-key-field 以指示用于计算分区哈希的字段。创建的事件类型的兼容模式可以通过 --compatibility-mode 选项指定。

您可以通过传递 @FILEPATH 作为 <json-schema> 值来指定一个文件路径以从其中读取 JSON 模式。

nakacli 事件-类型 删除 [标志] [选项] <名称>

删除指定名称的 <name> 的事件类型。

nakacli 事件-类型 列表 [标志] [选项]

列出所有注册的可用的事件类型（可能输出很多，准备好将其管道传输到 less。如果需要阅读，使用 --pretty 标志可能会使其更易于阅读。）

nakacli 指标[标志] [选项]

打印 Nakadi 服务器指标。

全局选项/标志

--bearer-token <TOKEN> 和 --zign

对于任何命令，您都可以通过 --bearer-token <TOKEN> 选项或 BEARER_TOKEN 环境变量来指定 Bearer 令牌。

如果您已设置 Zign，则可以通过简单地传递 --zign 标志来使用它。

--url<NAKADI_URL>

指定 Nakadi 服务器 URL，格式为 scheme://[auth:]hostname:[port]。也可以通过 NAKADI_URL 环境变量设置。

--pretty

使 JSON 输出具有正确缩进，以便更容易阅读。

--network-超时 <网络-超时>

指定非流式操作的网络超时时间（以秒为单位，默认值：1）。

更多

查看 nakacli help 以获取所有支持的命令的完整列表，以及 nakacli COMMAND --help 以获取其选项、标志和参数。