https://github.com/codbex/codbex-gaia
Basis Platform for Products
https://github.com/codbex/codbex-gaia
platform
Last synced: 2 days ago
JSON representation
Basis Platform for Products
- Host: GitHub
- URL: https://github.com/codbex/codbex-gaia
- Owner: codbex
- License: epl-2.0
- Created: 2023-04-23T08:06:02.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2026-03-17T08:13:21.000Z (24 days ago)
- Last Synced: 2026-03-17T23:33:04.139Z (24 days ago)
- Topics: platform
- Language: Java
- Homepage: https://codbex.com
- Size: 305 KB
- Stars: 1
- Watchers: 7
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Gaia by codbex
[](https://github.com/codbex/codbex-gaia/actions/workflows/build.yaml)
[](https://github.com/codbex/codbex-gaia/blob/main/LICENSE)
[](https://central.sonatype.com/namespace/com.codbex.gaia)
Gaia Edition contains all the available backend standard components except the Web IDE ones.
It is used as a basis platform for products build with and for `codbex` tools and runtimes.
* [Gaia by codbex](#gaia-by-codbex)
* [Run steps](#run-steps)
* [Start using Docker and released image](#start-using-docker-and-released-image)
* [Start using Docker and local sources](#start-using-docker-and-local-sources)
* [Build the project jar](#build-the-project-jar)
* [Build and run docker image locally](#build-and-run-docker-image-locally)
* [Java standalone application](#java-standalone-application)
* [Start the application](#start-the-application)
* [Start the application **in debug** with debug port
`8000`](#start-the-application-in-debug-with-debug-port-8000)
* [Spring profiles](#spring-profiles)
* [Run unit tests](#run-unit-tests)
* [Run integration tests](#run-integration-tests)
* [Run all tests](#run-all-tests)
* [Format the code](#format-the-code)
* [Access the application](#access-the-application)
* [REST API](#rest-api)
## Run steps
__Prerequisites:__
- Export the following variables before executing the steps
```shell
export GIT_REPO_FOLDER=''
export IMAGE='ghcr.io/codbex/codbex-gaia:latest'
export CONTAINER_NAME='gaia'
```
### Start using Docker and released image
```shell
# optionally remove the existing container with that name
docker rm -f "$CONTAINER_NAME"
docker pull "$IMAGE"
docker run --name "$CONTAINER_NAME" -p 80:80 "$IMAGE"
```
---
### Start using Docker and local sources
#### Build the project jar
```shell
cd $GIT_REPO_FOLDER
mvn -T 1C clean install -P quick-build
```
#### Build and run docker image locally
__Prerequisites:__ [Build the project jar](#build-the-project-jar)
```shell
cd "$GIT_REPO_FOLDER/application"
docker build . --tag "$IMAGE"
# optionally remove the existing container with that name
docker rm -f "$CONTAINER_NAME"
docker run --name "$CONTAINER_NAME" -p 80:80 "$IMAGE"
```
---
### Java standalone application
__Prerequisites:__ [Build the project jar](#build-the-project-jar)
#### Start the application
```shell
cd "$GIT_REPO_FOLDER"
java \
--add-opens=java.base/java.lang=ALL-UNNAMED \
--add-opens=java.base/java.lang.reflect=ALL-UNNAMED \
--add-opens=java.base/java.nio=ALL-UNNAMED \
-jar application/target/codbex-gaia-*.jar
```
#### Start the application **in debug** with debug port `8000`
```shell
cd "$GIT_REPO_FOLDER"
export PHOEBE_AIRFLOW_WORK_DIR="$AIRFLOW_WORK_DIR"
java \
-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=8000 \
--add-opens=java.base/java.lang=ALL-UNNAMED \
--add-opens=java.base/java.lang.reflect=ALL-UNNAMED \
--add-opens=java.base/java.nio=ALL-UNNAMED \
-jar application/target/codbex-gaia-*.jar
```
#### Spring profiles
- Eclipse Dirigible profiles
To activate Eclipse Dirigible, you have to add profiles `common` and `app-default` explicitly.
Example for profile `snowflake`: `SPRING_PROFILES_ACTIVE=common,snowflake,app-default`
---
### Run unit tests
```shell
cd "$GIT_REPO_FOLDER"
mvn clean install -P unit-tests
```
---
### Run integration tests
```shell
cd "$GIT_REPO_FOLDER"
mvn clean install -P integration-tests
```
---
### Run all tests
```shell
cd "$GIT_REPO_FOLDER"
mvn clean install -P tests
```
---
### Format the code
```shell
cd "$GIT_REPO_FOLDER"
mvn verify -P format
```
---
## Access the application
- Open URL [http://localhost:80](http://localhost:80)
- Login with the default credentials username `admin` and password `admin`
## REST API
```
http://localhost/swagger-ui/index.html
```