Deploy Java Apps
Java installation is powered by Adoptium Project. To install latest version with deployment script:
features:
- java
Without this, java
won't be available since no globally installed Java runtime available.
Install other version using java latest
, java lts
, java 18
, etc. To uninstall use java off
. Check the current version using java --version
from SSH.
Example
The deployment script below installs the latest java
compiler and writes Main.java
and run it directly.
source: clear
features:
- java
nginx:
root: public_html/public
passenger:
enabled: "on"
app_start_command: env PORT=$PORT java Main.java
commands:
- filename: Main.java
content: |
import java.io.IOException;
import java.io.OutputStream;
import java.net.InetSocketAddress;
import com.sun.net.httpserver.HttpExchange;
import com.sun.net.httpserver.HttpHandler;
import com.sun.net.httpserver.HttpServer;
public class Main {
public static void main(String[] args) throws Exception {
String portStr = System.getenv("PORT");
int port = portStr == null ? 3000 : Integer.parseInt(portStr);
HttpServer server = HttpServer.create(new InetSocketAddress(port), 0);
System.out.println("Server is listening to localhost:" + port);
server.createContext("/", new DefaultHandler());
server.setExecutor(null); // creates a default executor
server.start();
}
}
class DefaultHandler implements HttpHandler {
private static String template = """
<!DOCTYPE html>
<html>
<head>
<title>Java App</title>
<link rel="stylesheet" href="//unpkg.com/bootstrap/dist/css/bootstrap.min.css">
</head>
<body class="p-5 text-center">
<p><img src="//images.unsplash.com/photo-1465153690352-10c1b29577f8?fit=crop&w=200&h=200"
class="img-fluid rounded-circle"></p>
<h1 class="mb-3">Hello, world!</h1>
<p>Serving from Java version %s</p>
<p class="text-muted">DOM Cloud</p>
</body>
</html>
""";
public void handle(HttpExchange t) throws IOException {
String version = Runtime.version().toString();
String response = String.format(template, version);
t.sendResponseHeaders(200, response.length());
OutputStream os = t.getResponseBody();
os.write(response.getBytes());
os.close();
}
}
Existing Java projects
Existing Java projects can run directly from source code. This eliminates the need to compile the code into a JAR file, although startup time may be a little bit slower to start.
features:
- java
nginx:
root: public_html/public
passenger:
enabled: "on"
app_start_command: env PORT=$PORT java Main.java
App Management
Your app do not restarted automatically after file changes. To restart, run restart
via SSH.
Environment variables can be set either using NGINX's env_var_list
or ~/.bashrc
. Usually your language framework also reads .env
files.
See NGINX and App Daemon for more information about NGINX and App managements including restarting, environment variables, and other global limitations.
App Logging
You can see app log from Check -> Check Process Logs tab. Only startup problems displayed in the browser.
You might want to use a proper logging mechanism such as log4j then write it to a log file, or any other solution that suits you.
NGINX errors and traffic logs can be examined via Webmin or Check -> Check Process Logs tab.