On this page
community.grafana.grafana_plugin – Manage Grafana plugins via grafana-cli
Note
This plugin is part of the community.grafana collection (version 1.1.0).
To install it use: ansible-galaxy collection install community.grafana
.
To use it in a playbook, specify: community.grafana.grafana_plugin
.
Synopsis
- Install and remove Grafana plugins.
- See https://grafana.com/docs/plugins/installation/ for upstream documentation.
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
grafana_plugin_url
string
|
Full URL to the plugin zip file instead of downloading the file from https://grafana.com/api/plugins.
Requires grafana 4.6.x or later.
|
|
grafana_plugins_dir
string
|
Directory where the Grafana plugin will be installed.
If omitted, defaults to /var/lib/grafana/plugins .
|
|
grafana_repo
string
|
URL to the Grafana plugin repository.
If omitted, grafana-cli will use the default value: https://grafana.com/api/plugins.
|
|
name
string / required
|
Name of the plugin.
|
|
state
string
|
|
Whether the plugin should be installed.
|
version
string
|
Version of the plugin to install.
Defaults to latest .
|
Examples
---
- name: Install/update Grafana piechart panel plugin
community.grafana.grafana_plugin:
name: grafana-piechart-panel
version: latest
state: present
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
version
string
|
always |
version of the installed/removed/updated plugin.
|
Authors
- Thierry Sallé (@seuf)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/grafana/grafana_plugin_module.html