sensnet/crontab

镜像概述

该Docker镜像用于部署集成crontab定时任务的应用服务，支持开发环境构建与生产环境部署，提供用户交互、数据上报等API接口，需通过环境变量配置，适用于需要定时任务调度和API服务的应用场景。

核心功能与特性

• 多环境支持：提供开发环境（Dev Build）和生产环境（Deploy Build）构建方式
• 容器编排：支持docker-compose进行服务编排与状态管理
• API服务：包含用户头像上传、事件上报、位置获取等接口
• 定时任务：集成crontab定时任务功能
• 环境配置：通过环境变量文件进行服务参数配置

使用场景

• 开发环境下的应用功能测试与调试
• 生产环境的服务部署与运行
• 需要定时任务调度的应用场景
• 需要API接口进行用户交互和数据处理的服务

使用方法

开发环境构建与运行

bash
# 直接构建
./build develop

# 或使用docker-compose构建并运行
docker-compose build
docker-compose up -d

# 查看服务状态
docker-compose ps

生产环境部署

bash
# 在CI环境或本地部署（需提前准备env文件夹）
docker-compose -p sensnet -f docker-compose.deploy.yml pull
docker-compose -p sensnet -f docker-compose.deploy.yml up -d

# 未来可能的Docker Swarm部署方式
# docker-compose -f docker-compose.deploy.yml bundle -o sensnet.dab
# 将sensnet.dab文件复制到Docker Swarm节点
# docker deploy sensnet

环境变量配置

注意：部署前需准备env文件夹，包含环境变量配置文件（具体环境变量文档待补充）。

API接口列表

已完成接口

• POST /api/user/avatar：用户头像上传
• POST /api/user/location：用户位置上报（原WS GET_LOCATION）
• GET /api/address：获取LSD地址（原WS GET_LSD_ADDRESS）
• WS /api/ws：WebSocket连接（原WS Start）
• GET /api/map：获取服务地图（原POST /postservicemap）

待测试/开发接口

• POST /api/incidents：事件上报（仅GEIOS使用，需测试和错误处理）
• POST /api/twilio/sms：Twilio短信接收（仅TWILIO使用，需测试）
• POST /api/alert/sms：发送短信告警（需测试和错误处理）
• GET /api/report/checkin：获取签到报告（需后端变更）
• GET /api/report/alert：获取告警报告（需后端变更）

TODO事项

• 为/api/address接口添加缓存功能
• 为/api/user/avatar接口添加非PNG文件的测试