Update tests README with Model Runner Testcontainers information

Author: ajeetraina

tests/README.md

@@ -15,6 +15,9 @@ go test -v ./integration -run TestSimple
 # Run a specific integration test
 go test -v ./integration -run TestGenAIAppIntegration
 
+# Test Model Runner connectivity
+go test -v ./integration -run TestModelRunnerIntegration
+
 # Run extended performance tests
 go test -v ./integration -run TestExtendedPerformance
 
@@ -27,6 +30,7 @@ go test -v ./integration
 - **TestSimple**: Basic test to verify compilation and environment setup
 - **TestBasicTestcontainer**: Validates the Testcontainers environment setup
 - **TestGenAIAppIntegration**: Tests various API endpoints with different prompt types
+- **TestModelRunnerIntegration**: Tests connectivity to Docker Model Runner using Testcontainers
 - **TestLLMResponseQuality**: Validates the quality of LLM responses
 - **TestLLMPerformance**: Measures performance metrics of the LLM service
 - **TestMultiTurnConversation**: Tests context maintenance in conversations
@@ -47,6 +51,7 @@ go test -v ./integration
 - `extended_test.go`: Extended performance tests
 - `basic_testcontainer_test.go`: Basic test for Testcontainers functionality
 - `simple_test.go`: Minimal test to verify package compilation
+- `model_runner_test.go`: Test for Docker Model Runner connectivity using Testcontainers
 
 ## Running Tests
 
@@ -68,6 +73,16 @@ go test -v ./integration -run TestGenAIAppIntegration
 go test -v ./integration -run TestChatQuality
 ```
 
+### Model Runner Tests
+
+Tests connectivity to the Docker Model Runner:
+
+```bash
+# Enable Docker Model Runner in Docker Desktop first
+# Make sure to check "Enable host-side TCP support"
+go test -v ./integration -run TestModelRunnerIntegration
+```
+
 ### Performance Tests
 
 Measures response times and performance characteristics:
@@ -93,14 +108,39 @@ Skip long-running tests:
 go test -v ./integration -short
 ```
 
+## Using Testcontainers for Model Runner
+
+The `TestModelRunnerIntegration` test demonstrates how to use Testcontainers to connect to the Docker Model Runner:
+
+1. Creates a socat container that forwards traffic to model-runner.docker.internal
+2. Dynamically assigns ports to avoid conflicts
+3. Tests connectivity to the Model Runner API
+4. Logs available models and API endpoints
+5. Optionally attempts to create a model
+6. Provides the dynamically assigned URL for the application to use
+
+This approach eliminates the need for hardcoded port values and provides a more reliable testing environment.
+
 ## Prerequisites
 
 - Go 1.19 or higher
 - Docker (for Testcontainers functionality)
+- Docker Desktop with Model Runner enabled (for Model Runner tests)
 - Running GenAI application at http://localhost:8080 (for API tests)
 
-## Notes
+## Testcontainers vs Docker Compose
+
+This test suite demonstrates two approaches for managing dependencies:
+
+1. **Docker Compose**: Used in the main branch for starting the application and its dependencies
+2. **Testcontainers**: Used in this branch for programmatically managing dependencies
+
+Benefits of the Testcontainers approach:
+
+- Dynamic port allocation to avoid conflicts
+- Programmatic creation and cleanup of containers
+- Simplified connection management
+- Same approach can be used for both development and testing
+- Eliminates the need for multiple compose files
 
-- The tests expect your application to be running at http://localhost:8080
-- The Testcontainers functionality is currently simplified, but the structure is in place for full container-based testing
-- You can customize test duration and parameters in the respective test files
+See `TESTCONTAINERS_USAGE.md` in the project root for more details on the Testcontainers approach.