feat(nginx-certbot): add Nginx reverse proxy with Let's Encrypt SSL

- Add Docker Compose configuration for Nginx + Certbot
- Include init script for first certificate generation
- Auto-renewal every 12h, nginx reload every 6h
- Add MkDocs documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: nkaurelien

docs/services/api-management/nginx-certbot.md

@@ -0,0 +1,103 @@
+# Nginx + Certbot
+
+Reverse proxy Nginx avec certificats SSL Let's Encrypt automatiques.
+
+## Quick Start
+
+```bash
+cd nginx-certbot
+
+# 1. Configurer le domaine dans nginx/conf.d/default.conf
+# 2. Configurer init-letsencrypt.sh (domaine + email)
+
+# 3. Initialiser le certificat
+./init-letsencrypt.sh
+
+# 4. Démarrer
+docker compose up -d
+```
+
+## Ports
+
+| Service | Port | Description |
+|---------|------|-------------|
+| HTTP | 80 | Redirection vers HTTPS |
+| HTTPS | 443 | Trafic SSL |
+
+## Architecture
+
+```mermaid
+graph LR
+    A[Client] --> B[Nginx:80/443]
+    B --> C[Certbot]
+    B --> D[App Backend]
+    C --> E[Let's Encrypt]
+```
+
+## Fonctionnement
+
+### Renouvellement automatique
+
+- **Certbot** vérifie le renouvellement toutes les **12 heures**
+- **Nginx** recharge sa configuration toutes les **6 heures**
+- Certificats renouvelés automatiquement avant expiration
+
+### Challenge ACME
+
+```nginx
+location /.well-known/acme-challenge/ {
+    root /var/www/certbot;
+}
+```
+
+## Configuration
+
+### Variables
+
+| Variable | Description |
+|----------|-------------|
+| `domains` | Liste des domaines |
+| `email` | Email pour Let's Encrypt |
+| `staging` | Mode test (évite rate limits) |
+
+### Exemple proxy vers application
+
+```nginx
+server {
+    listen 443 ssl;
+    server_name app.example.com;
+
+    ssl_certificate /etc/letsencrypt/live/app.example.com/fullchain.pem;
+    ssl_certificate_key /etc/letsencrypt/live/app.example.com/privkey.pem;
+
+    location / {
+        proxy_pass http://app:8080;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+}
+```
+
+## Volumes
+
+| Chemin | Description |
+|--------|-------------|
+| `./nginx/conf.d` | Configuration Nginx |
+| `./certbot/conf` | Certificats SSL |
+| `./certbot/www` | Challenge ACME |
+
+## Mode Staging
+
+Pour les tests, activez le mode staging :
+
+```bash
+# Dans init-letsencrypt.sh
+staging=1
+```
+
+## Liens
+
+- [Certbot](https://certbot.eff.org/)
+- [Let's Encrypt](https://letsencrypt.org/)

mkdocs.yml

@@ -107,6 +107,7 @@ nav:
           - Socket Proxy: services/api-management/traefik/socket-proxy.md
       - Kong: services/api-management/kong.md
       - Hasura: services/api-management/hasura.md
+      - Nginx + Certbot: services/api-management/nginx-certbot.md
 
   - Orchestration:
       - Overview: services/orchestration/index.md

nginx-certbot/.env.example

@@ -0,0 +1,11 @@
+# Nginx Certbot Configuration
+
+# Domain(s) for SSL certificate
+DOMAIN=example.com
+
+# Email for Let's Encrypt notifications
+CERTBOT_EMAIL=your-email@example.com
+
+# Use staging server (1=yes, 0=no)
+# Set to 1 for testing to avoid rate limits
+STAGING=0

nginx-certbot/README.md

@@ -0,0 +1,105 @@
+# Nginx + Certbot (Let's Encrypt)
+
+Reverse proxy Nginx avec gestion automatique des certificats SSL via Certbot/Let's Encrypt.
+
+## Quick Start
+
+### 1. Configuration
+
+Éditer les fichiers de configuration :
+
+```bash
+# Modifier le domaine dans nginx/conf.d/default.conf
+# Remplacer "example.com" par votre domaine
+
+# Modifier init-letsencrypt.sh
+# - domains=(votre-domaine.com www.votre-domaine.com)
+# - email="votre-email@example.com"
+```
+
+### 2. Première initialisation
+
+```bash
+# Générer le premier certificat
+./init-letsencrypt.sh
+```
+
+### 3. Démarrage
+
+```bash
+docker compose up -d
+```
+
+## Fonctionnement
+
+- **Nginx** : Reverse proxy avec SSL termination
+- **Certbot** : Renouvellement automatique des certificats (toutes les 12h)
+- **Auto-reload** : Nginx recharge la config toutes les 6h
+
+## Structure
+
+```
+nginx-certbot/
+├── compose.yml
+├── init-letsencrypt.sh      # Script d'initialisation
+├── nginx/
+│   └── conf.d/
+│       └── default.conf     # Configuration Nginx
+└── certbot/
+    ├── conf/                # Certificats Let's Encrypt
+    └── www/                 # Challenge ACME
+```
+
+## Ajouter un nouveau site
+
+1. Créer un fichier dans `nginx/conf.d/` (ex: `mysite.conf`)
+2. Ajouter le domaine dans `init-letsencrypt.sh`
+3. Relancer le script d'initialisation
+
+### Exemple de configuration proxy
+
+```nginx
+server {
+    listen 80;
+    server_name myapp.example.com;
+
+    location /.well-known/acme-challenge/ {
+        root /var/www/certbot;
+    }
+
+    location / {
+        return 301 https://$host$request_uri;
+    }
+}
+
+server {
+    listen 443 ssl;
+    server_name myapp.example.com;
+
+    ssl_certificate /etc/letsencrypt/live/myapp.example.com/fullchain.pem;
+    ssl_certificate_key /etc/letsencrypt/live/myapp.example.com/privkey.pem;
+
+    location / {
+        proxy_pass http://myapp:8080;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+}
+```
+
+## Mode staging
+
+Pour les tests, utilisez le serveur staging de Let's Encrypt pour éviter les rate limits :
+
+```bash
+# Dans init-letsencrypt.sh
+staging=1
+```
+
+## Liens
+
+- [Certbot Documentation](https://certbot.eff.org/docs/)
+- [Let's Encrypt](https://letsencrypt.org/)
+- [Nginx Documentation](https://nginx.org/en/docs/)

nginx-certbot/compose.yml

@@ -0,0 +1,30 @@
+services:
+  nginx:
+    image: nginx:latest
+    container_name: nginx-proxy
+    restart: unless-stopped
+    volumes:
+      - ./nginx/conf.d:/etc/nginx/conf.d:ro
+      - ./certbot/conf:/etc/letsencrypt
+      - ./certbot/www:/var/www/certbot
+    ports:
+      - "80:80"
+      - "443:443"
+    networks:
+      - proxy-net
+    command: '/bin/sh -c ''while :; do sleep 6h & wait $${!}; nginx -s reload; done & nginx -g "daemon off;"'''
+
+  certbot:
+    image: certbot/certbot
+    container_name: certbot
+    restart: unless-stopped
+    volumes:
+      - ./certbot/conf:/etc/letsencrypt
+      - ./certbot/www:/var/www/certbot
+    entrypoint: "/bin/sh -c 'trap exit TERM; while :; do certbot renew; sleep 12h & wait $${!}; done'"
+    networks:
+      - proxy-net
+
+networks:
+  proxy-net:
+    driver: bridge

nginx-certbot/init-letsencrypt.sh

@@ -0,0 +1,64 @@
+#!/bin/bash
+
+# Configuration
+domains=(example.com www.example.com)
+email="your-email@example.com"
+staging=0 # Set to 1 for testing (avoid rate limits)
+
+rsa_key_size=4096
+data_path="./certbot"
+
+if [ -d "$data_path/conf/live/${domains[0]}" ]; then
+  read -p "Existing data found. Continue and replace existing certificate? (y/N) " decision
+  if [ "$decision" != "Y" ] && [ "$decision" != "y" ]; then
+    exit
+  fi
+fi
+
+echo "### Creating dummy certificate for ${domains[0]} ..."
+mkdir -p "$data_path/conf/live/${domains[0]}"
+docker compose run --rm --entrypoint "\
+  openssl req -x509 -nodes -newkey rsa:$rsa_key_size -days 1 \
+    -keyout '/etc/letsencrypt/live/${domains[0]}/privkey.pem' \
+    -out '/etc/letsencrypt/live/${domains[0]}/fullchain.pem' \
+    -subj '/CN=localhost'" certbot
+echo
+
+echo "### Starting nginx ..."
+docker compose up --force-recreate -d nginx
+echo
+
+echo "### Deleting dummy certificate for ${domains[0]} ..."
+docker compose run --rm --entrypoint "\
+  rm -Rf /etc/letsencrypt/live/${domains[0]} && \
+  rm -Rf /etc/letsencrypt/archive/${domains[0]} && \
+  rm -Rf /etc/letsencrypt/renewal/${domains[0]}.conf" certbot
+echo
+
+echo "### Requesting Let's Encrypt certificate for ${domains[*]} ..."
+domain_args=""
+for domain in "${domains[@]}"; do
+  domain_args="$domain_args -d $domain"
+done
+
+# Select appropriate email arg
+case "$email" in
+  "") email_arg="--register-unsafely-without-email" ;;
+  *) email_arg="--email $email" ;;
+esac
+
+# Enable staging mode if needed
+if [ $staging != "0" ]; then staging_arg="--staging"; fi
+
+docker compose run --rm --entrypoint "\
+  certbot certonly --webroot -w /var/www/certbot \
+    $staging_arg \
+    $email_arg \
+    $domain_args \
+    --rsa-key-size $rsa_key_size \
+    --agree-tos \
+    --force-renewal" certbot
+echo
+
+echo "### Reloading nginx ..."
+docker compose exec nginx nginx -s reload

nginx-certbot/nginx/conf.d/default.conf

@@ -0,0 +1,46 @@
+server {
+    listen 80;
+    server_name example.com www.example.com;
+
+    # Certbot challenge
+    location /.well-known/acme-challenge/ {
+        root /var/www/certbot;
+    }
+
+    # Redirect HTTP to HTTPS
+    location / {
+        return 301 https://$host$request_uri;
+    }
+}
+
+server {
+    listen 443 ssl;
+    server_name example.com www.example.com;
+
+    # SSL certificates (will be created by certbot)
+    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
+    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
+
+    # SSL configuration
+    ssl_protocols TLSv1.2 TLSv1.3;
+    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
+    ssl_prefer_server_ciphers off;
+    ssl_session_cache shared:SSL:10m;
+    ssl_session_timeout 1d;
+
+    # HSTS
+    add_header Strict-Transport-Security "max-age=63072000" always;
+
+    location / {
+        # Proxy to your application
+        # proxy_pass http://app:8080;
+        # proxy_set_header Host $host;
+        # proxy_set_header X-Real-IP $remote_addr;
+        # proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        # proxy_set_header X-Forwarded-Proto $scheme;
+
+        # Default: serve static files
+        root /var/www/html;
+        index index.html;
+    }
+}