docs: update README

This commit is contained in:
songlh
2025-01-16 17:39:43 +08:00
parent 6a20e2f578
commit 3ea81987a1
8 changed files with 314 additions and 149 deletions

61
docs/CONTRIBUTING.md Normal file
View File

@@ -0,0 +1,61 @@
# 🎉 Contributing to CMDB 🥳
首先,非常感谢您考虑为我们的项目做出贡献!我们欢迎任何形式的贡献,无论是提出新功能、改进代码、修复 bug 还是改善文档。
本指南将为您提供所有相关信息,帮助您快速入门并开始参与本项目。请花几分钟阅读它,它将帮助我们更好地协作,共同创造一个更好的项目。
## ❖ 提交问题 (Issue)
在提交 PR 之前,请先搜索 现有的 [PR](https://github.com/veops/cmdb/pulls) 或 [Issue](https://github.com/veops/cmdb/issues),查看是否已经有相关的开放或关闭的提交。
如果是修复 bug请首先提交一个 Issue。
对于新增功能,请先通过我们提供的联系方式与我们直接联系,以便更好的合作。
## ❖ 提交 PR 的步骤
1. 在 Github 上 fork 该项目的仓库。
2. 在本地复制仓库后创建一个新分支,用于开发新功能、修复 bug 或进行其他贡献,命令:`git checkout -b feat/xxxx`
3. 提交您的更改:`git commit -am 'feat: add xxxxx'`
4. 推送您的分支:`git push origin feat/xxxx`
5. 提交 Pull Request 时,请确保您的源分支是刚刚推送的分支,目标分支是 CMDB 项目的 master 分支。
6. 提交后,请留意与 Pull Request 相关的邮件和通知。待通过审核后,我们会按计划将其合并到 master 分支,并进行新一轮的版本发布。
## ❖ 开发环境
- Python 版本 >= 3.8
- Node.js 版本 >= 14.17.6
- Docker
## ❖ 代码风格
**API**: 请遵循 [Python Style](https://google.github.io/styleguide/pyguide.html)
**UI**: 请遵循 [node-style-guide](https://github.com/felixge/node-style-guide)
## ❖ 提交信息
+ 请遵循 [Angular](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular)
+ 提交时使用不同的范围
- API: `feat(api): xxx`
- UI: `feat(ui): xxx`
+ 为了确保所有开发者都能更好地理解,提交信息请使用英文。
- `feat` 添加新功能
- `fix` 修复问题/BUG
- `style` 代码风格相关,不影响运行结果
- `perf` 优化/性能提升
- `refactor` 代码重构
- `revert` 撤销编辑
- `test` 测试相关
- `docs` 文档/注释
- `chore` 依赖更新/脚手架配置修改等
- `workflow` 工作流优化
- `ci` 持续集成
- `types` 类型定义文件变更
- `wip` 开发中
## ❖ 代码内容
为了便于所有开发者理解,请确保代码注释和代码内容使用英文。

61
docs/CONTRIBUTING_en.md Normal file
View File

@@ -0,0 +1,61 @@
# 🎉 Contributing to CMDB 🥳
First of all, thank you very much for considering contributing to our project! We welcome any kind of contribution, whether it's proposing new functional features, improving code, fixing bugs, or improving documentation.
This guide will provide all the relevant information to help you get started working on this project. Please take a few minutes to read it, it will help us collaborate better and create a better project together.
## ❖ Submit Issue
Before jumping into a PR be sure to search [existing PRs](https://github.com/veops/cmdb/pulls) or [issues](https://github.com/veops/cmdb/issues) for an open or closed item that relates to your submission.
If it's a bug fix, please raise it in an Issue first.
For new feature additions, please first contact us directly via the contact information we provide.
## ❖ Pull Requests Steps
1. Fork this project's repo on Github
2. Create a new branch on your local copy to develop new features, fix bugs, or make other contributions, `git checkout -b feat/xxxx`
3. Submit your changes: `git commit -am 'feat: add xxxxx'`
4. Push your branch: `git push origin feat/xxxx`
5. To submit a `Pull Request`, make sure your source branch is the one you just pushed, and your target branch is the `master` branch of the CMDB project.
6. After submitting, watch out for emails and notifications associated with the Pull request. Once it's approved, we'll merge it into the `master` branch as planned. Doing a new round of releases
## ❖ Development Environment
- Python >= 3.8
- node >= 14.17.6
- docker
## ❖ Code Style
**API**: Please follow the [Python Style](https://google.github.io/styleguide/pyguide.html)
**UI**: Please follow the [node-style-guide](https://github.com/felixge/node-style-guide)
## ❖ Commit Messages
+ Please follow the [Angular](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular)
+ Commit with different scopes
- API: `feat(api): xxx`
- UI: `feat(ui): xxx`
+ Please keep the commit message in English for better understanding by all developers.
- `feat` Add new features
- `fix` Fix the problem/BUG
- `style` The code style is related and does not affect the running result
- `perf` Optimization/performance improvement
- `refactor` Refactor
- `revert` Undo edit
- `test` Test related
- `docs` Documentation/notes
- `chore` Dependency update/scaffolding configuration modification etc.
- `workflow` Workflow improvements
- `ci` Continuous integration
- `types` Type definition file changes
- `wip` In development
## ❖ Code Content
Please keep the code comments and code content in English for better understanding by all developers.

View File

@@ -4,98 +4,120 @@
<a href="https://github.com/veops/cmdb/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-AGPLv3-brightgreen" alt="License: GPLv3"></a>
<a href="https:https://github.com/sendya/ant-design-pro-vue"><img src="https://img.shields.io/badge/UI-Ant%20Design%20Pro%20Vue-brightgreen" alt="UI"></a>
<a href="https://github.com/pallets/flask"><img src="https://img.shields.io/badge/API-Flask-brightgreen" alt="API"></a>
<a href="https://github.com/veops/cmdb/stargazers">
<img src="https://img.shields.io/github/stars/veops/cmdb" alt="Stars Badge"/>
</a>
<a href="https://github.com/veops/cmdb">
<img src="https://img.shields.io/github/forks/veops/cmdb" alt="Forks Badge"/>
</a>
</p>
<p align="center">
English · <a href="../README.md">中文(简体)</a>
</p>
------------------------------
## Introduce
VE CMDB is a simple, lightweight and highly customizable operations and maintenance configuration management database (CMDB). It supports flexible model configuration and resource auto-discovery, and is designed to provide organizations with a convenient asset management solution that helps operations teams efficiently manage IT infrastructure and services.
[English](README_en.md) / [中文](../README.md)
## DEMO ONLINE
- Product documenthttps://veops.cn/docs/
- Preview online: <a href="https://cmdb.veops.cn" target="_blank">CMDB</a>
- Product document[https://veops.cn/docs/](https://veops.cn/docs/)
- Preview online: [https://cmdb.veops.cn](https://cmdb.veops.cn)
- username: demo
- password: 123456
> **ATTENTION**: branch `master` may be unstable as the result of continued development, please pull code from [releases](https://github.com/veops/cmdb/releases)
## Overview
- **ATTENTION**: branch `master` may be unstable as the result of continued development, Please use [releases](https://github.com/veops/cmdb/releases) to get the latest stable version
### Features
- **Custom Model and Model Relationships**: Supports customization of model attributes, including drop-down lists, font colors, calculated attributes and other advanced functions to meet different business needs.
- **Auto-discovery of resources**: supports auto-discovery of computers, network devices, storage devices, databases, middleware, public cloud resources, etc.
- **Multi-dimensional view display**: including resource view, hierarchical view, relationship view, etc., helping O&M personnel to comprehensively manage resources.
- **Fine-grained privilege control**: ensure system security through precise access control and complete operation logs.
- **Comprehensive Resource Search Function**: Supports flexible resource and relationship search to quickly locate and operate resources.
- **Integrated IP Address Management (IPAM) and Data Center Infrastructure Management (DCIM) features**: Simplify the management of network resources and data center equipment.
For more detailed features, please visit the [official website](https://veops.cn).
### System Characteristics
- Flexibility
1. Standardize and manage complex data assets
2. Automatically discover and inventory IT assets
+ No need to specify fixed operation and maintenance scenarios, supports free configuration and built-in multiple templates.
+ Support automatic discovery and inventory of IT assets, quickly set up an asset management system.
- Security
1. Fine-grained access control
2. Comprehensive operation logs
+ Fine-grained permission control mechanism to ensure the security of resource management.
+ Complete operation logs for easy auditing and problem tracking.
- Multi-application
1. Rich view display dimensions
2. Provide Restful API
3. Custom field triggers
+ Provides multiple views to meet the needs of different scenarios.
+ Powerful API interface supports deep integration.
+ Support for defining attribute triggers and calculating attributes to enhance data processing capabilities.
### Main Features
### Tech Stack
- Custom models and model relationships, with model attributes supporting advanced features such as dropdown lists, font colors, and computed attributes.
- Support for automatic discovery of computers, network devices, storage devices, databases, middleware, public cloud resources, etc.
- Support for displaying resource, hierarchy, and relationship views.
- Fine-grained access control and comprehensive operation logs.
- General resource and relationship search capabilities.
- Support for IP Address Management (IPAM) and Data Center Infrastructure Management (DCIM).
+ Back-end: Python [3.8-3.11].
+ Data Storage: MySQL, Redis
+ Front-end: Vue.js
+ UI component library: Ant Design Vue
### Overview
<table style="border-collapse: collapse; border: 1px solid black;">
<tr>
<td style="padding: 5px;background-color:#fff;">
<img width="400" src="./images/cmdb-screenshot-1.png"/>
</td>
<td style="padding: 5px;background-color:#fff;">
<img width="400" src="./images/cmdb-screenshot-2.png"/>
</td>
</tr>
### More Features
<tr>
<td style="padding: 5px;background-color:#fff;">
<img width="400" src="./images/cmdb-screenshot-3.png"/>
</td>
<td style="padding: 5px;background-color:#fff;">
<img width="400" src="./images/cmdb-screenshot-4.png"/>
</td>
</tr>
</table>
> Welcome to visit VeOps official website to discover more free operations and maintenance systems.
## Quick Start
## Installation
### 1. Set up
### One-Click Docker Quick Build
+ Option 1: Docker One-Click Quick Builds
[//]: # (> Method 1)
- step 1: **Prepare: install Docker and Docker Compose (v2)**
- step 2: copy the repository
```shell
git clone https://github.com/veops/cmdb.git
```
- step 3: In directory cmdb:
```
docker compose up -d
```
- Step 1: Install Docker environment and Docker Compose (v2)
- Step 2: Copy the project code, `git clone https://github.com/veops/cmdb.git`
- Step 3: Enter the home directory and start, `docker compose up -d`
[//]: # (> M**ethod 2 Usefull for linux os.)
+ [Local Setup](local_en.md)
+ [Installation with Makefile](makefile_en.md)
[//]: # (- step 1: **Prepare: install Docker and Docker Compose &#40;v2&#41;**)
### 2. Visit
- Open your browser and visit: [http://127.0.0.1:8000](http://127.0.0.1:8000)
- Username: demo or admin
- Password: 123456
[//]: # (- step 2: directly use the install.sh file in the project's root directory to `install`, `start`, `pause`, `status`, `delete`, and `uninstall` the application. )
## Access Company
[//]: # (```shell)
[//]: # (curl -so install.sh https://raw.githubusercontent.com/veops/cmdb/master/install.sh )
[//]: # (sh install.sh install)
[//]: # (```**)
### [Local Setup](local_en.md)
### [Installation with Makefile](makefile_en.md)
## Validation
- View: [http://127.0.0.1:8000](http://127.0.0.1:8000)
- username: demo or admin
- password: 123456
+ Companies using the open source CMDB are welcome to record in [#112](https://github.com/veops/cmdb/issues/112)
## Contributing
We welcome all developers to contribute code to improve and extend this project. Please read our [contribution guidelines](./CONTRIBUTING_en.md) first. Additionally, you can support Veops open source through social media, events, and sharing.
1. Fork it
2. Create your feature branch (`git checkout -b my-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-feature`)
5. Create new Pull Request
<a href="https://github.com/veops/cmdb/graphs/contributors">
<img src="https://contrib.rocks/image?repo=veops/cmdb" />
</a>
---
## Enterprise Edition
Compared to the Community Edition, VE Enterprise Edition provides a large number of enhancements and technical support services for enterprises. Enhancements include data compliance, data cascading, auto-discovery extensions, large screen customization, and more. [Enterprise Edition Details](https://veops.cn/cmdb)
## VE Technology's other open source projects
- [OneTerm](https://github.com/veops/oneterm): Provide secure access and control over all infrastructure.
- [messenger](https://github.com/veops/messenger): A simple and lightweight message sending service.
- [ACL](https://github.com/veops/acl): A general permission control management system.
- [ops-tools](https://github.com/veops/ops-tools): Common practices and code for operations and maintenance.
## Contact me
+ Email: <a href="mailto:bd@veops.cn">bd@veops.cn</a>

Binary file not shown.

After

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 80 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 184 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 121 KiB