使用NubesGen部署Quarkus应用全指南

前言

Quarkus作为新一代Java框架，以其快速启动和低内存消耗著称，非常适合云原生应用开发。本文将详细介绍如何通过NubesGen平台将Quarkus应用部署到Azure云环境，涵盖JVM模式和原生模式两种部署方式。

环境准备

在开始部署前，请确保已准备好以下环境：

1. Bash终端：Linux和MacOS系统已内置，Windows用户建议使用WSL
2. Azure CLI工具：用于Azure资源管理和身份验证
3. Git工具：用于代码版本控制

教程一：JVM模式部署Quarkus应用

第一步：创建Quarkus项目

使用Quarkus官方提供的项目生成器快速创建基础项目：

curl https://code.quarkus.io/d?e=resteasy-jackson&e=resteasy&cn=code.quarkus.io | tar -xzvf -

此命令会创建一个包含RESTEasy和Jackson扩展的基础Quarkus项目。

第二步：初始化Git仓库

cd code-with-quarkus
git init
git add .
git commit -m "first commit"
git remote add origin https://github.com/<your-github-account>/code-with-quarkus.git
git branch -M main
git push -u origin main

第三步：配置NubesGen GitOps

./nubesgen-cli-linux gitops

此步骤会初始化GitOps工作流，实现基础设施即代码(IaC)的自动化管理。

第四步：生成NubesGen配置

curl "https://nubesgen.com/demo.tgz?runtime=quarkus&application=app_service.standard&gitops=true" | tar -xzvf -

注意这里使用的是quarkus参数，表示JVM模式部署。

第五步：创建开发分支并推送

git checkout -b env-dev
git add .
git commit -m 'Configure GitOps with NubesGen'
git push --set-upstream origin env-dev

第六步：验证部署

1. 在GitHub Actions中查看部署流程
2. 在Azure门户中查看创建的资源
3. 访问应用URL验证部署结果

教程二：原生模式部署Quarkus应用

原生模式部署与JVM模式的主要区别在于使用了GraalVM进行提前编译，能获得更好的启动性能和更小的内存占用。

关键区别点

1. 在生成NubesGen配置时使用quarkus_native参数：

curl "https://nubesgen.com/demo.tgz?runtime=quarkus_native&application=app_service.standard&gitops=true" | tar -xzvf -

2. 部署后的应用将以容器形式运行，而非直接运行在JVM上

创建的Azure资源详解

无论采用哪种部署模式，NubesGen都会创建以下核心资源：

1. App Service计划：定义计算资源的规格和定价层
2. App Service实例：实际运行应用的托管服务
   • JVM模式：配置为Java运行环境
   • 原生模式：配置为Docker容器环境

自动配置的环境变量

NubesGen会自动配置以下Quarkus标准环境变量，实现开箱即用的云服务集成：

环境变量	用途
QUARKUS_DATASOURCE_JDBC_URL	数据库JDBC连接地址
QUARKUS_DATASOURCE_USERNAME	数据库用户名
QUARKUS_DATASOURCE_PASSWORD	数据库密码
QUARKUS_REDIS_HOSTS	Redis连接配置
QUARKUS_MONGODB_DATABASE	MongoDB数据库名
QUARKUS_MONGODB_HOSTS	MongoDB连接URI
AZURE_STORAGE_*	Azure存储账户相关配置

清理资源

完成测试后，请务必清理Azure资源以避免产生不必要的费用：

1. 删除应用资源组：rg-demo-XXXX-XXXX-XXXX-XXXX-001
2. 删除Terraform状态存储账户：位于rg-terraform-001资源组中

总结

通过NubesGen部署Quarkus应用，开发者可以：

1. 快速实现从开发到生产的全流程自动化
2. 灵活选择JVM或原生模式部署
3. 轻松集成各类Azure云服务
4. 通过GitOps实现基础设施的版本控制和自动化管理

无论您是Quarkus初学者还是经验丰富的开发者，NubesGen都能显著简化您的云原生应用部署流程。