Aller au contenu principal

Variables d'environnement - Timeouts

Ce document liste toutes les variables d'environnement liées à la gestion des timeouts dans Aaperture.

💡 Astuce : Pour ajouter ces variables à votre .env.example, copiez le contenu de ENV_TIMEOUT_EXAMPLE.txt (voir .env.example) dans la section appropriée.

📋 Variables disponibles​

Ajoutez ces variables à votre fichier .env pour configurer les timeouts selon vos besoins.

Base de données (milliseconds)​

# Timeout pour requêtes DB individuelles (défaut: 30000 = 30 secondes)
DB_QUERY_TIMEOUT=30000

# Timeout pour connexions DB (défaut: 10000 = 10 secondes)
DB_CONNECTION_TIMEOUT=10000

# Timeout pour connexions idle (défaut: 30000 = 30 secondes)
DB_IDLE_TIMEOUT=30000

APIs externes (milliseconds)​

# Timeout pour Google Calendar API (défaut: 10000 = 10 secondes)
GOOGLE_CALENDAR_TIMEOUT=10000

# Timeout pour Gmail API (défaut: 10000 = 10 secondes)
GMAIL_API_TIMEOUT=10000

# Timeout pour Google OAuth (défaut: 10000 = 10 secondes)
GOOGLE_OAUTH_TIMEOUT=10000

# Timeout pour OpenAI API (défaut: 30000 = 30 secondes)
OPENAI_API_TIMEOUT=30000

Jobs et tâches (milliseconds)​

# Timeout maximum pour jobs cron (défaut: 300000 = 5 minutes)
CRON_JOB_TIMEOUT=300000

HTTP (milliseconds)​

# Timeout global pour requêtes HTTP (défaut: 30000 = 30 secondes)
HTTP_REQUEST_TIMEOUT=30000

Infrastructure (seconds pour scripts shell)​

# Timeout pour migrations de base de données (défaut: 600 = 10 minutes)
MIGRATION_TIMEOUT=600

# Timeout pour backups de base de données (défaut: 1800 = 30 minutes)
BACKUP_TIMEOUT=1800

Autres (milliseconds)​

# Timeout pour service email SMTP (défaut: 30000 = 30 secondes)
EMAIL_TIMEOUT=30000

# Timeout pour WebSocket (défaut: 60000 = 60 secondes)
WEBSOCKET_TIMEOUT=60000

📝 Exemple de configuration complète​

# ============================================
# TIMEOUT CONFIGURATION
# ============================================

# Database timeouts (milliseconds)
DB_QUERY_TIMEOUT=30000
DB_CONNECTION_TIMEOUT=10000
DB_IDLE_TIMEOUT=30000

# External API timeouts (milliseconds)
GOOGLE_CALENDAR_TIMEOUT=10000
GMAIL_API_TIMEOUT=10000
GOOGLE_OAUTH_TIMEOUT=10000
OPENAI_API_TIMEOUT=30000

# Job timeouts (milliseconds)
CRON_JOB_TIMEOUT=300000

# HTTP timeouts (milliseconds)
HTTP_REQUEST_TIMEOUT=30000

# Infrastructure timeouts (seconds for shell scripts)
MIGRATION_TIMEOUT=600
BACKUP_TIMEOUT=1800

# Other timeouts (milliseconds)
EMAIL_TIMEOUT=30000
WEBSOCKET_TIMEOUT=60000

⚙️ Valeurs par défaut​

Toutes les variables sont optionnelles. Si elles ne sont pas définies, les valeurs par défaut suivantes sont utilisées :

VariableDéfautDescription
DB_QUERY_TIMEOUT30000 msTimeout pour requêtes DB
DB_CONNECTION_TIMEOUT10000 msTimeout pour connexions DB
DB_IDLE_TIMEOUT30000 msTimeout pour connexions idle
GOOGLE_CALENDAR_TIMEOUT10000 msTimeout Google Calendar API
GMAIL_API_TIMEOUT10000 msTimeout Gmail API
GOOGLE_OAUTH_TIMEOUT10000 msTimeout Google OAuth
OPENAI_API_TIMEOUT30000 msTimeout OpenAI API
CRON_JOB_TIMEOUT300000 msTimeout jobs cron (5 min)
HTTP_REQUEST_TIMEOUT30000 msTimeout requêtes HTTP
MIGRATION_TIMEOUT600 sTimeout migrations (10 min)
BACKUP_TIMEOUT1800 sTimeout backups (30 min)
EMAIL_TIMEOUT30000 msTimeout SMTP
WEBSOCKET_TIMEOUT60000 msTimeout WebSocket

🔧 Configuration recommandée par environnement​

Développement​

# Timeouts plus courts pour développement rapide
DB_QUERY_TIMEOUT=10000
HTTP_REQUEST_TIMEOUT=15000
OPENAI_API_TIMEOUT=20000

Production​

# Timeouts plus longs pour production (opérations plus lourdes)
DB_QUERY_TIMEOUT=60000
HTTP_REQUEST_TIMEOUT=60000
OPENAI_API_TIMEOUT=60000
CRON_JOB_TIMEOUT=600000  # 10 minutes
MIGRATION_TIMEOUT=1200   # 20 minutes
BACKUP_TIMEOUT=3600      # 60 minutes

📚 Documentation​

Pour plus d'informations sur l'utilisation des timeouts, consultez :