Grafana开发环境运行在Linux上,所以大多数工程师在他们的机器上安装了Linux。
麦金塔操作系统已经支持Linux开箱即用,所以在Mac上启动开发环境很简单(如果你使用的是Mac,请参考本指南)作为初级开发者如何为《Grafana》做出贡献,其中解释了如何在Mac上设置Grafana开发环境。)
相反,Windows操作系统没有Linux环境,因此在Windows机器上开发软件可能很困难。但是随着WSL在Windows上,你现在可以直接在Windows上运行GNU/Linux环境。这篇博文将解释如何开始。
注意:要获得关于Grafana的设置过程的最新信息,请查看自述在GitHub上。
安装依赖关系
在Windows PC上运行Grafana开发环境有两种依赖:
- Linux运行时环境(WSL)
- 开发(Dev)依赖
通读并确保系统上安装了所有依赖项。
Linux运行时环境
注意:在开始安装Linux运行时环境之前,请注意您的计算机必须在UEFI BIOS上运行,UEFI BIOS支持开箱即用的虚拟化。
要轻松地设置Grafana开发人员环境,您需要一个Linux环境在Windows机器上本地运行。幸运的是,Windows子系统for Linux (WSL)允许您直接在Windows上运行本地Linux命令行工具,以及传统的Windows桌面和现代商店应用程序。
为了让Grafana和Docker在您的机器上有效地运行,您需要安装WSL和Linux发行版。对于Linux发行版,我使用Ubuntu v18.04进行了一些测试,它运行得很好。
有关安装说明,请参见Microsoft WSL安装指南.
Dev依赖性
注意:建议您使用Linux终端安装开发依赖项。
由于Windows 10同时运行Windows和Linux环境,您可能会犯这样的错误:在一个环境中安装依赖项,然后试图从另一个环境访问它。这是大多数Windows用户在设置工作环境时面临的一个主要问题。对于任何类型的应用程序或软件开发工作,您都应该始终使用Linux环境(WSL)。
为了让Grafana在你的机器上运行,你需要安装一些必要的依赖项:
Node.js LTS(v14.15.5):我建议你使用Node版本管理器来安装Node.js。NVM提供Node版本管理界面。看看安装指南.
纱(
NPM安装-g纱线
).码头工人Docker需要安装在Windows上,但为每个WSL发行版激活。它需要WSL2才能成功运行。如果您还没有使用WSL2,我们建议您将WSL更新到WSL2。
下载Grafana
警告:不要使用
去
下载Grafana。最近版本的Go添加了一些与Grafana存储库结构不兼容的行为。
在Windows机器上下载Grafana:
打开终端并导航到所需的目录。作为最佳实践,我通常将所有软件项目克隆到一个中心目录中。
运行
Git克隆https://github.com/grafana/grafana.git
.这个命令下载Grafana到一个新的grafana
目录。导航到
grafana
通过运行目录cd grafana
.在您喜欢的代码编辑器中打开Grafana目录。如果您正在使用Visual Studio Code,则运行
代码。
在VSCode中打开Grafana。
运行Grafana
Grafana由两个主要部分组成:前端和后端。要在机器上完全运行Grafana应用程序,必须同时启动前端和后端。
后端
导航到您的终端并通过运行启动后端web服务器使运行
.请记住,可以在启动后端之前启动前端。
前端
在构建前端资产之前,需要安装前端依赖项。打开一个不同的终端,导航到Grafana目录,并运行:
Yarn install——pure-lockfile
命令完成后,你可以开始构建我们的源代码:
纱线开始
Grafana将在http://localhost:3000上提供。您将看到登录页面。默认凭据是:
用户名:admin密码:admin
首次登录时,系统会提示您修改密码。你可以决定跳过那一页。
测试Grafana
你可以看看Grafana文档来了解更多。
添加数据源
幸运的是,对于所有开发人员和贡献者来说,您可以轻松地添加数据源并运行相应的数据库。您可以找到相关文档在这里,但是我将向您介绍它并添加一些额外的信息。
- 第一步,您需要将目录更改为devenv。
cd devenv
- 在devenv中,需要运行bash命令
。/ setup.sh
.这意味着运行。/ setup.sh
会执行这个脚本(任何可执行的bash脚本都可以在前面加上。/来运行),它会在你的Grafana中设置几个数据源和仪表板。数据源将被命名gdev -仪表板文件夹将被命名gdev仪表板. - 在终端执行该命令后,重启Grafana服务器(后端)。然后您应该能够看到更改。
。/ setup.sh
- 从devenv那里拿回Grafana目录。
cd . .
- 执行make命令。
Make devenv sources=influxdb,loki
这个命令创建一个Docker合成文件,其中配置了指定的数据库并准备运行!
中还可以找到所有可用数据库的列表grafana / devenv /码头工人/块.
现在您已经设置好并准备好开始探索或为Grafana做出贡献!了解更多关于开始为Grafana项目做贡献并查看所有最新的功能Grafana 7.4.