Kibana – 创建插件的步骤
首先
由于有许多关于旧版本的混乱信息,我在最初创建插件的模板时遇到了困难,所以我会记录下6.6.2版本的步骤。在后续版本中,这些步骤基本上也可行,截至目前,以下内容是基于在Archlinux上执行的结果。
准备工作
- 可以通过包管理器安装node.js的版本管理工具nvm和n,以及包管理器安装yarn。
准备 Kibana
首先,将Kibana进行复制,并在本地进行克隆。
git clone https://github.com/[YOUR_USERNAME]/kibana.git kibana
cd kibana
请检出标签v6.6.2。
git checkout -b v6.6.2 refs/tags/v6.6.2
使用 nvm 或 n 工具激活 .node-version 中指定的 node.js 版本(如果是 6.6.2,则使用 10.15.2)。
n 10.15.2
# または
nvm use
使用由 Kibana 提供的脚本来安装依赖项(可能需要几分钟时间)(请注意不是使用 yarn init)。
yarn kbn bootstrap
安装和启动Elasticsearch。
从官方网站或GitHub上下载Elasticsearch版本6.6.2的tar.gz文件。
由于Kibana和Elasticsearch对版本的要求比较严格,如果下载的版本有误可能无法正常工作。
将其放置在任意位置,不要解压缩。
例如,与Kibana并列创建一个名为Elasticsearch的文件夹,并将其放置在其中。
这样,目录结构将如下所示。
│
├ kibana
├─ (gitでクローンしてきた中身)
├ elasticsearch
└─ elasticserach-6.6.2.tar.gz
确保Java已经在这里安装。所需的版本在elasticsearch源码的`.ci/java-versions.properties`中写明,版本6.6.2指定了Java8。
然后将当前工作目录(CWD)更改为Kibana,并通过由Kibana提供的脚本启动Elasticsearch。
yarn es archive ../elasticsearch/elasticsearch-6.6.2.tar.gz
试着启动 Kibana,然后确认之前的步骤是否正确。执行以下命令后,Kibana 应该运行在 localhost:5601 上。(启动可能需要几分钟到10分钟不等。如果出现类似 “Server running at http://localhost:5601/***” 的日志,那么很可能启动已经完成。)
yarn start
使用kibana-plugin-generator创建插件的脚手架
请关闭一次 Kibana 和 Elasticsearch 实例。
使用 Kibana 提供的脚本,并将 Kibana 设置为当前工作目录,可以生成 Kibana 插件的模板。
请在 my_plugin 中填入您的插件名称。
node scripts/generate_plugin my_plugin
被问到很多问题,但重要的是针对的版本,需要指定的是 6.6.2 而不是规定的 6.6。
其他则取决于所需功能。
在上述操作中,将在与 Kibana 并行的目录下的 “kibana-extra” 目录中生成一个名为 “my_plugin” 的插件。此时的目录结构如下所示。
│
├ elasticsearch
├ kibana
├ kibana-extra
└─ my_plugin
只需按照类似于准备 Kibana 的步骤,安装插件的依赖并尝试启动即可。
插件的启动
将 my_plugin 设为当前工作目录,并使用以下命令安装 dependencies。
yarn kbn bootstrap
在另一个终端上,也可以通过我的插件来完成,但我会将kibana设置为当前工作目录并启动elasticsearch。
yarn es archive ../elasticsearch/elasticsearch-6.6.2.tar.gz
最后,将 my_plugin 设为当前工作目录,并启动 kibana。请在 CWD 中而非 kibana 中执行以下命令。
yarn start
稍等大约10分钟左右,然后查看localhost:5601,在侧边栏应该会出现我的应用程序。
总结
辛苦了。
如果有什么错误或疑问,请告诉我 (_ _)。