|
|
@@ -17,7 +17,7 @@ sidebar_label: Docker方式部署
|
|
|
2. 拉取HertzBeat Docker镜像
|
|
|
镜像版本TAG可查看[官方镜像仓库](https://hub.docker.com/r/tancloud/hertzbeat/tags)
|
|
|
```
|
|
|
- $ docker pull tancloud/hertzbeat:latest
|
|
|
+ $ docker pull tancloud/hertzbeat:[版本tag]
|
|
|
```
|
|
|
3. 配置HertzBeat的配置文件
|
|
|
在主机目录下创建application.yml，eg:/opt/application.yml
|
|
|
@@ -39,19 +39,63 @@ sidebar_label: Docker方式部署
|
|
|
|
|
|
```
|
|
|
|
|
|
-4. 启动HertzBeat Docker容器
|
|
|
+4. 配置用户配置文件(非必须,配置账户需要)
|
|
|
+ HertzBeat默认内置三个用户账户,分别为 admin/admin tom/tom@123 lili/lili
|
|
|
+ 若需要新增删除修改账户或密码，可以通过配置 `sureness.yml` 实现，若无此需求可忽略此步骤
|
|
|
+ 在主机目录下创建sureness.yml，eg:/opt/sureness.yml
|
|
|
+ 配置文件内容参考 项目仓库[/script/sureness.yml](https://gitee.com/dromara/hertzbeat/blob/master/script/sureness.yml)
|
|
|
+ 修改sureness.yml的如下部分参数：[注意⚠️sureness配置的其它默认参数需保留]
|
|
|
+
|
|
|
+ ```yaml
|
|
|
+ # 用户账户信息
|
|
|
+ # 下面有 admin tom lili 三个账户
|
|
|
+ # eg: admin 拥有[role1,role2]角色,密码为admin
|
|
|
+ # eg: tom 拥有[role1,role2,role3],密码为tom@123
|
|
|
+ # eg: lili 拥有[role1,role2],明文密码为lili, 加盐密码为1A676730B0C7F54654B0E09184448289
|
|
|
+ account:
|
|
|
+ - appId: admin
|
|
|
+ credential: admin
|
|
|
+ role: [role1,role2]
|
|
|
+ - appId: tom
|
|
|
+ credential: tom@123
|
|
|
+ role: [role1,role2,role3]
|
|
|
+ - appId: lili
|
|
|
+ # 注意 Digest认证不支持加盐加密的密码账户
|
|
|
+ # 加盐加密的密码，通过 MD5(password+salt)计算
|
|
|
+ # 此账户的原始密码为 lili
|
|
|
+ credential: 1A676730B0C7F54654B0E09184448289
|
|
|
+ salt: 123
|
|
|
+ role: [role1,role2]
|
|
|
+ ```
|
|
|
+
|
|
|
+6. 启动HertzBeat Docker容器
|
|
|
```
|
|
|
- $ docker run -d -p 1157:1157 -v /opt/application.yml:/opt/hertzbeat/config/application.yml --name hertzbeat tancloud/hertzbeat:latest
|
|
|
+ $ docker run -d -p 1157:1157 -v /opt/application.yml:/opt/hertzbeat/config/application.yml -v /opt/sureness.yml:/opt/hertzbeat/config/sureness.yml --name hertzbeat tancloud/hertzbeat:[版本tag]
|
|
|
526aa188da767ae94b244226a2b2eec2b5f17dd8eff592893d9ec0cd0f3a1ccd
|
|
|
```
|
|
|
这条命令启动一个运行HertzBeat的Docker容器，并且将容器的1157端口映射到宿主机的1157端口上。若宿主机已有进程占用该端口，则需要修改主机映射端口。
|
|
|
- docker run -d : 通过Docker运行一个容器,使其在后台运行
|
|
|
- -p 1157:1157 : 映射容器端口到主机端口
|
|
|
- - -v /opt/application.yml:/opt/hertzbeat/config/application.yml : 挂载上一步修改的本地配置文件到容器中，即使用本地配置文件覆盖容器配置文件。我们需要修改此配置文件的MYSQL，TDengine配置信息来连接外部服务。
|
|
|
+ - -v /opt/application.yml:/opt/hertzbeat/config/application.yml : 挂载上上一步修改的本地配置文件到容器中，即使用本地配置文件覆盖容器配置文件。我们需要修改此配置文件的MYSQL，TDengine配置信息来连接外部服务。
|
|
|
+ - -v /opt/sureness.yml:/opt/hertzbeat/config/sureness.yml : (非必须)挂载上一步修改的账户配置文件到容器中，若无修改账户需求可删除此命令参数。
|
|
|
- --name hertzbeat : 命名容器名称 hertzbeat
|
|
|
- - tancloud/hertzbeat:latest : 使用拉取的HertzBeat官方发布的应用镜像来启动容器
|
|
|
-
|
|
|
-5. 开始探索HertzBeat
|
|
|
- 浏览器访问 http://ip:1157/console 开始使用HertzBeat进行监控告警。默认账户密码 admin/admin
|
|
|
+ - tancloud/hertzbeat:[版本tag] : 使用拉取的HertzBeat官方发布的应用镜像来启动容器,TAG可查看[官方镜像仓库](https://hub.docker.com/r/tancloud/hertzbeat/tags)
|
|
|
+
|
|
|
+7. 开始探索HertzBeat
|
|
|
+ 浏览器访问 http://ip:1157/console 开始使用HertzBeat进行监控告警。
|
|
|
+
|
|
|
+**HAVE FUN**
|
|
|
+
|
|
|
+### Docker部署常见问题
|
|
|
+
|
|
|
+1. **MYSQL,TDENGINE和HertzBeat都Docker部署在同一主机上，HertzBeat使用localhost或127.0.0.1连接数据库失败**
|
|
|
+此问题本质为Docker容器访问宿主机端口连接失败，由于docker默认网络模式为Bridge模式，其通过localhost访问不到宿主机。
|
|
|
+> 解决办法一：配置application.yml将数据库的连接地址由localhost修改为宿主机的对外IP
|
|
|
+> 解决办法二：使用Host网络模式启动Docker，即使Docker容器和宿主机共享网络 `docker run -d --network host .....`
|
|
|
+
|
|
|
+2. **按照流程部署，访问 http://ip:1157/console 无界面**
|
|
|
+请参考下面几点排查问题：
|
|
|
+> 一：依赖服务MYSQL数据库，TDENGINE数据库是否已按照启动成功，对应hertzbeat数据库是否已创建，SQL脚本是否执行
|
|
|
+> 二：HertzBeat的配置文件 `application.yml` 里面的依赖服务IP账户密码等配置是否正确
|
|
|
+> 三：若都无问题可以 `docker logs hertzbeat` 查看容器日志是否有明显错误，提issue或交流群或社区反馈
|
|
|
|
|
|
-**HAVE FUN**
|
tomsun28