Skip to content

Commit fefdc9f

Browse files
committed
docs(cat_finder): add docker port map
1 parent 4774d67 commit fefdc9f

2 files changed

Lines changed: 22 additions & 7 deletions

File tree

docs/how-to-build.zh.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -74,12 +74,12 @@ $ python3 setup.py install --user
7474

7575
P.S. 默认 ffmpeg 依赖自动从 github 上拉取源码构建,这会使得首次构建的时间较长。若希望缩短首次构建时间,或者希望依赖一个指定版本的 ffmpeg,可以启用环境变量`CARGO_FEATURE_PREBUILD`并参考[rust-ffmpeg](https://github.com/zmwangx/rust-ffmpeg/wiki/Notes-on-building)自行构建
7676

77-
## Python Examples 基础用例
77+
## Python “开机自检”用例
7878
```bash
7979
$ cd examples
8080
$ cargo run --example run_with_plugins -- -p logical_test
8181
```
82-
`logical_test` 就是 examples 下的测试用例名称,默认使用和目录同名的`logical_test.toml`做配置文件
82+
`logical_test` examples 下最基本的计算图测试用例,`logical_test`能正常结束表示 MegFlow 编译成功、基础功能无问题
8383

8484
此处常见问题:`error while loading shared libraries: libpython3.8.xxx`。如果使用 conda 只需要
8585
```bash
@@ -88,6 +88,8 @@ $ export LD_LIBRARY_PATH=/home/`whoami`/miniconda3/pkgs/python-3.8.11-h12debd9_0
8888

8989
## Python Built-in Applications
9090

91+
接下来开始运行好玩的 Python 应用
92+
9193
* [猫猫围栏运行手册](../flow-python/examples/cat_finder/README.md)
9294
* 图片注册猫猫
9395
* 部署视频围栏,注册的猫离开围栏时会发通知

flow-python/examples/cat_finder/README.md

Lines changed: 18 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -57,21 +57,31 @@ $ cargo run --example run_with_plugins -- -c cat_finder/image_gpu.toml -p cat_f
5757
$ cargo run --example run_with_plugins -- -c cat_finder/image_cpu.toml -p cat_finder # 无 GPU 的 laptop 执行这句
5858
```
5959

60-
服务配置文件在`cat_finder/image_gpu.toml`,详细解释见 [how-to-add-graph](../../../docs/how-to-add-graph.zh.md) 。这里只需要浏览器打开主机所在 8081 端口服务。
61-
62-
```bash
63-
$ google-chrome-stable http://127.0.0.1:8081/docs
64-
```
60+
现在 8081 端口部署了“猫体注册”服务,只需要打开浏览器上传图片、猫咪名称即可。`cat_finder/image_gpu.toml` 详细解释见 [how-to-add-graph](../../../docs/how-to-add-graph.zh.md) 。这里只需要浏览器打开主机所在 8081 端口服务。
6561

6662
![](images/cat_finder_image_select.jpg)
6763

64+
6865
测试图片在软链接后的 `models/cat_finder_testdata` 目录。打开浏览器 UI 中选择图片、填写名称,提交即可。成功后
6966
* 用 redis-cli `keys *`可查到对应 BASE64 特征
7067
* 前端展示检测框
7168

7269
![](images/cat_finder_image_result.jpg)
7370

7471

72+
FAQ:如果服务部署在 docker 里,,运行时容器使用端口映射,把内部的 8081 端口映射到宿主机。例如把内部容器的 8081 映射成外部物理机的 18081、把 8082 映射成 18082
73+
```bash
74+
$ docker run -p 18081:8081 -p 18082:8082 -it ubuntu /bin/bash
75+
```
76+
此时用`docker ps`可以看到 PORTS 映射关系
77+
```bash
78+
$ docker ps
79+
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
80+
d4b5b563051e ubuntu "/bin/bash" 9 seconds ago Up 8 seconds 0.0.0.0:18081->8081/tcp, :::18081->8081/tcp, 0.0.0.0:18082->8082/tcp, :::18082->8082/tcp nostalgic_swartz
81+
82+
```
83+
浏览器打开宿主机的 ip:18081 端口即可使用
84+
7585
## 视频识别
7686

7787
准备一个 rtsp 视频流地址,做测试输入(因不可抗力 MegFlow 无法提供现成地址)。模型包目录提供了测试视频,在 `models/cat_finder_testdata`,需要用户自行部署 live555 服务。最直接的办法:
@@ -127,6 +137,9 @@ $ redis-cli
127137
```
128138
`brpop notification.cat_finder` 可消费报警消息。
129139

140+
141+
FAQ:如果服务部署在 docker 里,同样可以把 8082 端口映射到宿主机端口。
142+
130143
## 模型列表
131144

132145
本服务有以下模型的痕迹

0 commit comments

Comments
 (0)