https://github.com/zeropsio/recipe-java
https://github.com/zeropsio/recipe-java
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/zeropsio/recipe-java
- Owner: zeropsio
- Created: 2024-06-24T15:52:22.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-06-24T17:59:22.000Z (almost 2 years ago)
- Last Synced: 2025-03-16T06:24:29.754Z (over 1 year ago)
- Language: Java
- Size: 25.4 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Zerops x Java
This is a basic example of a Java Spring Boot app running on [Zerops](https://zerops.io) — a simple endpoint with connect, read and write operations to a Zerops PostgreSQL database.
## Deploy on Zerops
You can either click the deploy button to deploy directly on Zerops, or manually copy the [import yaml](https://github.com/zeropsio/recipe-java/blob/main/zerops-project-import.yml) to the import dialog in the Zerops app.
[](https://app.zerops.io/recipe/java)
## Recipe features
- Java 17 Spring Boot app running on a load balanced **Zerops Java** service
- Zerops **PostgreSQL 16** service as database
- Healthcheck setup example
- Utilization of Zerops' built-in **environment variables** system
- Utilization of Zerops' built-in **log management**
## Production vs. development
The base of the recipe is ready for production, with the main differences being:
- Use a highly available version of the PostgreSQL database (change `mode` from `NON_HA` to `HA` in recipe YAML, `db` service section)
- Use at least two containers for the Java service to achieve high reliability and resilience (add `minContainers: 2` in recipe YAML, `api` service section)
Further considerations for running more complex, highly available Java production apps on Zerops:
- Containers are volatile - use Zerops object storage to store your files
- Use Zerops Redis (KeyDB) for caching, storing sessions and pub/sub messaging
- Implement more advanced logging, such as using [SLF4J](http://www.slf4j.org/) with [Logback](http://logback.qos.ch/)
## Changes made over the default installation
Configure the application to [listen on all network interfaces](https://github.com/zeropsio/recipe-java/blob/main/src/main/resources/application.properties#L11) (`server.address=0.0.0.0`) to ensure it's accessible within the Zerops environment
Need help setting your project up? Join [Zerops Discord community](https://discord.com/invite/WDvCZ54).