hpreston/myhero_app

MyHero App服务

镜像概述

这是基础微服务演示应用的App服务，为用户投票选择喜爱的电影超级英雄提供逻辑层支持。该应用基于Python Flask开发，以Docker容器形式部署，是MyHero系列微服务（含数据、Web、可选MQTT队列处理、Spark Bot、Tropo短信投票等服务）的核心组件之一。

核心功能

• 提供投票系统逻辑层，支持直接调用数据服务或通过MQTT队列处理投票请求
• 提供v1（无认证）和v2（需认证）两种API接口，涵盖选项管理、投票提交、结果查询等功能
• 支持通过命令行参数、环境变量或交互输入三种方式配置服务参数
• 兼容本地Vagrant开发环境，可快速搭建测试环境

使用场景

• 微服务架构演示与学习
• 简单投票系统原型开发与测试
• 容器化应用部署实践

配置说明

必要信息配置

服务运行需提供以下信息，优先级：命令行参数 > 环境变量 > 交互输入：

1. 数据服务器地址
2. 数据服务器认证密钥
3. 应用服务器认证密钥

命令行参数示例：

bash
python myhero_app/myhero_app.py --dataserver "http://myhero-data.server.com" --datakey "DATA_AUTH_KEY" --appsecret "APP_AUTH_KEY"

环境变量示例：

bash
export myhero_data_server="http://myhero-data.server.com"
export myhero_data_key="DATA_AUTH_KEY"
export myhero_app_key="APP_AUTH_KEY"
python myhero_app/myhero_app.py

投票处理模式

• 直接模式（默认）：App服务直接调用数据服务处理投票
• 队列模式：需部署MQTT服务器（如Mosca）和myhero_ernst服务，投票请求通过队列转发处理
  启用方式：添加命令行参数--mode queue或设置环境变量myhero_app_mode=queue

API访问

v1 API（无认证，将逐步移除）

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

v2 API（需认证，添加-H "key: APP_AUTH_KEY"）

• 获取投票选项：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

Docker部署示例

bash
# 直接模式部署
docker run -d \
  -e myhero_data_server="http://myhero-data.server.com" \
  -e myhero_data_key="DATA_AUTH_KEY" \
  -e myhero_app_key="APP_AUTH_KEY" \
  -p 5000:5000 \
  hpreston/myhero_app

# 队列模式部署（需提前部署MQTT服务器和myhero_ernst服务）
docker run -d \
  -e myhero_data_server="http://myhero-data.server.com" \
  -e myhero_data_key="DATA_AUTH_KEY" \
  -e myhero_app_key="APP_AUTH_KEY" \
  -e myhero_app_mode=queue \
  -p 5000:5000 \
  hpreston/myhero_app

本地Vagrant开发

仓库包含Vagrant配置文件，可快速搭建CentOS7虚拟机环境：

1. 执行vagrant up（可能需运行两次）启动Docker主机和容器
2. 通过本地localhost:15001访问服务（示例：curl -H "key: DevApp" http://localhost:15001/options）
3. 环境变量已在Vagrantfile中配置，支持多服务同时本地开发