Skip to content

Conversation

@bolinocroustibat
Copy link
Contributor

@bolinocroustibat bolinocroustibat commented Oct 31, 2025

After using Tabular API with real Hydra data locally I realized the workflow for using TabularAPI locally with real data was not very convenient neither very well documented.

This PR aims to make the DX for this case a bit nicer and better documented, by introducing Docker Compose profiles to manage test and real Hydra database setups.

Changes

  • Added docker-compose profiles for separate test and real database setups:
    • --profile test: Starts test CSV database and PostgREST (for tests)
    • --profile hydra: Starts PostgREST connecting to real Hydra CSV database (for development)
  • Service naming: Renamed test PostgREST to postgrest-test; main postgrest points to real Hydra
  • Port configuration: PostgREST port is configurable via PGREST_PORT env var (defaults to 8080)
  • Documentation: Updated README with profile explanations and setup instructions
  • CI: Updated CircleCI config to use --profile test

No services start by default; explicitly specify a profile. This allows switching between test and real database setups without separate compose files while always being explicit.

@bolinocroustibat bolinocroustibat self-assigned this Oct 31, 2025
@bolinocroustibat bolinocroustibat force-pushed the refactor-docker-compose branch 3 times, most recently from 895b5c1 to d12b2e0 Compare November 3, 2025 13:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants