[home]开源官网初始化

2022-02-02 22:49:50 +08:00
parent 9347097905
commit c47706be17
132 changed files with 15971 additions and 1 deletions
--- a/home/docs/start/docker-deploy.md
+++ b/home/docs/start/docker-deploy.md
@@ -0,0 +1,35 @@
+---
+id: docker-deploy  
+title: 通过Docker方式安装HertzBeat    
+sidebar_label: Docker方式部署    
+---
+
+### 🐕 开始使用
+
+- 如果您不想部署而是直接使用，我们提供SAAS监控云-[TanCloud探云](https://console.tancloud.cn)，即刻[登陆注册](https://console.tancloud.cn)免费使用。  
+- 如果您是想将HertzBeat部署到内网环境搭建监控系统，请参考下面的部署文档进行操作。 
+
+### 🐵 依赖服务部署   
+
+> HertzBeat最少依赖于 关系型数据库[MYSQL8+](https://www.mysql.com/) 和 时序性数据库[TDengine2+](https://www.taosdata.com/getting-started)
+
+##### 安装MYSQL  
+1. docker安装MYSQl  
+`docker run -d --name mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 mysql`   
+2. 创建名称为hertzBeat的数据库  
+3. 执行位于项目仓库script目录下的数据库脚本 schema.sql    
+
+##### 安装TDengine   
+1. docker安装TDengine   
+`docker run -d -p 6030-6049:6030-6049 -p 6030-6049:6030-6049/udp --name tdengine tdengine/tdengine`     
+2. 创建名称为hertzBeat的数据库
+
+### 🍞 HertzBeat安装   
+> HertzBeat支持通过源码安装启动，Docker容器运行和安装包方式安装部署。  
+
+#### Docker方式快速安装
+`docker run -d -p 1157:1157 --name hertzbeat tancloud/hertzbeat:latest`  
+#### 通过安装包安装   
+todo  
+
+**HAVE FUN**
--- a/home/docs/start/mysql-init.md
+++ b/home/docs/start/mysql-init.md
@@ -0,0 +1,30 @@
+---
+id: mysql-init  
+title: 依赖服务MYSQL安装初始化        
+sidebar_label: MYSQL安装初始化    
+---
+MYSQL是一款值得信赖的关系型数据库，HertzBeat使用其存储监控信息，告警信息，配置信息等结构化关系数据。  
+
+> 如果您已有MYSQL环境，可直接跳到SQL脚本执行那一步。  
+
+### 通过Docker方式安装MYSQL   
+1. 下载安装Docker环境   
+   Docker 工具自身的下载请参考 [Docker官网文档](https://docs.docker.com/get-docker/)。
+   安装完毕后终端查看Docker版本是否正常输出。  
+   ```
+   $ docker -v
+   Docker version 20.10.12, build e91ed57
+   ```
+2. Docker安装MYSQl  
+   ```
+   $ docker run -d --name mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 mysql:latest
+   526aa188da767ae94b244226a2b2eec2b5f17dd8eff594533d9ec0cd0f3a1ccd
+   ```
+   使用```$ docker ps```查看数据库是否启动成功
+
+### SQL脚本执行   
+1. 进入MYSQL或使用客户端连接MYSQL服务
+2. 创建名称为hertzbeat的数据库
+3. 执行位于项目仓库script目录下的数据库建表初始化脚本 schema.sql
+4. 查看hertzbeat数据库是否成功建表
+
--- a/home/docs/start/package-deploy.md
+++ b/home/docs/start/package-deploy.md
@@ -0,0 +1,35 @@
+---
+id: package-deploy  
+title: 通过安装包安装HertzBeat    
+sidebar_label: 安装包方式部署    
+---
+
+### 🐕 开始使用
+
+- 如果您不想部署而是直接使用，我们提供SAAS监控云-[TanCloud探云](https://console.tancloud.cn)，即刻[登陆注册](https://console.tancloud.cn)免费使用。  
+- 如果您是想将HertzBeat部署到内网环境搭建监控系统，请参考下面的部署文档进行操作。 
+
+### 🐵 依赖服务部署   
+
+> HertzBeat最少依赖于 关系型数据库[MYSQL8+](https://www.mysql.com/) 和 时序性数据库[TDengine2+](https://www.taosdata.com/getting-started)
+
+##### 安装MYSQL  
+1. docker安装MYSQl  
+`docker run -d --name mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 mysql`   
+2. 创建名称为hertzBeat的数据库  
+3. 执行位于项目仓库script目录下的数据库脚本 schema.sql    
+
+##### 安装TDengine   
+1. docker安装TDengine   
+`docker run -d -p 6030-6049:6030-6049 -p 6030-6049:6030-6049/udp --name tdengine tdengine/tdengine`     
+2. 创建名称为hertzBeat的数据库
+
+### 🍞 HertzBeat安装   
+> HertzBeat支持通过源码安装启动，Docker容器运行和安装包方式安装部署。  
+
+#### Docker方式快速安装
+`docker run -d -p 1157:1157 --name hertzbeat tancloud/hertzbeat:latest`  
+#### 通过安装包安装   
+todo  
+
+**HAVE FUN**
--- a/home/docs/start/quickstart.md
+++ b/home/docs/start/quickstart.md
@@ -0,0 +1,44 @@
+---
+id: quickstart  
+title: 快速开始    
+sidebar_label: 快速开始    
+---
+
+### 🐕 开始使用
+
+- 如果您不想部署而是直接使用，我们提供SAAS监控云-[TanCloud探云](https://console.tancloud.cn)，即刻[登陆注册](https://console.tancloud.cn)免费使用。  
+- 如果您是想将HertzBeat部署到内网环境搭建监控系统，请参考下面的部署文档进行操作。 
+
+### 🐵 依赖服务部署   
+
+> HertzBeat最少依赖于 关系型数据库[MYSQL8+](https://www.mysql.com/) 和 时序性数据库[TDengine2+](https://www.taosdata.com/getting-started)
+
+##### 安装MYSQL  
+1. docker安装MYSQl  
+`docker run -d --name mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 mysql`   
+2. 创建名称为hertzbeat的数据库  
+3. 执行位于项目仓库script目录下的数据库脚本 schema.sql    
+
+详细步骤参考 [依赖服务MYSQL安装初始化](mysql-init.md)    
+
+##### 安装TDengine   
+1. docker安装TDengine   
+`docker run -d -p 6030-6049:6030-6049 -p 6030-6049:6030-6049/udp --name tdengine tdengine/tdengine`     
+2. 创建名称为hertzbeat的数据库
+
+详细步骤参考 [依赖服务TDengine安装初始化](tdengine-init.md)   
+
+### 🍞 HertzBeat安装   
+> HertzBeat支持通过源码安装启动，Docker容器运行和安装包方式安装部署。  
+
+#### Docker方式快速安装
+`docker run -d -p 1157:1157 --name hertzbeat tancloud/hertzbeat:latest`  
+
+详细步骤参考 [通过Docker方式安装HertzBeat](docker-deploy.md) 
+
+#### 通过安装包安装   
+todo  
+
+详细步骤参考 [通过安装包安装HertzBeat](package-deploy.md) 
+
+**HAVE FUN**
--- a/home/docs/start/tdengine-init.md
+++ b/home/docs/start/tdengine-init.md
@@ -0,0 +1,50 @@
+---
+id: tdengine-init  
+title: 依赖服务TDengine安装初始化        
+sidebar_label: TDengine安装初始化    
+---
+TDengine是一款国产的开源物联网时序型数据库，我们使用其替换了InfluxDb，来存储采集到的监控指标数据。
+
+> 如果您已有TDengine环境，可直接跳到创建数据库实例那一步。
+
+### 通过Docker方式安装TDengine 
+> 可参考官方网站[安装教程](https://www.taosdata.com/docs/cn/v2.0/getting-started/docker)  
+1. 下载安装Docker环境   
+   Docker 工具自身的下载请参考 [Docker官网文档](https://docs.docker.com/get-docker/)。
+   安装完毕后终端查看Docker版本是否正常输出。
+   ```
+   $ docker -v
+   Docker version 20.10.12, build e91ed57
+   ```
+2. Docker安装TDengine
+   ```
+   $ docker run -d -p 6030-6049:6030-6049 -p 6030-6049:6030-6049/udp --name tdengine tdengine/tdengine
+   526aa188da767ae94b244226a2b2eec2b5f17dd8eff594533d9ec0cd0f3a1ccd
+   ```
+   使用```$ docker ps```查看数据库是否启动成功
+
+### 创建数据库实例    
+1. 进入数据库Docker容器  
+   ```
+   $ docker exec -it tdengine /bin/bash
+   root@tdengine-server:~/TDengine-server-2.4.0.4#
+   ```
+2. 创建名称为hertzbeat的数据库
+   进入容器后，执行 taos shell 客户端程序。
+   ```
+   root@tdengine-server:~/TDengine-server-2.4.0.4# taos
+   Welcome to the TDengine shell from Linux, Client Version:2.4.0.4
+   Copyright (c) 2020 by TAOS Data, Inc. All rights reserved.
+   taos>
+   ```
+   执行创建数据库命令
+   ```
+   taos> show databases;
+   taos> CREATE DATABASE hertzbeat KEEP 90 DAYS 10 BLOCKS 6 UPDATE 1;
+   ```
+   上述语句将创建一个名为 hertzbeat 的库，这个库的数据将保留90天（超过90天将被自动删除），每 10 天一个数据文件，内存块数为 6，允许更新数据
+3. 查看hertzbeat数据库是否成功创建
+   ```
+   taos> show databases;
+   taos> use hertzbeat;
+   ```