docker-compose-tests

name: docker-compose-tests description: Use Gradle Compose tasks to prepare and recover local Elasticsearch/OpenSearch test infrastructure in kt-search. Trigger this skill when tests or docs generation require a running cluster (especially localhost:9990), when instructions say to run ./gradlew composeUp before tests, or when compose startup fails due stale/conflicting containers.

Docker Compose Tests

Use Gradle Compose tasks, not raw docker compose commands, for this repository.

Standard Workflow

1. Start test infrastructure: ./gradlew composeUp
2. Run the target tests (examples): ./gradlew :docs:test --tests '*DocumentationTest*' --rerun-tasks ./gradlew :search-client:jvmTest
3. Optionally stop infrastructure: ./gradlew composeDown

Recovery Workflow

If composeUp fails with container name conflicts (for example /testes):

1. ./gradlew composeDown
2. ./gradlew composeUp
3. Re-run the failed test command

Rules

• Prefer ./gradlew composeUp as the canonical startup path.
• Do not disable docs examples to bypass failing docs tests.
• Regenerate docs with test commands (not manual edits of generated outputs).