如何配置grafana开发环境

前言

grafana是一款功能强大的数据可视化软件，支持多种数据源。本文将介绍如何配置grafana开发环境，可对其进行汉化等处理。

如果不二次开发，可参照文档直接安装已编译的版本：

https://grafana.com/grafana/download

下文介绍的配置方法可用于修改grafana源码

安装前的准备

本文环境：ubuntu

1、安装go，并配置GOPATH环境变量：

sudo apt-get install golang

vi ~/.profile

最后面增加一行：export GOPATH='/root/go'

使配置生效：source ~/.profile

2、node安装和版本升级：

ubuntu参考：

https://segmentfault.com/a/1190000008653668

centos参考：

https://segmentfault.com/a/1190000015430583

由于默认的node版本低，此处需要升级为大于8，本文档中使用的是11.14.0

3、安装yarn：

https://yarnpkg.com/lang/en/docs/install/#debian-stable

4、下载项目代码

git项目地址：

https://github.com/grafana/grafana

本文中没有直接使用go get github.com/grafana/grafana

而是先将代码clone下来，然后必须将代码放到：$GOPATH/src/github.com/grafana/grafana

编译和运行

1、前端环境

npm install -g node-gyp

进入文件夹：$GOPATH/src/github.com/grafana/grafana

安装依赖：yarn install --pure-lockfile

执行编译：yarn start

编译完成后，在public文件夹会看到多了个build文件夹

2、后端环境

go run build.go setup

go run build.go build

编译完成后，会看到多了个bin文件夹

3、运行

bin/grafana-server start

修改代码

比如修改public/app/core/utils/rangeutil.ts 将display字段翻译为中文

打一个包

go run build.go build package

打包好的deb文件在dist文件夹下

在另外的服务器安装

sudo dpkg -i grafana_xxxx.deb 

安装后的文件位置：

项目文件/usr/share/grafana

配置文件/etc/grafana/grafana.ini

可能遇到的问题

1、yarn install --pure-lockfile特别慢

vi ~/.npmrc

写入以下内容

sass_binary_site =

https://npm.taobao.org/mirrors/node-sass/

phantomjs_cdnurl =

https://npm.taobao.org/mirrors/phantomjs/

registry =

http://registry.npm.taobao.org

2、yarn install --pure-lockfile有报错：

An unexpected error occurred: "https://registry.yarnpkg.com/@types/react/-/react-16.8.8.tgz: getaddrinfo EAI_AGAIN registry.yarnpkg.com:443".

可能是执行这行命令中断过，下次执行就报错了，可以删除yarn.lock文件和node_modules文件夹后重新执行

3、pkg/setting/setting.go:225:35: undefined: http.SameSite

因为go版本过低：

https://community.grafana.com/t/build-from-source-problem/14426

4、请确保代码是在这个路径$GOPATH/src/github.com/grafana/grafana，否则执行go命令容易报错