博客/工程

如何在Windows PC上使用WSL建立Grafana开发环境

2021年3月3日5分钟

Grafana开发环境运行在Linux上,所以大多数工程师在他们的机器上安装了Linux。

麦金塔操作系统已经支持Linux开箱即用,所以在Mac上启动开发环境很简单(如果你使用的是Mac,请参考本指南)作为初级开发者如何为《Grafana》做出贡献,其中解释了如何在Mac上设置Grafana开发环境。)

相反,Windows操作系统没有Linux环境,因此在Windows机器上开发软件可能很困难。但是随着WSL在Windows上,你现在可以直接在Windows上运行GNU/Linux环境。这篇博文将解释如何开始。

注意:要获得关于Grafana的设置过程的最新信息,请查看自述在GitHub上。

安装依赖关系

在Windows PC上运行Grafana开发环境有两种依赖:

  1. Linux运行时环境(WSL)
  2. 开发(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在你的机器上运行,你需要安装一些必要的依赖项:

  • 去(v1.15)

  • 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:

  1. 打开终端并导航到所需的目录。作为最佳实践,我通常将所有软件项目克隆到一个中心目录中。

  2. 运行Git克隆https://github.com/grafana/grafana.git.这个命令下载Grafana到一个新的grafana目录。

  3. 导航到grafana通过运行目录cd grafana

  4. 在您喜欢的代码编辑器中打开Grafana目录。如果您正在使用Visual Studio Code,则运行代码。在VSCode中打开Grafana。

运行Grafana

Grafana由两个主要部分组成:前端和后端。要在机器上完全运行Grafana应用程序,必须同时启动前端和后端。

后端

导航到您的终端并通过运行启动后端web服务器使运行.请记住,可以在启动后端之前启动前端。

前端

在构建前端资产之前,需要安装前端依赖项。打开一个不同的终端,导航到Grafana目录,并运行:

Yarn install——pure-lockfile

命令完成后,你可以开始构建我们的源代码:

纱线开始

Grafana将在http://localhost:3000上提供。您将看到登录页面。默认凭据是:

用户名:admin密码:admin

首次登录时,系统会提示您修改密码。你可以决定跳过那一页。

测试Grafana

你可以看看Grafana文档来了解更多。

添加数据源

幸运的是,对于所有开发人员和贡献者来说,您可以轻松地添加数据源并运行相应的数据库。您可以找到相关文档在这里,但是我将向您介绍它并添加一些额外的信息。

  1. 第一步,您需要将目录更改为devenv。
cd devenv
  1. 在devenv中,需要运行bash命令。/ setup.sh.这意味着运行。/ setup.sh会执行这个脚本(任何可执行的bash脚本都可以在前面加上。/来运行),它会在你的Grafana中设置几个数据源和仪表板。数据源将被命名gdev -仪表板文件夹将被命名gdev仪表板
  2. 在终端执行该命令后,重启Grafana服务器(后端)。然后您应该能够看到更改。
。/ setup.sh
  1. 从devenv那里拿回Grafana目录。
cd . .
  1. 执行make命令。
Make devenv sources=influxdb,loki

这个命令创建一个Docker合成文件,其中配置了指定的数据库并准备运行!

中还可以找到所有可用数据库的列表grafana / devenv /码头工人/块

现在您已经设置好并准备好开始探索或为Grafana做出贡献!了解更多关于开始为Grafana项目做贡献并查看所有最新的功能Grafana 7.4