OPS_DOCS

Étape 6 : Dépannage & Débogage

Même les meilleures configurations rencontrent des obstacles. Voici comment inspecter, diagnostiquer et résoudre les erreurs.

Maîtriser les Logs

Les logs sont votre premier outil de diagnostic. Visualisez ce qui se passe à l'intérieur de vos containers en temps réel.

# Voir les dernières lignes
docker logs --tail 50 container_name

# Suivre en direct (Live feedback)
docker logs -f container_name

# Avec Docker Compose (tous les services de la stack)
docker compose logs -f --tail 20

Déboguer en Développement

Si un service ne démarre pas ou se comporte mal, inspectez son environnement et sa structure interne.

Entrer dans le container

docker exec -it name bash

Vérifier les variables d'env

docker inspect name | grep Env

Permission Denied (Docker Volumes)

Si vos containers ne peuvent pas écrire dans les dossiers montés (ex: `wp-content`), c'est souvent un problème de permissions sur l'hôte.

# Appliquer récursivement à www-data (UID 33)
sudo chown -R 33:33 /opt/stacks/wordpress/wp-content

Boucles de redirection HTTPS

WordPress peut se perdre s'il ne sait pas que Cloudflare gère le SSL. Ajoutez ceci en haut de votre `wp-config.php`.

if (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https') {
    $_SERVER['HTTPS'] = 'on';
}

Le tunnel ne se connecte pas

  • Vérifiez les logs : docker logs cloudflared-tunnel
  • Assurez-vous que le **Token** est correct.
  • Vérifiez la connexion internet du VPS.