Skip to content

Commit 42066cf

Browse files
author
guyplusplus
committed
Many plugin zip creation info after deploying on 7.8.0
1 parent 1b6b65e commit 42066cf

File tree

1 file changed

+14
-10
lines changed

1 file changed

+14
-10
lines changed

README.md

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -137,13 +137,13 @@ I use [Microsoft Code](https://code.visualstudio.com/) to edit code and [Google
137137

138138
## Packaging the plugin as a zip file
139139

140-
Simply add the plugin directory inside a `kibana` folder and zip the file. Filename format carries the Kibana version (i.e. 7.8.0) followed by the plugin version (i.e. 1.0.0). Do not include the `vis_type_custom_form_filter_accounts/target` directory in the zip file.
140+
Few key points to be aware:
141+
* Simply add the plugin directory inside a `kibana` folder and zip the file. Perform this zip operation on Linux ; on Windows it leads to wired error when installing the plugin `"Plugin installation was unsuccessful due to error "EACCES: permission denied, open '/usr/share/kibana/plugins/.plugin.installing/package.json'""`.
142+
* By (my) convension, zip filename format carries the Kibana version (i.e. 7.8.0) followed by the plugin version (i.e. 1.0.0)
143+
* Set the Kibana version and the plugin version by updating the file `kbn_tp_custom_form_filter_accounts/package.json`, respectively the value of the keys `kibana.version` and `version`
144+
* Include the `vis_type_custom_form_filter_accounts/target` directory which comes for the devevelopment environment in the zip file
141145

142-
First setup the Kibana version by updating the files:
143-
* `kbn_tp_custom_form_filter_accounts/package.json`, value `kibana.version`
144-
* `kbn_tp_custom_form_filter_accounts/kibana.json`, value `version`
145-
146-
The zip structure is
146+
The zip structure is:
147147

148148
```
149149
vis_type_custom_form_filter_accounts_7.8.0_1.0.0.zip
@@ -156,21 +156,25 @@ vis_type_custom_form_filter_accounts_7.8.0_1.0.0.zip
156156
...
157157
server/
158158
...
159+
target/
160+
...
159161
```
160162

161163
## Installing the plugin
162164

163-
The plugin can then be installed like this for an apt installed Kibana.
165+
The plugin can then be installed like this for an apt-get installed Kibana.
164166

165167
```shell
166-
$ sudo ./bin/kibana-plugin --allow-root install file:///home/john/downloads/vis_type_custom_form_filter_accounts_7.8.0_1.0.0.zip
167-
$ sudo ./bin/kibana-plugin --allow-root install https://github.com/guyplusplus/Kibana-Plugin-Custom-Form-Filter-Visualization/releases/download/1.0.0/vis_type_custom_form_filter_accounts_7.8.0_1.0.0.zip
168+
$ cd /usr/share/kibana
169+
$ sudo -u kibana ./bin/kibana-plugin install file:///home/john/downloads/vis_type_custom_form_filter_accounts_7.8.0_1.0.0.zip
170+
$ sudo -u kibana ./bin/kibana-plugin install https://github.com/guyplusplus/Kibana-Plugin-Custom-Form-Filter-Visualization/releases/download/1.0.0/vis_type_custom_form_filter_accounts_7.8.0_1.0.0.zip
168171
```
169172

170173
Deleting then installing the plugin often fails for me. I fix it by running this command.
171174

172175
```shell
173-
$ sudo ./bin/kibana-plugin --allow-root remove vis_type_custom_form_filter_accounts
176+
$ cd /usr/share/kibana
177+
$ sudo -u kibana ./bin/kibana-plugin remove vis_type_custom_form_filter_accounts
174178
Removing vis_type_custom_form_filter_accounts...
175179
Plugin removal complete
176180
$ sudo rm -rf /usr/share/kibana/optimize/bundles

0 commit comments

Comments
 (0)