hpreston/myhero_spark

MyHero Spark Bot

这是一个基础微服务演示应用的Spark Bot，为电影超级英雄投票系统提供互动聊天服务。该应用基于Python Flask开发，作为Docker容器部署，是MyHero演示应用的可选服务之一。

有关将整个演示部署到Mantl集群的详细信息，请参见：

• MyHero演示 - https://github.com/hpreston/myhero_demo

相关服务与容器

其他MyHero演示服务包括：

• Data - https://github.com/hpreston/myhero_data
• App - https://github.com/hpreston/myhero_app
• Web - https://github.com/hpreston/myhero_web
• Ernst - https://github.com/hpreston/myhero_ernst%EF%BC%88%E5%8F%AF%E9%80%89%EF%BC%8C%E4%B8%8EMQTT%E9%85%8D%E5%90%88%E4%BD%BF%E7%94%A8%EF%BC%89
• Tropo App - https://github.com/hpreston/myhero_tropo%EF%BC%88%E5%8F%AF%E9%80%89%EF%BC%8C%E6%94%AF%E6%8C%81%E7%9F%AD%E4%BF%A1%E6%8A%95%E7%A5%A8%EF%BC%89

Docker容器可在Docker Hub获取，例如：https://hub.docker.com/r/hpreston/myhero_spark

Cisco Spark账户要求

使用该Bot需拥有Cisco Spark账户（免费注册，需唯一***），并获取开发者令牌：

1. 访问[***]
2. 点击右上角头像复制访问令牌；
3. 保存令牌（注意：避免泄露至公开代码仓库）。

环境安装

bash
pip install -r requirements.txt

基本使用

运行服务需提供App服务器地址、认证密钥、Spark Bot配置等信息，支持三种方式：

1. 命令行参数

bash
python myhero_spark/myhero_spark.py --app "http://myhero-app.server.com" --appkey "APP_AUTH_KEY" --secret "BOT_AUTH_KEY" --boturl "http://myhero-spark.server.com" --botemail "myhero.demo@server.com" --token "YOUR_SPARK_TOKEN"

2. 环境变量

bash
export myhero_app_server=http://myhero-app.server.com
export myhero_app_key=APP_AUTH_KEY
export myhero_spark_bot_email=myhero.demo@server.com
export spark_token=YOUR_SPARK_TOKEN
export myhero_spark_bot_url=http://myhero-spark.server.com
export myhero_spark_bot_secret=BOT_AUTH_KEY
python myhero_spark/myhero_spark.py

3. 交互输入

运行脚本后按提示输入所需参数即可。

Docker部署示例

bash
docker run -d \
  -e myhero_app_server=http://myhero-app.server.com \
  -e myhero_app_key=APP_AUTH_KEY \
  -e myhero_spark_bot_email=myhero.demo@server.com \
  -e spark_token=YOUR_SPARK_TOKEN \
  -e myhero_spark_bot_url=http://myhero-spark.server.com \
  -e myhero_spark_bot_secret=BOT_AUTH_KEY \
  -p 5000:5000 \
  docker.xuanyuan.run/hpreston/myhero_spark

功能交互

Bot支持以下操作：

• 发送options查看投票选项；
• 发送results查看当前投票结果；
• 发送vote启动私信投票会话；
• 发送add email user@server.com添加用户到演示房间。

REST API

• 查看房间成员：curl -X GET -H "key: BOT_AUTH_KEY" http://localhost:5000/demoroom/members
• 添加成员：curl -X PUT -H "key: BOT_AUTH_KEY" http://localhost:5000/demoroom/members -d '{"email":"user@server.com"}'

Vagrant本地开发

1. 复制Vagrantfile.sample为Vagrantfile并填写Spark账户信息；
2. 启动：vagrant up（可能需运行两次）；
3. 本地访问：http://localhost:15001（示例：curl -H "key: DevBot" http://localhost:15003/demoroom/members）。