Skip to content

README.md

Latest commit

 

History

History
44 lines (33 loc) · 1.45 KB

README.md

File metadata and controls

44 lines (33 loc) · 1.45 KB
name ords-testcontainers
description Testcontainers sample for running ORDS alongside Oracle AI Database Free in integration tests.
tags
Database
Java
MongoDB
ORDS
Testcontainers
oraclefree
blog_post https://andersswanson.dev/2026/04/07/test-ords-locally-with-testcontainers-oracle-ai-database-free-and-mongodb/

ORDS Testcontainers

This module demonstrates how to run Oracle REST Data Services (ORDS) with Testcontainers against an Oracle AI Database Free container.

The sample mirrors the ords-docker-compose module, but replaces Docker Compose with a custom Java GenericContainer implementation that can be reused in integration tests.

container diagram

Prerequisites

  • Java 21+
  • Maven
  • Docker-compatible container runtime
  • Access to container-registry.oracle.com/database/ords:latest

Run the sample

mvn test

What the sample covers

  • Starting an Oracle AI Database Free container on a shared Docker network
  • Bootstrapping an ordsuser/ordsuserpwd schema with a sysdba SQL script
  • Starting an ORDS container with a custom OrdsContainer
  • Waiting for ORDS to become reachable over HTTP
  • Enabling the test schema for ORDS before container startup completes
  • Validating MongoDB Java client CRUD compatibility through the ORDS MongoDB API

The ORDS container exposes HTTP on internal port 8080 and the MongoDB API on internal port 27017.