如何快速部署 Open Event Android 生成器:Docker、Kubernetes 与 AWS/GCP/DigitalOcean 多云实战指南
如何快速部署 Open Event Android 生成器:Docker、Kubernetes 与 AWS/GCP/DigitalOcean 多云实战指南
Open Event Android 是 FOSSASIA 的开源项目,其核心组件 App Generator(APK 生成器) 是一个 Web 服务:你只需上传活动数据(zip 包或 API 地址),它就能自动定制源码、打包并签名,生成专属活动的 Android 应用 APK。本文将带你用 Docker、Kubernetes(GCP)、AWS EC2 和 DigitalOcean Droplet 四种方式快速部署 Open Event Android 生成器,并附本地手动部署方案,帮你一次跑通全部环境。
Open Event Android 生成器是什么?
整个生成器由三部分协作完成,理解架构图后,后面所有部署方式都变得直白:
- Flask Web 框架:接收请求,用户点击"GENERATE ANDROID APP"后,process 函数 把任务 payload 写入 Redis 队列
- Celery Job Queue + Redis:后台 worker 从 Redis 拉取任务,执行真正的生成工作
- Android SDK + JDK + Gradle:worker 用它们编译、签名出最终的 release APK
生成的应用既可以直接下载,也能通过邮箱送达。下面是生成器运行后的实际界面,上传 zip 或填写 API 地址后点击按钮即可开工:
任务提交后,web 端会立即创建 Celery 任务并返回状态,具体代码逻辑可见 generator.py 中的 normalize 与 generate 方法:
worker 侧则由 generate_app_task 在后台执行构建,任务代码见 celery_task 处理流程:
方案一:Docker 一键部署(最快上手)
Docker 方式是最省心的选择:docker-compose.yml 已内置 redis 和 web 两个服务,一条命令即可拉起完整环境。完整教程见 docs/installation/docker.md。
前置要求
- 安装最新版 Docker 与 docker-compose
- 执行
docker和docker-compose命令确认安装成功
构建与启动步骤
git clone https://gitcode.com/gh_mirrors/op/open-event-android.git && cd open-event-android
export SERVER_NAME=localhost
docker-compose build
docker-compose up
📌 关于 SERVER_NAME:它必须与服务器实际使用的域名一致,不能包含 http、https、www 或结尾斜杠,例如 domain.com、sub.domain.com:5000。
构建完成后浏览器访问 localhost,生成器即已上线。
更新与守护模式
| 场景 | 命令 |
|---|---|
| 更新镜像到最新版本 | docker-compose build 后 docker-compose up |
| 后台守护运行(终端关闭不中断) | docker-compose up -d |
方案二:Kubernetes(GCP)容器集群部署
适合需要长期稳定运行、可自动健康检查的生产场景。官方教程见 docs/installation/gce-kubernetes.md,部署脚本 kubernetes/deploy.sh 封装了全部 kubectl 操作。
模式 1:依赖 Open Event API Server 的集群
- 先部署 Open Event Orga Server(使用
nextgen分支配置),再回到本仓库 - 为生成器申请独立域名(或子域名),把集群的 External IP 添加为域名 DNS 的
A记录 - 把你的域名写入 ingress-notls.yml 与 ingress-tls.yml(替换
droidgen.eventyay.com) - 执行部署:
./kubernetes/deploy.sh create
部署完成后即可通过域名访问。
模式 2:独立部署(Standalone)
若没有现成集群,可先在 GCP 上用 gcloud 创建集群并安装 kubectl,然后:
gcloud config set compute/zone us-west1-a
gcloud container clusters create droidgen-cluster --cluster-version=1.6.4 --num-nodes=1
gcloud container clusters get-credentials droidgen-cluster
./kubernetes/deploy.sh standalone-create
随后查询 ingress 获取访问 IP(可能需执行多次直到 IP 分配完成):
kubectl get ingress --namespace web android-generator-notls
💡 独立模式会额外部署 Redis 命名空间,YAML 文件位于 yamls/standalone/;卸载用 ./kubernetes/deploy.sh standalone-delete。
容器内启动逻辑统一由 kubernetes/run.sh 完成——先起 Celery worker,再起 Gunicorn 监听 8080 端口;镜像则由 kubernetes/images/generator/Dockerfile 构建,其中预装了 JDK 8、Android SDK 与构建依赖。android-deployment.yml 还配置了 /health-check/ 存活探针,保证服务异常时自动重启。
方案三:AWS EC2 云上实战
AWS 部署分三个阶段,完整步骤见 docs/installation/aws.md。
Phase 1:创建 EC2 实例
在 AWS 控制台创建 Ubuntu x64 实例。第 6 步"配置安全组"时,添加一条允许所有 HTTP 连接的规则,效果如下:
第 7 步点击 Launch 时创建新密钥对(如命名为 mykey)并下载。⚠️ 请妥善保存私钥,丢失意味着失去服务器访问权:
实例创建后点击 Connect,按提示用 SSH 登录(在私钥所在目录执行):
chmod 400 mykey.pem
ssh -i "mykey.pem" ubuntu@ec2-52-41-207-116.us-west-2.compute.amazonaws.com
登录后安装语言包 sudo apt-get install language-pack-en。
Phase 2:安装 Docker 与 Docker Compose
sudo apt-get update
sudo apt-get install apt-transport-https ca-certificates
sudo apt-get install -y docker-engine
sudo apt-get -y install python-pip
sudo pip install docker-compose
sudo usermod -a -G docker $(whoami)
最后一步后需重新登录 SSH 使 docker 组权限生效。
Phase 3:构建并运行生成器
git clone https://gitcode.com/gh_mirrors/op/open-event-android.git && cd open-event-android
export SERVER_NAME="ec2-52-41-207-116.us-west-2.compute.amazonaws.com"
docker-compose build
docker-compose up
访问实例的 Public DNS 即可看到在线的生成器。生产环境建议改用 docker-compose up -d 守护运行。
方案四:DigitalOcean Droplet 部署
DigitalOcean 的思路同样是"装 Docker → 跑镜像",教程见 docs/installation/digital-ocean.md。
- 创建 Ubuntu x64 Droplet,内存至少 1 GB(512 MB 实测不够用)
- 创建后邮箱会收到 Droplet 的 IP、用户名与密码:
- SSH 登录并按提示强制修改密码:
ssh root@104.236.228.132
- 安装 Docker 与 Docker Compose(步骤同 AWS Phase 2),然后:
git clone https://gitcode.com/gh_mirrors/op/open-event-android.git && cd open-event-android
export SERVER_NAME=104.236.228.132
docker-compose build
docker-compose up -d
访问 Droplet 的 IP 地址即完成部署。
⚠️ 常见坑:仅用 IP 访问时可能遇到浏览器登录失败问题(Chrome 已知行为),解决办法是给 Droplet 绑定一个域名;同时 SERVER_NAME 要与实际访问的域名/IP 保持一致。
方案五:本地手动部署(无 Docker)
如果需要在裸机或定制环境运行,官方提供了 docs/installation/generic.md 教程,核心依赖为 Ubuntu 14.04+、Python 2.7、JDK 8、Android SDK 与 Redis。环境要求详见 apk-generator/v2/README.md,需设置以下环境变量:
ANDROID_HOME、GENERATOR_WORKING_DIR、KEYSTORE_PATH、KEYSTORE_PASSWORD、KEY_ALIAS(必填)REDIS_URL、SECRET_KEY、INTEGRATE_SOCKETIO(可选)
启动流程:在 apk-generator/v2/ 目录下执行 sudo -H pip install -r requirements.txt 安装依赖,配置 APP_CONFIG=config.ProductionConfig 与 REDIS_URL,然后分别在两个终端启动:
celery worker -A app.celery --loglevel=INFO
gunicorn -b 0.0.0.0:8080 app:app --enable-stdio-inheritance --log-level "info"
浏览器访问 http://localhost:8080 即可。APK 构建与签名由 build_apk.sh 脚本完成,配置项定义在 config.py 中。
四种方案对比与选择建议
| 方案 | 上手难度 | 适用场景 | 参考文档 |
|---|---|---|---|
| Docker Compose | ⭐ 最简单 | 个人试用、快速验证 | docker.md |
| Kubernetes (GCP) | ⭐⭐⭐ | 生产环境、高可用集群 | gce-kubernetes.md |
| AWS EC2 | ⭐⭐ | 已有 AWS 资源、公网部署 | aws.md |
| DigitalOcean | ⭐⭐ | 轻量 VPS、低成本长期运行 | digital-ocean.md |
| 手动部署 | ⭐⭐⭐⭐ | 裸机定制、学习原理 | generic.md |
部署常见问题清单
- ✅
SERVER_NAME是什么? 服务访问域名,不含协议前缀与www,不含结尾/ - ✅ 服务随终端关闭而停止? 改用
docker-compose up -d或 nohup 后台运行 - ✅ 内存不够? 生成 APK 会触发 Gradle 构建,Docker 环境建议 1 GB 以上内存
- ✅ 如何更新? 重新
docker-compose build后docker-compose up -d即可
按本文路径走一遍,你既能 5 分钟用 Docker 跑起开发环境,也能把 Open Event Android 生成器稳稳部署到 GCP Kubernetes、AWS 或 DigitalOcean 的生产集群中。🚀







