https://github.com/CleverCloud/grafana-example

Run Grafana on Clever Cloud
https://github.com/CleverCloud/grafana-example

clevercloud-example grafana

Last synced: about 2 months ago
JSON representation

Run Grafana on Clever Cloud

• Host: GitHub
• URL: https://github.com/CleverCloud/grafana-example
• Owner: CleverCloud
• Created: 2018-11-29T09:23:59.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2022-05-19T08:55:53.000Z (over 2 years ago)
• Last Synced: 2024-08-04T17:08:53.104Z (5 months ago)
• Topics: clevercloud-example, grafana
• Language: Shell
• Homepage:
• Size: 11.7 KB
• Stars: 2
• Watchers: 9
• Forks: 17
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-clever-cloud - Grafana

README

        
# How to set up Grafana on Clever Cloud

1. Fork this repository.

2. Create a [Node.js application](https://www.clever-cloud.com/doc/getting-started/by-language/node/#create-an-application-on-clever-cloud). It will download and run Grafana using the root `package.json` file. The install script `build.sh` will download grafana and its plugins and the start one `run.sh` will start the grafana-server binary.

3. In your application environment variables add ```GF_SERVER_HTTP_PORT=8080```.

4. Add ```GRAFANA_VERSION``` and ```GRAFANA_SHA_256``` environment variables. You can find these values on the [Grafana download page](https://grafana.com/grafana/download).

5. Check Node.js version used in `package.json`, for instance Grafana 7.5.5 expects Node.js 14 (see Grafana's [package.json](https://github.com/grafana/grafana/blob/v7.5.5/package.json#L317)).

6. To install custom Grafana plugin, you can set them directly in `GRAFANA_PLUGINS` environnement variable split by a `,`, for example with the value: `plugin,other_one:0.0.2,https://github.com/ovh/ovh-warp10-datasource.git`. It will install the latest version of `plugin`, the version `0.0.2` of `second_one` using the grafana-cli commands. And for the `ovh-warp10-datasource` plugin, `git clone` is used instead, as it's done for any plugin starting by `http`.

7. Add `GF_PLUGIN_DIR` environnement variable with `./data/plugins` to use local cloned plugins.

8. You can now build and start the Clever Cloud application, be aware however that if you restart it your data will not be persisted (see next section to learn how to persist data).

9. To configure Grafana through environment variables please check [grafana configuration page](https://grafana.com/docs/grafana/latest/administration/configuration/).

# Persisting Data on a database

For this example we will use mysql however the procedure shouldn't be too different with any other type of database as PostgreSQL.

1. Create your database add-on on Clever Cloud and link it to the application, you can check our [documentation](https://www.clever-cloud.com/doc/getting-started/quickstart/#create-your-first-add-on).

2. In your application environment variables you should now see the information you need to connect to your database.

3. Link your add-on to your Grafana application. To do this you need to create a few environment variables (replace what's in '<>' with the actual value):

    - ```GF_DATABASE_NAME=```

    - ```GF_DATABASE_HOST=```

    - ```GF_DATABASE_PASSWORD=```

    - ```GF_DATABASE_URL=```

    - ```GF_DATABASE_USER=```

    - ```GF_DATABASE_TYPE=mysql```