hpreston/myhero_ernst

MyHero Ernst服务

镜像概述

本镜像为MyHero Demo微服务演示应用的投票处理服务，基于Python Flask框架开发，以Docker容器形式部署。该服务主要功能是订阅MQTT服务器接收投票数据并进行处理，是MyHero Demo整体架构中的核心组件之一。

核心功能

• 订阅MQTT服务器获取投票数据并完成处理
• 提供v1（无认证，将被移除）和v2（需认证）两个版本的API接口，支持投票选项管理、投票提交及结果查询
• 支持通过命令行参数、环境变量或交互输入三种方式配置服务参数

使用场景

• MyHero Demo微服务架构演示中的投票流程处理
• 本地开发或测试环境中MQTT消息处理的场景验证

配置说明

环境依赖

需依赖MQTT服务器（如Mosca），MyHero Demo默认使用Mosca作为MQTT服务端。

配置方式

服务运行需提供数据服务器地址、认证密钥、MQTT服务器信息等参数，支持以下三种配置方式：

1. 命令行参数：

   bash
   python myhero_ernst/myhero_ernst.py --dataserver "http://myhero-data.server.com" --datakey "DATA_AUTH_KEY" --appsecret "APP_AUTH_KEY" --mqtthost "192.168.1.10" --mqttport "1883" --mqttserver "mqtt.service.consul"
   

2. 环境变量：

   bash
   export myhero_data_server="http://myhero-data.server.com"
   export myhero_data_key="DATA_AUTH_KEY"
   export myhero_mqtt_host=192.168.1.10
   export myhero_mqtt_port=1883
   export myhero_mqtt_server=mqtt.service.consul
   python myhero_ernst/myhero_ernst.py
   

3. 交互输入：运行脚本后按提示输入所需参数。

Docker部署示例

bash
docker run -d \
  -e myhero_data_server="http://myhero-data:5000" \
  -e myhero_data_key="YOUR_DATA_KEY" \
  -e myhero_mqtt_host="mqtt-server" \
  -e myhero_mqtt_port=1883 \
  -p 5000:5000 \
  docker.xuanyuan.run/hpreston/myhero_ernst

API接口

v1接口（无认证，将被废弃）

• 获取英雄选项列表：curl http://localhost:5000/hero_list
• 查询投票结果：curl http://localhost:5000/results
• 提交投票：curl http://localhost:5000/vote/<HERO_NAME>

v2接口（需认证）

• 获取投票选项：curl -X GET -H "key: APP_AUTH_KEY" http://localhost:5000/options
• 添加新选项：curl -X PUT -H "key: APP_AUTH_KEY" http://localhost:5000/options -d '{"option":"Deadpool"}'
• 替换选项列表：curl -X POST -H "key: APP_AUTH_KEY" http://localhost:5000/options -d @sample_post.json
• 删除选项：curl -X DELETE -H "key: APP_AUTH_KEY" http://localhost:5000/options/Deadpool
• 提交投票：curl -X POST -H "key: APP_AUTH_KEY" http://localhost:5000/vote/Deadpool
• 查询结果：curl -X GET -H "key: APP_AUTH_KEY" http://localhost:5000/results

本地开发（Vagrant）

通过Vagrant启动CentOS7虚拟机进行本地开发：

1. 执行vagrant up（可能需运行两次）
2. 通过localhost:15001访问服务，示例：curl -H "key: DevApp" http://localhost:15001/options （环境变量已在Vagrant配置中预设）