grafana 8.x 源代码运行（window）

我就是我 2023-10-02 12:45 49阅读 0赞

#### 文章目录 ####

*   *   *   *  一、环境：
             *  二、安装环境
             *   *  1、mingw 安装
                 *  2、gcc 和 g++ 区别
                 *  3、添加 go 模块代理
                 *  4、环境变量
             *  三、编译后端
             *  四、启动前端
             *  五、启动后端
             *   *  1、解决办法
                 *  2、修改默认端口号
             *  六、说明
             *  七、前端解决方案
             *  八、后端解决方案

grafana 参考开发文档 [https://github.com/grafana/grafana/blob/v8.1.5/contribute/developer-guide.md][https_github.com_grafana_grafana_blob_v8.1.5_contribute_developer-guide.md]，建议选择对应版本的对应开发文档，不同版本可能有变化

文章写的比较简单，都启动成功才记录的，所以少了很多截图，如果有其他错误可以去 grafana 的问题中查找，一般都能找到 [https://github.com/grafana/grafana/issues][https_github.com_grafana_grafana_issues]

##### 一、环境： #####

node：16.4.0  
go：1.71  
mingw：9.0  
grafana：8.0.0 或 grafana：8.1.5（这两个版本按如下步骤成功，grafana：8.2.0失败后面有说明）  
window 10

版本说明

*  go 语言版本需要查看你下载的 grafana 源代码的 go.mod 版本，高于这个指定版本即可，
 *  mingw 安装 64 位的，不然会报错（当然你也可以使用官网推荐的 `TDM-GCC` [https://jmeubank.github.io/tdm-gcc/][https_jmeubank.github.io_tdm-gcc]）
 *  文中所说的 go 和 golang 是一个东西

##### 二、安装环境 #####

node、go下载安装配置环境变量比较简单就不说了，grafana 源码从 github 直接拉去就行，下面说说 gcc 的安装

###### 1、mingw 安装 ######

grafana 开发文档中讲的是 linux /mac 系统安装比较简单，window 的代替方案为安装适用于 Linux 的 Windows 子系统 (WSL)（开发文档有说明），也可以在 window 上安装 docker 使用Linux容器。

安装 mingw 的目的是安装 c/c++ 编译环境，安装地址 [https://sourceforge.net/projects/mingw-w64/][https_sourceforge.net_projects_mingw-w64]，安装完成配置环境变量，打开 cmd 使用 mingw-get install g++ 安装 c/c++ 编译环境（该安装教程自行网上搜索，安装比较慢，WiFi容易失败，或者使用下面链接）

由于是外网，下载比较慢，如果你是科网学上那挺快的，或者你可以使用百度网盘提取，其中里面已经包含 gcc ，下载即用，记得添加环境变量，将 bin 目录添加到 path 中，使用 gcc -v 可以查看版本号证明环境正常  
百度网盘链接：[https://pan.baidu.com/s/1vk9eJ-a2Ma3SNMNilHoMvQ][https_pan.baidu.com_s_1vk9eJ-a2Ma3SNMNilHoMvQ] 提取码：8v42

###### 2、gcc 和 g++ 区别 ######

gcc用于编译C程序，而g++ 用于编译C ++程序。 因为，C程序也可以通过g ++编译，因为它是扩展的，或者可以说是C编程语言的高级编译器。

###### 3、添加 go 模块代理 ######

环境变量中添加 GOPROXY=https://goproxy.cn，也可以使用 https://goproxy.io，grafana 服务端是 go 语言开发的，编译构建时 需要下载很多模块，配置代理比较快。

###### 4、环境变量 ######

*  go
    
     *  GOPATH=I:\\goProject 存放 go 安装的相关模块，类似 node 的安装包，Java 的 maven 依赖
     *  GOROOT=H:\\golang 代表 go 的安装目录
     *  GOPROXY=https://goproxy.cn 表示 go 模块安装的代理
     *  path=H:\\golang\\bin 表示 go 的启动命令
 *  mingw
    
     *  path=H:\\MinGW\\mingw64\\bin

##### 三、编译后端 #####

进入源码目录，如：I:\\goProject\\grafana-8.0.0，执行如下命令

go run build.go setup
    go run build.go build

使用 go run build.go setup 命令时可能会遇到以下错误（grafana：8.2.0 报的错误，更换为 grafana：8.0.0 或 grafana：8.1.5 成功），注意在安装时如果打印任何错误退出程序最终可能不能正常运行  
![在这里插入图片描述][d08df2dfe69c47b39b6851c71f494136.png]  
这种是正常结束的  
![在这里插入图片描述][93588a42951548258e355f91690fcd27.png]

##### 四、启动前端 #####

建议 yarn 配置淘宝镜像

# 查看当前镜像
    yarn config get registry
    # 配置淘宝镜像
    yarn config set registry https://registry.npm.taobao.org/

使用如下命令安装依赖启动

# 如果要修改锁定文件，则以错误退出代码中止
    yarn install --immutable
    # 不生成锁文件
    # yarn install --pure-lockfile
    
    yarn start

前端安装依赖使用 yarn install --immutable 访问首页，可能会报错误 html/template: “index” is undefined，不过官网推荐使用该命令。我使用 yarn install --pure-lockfile 启动正常

##### 五、启动后端 #####

注意：  
启动 bin/windows-amd64/grafana-server.exe 时，会爆一个错误  
![在这里插入图片描述][06d2f83983a9448b9b81fa577a702194.png]

###### 1、解决办法 ######

方法一：  
将 bin/windows-amd64 目录下的所有文件复制到 bin 目录下，则启动正常  
方法二：  
启动时指定 homepath 路径 grafana-server.exe -homepath “I:\\goProject\\grafana-8.1.5”  
![在这里插入图片描述][909b1ffaeb6b4c068fca6be8f5f5f0d0.png]

###### 2、修改默认端口号 ######

官方地址 [https://grafana.com/docs/grafana/latest/installation/windows/][https_grafana.com_docs_grafana_latest_installation_windows]

注意：默认的 Grafana 端口是3000. 此端口在 Windows 上可能需要额外的权限。如果它没有出现在默认端口中，您可以尝试更改为其他端口，不要更改 defaults.ini 文件。

修改方法：

*  进入conf目录，复制 sample.ini 到 custom.ini
 *  编辑custom.ini并取消 http\_port 注释（;是 ini 文件中的注释字符）
 *  将其更改为类似8080的端口。

![在这里插入图片描述][8163246e72f447fe91fed12f0ee87acc.png]

##### 六、说明 #####

截至 2021-10-26，我测试了 grafana 8.0.0 和 grafana 8.1.5 版本如上操作正常，当我使用 grafana 8.2.0 时遇到错误  
![在这里插入图片描述][1e7d09ded8f94024a907d86cb4a77de1.png]  
该错误在 grafana 的源码问题中可以找到，但针对 window 暂时没找到好的解决方法[https://github.com/grafana/grafana/issues?q=undefined%3A+server.Initialize][https_github.com_grafana_grafana_issues_q_undefined_3A_server.Initialize]

我最终将降版本使用 8.0.0 和 8.1.5 都可以正常运行，没有出现该错误

##### 七、前端解决方案 #####

假如你只做 grafana 的前端二次开发，觉得后端这些搭建比较麻烦，你只想修改 grafana 的前端代码，可以不构建后端代码，使用如下方法

你可以下载 grafana 的程序安装包（不是源码），在下载一份源码文件，只需要安装上面说的步骤构建前端，然后修改程序安装包的 grafana-8.1.5\\conf\\defaults.ini 文件，修改如下位置，指定前端代码路径，`其实你也可以直接删除程序安装包的 public 目录，将自己的源码 public 复制进去，就可以不修改配置文件`  
![在这里插入图片描述][e990bf3583084c8f961ffe910ed1036d.png]  
最后，你只需要启动源码的前端（使用 yarn start），运行 grafana 服务器（/bin/grafana\_server.exe）,访问 127.0.0.1:3000 即可成功

##### 八、后端解决方案 #####

如果你只做后端的二次开发，只需要将前端 `yarn build` 打包即可，不需要 `yarn start` 启动前端，只需要启动 bin/grafana-server.exe 即可，启动时会去加载配置文件中配置的静态资源

[https_github.com_grafana_grafana_blob_v8.1.5_contribute_developer-guide.md]: https://github.com/grafana/grafana/blob/v8.1.5/contribute/developer-guide.md
[https_github.com_grafana_grafana_issues]: https://github.com/grafana/grafana/issues
[https_jmeubank.github.io_tdm-gcc]: https://jmeubank.github.io/tdm-gcc/
[https_sourceforge.net_projects_mingw-w64]: https://sourceforge.net/projects/mingw-w64/
[https_pan.baidu.com_s_1vk9eJ-a2Ma3SNMNilHoMvQ]: https://pan.baidu.com/s/1vk9eJ-a2Ma3SNMNilHoMvQ
[d08df2dfe69c47b39b6851c71f494136.png]: https://img-blog.csdnimg.cn/d08df2dfe69c47b39b6851c71f494136.png
[93588a42951548258e355f91690fcd27.png]: https://img-blog.csdnimg.cn/93588a42951548258e355f91690fcd27.png
[06d2f83983a9448b9b81fa577a702194.png]: https://img-blog.csdnimg.cn/06d2f83983a9448b9b81fa577a702194.png
[909b1ffaeb6b4c068fca6be8f5f5f0d0.png]: https://img-blog.csdnimg.cn/909b1ffaeb6b4c068fca6be8f5f5f0d0.png
[https_grafana.com_docs_grafana_latest_installation_windows]: https://grafana.com/docs/grafana/latest/installation/windows/
[8163246e72f447fe91fed12f0ee87acc.png]: https://img-blog.csdnimg.cn/8163246e72f447fe91fed12f0ee87acc.png
[1e7d09ded8f94024a907d86cb4a77de1.png]: https://img-blog.csdnimg.cn/1e7d09ded8f94024a907d86cb4a77de1.png
[https_github.com_grafana_grafana_issues_q_undefined_3A_server.Initialize]: https://github.com/grafana/grafana/issues?q=undefined:%20server.Initialize
[e990bf3583084c8f961ffe910ed1036d.png]: https://img-blog.csdnimg.cn/e990bf3583084c8f961ffe910ed1036d.png