ADempiere gRPC Server

English | Spanish

This is a project to publish ADempiere, over gRPC service, decoupling in modules such as Access, Application Dictionary, Business, Point Of Sales, Workflow, Dashboarding, File Management, Logs, Requests (as Issue Management), User Customization, etc.

Recreate proto stub class

For recreate stub class you must have follow:

protobuf
gradle
Maven
Also you can see it: gRPC-Java
Complete Java Documentation After installed it just go to source code folder an run it:

Runing as development

Clean

gradle clean

Execute server with default conection file

gradle run

Execute server with custom conection file

gradle run --args="'resources/standalone.yaml'"

Runing Server

The server can be running as java class. See it: org.spin.server.AllInOneServices Don't forgive that for run server you need set yaml file line is /resources folder.

Use latest release
Unzip binary
Go to bin folder
Run it

./adempiere-all-in-one-server "./resources/standalone.yaml"

For all enviroment you should run the follow images:

ADempiere Postgres: https://hub.docker.com/r/solopcloud/adempiere-postgres
```
docker pull solopcloud/adempiere-postgres
```
ADempiere Backend: https://hub.docker.com/r/solopcloud/adempiere-backend
```
docker pull solopcloud/adempiere-backend:experimental
```
ADempiere Proxy: https://hub.docker.com/r/solopcloud/adempiere-proxy
```
docker pull solopcloud/adempiere-proxy:experimental
```
Frontend-Core: https://hub.docker.com/r/solopcloud/adempiere-vue
```
docker pull solopcloud/adempiere-vue:experimental
```

Run docker container:

Minimal Docker Requirements

To use this Docker image you must have your Docker engine version greater than or equal to 3.0.

Environment variables

DB_TYPE: Database Type (Supported Oracle and PostgreSQL). Default PostgreSQL.
DB_HOST: Hostname for data base server. Default: localhost.
DB_PORT: Port used by data base server. Default: 5432.
DB_NAME: Database name that Adempiere-Backend will use to connect with the database. Default: adempiere.
DB_USER: Database user that Adempiere-Backend will use to connect with the database. Default: adempiere.
DB_PASSWORD: Database password that Adempiere-Backend will use to connect with the database. Default: adempiere.
IDLE_TIMEOUT: It sets the maximum time a connection can sit around without being used before it gets closed to free up resources. Default: 300.
MINIMUM_IDLE: It sets the minimum number of connections that should be kept open and ready to use, even if they're not currently being used. This helps improve performance by reducing the time it takes to get a connection. Default: 1.
MAXIMUM_POOL_SIZE: It sets the maximum number of connections that can be open at the same time. This helps prevent the pool from getting too big and using up too much memory. Default: 10.
CONNECTION_TIMEOUT: it sets the maximum time HikariCP will wait to get a connection from the pool before giving up and throwing an error. Default: 5000.
MAXIMUM_LIFETIME: It sets the maximum amount of time a connection can stay open in the pool before it's automatically closed. This helps keep the pool clean and prevents problems. Default: 6000.
KEEPALIVE_TIME: It sets a test query that HikariCP will run on connections to make sure they're still working properly. Default: 360000.
CONNECTION_TEST_QUERY: It sets how often HikariCP will check if a connection is still working properly. This helps prevent problems with connections that might become inactive. Default: SELECT 1
SERVER_PORT: Port to access Adempiere-Backend from outside of the container. Default: 50059.
SERVER_LOG_LEVEL: Log Level. Default: WARNING.
TZ: (Time Zone) Indicates the time zone to set in the nginx-based container, the default value is America/Caracas (UTC -4:00).
SYSTEM_LOGO_URL: Logo of the main image of the system, shown in the login screen.
JAVA_OPTIONS: Additional java options to execute application. Default: -Xms64M -Xmx1512M

Build docker image (for development only):

First compile output files.

# Assembles the outputs of this project.
gradle assemble

# Or Assembles and tests this project.
gradle build

Build docker image (alpine)

docker build -t solopcloud/adempiere-backend:alpine-dev -f ./docker/alpine.Dockerfile .

Build docker image (multi-arch)

docker build -t solopcloud/adempiere-backend:dev -f ./docker/focal.Dockerfile .

Download docker image:

docker pull solopcloud/adempiere-backend:alpine

Run container container:

docker run -it -d \
    --name adempiere-backend \
    -p 50059:50059 \
    -e DB_HOST="your-db-host" \
    -e DB_PORT="5432" \
    -e DB_NAME=\"adempiere\" \
    -e DB_PASSWORD="adempiere" \
    -e JWT_SECRET_KEY="your-json-web-token-secret-key" \
    -e TZ="America/Caracas" \
    solopcloud/adempiere-backend:alpine

Run with Docker-Compose

Or easy run container using docker-compose with follow command:

docker compose -f build-docker/docker-compose.yaml up

solop-develop / adempiere-grpc-server

readme