如何快速部署 Open Event Android 生成器:Docker、Kubernetes 与 AWS/GCP/DigitalOcean 多云实战指南

原创2026-10-12 18:58:361,908 阅读

如何快速部署 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 生成器是什么?

整个生成器由三部分协作完成,理解架构图后,后面所有部署方式都变得直白:

Open Event Android App Generator 架构图:Flask 框架、Celery 任务队列与 Redis 协作

  • Flask Web 框架:接收请求,用户点击"GENERATE ANDROID APP"后,process 函数 把任务 payload 写入 Redis 队列
  • Celery Job Queue + Redis:后台 worker 从 Redis 拉取任务,执行真正的生成工作
  • Android SDK + JDK + Gradle:worker 用它们编译、签名出最终的 release APK

生成的应用既可以直接下载,也能通过邮箱送达。下面是生成器运行后的实际界面,上传 zip 或填写 API 地址后点击按钮即可开工:

Open Event Android APK 生成器 Web 界面:填写邮箱、选择数据来源并生成 Android 应用

任务提交后,web 端会立即创建 Celery 任务并返回状态,具体代码逻辑可见 generator.py 中的 normalize 与 generate 方法:

Open Event Android 生成器后端 process 函数代码截图:提交表单后创建 Celery 任务写入 Redis

worker 侧则由 generate_app_task 在后台执行构建,任务代码见 celery_task 处理流程:

Open Event Android 生成器 Celery 后台任务代码截图:generate_app_task 调用 generator 生成 APK

方案一: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 的集群

  1. 先部署 Open Event Orga Server(使用 nextgen 分支配置),再回到本仓库
  2. 为生成器申请独立域名(或子域名),把集群的 External IP 添加为域名 DNS 的 A 记录
  3. 把你的域名写入 ingress-notls.yml 与 ingress-tls.yml(替换 droidgen.eventyay.com)
  4. 执行部署:
./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 连接的规则,效果如下:

AWS EC2 安全组配置截图:添加允许 HTTP 连接入站的规则

第 7 步点击 Launch 时创建新密钥对(如命名为 mykey)并下载。⚠️ 请妥善保存私钥,丢失意味着失去服务器访问权:

AWS EC2 密钥对创建截图:新建 mykey 密钥对并下载私钥文件

实例创建后点击 Connect,按提示用 SSH 登录(在私钥所在目录执行):

AWS EC2 实例 SSH 连接指引截图:chmod 400 私钥后用 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。

  1. 创建 Ubuntu x64 Droplet,内存至少 1 GB(512 MB 实测不够用)
  2. 创建后邮箱会收到 Droplet 的 IP、用户名与密码:

DigitalOcean Droplet 创建完成邮件截图:包含服务器 IP 地址、用户名与初始密码

  1. SSH 登录并按提示强制修改密码:
ssh root@104.236.228.132
  1. 安装 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 的生产集群中。🚀

登录后查看全文
open-event-android