Skip to content

README.md

Latest commit

 

History

History
76 lines (50 loc) · 3.37 KB

README.md

File metadata and controls

76 lines (50 loc) · 3.37 KB
Raw
name microtx-java-sample
description Spring Boot service scaffold for Oracle Transaction Manager for Microservices.
tags
Java
MicroTX
SpringBoot

Oracle Transaction Manager for Microservices (MicroTx) Sample

MicroTx is a durable workflow orchestration layer supporting agentic AI and distrubted transaction management, integrated with Oracle AI Database.

Important Files

Run MicroTx and Oracle AI Database Free

The Docker Compose environment pulls the MicroTx Free images from Oracle Container Registry. MicroTx Free is for developers to build and evaluate applications using distributed transactions and workflows with Agentic AI.

docker login container-registry.oracle.com

The included tcs-config.yaml and workflow-server-config.properties files connect MicroTx to Oracle AI Database Free over the shared Compose network. The configuration notes describe the database and credential settings.

Start the environment:

docker compose -f microtx-docker-compose.yaml up -d
docker compose -f microtx-docker-compose.yaml ps

The workflow-key-init service generates the workflow-server encryption key the first time the environment starts. The key is retained in the workflow-encryption-key volume and reused across restarts.

The services are available at:

  • MicroTx coordinator health: http://localhost:9000/health
  • MicroTx workflow server health: http://localhost:9010/workflow-server/health
  • MicroTx console: http://localhost:8080/consoleui/
  • Oracle AI Database Free: localhost:1521/FREEPDB1

Stop the environment without deleting its database and workflow storage volumes:

docker compose -f microtx-docker-compose.yaml down

Add --volumes only when you intentionally want to delete the persisted development data and workflow-server encryption key. Deleting the key prevents the workflow server from decrypting secrets that were encrypted with it.

Access the MicroTx console UI

http://localhost:8080/consoleui

You should see the microtx dashboard:

console UI

MicroTx Java Application

TBD - stay tuned for a working Java sample that complements the Docker Compose environment.

MicroTx Enterprise Edition (EE)

The MicroTx EE images are recommended for licensed, production workflows. Find the MicroTx EE images here: