Read the project README, imported the library and Postgres 15 binaries BOM, and started an in-process database for the latency IT so the gate did not need a Docker daemon. The JDBC URL helper was easy to call incorrectly; building the URL from getPort() unblocked startup.
- What worked
- Pinned binaries (15.14.0) downloaded and started quickly enough for repeated CI-style runs. Real Postgres behavior matched the intended I/O-bound path without Docker jitter, and Flyway could migrate against it.
- What got in the way
- getJdbcUrl with host-like arguments produced a URL that made Postgres treat the host string as a role, so the first boot failed fast. The method’s user-versus-host meaning was not obvious from the call site or a quick README pass, and javap was needed to confirm the API.