LibreChat/helm/librechat/examples/dns-configuration.yaml
MyGitHub e4f323e71a
🌐 feat: Helm DNS Configuration Support for Traffic Redirection (#9785)
This PR adds DNS configuration support to the LibreChat Helm chart, enabling users to redirect traffic to proxy servers or use custom DNS settings.

## What's Changed
- Added dnsPolicy and dnsConfig fields to deployment.yaml template
- Added DNS configuration options to values.yaml with comprehensive examples
- Created documentation and example configurations

## Use Cases
- Redirect AI service traffic (AWS Bedrock, OpenAI, etc.) to proxy servers
- Use corporate DNS servers for name resolution
- Control traffic routing through custom DNS configurations
- Enforce traffic through security gateways

## Configuration Example
```yaml
dnsPolicy: "None"
dnsConfig:
  nameservers:
    - "10.0.0.10"  # Custom DNS server for redirections
  searches:
    - "svc.cluster.local"
  options:
    - name: ndots
      value: "2"
```

## Testing Results
✅ Successfully tested with Docker Compose environment
✅ DNS resolution correctly redirects to configured IPs
✅ HTTP requests properly routed to proxy servers
✅ Tested with multiple domains (AWS Bedrock, OpenAI, SageMaker)

Test output:
- bedrock-runtime.us-east-1.amazonaws.com -> 172.25.0.10 ✓
- api.openai.com -> 172.25.0.10 ✓
- sagemaker-runtime.us-east-1.amazonaws.com -> 172.25.0.10 ✓

All DNS redirects working correctly with proxy server receiving traffic.

## Documentation
- Added comprehensive DNS_CONFIGURATION.md guide
- Included examples for common use cases
- Provided troubleshooting steps

## Backward Compatibility
This change is fully backward compatible. If dnsPolicy and dnsConfig are not specified, the default Kubernetes DNS behavior is maintained.

Fixes #[issue_number]

Co-authored-by: LibreChat User <user@example.com>
2025-09-23 10:41:58 -04:00

43 lines
No EOL
1.2 KiB
YAML

# DNS Configuration Examples for LibreChat Helm Chart
# This file demonstrates how to configure custom DNS settings for traffic redirection
# Example 1: Redirect AWS Bedrock traffic to a proxy server
dnsPolicy: "None" # Ignore cluster DNS, use only custom DNS
dnsConfig:
nameservers:
- "10.0.0.10" # Your custom DNS server that handles redirections
- "8.8.8.8" # Fallback to Google DNS for other domains
searches:
- "svc.cluster.local"
- "cluster.local"
options:
- name: ndots
value: "2"
---
# Example 2: Use corporate DNS server
dnsPolicy: "None"
dnsConfig:
nameservers:
- "192.168.1.53" # Corporate DNS server
- "192.168.1.54" # Backup DNS server
---
# Example 3: Combine with hostAliases for simple redirects
dnsPolicy: "ClusterFirst" # Use cluster DNS first
dnsConfig:
options:
- name: timeout
value: "1"
- name: attempts
value: "2"
# Note: For simple host-to-IP mappings, you can also use hostAliases
# in combination with DNS configuration (add this to deployment spec):
# hostAliases:
# - ip: "10.100.50.200"
# hostnames:
# - "bedrock-runtime.us-east-1.amazonaws.com"
# - "api.openai.com"