aprsme/app

APRSme镜像说明

镜像概述

APRSme镜像为APRS（自动位置报告系统）相关应用提供本地开发环境，集成RabbitMQ、PostgreSQL等依赖服务，支持应用的开发、测试与功能调试，帮助开发者快速搭建完整的运行环境。

核心功能

1. 依赖服务启动：通过docker-compose启动RabbitMQ、APRS数据摄入服务及PostgreSQL数据库
2. 应用运行：支持Mix命令安装依赖、启动Web服务器、数据库迁移与种子数据生成
3. 消息监控：提供RabbitMQ管理界面及脚本工具，用于查看消息队列的发布与消费状态
4. 测试支持：集成测试命令，方便开发者进行单元测试与功能验证

使用场景

• APRSme应用的本地开发与调试
• 业余无线电数据处理功能的验证与测试
• 消息队列相关功能的故障排查

配置说明

需设置以下环境变量（Dokku部署时必填）：

• DATABASE_URL：数据库连接地址
• RABBITMQ_URL：RabbitMQ连接地址
• SECRET_KEY_BASE：应用密钥
• DOKKU_LETSENCRYPT_EMAIL：Let's Encrypt证书***
• HOSTNAME：应用域名

部署示例

启动依赖服务

bash
docker-compose -f docker-compose-dev.yml up

运行应用

1. 安装依赖：

bash
mix deps.get

2. 启动Web服务器：

bash
iex -S mix phx.server

3. 数据库迁移：

bash
mix ecto.migrate

4. 生成种子数据与管理员用户：

bash
mix run priv/repo/seeds.exs

访问 http://127.0.0.1:4000/ 即可查看通过WebSocket接收的APRS消息。

故障排查

• 查看RabbitMQ管理界面：http://localhost:15672/（默认账号密码见docker-compose.yml）
• 检查消息发布速率：

bash
curl -s -u guest:guest http://localhost:15672/api/exchanges/aprs/aprs:messages | jq '.message_stats .publish_in_details .rate'

• 检查消息消费速率：

bash
curl -s -u guest:guest http://localhost:***/api/queues/aprs/aprs:archive | jq '.message_stats .deliver_get_details .rate'