# Specialized Docker Compose Configurations

This directory contains specialized Docker Compose configurations for specific testing scenarios.

## ⚠️ Important Note

**For Observability:**
We **strongly recommend** using the new, fully integrated observability stack located in `../observability/`. It provides a production-ready setup with Prometheus, Grafana, Tempo, Loki, and OpenTelemetry Collector, all with persistent storage and optimized configurations.

The `docker-compose.observability.yaml` in this directory is kept for legacy reference or specific minimal testing needs but is **not** the primary recommended setup.

## 📁 Configuration Files

### Cluster Testing

- **`docker-compose.cluster.yaml`**
  - **Purpose**: Simulates a 4-node RustFS distributed cluster.
  - **Use Case**: Testing distributed storage logic, consensus, and failover.
  - **Nodes**: 4 RustFS instances.
  - **Storage**: Uses local HTTP endpoints.

### Legacy / Minimal Observability

- **`docker-compose.observability.yaml`**
  - **Purpose**: A minimal observability setup.
  - **Status**: **Deprecated**. Please use `../observability/docker-compose.yml` instead.

## 🚀 Usage Examples

### Cluster Testing

To start a 4-node cluster for distributed testing:

```bash
# From project root
docker compose -f .docker/compose/docker-compose.cluster.yaml up -d
```

### (Deprecated) Minimal Observability

```bash
# From project root
docker compose -f .docker/compose/docker-compose.observability.yaml up -d
```