Configuration¶

Variables d'environnement¶

Le fichier .env contient toute la configuration:

# Application
APP_NAME=mon-projet
APP_ENV=development
APP_PORT=8080

# Database
DB_HOST=localhost
DB_PORT=5432
DB_USER=postgres
DB_PASSWORD=postgres
DB_NAME=mon-projet
DB_SSLMODE=disable

# JWT
JWT_SECRET=          # À REMPLIR!
JWT_EXPIRY=15m
REFRESH_TOKEN_EXPIRY=168h

Générer un JWT_SECRET sécurisé¶

CRITIQUE: Générez toujours un secret fort:

openssl rand -base64 32

Exemple de résultat:

XqR7nP3vY2kL9wH4sT6mU8jC1bN5aD0f

Ajoutez-le dans .env:

JWT_SECRET=XqR7nP3vY2kL9wH4sT6mU8jC1bN5aD0f

Configuration par environnement¶

Development¶

APP_ENV=development
DB_HOST=localhost
DB_SSLMODE=disable

Staging¶

APP_ENV=staging
DB_HOST=staging-db.example.com
DB_SSLMODE=require
JWT_SECRET=<secret-depuis-vault>

Production¶

APP_ENV=production
DB_HOST=prod-db.example.com
DB_SSLMODE=require
DB_PASSWORD=<secret-depuis-secrets-manager>
JWT_SECRET=<secret-depuis-secrets-manager>

Best practice: Utiliser des secrets managers:

AWS: Secrets Manager, Parameter Store
GCP: Secret Manager
Kubernetes: Secrets
HashiCorp: Vault

Configuration PostgreSQL¶

Option 1: PostgreSQL local¶

macOS (Homebrew):

brew install postgresql@16
brew services start postgresql@16
createdb mon-projet

Linux (apt):

sudo apt update
sudo apt install postgresql postgresql-contrib
sudo systemctl start postgresql
sudo -u postgres createdb mon-projet

Option 2: Docker¶

docker run -d \
  --name postgres \
  -e POSTGRES_DB=mon-projet \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_PASSWORD=postgres \
  -p 5432:5432 \
  postgres:16-alpine

Option 3: Docker Compose¶

Si un docker-compose.yml est généré:

version: '3.8'

services:
  postgres:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: mon-projet
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

Lancer:

docker-compose up -d postgres

Vérification de connexion¶

# Avec psql
psql -h localhost -U postgres -d mon-projet

# Ou tester depuis l'app
make run
# Vérifier les logs: "Database connected successfully"

Previous: Structure du projet
Next: Développement
Index: Guide Index