111 lines
3.3 KiB
Markdown
111 lines
3.3 KiB
Markdown
# 当前源码与开发环境说明
|
||
|
||
## 结论
|
||
|
||
当前最新版本源码不在本地 `massive-cloud-export` 目录中，而是在开发服务器 `2680v4`：
|
||
|
||
```bash
|
||
ssh 2680v4
|
||
cd /home/lipan/massive-cloud-v3
|
||
```
|
||
|
||
本地 `massive-cloud-export` 更接近旧版离线导出包或历史交付包，可作为历史留档参考；日常开发、联调和问题排查应以 `2680v4:/home/lipan/massive-cloud-v3` 为准。
|
||
|
||
## 协作方式
|
||
|
||
- 当前项目由两名开发人员共同维护。
|
||
- 日常习惯是直接 SSH 到 `2680v4` 上修改代码。
|
||
- 修改目录为 `/home/lipan/massive-cloud-v3`。
|
||
- 该目录是当前实际运行服务挂载的源码目录，代码改动会被开发模式服务读取。
|
||
- 服务器工作区可能存在其他开发人员的未提交改动，修改前应先查看状态，避免覆盖他人工作：
|
||
|
||
```bash
|
||
git status --short
|
||
```
|
||
|
||
## 外网调试入口
|
||
|
||
`http://npsx.i-llusion.cn:3002` 不是正式生产环境地址，而是开发环境的公网穿透访问地址。
|
||
|
||
访问链路为：
|
||
|
||
```text
|
||
外网浏览器
|
||
-> http://npsx.i-llusion.cn:3002
|
||
-> 内网穿透
|
||
-> 2680v4:3002
|
||
-> massive-point-cloud-app-dev
|
||
```
|
||
|
||
服务器上存在 `npc` 穿透客户端进程，连接到 `47.106.245.28:8024`，用于把 `2680v4` 上的开发服务暴露到公网，方便外网访问和调试。
|
||
|
||
## 当前运行方式
|
||
|
||
当前服务使用开发模式 Docker 编排文件运行：
|
||
|
||
```bash
|
||
cd /home/lipan/massive-cloud-v3
|
||
sudo docker compose -f docker-compose.dev.yml ps
|
||
```
|
||
|
||
关键运行信息：
|
||
|
||
- 应用容器：`massive-point-cloud-app-dev`
|
||
- 编排文件：`/home/lipan/massive-cloud-v3/docker-compose.dev.yml`
|
||
- 网络模式：`network_mode: host`
|
||
- 应用端口：`3002`
|
||
- 源码映射：`/home/lipan/massive-cloud-v3:/app`
|
||
- 依赖卷：`pointcloud-app-node-modules-dev:/app/node_modules`
|
||
- 数据目录映射：`/home/lipan/massive-cloud-v3/data:/data`
|
||
- 算法目录映射：`/home/lipan/massive-cloud-v3/alg:/alg:ro`
|
||
|
||
容器启动后会在 `/app` 中执行：
|
||
|
||
```bash
|
||
pnpm install && pnpm dev --host 0.0.0.0
|
||
```
|
||
|
||
因此，开发人员在宿主机 `/home/lipan/massive-cloud-v3` 中修改的源码，会通过 volume 映射进入容器 `/app`，由容器内的 Node/tsx 开发服务运行。
|
||
|
||
## Docker 权限
|
||
|
||
`lipan` 用户当前直接访问 Docker daemon 权限不足，管理容器时需要使用 `sudo`：
|
||
|
||
```bash
|
||
sudo docker ps
|
||
sudo docker logs -f massive-point-cloud-app-dev
|
||
sudo docker compose -f docker-compose.dev.yml ps
|
||
sudo docker compose -f docker-compose.dev.yml restart app
|
||
```
|
||
|
||
## 常用检查命令
|
||
|
||
```bash
|
||
# 登录开发服务器
|
||
ssh 2680v4
|
||
|
||
# 进入当前源码目录
|
||
cd /home/lipan/massive-cloud-v3
|
||
|
||
# 查看代码状态，注意是否有他人改动
|
||
git status --short
|
||
|
||
# 查看当前容器
|
||
sudo docker ps
|
||
|
||
# 查看应用日志
|
||
sudo docker logs -f massive-point-cloud-app-dev
|
||
|
||
# 查看 3002 端口监听
|
||
sudo ss -lntp sport = :3002
|
||
|
||
# 查看穿透进程
|
||
pgrep -af "npc|nps|frp"
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
- `massive-cloud-export` 不是当前最新开发源码目录，后续维护不要以它为准。
|
||
- 如果需要保留旧版交付材料，可以继续保留 `massive-cloud-export`；如果要清理，应先确认其中截图、部署包说明、历史交付内容是否还需要留档。
|
||
- 直接在服务器改代码时，务必先确认工作区状态，避免覆盖另一名开发人员正在修改的文件。
|