Spring Boot (JVM)

Guide for Spring Boot applications written in Java/Kotlin.

​

Prerequisites

​

Select Template and Repository

On the dashboard, click or ⌘ + K to open the deployment modal and select the Java template. Then choose a GitHub repository from the dropdown or input a Git repository URL in the Git URL tab.

​

Deployment Settings

Apply the following settings to ensure your service runs seamlessly.

​

Set Resources and Deploy

• Resource Type: Select between On-demand or Spot instance types

• CPU: Maximum vCPU resource for the service. Minimum vCPU means 0.1 vCPU

• Memory: Maximum memory size your service can use

• Replica: Number of service replicas for high availability and load balancing

• Deploy: Click Deploy

​

Advanced Settings

​

Deploy Jar Files from the Repository

• When deploying a Spring Boot jar file reflected in the repository, specify the jar file path in the Pre-built jar file path field of the deployment settings, as per your build tool:
  • Gradle: build/libs/[project-name].jar
  • Maven: target/[project-name].jar

​

Include Specific Resource Paths in the Build Process

• When deploying a Spring Boot project via ale, files in the src directory, except for those defined in WebProperties.Resources (e.g., /static), are excluded from the build.
  If your project references resources from specific paths, include those directories in the Include files in build field of the deployment settings. Use commas (,) to specify multiple directories.

​

Deploy Multi-Module Applications

• Deploying a Spring Boot application composed of multiple modules requires specific configurations. The following example outlines the process:

  Copy

  project-root/
    ├── build.gradle.kts
    ├── settings.gradle.kts
    ├── api/
    │   ├── build.gradle.kts
    │   └── src/
    │       └── main/
    │           ├── kotlin/
    │           └── resources/
    ├── core/
    │   ├── build.gradle.kts
    │   └── src/
    │       └── main/
    │           ├── kotlin/
    │           └── resources/
    └── gradle/
        └── wrapper/
            ├── gradle-wrapper.jar
            └── gradle-wrapper.properties
  

  • Configure the api module as the main class and structure as shown.
  • After selecting the Spring Boot template, apply the following settings:
    • Start Command: java -jar api/build/libs/api-0.0.1-SNAPSHOT.jar
      • Replace <main-module-name> with the actual module name.
    • Include files in build: core,api
      • Separate module directory names with commas.

Spring Boot Docs