通过 Docker 方式安装 HertzBeat

推荐使用Docker部署HertzBeat

下载安装Docker环境
Docker 工具自身的下载请参考以下资料：
Docker官网文档菜鸟教程-Docker教程安装完毕后终端查看Docker版本是否正常输出。
```
$ docker -v
Docker version 20.10.12, build e91ed57
```
拉取HertzBeat Docker镜像
镜像版本TAG可查看官方镜像仓库
```
$ docker pull tancloud/hertzbeat   
```

部署HertzBeat您可能需要掌握的几条命令

#查看所有容器(在运行和已经停止运行的容器)
$ docker ps -a
#启动/终止/重启/运行状态
$ docker start/stop/restart/stats 容器id或者容器名
#进入容器并打开容器的shell终端
$ docker exec -it 容器id或者容器名 /bin/bash
#退出容器终端
ctrl+p然后ctrl+q
#完全退出容器的终端 
ctrl+d或者
$ exit

配置挂载的HertzBeat的配置文件(可选)
在主机目录下创建application.yml，eg:/opt/application.yml
配置文件完整内容见项目仓库/script/application.yml 您可以根据需求修改配置文件
- 若需使用邮件发送告警，需替换application.yml里面的邮件服务器参数
- 推荐若需使用外置Mysql数据库替换内置H2数据库，需替换application.yml里面的spring.datasource参数具体步骤参见 H2数据库切换为MYSQL）
- 推荐若需使用时序数据库TDengine来存储指标数据，需替换application.yml里面的warehouse.store.td-engine参数具体步骤参见使用TDengine存储指标数据
- 推荐若需使用时序数据库IotDB来存储指标数据库，需替换application.yml里面的warehouse.storeiot-db参数具体步骤参见使用IotDB存储指标数据
配置挂载的HertzBeat用户配置文件，自定义用户密码(可选)
HertzBeat默认内置三个用户账户,分别为 admin/hertzbeat tom/hertzbeat guest/hertzbeat
若需要新增删除修改账户或密码，可以通过配置 sureness.yml 实现，若无此需求可忽略此步骤
在主机目录下创建sureness.yml，eg:/opt/sureness.yml
配置文件完整内容见项目仓库/script/sureness.yml
具体修改步骤参考配置修改账户密码
启动HertzBeat Docker容器

$ docker run -d -p 1157:1157 \
    -e LANG=zh_CN.UTF-8 \
    -e TZ=Asia/Shanghai \
    -v /opt/data:/opt/hertzbeat/data \
    -v /opt/logs:/opt/hertzbeat/logs \
    -v /opt/application.yml:/opt/hertzbeat/config/application.yml \
    -v /opt/sureness.yml:/opt/hertzbeat/config/sureness.yml \
    --restart=always \
    --name hertzbeat tancloud/hertzbeat

这条命令启动一个运行HertzBeat的Docker容器，并且将容器的1157端口映射到宿主机的1157端口上。若宿主机已有进程占用该端口，则需要修改主机映射端口。

docker run -d : 通过Docker运行一个容器,使其在后台运行
-p 1157:1157 : 映射容器端口到主机端口，请注意，前面是宿主机的端口号，后面是容器的端口号。
-e LANG=zh_CN.UTF-8 : (可选) 设置语言
-e TZ=Asia/Shanghai : (可选) 设置时区
-v /opt/data:/opt/hertzbeat/data : (可选，数据持久化)重要⚠️ 挂载H2数据库文件到本地主机，保证数据不会因为容器的创建删除而丢失
-v /opt/logs:/opt/hertzbeat/logs : (可选，不需要可删除)挂载日志文件到本地主机，保证日志不会因为容器的创建删除而丢失，方便查看
-v /opt/application.yml:/opt/hertzbeat/config/application.yml : (可选,不需要可删除)挂载上上一步修改的本地配置文件到容器中，即使用本地配置文件覆盖容器配置文件。我们需要修改此配置文件的MYSQL，TDengine配置信息来连接外部服务。
-v /opt/sureness.yml:/opt/hertzbeat/config/sureness.yml : (可选,不需要可删除)挂载上一步修改的账户配置文件到容器中，若无修改账户需求可删除此命令参数。
注意⚠️ 挂载文件时，前面参数为你自定义本地文件地址，后面参数为docker容器内文件地址(固定)
--name hertzbeat : 命名容器名称 hertzbeat
--restart=always：(可选，不需要可删除)使容器在Docker启动后自动重启。若您未在容器创建时指定该参数，可通过以下命令实现该容器自启。
```
$ docker update --restart=always hertzbeat
```
tancloud/hertzbeat : 使用拉取最新的的HertzBeat官方发布的应用镜像来启动容器,版本可查看官方镜像仓库

开始探索HertzBeat
浏览器访问 http://ip:1157/ 即可开始探索使用HertzBeat，默认账户密码 admin/hertzbeat。

HAVE FUN

Docker部署常见问题

最多的问题就是网络问题，请先提前排查

MYSQL,TDENGINE或IotDB和HertzBeat都Docker部署在同一主机上，HertzBeat使用localhost或127.0.0.1连接数据库失败
此问题本质为Docker容器访问宿主机端口连接失败，由于docker默认网络模式为Bridge模式，其通过localhost访问不到宿主机。
解决办法一：配置application.yml将数据库的连接地址由localhost修改为宿主机的对外IP
解决办法二：使用Host网络模式启动Docker，即使Docker容器和宿主机共享网络 docker run -d --network host .....
按照流程部署，访问 http://ip:1157/ 无界面
请参考下面几点排查问题：
一：若切换了依赖服务MYSQL数据库，排查数据库是否成功创建，是否启动成功二：HertzBeat的配置文件 application.yml 里面的依赖服务IP账户密码等配置是否正确
三：若都无问题可以 docker logs hertzbeat 查看容器日志是否有明显错误，提issue或交流群或社区反馈
日志报错TDengine连接或插入SQL失败
一：排查配置的数据库账户密码是否正确，数据库是否创建
二：若是安装包安装的TDengine2.3+，除了启动server外，还需执行 systemctl start taosadapter 启动 adapter
监控历史图表长时间都一直无数据
一：Tdengine或IoTDB是否配置，未配置则无历史图表数据
二：Tdengine的数据库hertzbeat是否创建三: HertzBeat的配置文件 application.yml 里面的依赖服务 IotDB或Tdengine IP账户密码等配置是否正确
监控页面历史图表不显示，弹出 [无法提供历史图表数据，请配置依赖时序数据库]
如弹窗所示，历史图表展示的前提是需要安装配置hertzbeat的依赖服务 - 安装初始化此数据库参考 TDengine安装初始化或 IoTDB安装初始化
安装配置了时序数据库，但页面依旧显示弹出 [无法提供历史图表数据，请配置依赖时序数据库]
请检查配置参数是否正确 iot-db 或td-engine enable 是否设置为true 注意⚠️若hertzbeat和IotDB，TDengine都为docker容器在同一主机下启动，容器之间默认不能用127.0.0.1通讯，改为主机IP 可根据logs目录下启动日志排查

Docker部署常见问题​

Docker部署常见问题