chirpstack v4版本 全流程部署[ubuntu+docker]
背景介绍
由于chirpstackv3 版本使用的是锐米提供的版本,从网络上寻找的资源大多数都是一样的v3版本,是经过别人编译好发布出来的,原本的chirpsatck项目是运行的linxu环境下的,因此我的想法是在linux服务器上部署chirpsatckv4,暂时使用linux上的chirpstack v4版本,目前编译成exe程序在windows运行的难度还较高
部署过程
下载virtualBox和ubuntu
使用VirtualBox安装Ubuntu虚拟机 - 完整教程-CSDN博客
可以参考以上的教程完成虚拟机基础环境的配置
ubuntu部署docker
【环境配置】ubuntu中 Docker的安装_ubuntu安装docker-CSDN博客
可以参考以上的教程完成docker容器的配置
docker部署chirpstack
在Linux下使用Docker部署chirpstack-CSDN博客
可以参考以上的教程完成chirpstackv4 版本的docker部署
虚拟机网卡配置
1.点击设置
2.选择网络-连接方式-桥接网卡
3.重启虚拟机更新配置
4.打开虚拟机输入 ip addr show 查看虚拟机ip
记得记住虚拟机的ip,以后访问chirpsatck需要使用
chirpstack启动
先启动docker容器,如果部署成功后docker会已经启动,如果重启后docker会关闭,需要重新启动
#进入chirpstack-docker的目录
cd chirpstack-docker
#启动chirpsatck
sudo docker-compose up -d
web访问
在本机浏览器输入
<虚拟机ip>:8080
访问chirpstack网页,账号密码都是 admin
api文档
chirpstackv4版本的api文档进行了迁移,原本的api文档是localhost:8080/api
新的api文档迁移到了8090的端口下,localhost:8090
chirpsatckv4相对于v3有较大的改动,可以参考
v4 breaking changes - ChirpStack open-source LoRaWAN® Network Server documentation
v3 版本
v4 版本
api对比
ChirpStack 使用的 API
v3版本api共13个模块
v4版本仅剩8个模块 一些接口被合并了
| 模块 | 请求方式 | URL | v4版本改动 |
|---|---|---|---|
| InternalService | post | /api/internal/login | 接口被删除 |
| ApplicationService | get | /api/applications | 接口不变,返回参数变化 |
| post | /api/applications | 接口不变,传入参数变化 | |
| DeviceProfileService | get | /api/device-profiles | 接口不变,返回参数变化 |
| get | /api/device-profiles/{id} | 接口不变,返回参数变化 | |
| post | /api/device-profiles | 接口不变,传入参数变化 | |
| DeviceQueueService | delete | /api/devices/{dev_eui}/queue | 合并到了DeviceService模块中 |
| get | /api/devices/{dev_eui}/queue | 合并到了DeviceService模块中,返回参数增加 | |
| DeviceService | post | /api/devices | 接口不变 |
| delete | /api/devices/{dev_eui} | 接口不变 | |
| get | /api/devices/{dev_eui}/activation | 接口不变,返回参数增加 | |
| post | /api/devices/{device_activation.dev_eui}/activate | 接口不变 | |
| GatewayProfileService | get | /api/gateway-profiles | 接口被删除,疑似合并到TenantService模块 |
| post | /api/gateway-profiles | 接口被删除,疑似合并到TenantService模块 | |
| MulticastGroupService | get | /api/multicast-groups | 接口不变,返回参数增加 |
| post | /api/multicast-groups | 接口不变,传入参数发生改变 | |
| get | /api/multicast-groups/{id} | 接口不变,返回参数增加 | |
| post | /api/multicast-groups/{multicast_group_id}/devices | 接口不变,传入参数减少 | |
| delete | /api/multicast-groups/{multicast_group_id}/devices/{dev_eui} | 接口不变 | |
| post | /api/multicast-groups/{multicast_queue_item.multicast_group_id}/queue | 接口不变 | |
| NetworkServerService | get | /api/network-servers | 接口被删除 |
| post | /api/network-servers | 接口被删除 | |
| OrganizationService | get | /api/organizations | 接口被删除,疑似合并到TenantService模块 |
| post | /api/organizations | 接口被删除,疑似合并到TenantService模块 | |
| ServiceProfileService | get | /api/service-profiles | 接口被删除 |
| post | /api/service-profiles | 接口被删除 |
缓存清理指令
chirpstack v4使用的主要是postgresql和redis进行数据的存储和缓存
redis清理过程
首先，进入运行Redis的Docker容器。运行redis的容器叫chirpstack-docker-redis-1
docker exec -it chirpstack-docker-redis-1 /bin/sh
进入容器后，你可以使用 <font style="color:rgb(0, 0, 0);">redis-cli</font> 来执行各种 Redis 命令。
清理所有数据:redis-cli FLUSHALL
清理特定数据库:redis-cli SELECT 0 redis-cli FLUSHDB
pgsql清理过程
首先，进入运行PostgreSQL的Docker容器。运行pgsql的容器叫做chirpstack-docker-postgres-1
docker exec -it chirpstack-docker-postgres-1- psql -U postgres
pgsql无法登陆进行数据操作,使用docker操作删除数据的方式
注意删除挂载数据卷后,redis和pgsql中的数据都会清空
//列出数据卷
docker volume ls//删除之前挂载的数据卷
docker volume rm chirpstack-docker_postgresqldata
docker volume rm chirpstack-docker_redisdata//重新启动
sudo docker-compose up -d