====== Procédure : Ajouter un nouveau service ======

===== Étape 1 : Préparation =====

  - [ ] Choisir un nom de service
  - [ ] Définir le nom de domaine (ex: ''monservice.cotting.fr'')
  - [ ] Créer le dossier ''/opt/stacks/[service]''
  - [ ] Vérifier les prérequis (base de données, etc.)

===== Étape 2 : Configuration Docker =====

<code bash>
# Créer la structure
sudo mkdir -p /opt/stacks/[service]
cd /opt/stacks/[service]

# Créer docker-compose.yml
sudo nano docker-compose.yml
</code>

**Template docker-compose.yml :**

<code yaml>
version: '3.8'

services:
  monservice:
    image: [image:tag]
    container_name: [nom-container]
    restart: unless-stopped
    environment:
      - TZ=Europe/Paris
      # Autres variables
    volumes:
      - /opt/stacks/[service]/data:/data
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.[service]-http.rule=Host(`[service].cotting.fr`)"
      - "traefik.http.routers.[service]-http.entrypoints=web"
      - "traefik.http.routers.[service]-http.middlewares=redirect-to-https@file"
      - "traefik.http.routers.[service]-https.rule=Host(`[service].cotting.fr`)"
      - "traefik.http.routers.[service]-https.entrypoints=websecure"
      - "traefik.http.routers.[service]-https.tls.certresolver=le"
      - "traefik.http.services.[service].loadbalancer.server.port=80"
    networks:
      - dashboard_web

networks:
  dashboard_web:
    external: true
</code>

===== Étape 3 : DNS AdGuard =====

  - Accéder à [[https://adguard.cotting.fr|AdGuard]]
  - **Filters** → **DNS rewrites** → **Add DNS rewrite**
  - ''[service].cotting.fr → 192.168.1.200''
  - **Save**

===== Étape 4 : Déploiement =====

<code bash>
cd /opt/stacks/[service]
docker compose up -d

# Vérifier les logs
docker logs [nom-container] --tail 50

# Vérifier l'état
docker ps | grep [service]
</code>

===== Étape 5 : Vérification =====

<code bash>
# Test DNS
nslookup [service].cotting.fr 192.168.1.200

# Test HTTPS
curl -I https://[service].cotting.fr

# Vérifier dans Traefik Dashboard
# http://192.168.1.200:8080 → HTTP → Routers
</code>

===== Étape 6 : Configuration backup =====

Créer le script de backup :

<code bash>
sudo nano /opt/scripts/backup-[service].sh
</code>

Ajouter au backup global :

<code bash>
sudo nano /opt/scripts/backup-all.sh
# Ajouter la ligne :
/opt/scripts/backup-[service].sh 2>&1 | tee -a "$LOG_FILE"
</code>

===== Étape 7 : Documentation =====

  - Créer la page ''services:[service]'' dans ce wiki
  - Ajouter le service à [[infrastructure:start|la page d'accueil]]
  - Ajouter le service à [[infrastructure:architecture|l'architecture]]
  - Mettre à jour [[infrastructure:changelog|le changelog]]

===== Étape 8 : Heimdall =====

Ajouter le service au dashboard [[https://dash.cotting.fr|Heimdall]].

===== Checklist finale =====

  - [ ] Service déployé et accessible
  - [ ] DNS configuré
  - [ ] HTTPS fonctionnel (certificat SSL)
  - [ ] Backup configuré
  - [ ] Documentation wiki créée
  - [ ] Ajouté à Heimdall
  - [ ] Changelog mis à jour

[[infrastructure:procedures|← Retour procédures]] | [[infrastructure:start|← Accueil]]
```

---

## 🎨 PARTIE 4 : Personnalisation de DokuWiki

### Configuration recommandée

**Aller sur :** `https://wiki.cotting.fr/doku.php?id=admin:configuration`

**Paramètres à modifier :**
```
Display:
  Theme: dokuwiki (par défaut) ou installer un thème
  Sidebar: left

Authentication:
  ACL: Activé
  Default ACL: Closed Wiki (recommandé)

Navigation:
  Breadcrumbs: 10
  Recent changes to show: 20

Editing:
  Allow HTML: Oui (si confiance)
  Use CAPTCHA: Non (wiki fermé)