Grafana源碼編譯–Windows
準備工作
1、系統:Windows
2、軟件:
(1)GO:儘量使用跟Grafana源碼版本一樣的Go版本,通過Github上https://github.com/grafana/grafana/網址,源碼根目錄下有個go.mod,打開文件,第二行會有說明Go的版本,這點很重要,如果用高版本或新版本,不能保證後面會不會出現坑。
(2)Git:版本沒有要求,用於從github中clone源碼到本地,用法如下:
# 進入某個文件夾
cd F:\GoProjects\src\github.com\grafana
# clone源碼到該文件夾下
git clone https://github.com/grafana/grafana.git
(3)NodeJs:選擇最新的穩定版本即可,Grafana的編譯有此說明For this you need nodejs (v.6+)。
(4)Nod-gyp,Grafana的前端編譯工具。
(5)GCC:Grafana後端編譯提及的工具,建議選擇和Grafana一致的GCC,需要注意的是,如果你電腦安裝了多個GCC編譯軟件,你需要確認運行的默認GCC是否爲你所需要的版本,把你所需要的GCC放在Path系統環境變量的前面)。
安裝Go
1、在官網上下載Go安裝包,也可在Go語言中文網https://studygolang.com/dl下載,安裝go1.13.5.windows-amd64.msi後,給Go添加環境變量:
(1)在系統環境變量Path中,添加路徑:D:\Program Files\Go\bin
,也就是執行文件位置;
(2)在系統環境變量中,新建GOPATH,添加路徑:F:\GoProjects
,該路徑爲項目放置的位置,該項目下需要建立bin、pkg、src三個文件夾;
(3)在系統環境變量中,新建GOROOT,添加路徑:D:\Program Files\Go
,也就是Go安裝的位置;
(4)在用戶環境變量中,新建GOPROXY,添加地址:https://goproxy.cn
,可以提高後續下載工作的效率;
2、檢驗是否安裝成功,打開命令提示符,輸入:go version
,出現版本信息表示安裝成功。
安裝NodeJS
1、在http://nodejs.cn/download/下載NodeJS,安裝node-v12.14.0-x64.msi後,在nodejs的根目錄新建node_cache、node_global兩個文件夾。
2、給nodejs添加環境變量:
(1)在系統變量中,新建NODE_PATH,添加路徑D:\Program Files\nodejs\node_global
和D:\Program Files\nodejs\node_modules
;
(2)在系統變量Path中,添加路徑D:\Program Files\nodejs\
和D:\Program Files\nodejs\node_global
;
3、檢驗是否安裝成功,打開命令提示符,輸入:node --version
,出現版本信息表示安裝成功。
安裝Git
1、在Git官網上https://git-scm.com/download/下載安裝包,安裝Git-2.24.0.2-64-bit.exe。
2、給Git添加系統環境變量,在系統變量Path中,添加路徑:D:\Program Files\Git\cmd
。
3、檢驗是否安裝成功,打開命令提示符,輸入:git --version
,出現版本信息表示安裝成功。
安裝gcc
我這裏就不寫了,提供給大家一個參考文檔:https://www.cnblogs.com/findumars/p/8289443.html,裏面有詳細的步驟。
獲取源碼
1、使用管理員身份運行cmd,進入F:\GoProjects\
後運行go get github.com/grafana/grafana
,這裏的路徑F:\GoProjects\
也就是系統環境變量中GOPATH
中添加的路徑。
# 進入F:\GoProjects\
cd F:\GoProjects\
# 獲取grafana源碼
go get github.com/grafana/grafana
運行成功後,源碼放在F:\GoProjects\src\github.com\grafana\grafana
路徑下。
2、進入F:\GoProjects\src\github.com\grafana\grafana
後,編譯後端代碼。
cd F:\GoProjects\src\github.com\grafana\grafana
go run build.go setup
go run build.go build
3、編譯前端代碼。
(1)安裝 node-gyp
node-gyp 是 Node.js 原生自帶的構建工具,它需要在 Windows 額外的依賴,windows 需要以管理員身份運行 cmd 或 powershell,然後運行下面的命令,檢查npm dependencies。
npm --add-python-to-path='true' --debug install --global windows-build-tools
npm install -g node-gyp
(2)安裝 yarn
npm install -g yarn
(3)正式編譯
yarn install --pure-lockfile
如果出現如下錯誤:
請運行以下命令更改執行策略,然後繼續運行yarn install --pure-lockfile
。
set-ExecutionPolicy RemoteSigned
(4)運行yarn start
yarn start
4、運行grafana
複製一份grafana/conf/sample.ini,改名爲custom.ini,修改custom.ini文件裏的http_port = 3000,取消註釋(刪除前面的;符號),我把3000改成了8081。
瀏覽器中打開 http://localhost:8081,默認賬戶、密碼爲:admin、admin。
5、如果需要參與源碼開發,需要運行:
cd F:\GoProjects
#獲取bra,bra將會生成在`F:\GoProjects\src\github.com\Unknwon\bra`目錄下。
go get github.com/unknown/bra
cd F:\GoProjects\src\github.com\grafana\grafana
#監聽後端代碼
go run F:\GoProjects\src\github.com\Unknwon\bra\bra.go run
#監聽前端代碼
npm run watch