About

JHipster Azure Spring Apps can quickly create applications that can be deployed on Azure Spring Apps with easy steps.

Documentation about Azure Spring Apps is available here

Prerequisites

The following prerequisites are required to use this application. Please ensure that you have them all installed locally.

• Java 17 or later - for API backend
• Node.js with npm (16.13.1+) - for the Web frontend
• Maven - for local build
• Azure Subscription:
  • Try Azure for free, you can start with $200 Azure credit.
  • To help you get started, Azure Spring Apps have monthly FREE grants on all plans – 50 vCPU Hours and 100 memory GB Hours per plan.
• Azure Developer CLI 1.2.0 or later

🚀 How to generate a project

CLI

1. Install the package with npm install -g generator-jhipster-azure-spring-apps
2. Create and navigate to a directory
3. Generate the application with jhipster-azure-spring-apps createtodoapp

JHipster Online

Go to JHipster Online and generate your application.

🚁 How to run locally

To run the project on the localhost:

• mvn clean package -DskipTests
• java -jar web/target/${artifact-name}-web-0.0.1-SNAPSHOT.jar

You can also use Maven Wrapper with:

• chmod +x mvnw
• mvnw clean package -DskipTests
• ./mvnw spring-boot:run -f web/pom.xml

To test the local project, access port 8080 (by default) or the one that you specified:

• http://localhost:8080/

🎉 How to deploy on Azure

1. Log in to azd. Only required once per-install. azd auth login
   • If you are on Windows, install powershell
2. Navigate to the generated project directory and run azd up

After the command is executed, you can see the following log signs that the deployment was successful.

SUCCESS: Your application was provisioned and deployed to Azure Spring Apps in <deployment-time>.
You can view the resources created under the resource group <your-resource-group> in Azure Portal:
https://portal.azure.come/#@/resource/subscriptions/<subscription-id>/resourceGroups/<your-resource-group>/overview

The output Application url is the endpoint to access the todo application.

❤️ Next Steps

• Try Azure for free, you can start with $200 Azure credit.

• To help you get started, Azure Spring Apps have monthly FREE grants on all plans – 50 vCPU Hours and 100 memory GB Hours per plan.

• To learn more about this project, check here.

• At this point, you have a complete application deployed on Azure, to delete all the Azure resources created with this template: azd down