English | 中文 |
---|
DevLake 将你所有的 DevOps 数据以实用、个性化、可扩展的视图呈现。通过 DevLake,从不断增加的开发者工具列表中收集、分析和可视化数据。
DevLake 适用于希望更好地通过数据了解其开发过程的开发团队,以及希望以数据驱动提升自身实践的开发团队。有了 DevLake,你可以向你的开发过程提出任何问题,只要连接数据并查询。
点击这里 查看 Demo. Demo里呈现的数据来自此仓库。
用户名/密码: test/test
下面是一个 数据源插件(data source plugins) 的列表,用于收集和处理特定来源的数据。每个插件都有一个 README.md
文件,包含基本设置、故障排除和指标信息。
关于建立一个新的 data source plugins 的更多信息,请参见添加一个插件。
目录 | 内容 | 文档 |
---|---|---|
Jira | 概述,数据和指标,配置,API | Link |
Gitlab | 概述,数据和指标,配置,API | Link |
Jenkins | 概述,数据和指标,配置,API | Link |
GitHub | 概述,数据和指标,配置,API | Link |
一共有 3 种方式来安装 Dev Lake:用户安装,开发者安装和云端安装。
这样
的命令需要在你的终端中运行注:安装完 Docker 后,你可能需要运行 Docker 应用程序并重新启动你的终端
克隆仓库。
git clone https://github.com/merico-dev/lake.git devlake cd devlake cp .env.example .env
启动 Docker,然后运行 docker-compose up -d
启动服务。
访问 localhost:4000
来设置 Dev Lake 的配置文件
- 在 “Integration”页面上找到到所需的插件页面
- 你需要为你打算使用的插件输入必要的信息
- 请参考以下内容,以了解如何配置每个插件的更多细节 -> Jira -> GitLab -> Jenkins -> GitHub
- 提交表单,通过点击每个表单页面上的Save Connection按钮来更新数值。
devlake
需要一段时间才能完全启动。如果config-ui
提示 API 无法访问,请等待几秒钟并尝试刷新页面。- 如果想收集一个 Repo 进行快速预览,请在数据集成/Github页面提供一个 Github 的个人 Token。
访问 localhost:4000/triggers
,触发数据收集
请参考这篇Wiki How to trigger data collection。数据收集可能需要一段时间,取决于你想收集的数据量。
- 如果要收集这个 repo 以进行,你可以使用以下 JSON
[ [ { "Plugin": "github", "Options": { "repositoryName": "lake", "owner": "merico-dev" } } ] ]
admin
, 密码: admin
)。当数据收集完成后,该按钮将显示在触发收集页面。为了定期同步数据,我们提供了lake-cli
以方便发送数据收集请求,我们同时提供了cron job以定期触发 cli 工具。
sudo apt-get install build-essential
进入你想安装本项目的路径,并克隆资源库
git clone https://github.com/merico-dev/lake.git cd lake
安装 go packages
make install
将样本配置文件复制到新的本地文件
cp .env.example .env
在.env
文件中找到以DB_URL
开头的那一行,把mysql:3306
替换为127.0.0.1:3306
启动 MySQL 和 Grafana
确保在此步骤之前 Docker 正在运行。
docker-compose up mysql grafana
在 2 个终端种分别以开发者模式运行 lake 和 config UI:
# run lake make dev # run config UI make configure-dev
访问 config-ui localhost:4000
来配置 Dev Lake 数据源
- 在 “Integration”页面上找到到所需的插件页面
- 你需要为你打算使用的插件输入必要的信息
- 请参考以下内容,以了解如何配置每个插件的更多细节 -> Jira -> GitLab -> Jenkins -> GitHub
访问 localhost:4000/triggers
,触发数据收集
请参考这篇Wiki How to trigger data collection。对于大型项目,这可能需要20分钟。 (Gitlab 10k+ commits 或 Jira 5k+ 事务)
- 如果要收集这个 repo 以进行,你可以使用以下 JSON
[ [ { "Plugin": "github", "Options": { "repositoryName": "lake", "owner": "merico-dev" } } ] ]
在Grafana仪表板中实现数据的可视化
从这里你可以看到丰富的图表,这些图表来自于收集和处理后的数据
admin
, 密码: admin
)Dev lake
中的仪表板如果你想在云端安装Dev Lake,你可以使用 Tin 来进行. 查看详细信息
声明:
对于使用 Tin 在云端托管 Dev Lake 的用户,设置密码来保护实例下配置信息的安全是至关重要的。Dev Lake作为一个自我托管的产品,部分是为了确保用户对数据有完全的保护和所有权,对于 Tin 托管来说也是如此,这个风险点需要由终端用户来消除。
运行测试:
make test
本节列出了所有的文件,以帮助你快速为 repo 做出贡献。
我们使用 Grafana 作为可视化工具,为存储在我们数据库中的数据建立图表。可以使用SQL查询,添加面板来构建、保存和编辑自定义仪表盘。
关于配置和定制仪表盘的所有细节可以在 Grafana 文档 中找到。
在 Discord 上给我们发消息
问:当我运行docker-compose up -d
时,得到这个错误: “qemu: uncaught target signal 11 (Segmentation fault) - core dumped”。如何解决这个问题?
答:Mac M1用户需要在他们的机器上下载一个特定版本的docker。你可以在这里找到它。 https://docs.docker.com/desktop/mac/apple-silicon/
此项目的许可证为 Apache License 2.0 - 查看 许可证
详情。