dokuwiki

User Tools

Site Tools

Trace: ‱ nouveau-service
infrastructure:procedures:nouveau-service

Table of Contents

Procédure : Ajouter un nouveau service

Étape 1 : PrĂ©paration

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

Étape 2 : Configuration Docker

# Créer la structure
sudo mkdir -p /opt/stacks/[service]
cd /opt/stacks/[service]
 
# Créer docker-compose.yml
sudo nano docker-compose.yml

Template docker-compose.yml : 

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

Étape 3 : DNS AdGuard

  1. Accéder à AdGuard
  2. Filters → DNS rewrites → Add DNS rewrite
  3. [service].cotting.fr → 192.168.1.200
  4. Save

Étape 4 : DĂ©ploiement

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]

Étape 5 : VĂ©rification

# 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

Étape 6 : Configuration backup

Créer le script de backup : 

sudo nano /opt/scripts/backup-[service].sh

Ajouter au backup global : 

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

Étape 7 : Documentation

  1. Créer la page services:[service] dans ce wiki
  2. Ajouter le service Ă  la page d'accueil
  3. Ajouter le service Ă  l'architecture
  4. Mettre Ă  jour le changelog

Étape 8 : Heimdall

Ajouter le service au dashboard Heimdall.

Checklist finale

  1. [ ] Service déployé et accessible
  2. [ ] DNS configuré
  3. [ ] HTTPS fonctionnel (certificat SSL)
  4. [ ] Backup configuré
  5. [ ] Documentation wiki créée
  6. [ ] Ajouté à Heimdall
  7. [ ] Changelog mis Ă  jour

← Retour procĂ©dures | ← 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é)
infrastructure/procedures/nouveau-service.txt · Last modified: by olicot