如何快速部署绿豆APP源码到服务器？

在实际项目交付中，绿豆APP源码的上线往往是时间紧迫的节点。本文从服务器选型、依赖安装到源码拉取、环境变量配置，逐层剖析每一步骤的要点，帮助技术人员在最短时间内完成部署，避免因细节疏漏导致的反复调试。

一、服务器与运行环境的选型

大多数情况下，Ubuntu 22.04 LTS 或 CentOS 8 以其长期支持和成熟的包管理系统成为首选。若已有 Docker 环境，建议直接使用容器化部署，以实现环境隔离和快速回滚。

• CPU：最低 2 核，推荐 4 核以上；
• 内存：4 GB 起步，业务高峰期建议 8 GB；
• 磁盘：SSD 100 GB，确保日志与缓存空间充足；
• 网络：对外 HTTPS 端口 443 必须开放，若使用第三方广告 SDK，额外打开 80/443/8080 等端口。

二、获取源码并初始化项目

绿豆APP源码托管在 GitHub 私有仓库，克隆前需在服务器上配置 SSH 公钥或使用 HTTPS 方式的访问令牌。下面的代码示例演示了两种常见的拉取方式。

# 使用 SSH
git clone git@github.com:your-org/green-bean-app.git /opt/green-bean

# 使用 HTTPS + Token
git clone https://your-token@github.com/your-org/green-bean-app.git /opt/green-bean

克隆完成后，进入项目根目录执行 ./gradlew clean build，确保所有依赖可以顺利下载。若网络受限，可在 gradle.properties 中配置国内镜像。

三、关键环境变量与配置文件的准备

绿豆APP依赖外部服务（如广告平台、支付网关、对象存储），这些信息均通过环境变量注入。推荐使用 .env 文件统一管理，Docker Compose 会自动读取。

• APP_PORT=8080
• DB_URL=jdbc:mysql://db-host:3306/greenbean?characterEncoding=utf8
• DB_USER=gb_user
• DB_PASSWORD=******
• AD_PROVIDER_KEY=xxxxxxxxxxxx

完成后，执行 source .env 让当前 shell 读取变量，或在系统服务管理器（systemd）中声明相同的键值。

四、容器化部署或直接运行

若选用 Docker，编写简洁的 docker-compose.yml 即可实现一键启动。下面的片段展示了核心服务的定义。

version: '3.8'
services:
  app:
    image: openjdk:17-jdk
    container_name: green-bean-app
    working_dir: /app
    volumes:
      - ./green-bean:/app
    env_file:
      - .env
    command: ["java","-jar","/app/build/libs/green-bean.jar"]
    ports:
      - "${APP_PORT}:8080"
    restart: unless-stopped

执行 docker compose up -d 后，容器即在后台启动，日志可通过 docker logs -f green-bean-app 实时观察。若不使用容器，直接在服务器上运行 java -jar build/libs/green-bean.jar，并配合 nohup 与 systemd 实现守护。

五、常见故障排查要点

部署完成后，最常碰到的三类问题分别是依赖未加载、端口冲突以及数据库连接异常。下面列出快速定位的检查清单。

• 确认 JAVA_HOME 与 PATH 是否指向 JDK 17；
• 使用 netstat -tlnp | grep 8080 验证端口是否已被占用；
• 检查数据库防火墙规则，确保服务器 IP 已加入白名单；
• 查看容器内部日志，关键字 Exception 与 Caused by 能快速锁定异常根源。

掌握上述要点后，绿豆APP的上线时间可从数小时压缩到一次性完成，真正实现“写完代码，点一下按钮，服务马上跑”。