Contrôler les conteneurs Docker

WP Staging CLI fournit des commandes pour contrôler les conteneurs Docker de tes sites WordPress. Ce guide couvre le démarrage, l’arrêt et le redémarrage des conteneurs, la vérification du statut et l’accès aux shells.

Démarrer les conteneurs

Démarre les conteneurs pour tous les sites :

wpstaging start

Démarre les conteneurs pour un site spécifique :

wpstaging start mysite.local

Arrêter les conteneurs

Arrête les conteneurs pour tous les sites :

wpstaging stop

Arrête les conteneurs pour un site spécifique :

wpstaging stop mysite.local

Redémarrer les conteneurs

Redémarre les conteneurs pour tous les sites :

wpstaging restart

Redémarre les conteneurs pour un site spécifique :

wpstaging restart mysite.local

Utilise le redémarrage lorsque tu as effectué des changements de configuration ou si un site ne répond plus.

Vérifier le statut des conteneurs

Affiche le statut de tous les sites :

wpstaging status

Exemple de résultat :

HOSTNAME            STATUS      CONTAINERS
mysite.local        running     php: Up, nginx: Up, mariadb: Up, mailpit: Up
dev.local           stopped     php: -, nginx: -, mariadb: -, mailpit: -
test.local          running     php: Up, nginx: Up, mariadb: Up, mailpit: Up

Vérifie le statut de sites spécifiques :

wpstaging status mysite.local

Ou de plusieurs sites :

wpstaging status site1.local site2.local

Accéder au shell PHP

Ouvre un shell interactif dans le conteneur PHP (en tant qu’utilisateur du serveur web) :

wpstaging shell mysite.local

Ouvre un shell en tant que root :

wpstaging shell mysite.local root

Une fois dans le shell, tu as accès à :

• Les fichiers WordPress dans /var/www/html
• WP-CLI pour la gestion WordPress
• PHP et Composer

Exemple de session shell :

$ wpstaging shell mysite.local
www-data@php:/var/www/html$ wp plugin list
+----------------+----------+--------+---------+
| name           | status   | update | version |
+----------------+----------+--------+---------+
| akismet        | inactive | none   | 5.3     |
| hello          | inactive | none   | 1.7.2   |
+----------------+----------+--------+---------+
www-data@php:/var/www/html$ exit

Accéder au shell de la base de données

Ouvre un shell interactif dans le conteneur MariaDB :

wpstaging shell-db mysite.local

Ouvre en tant que root :

wpstaging shell-db mysite.local root

Cela te donne un accès direct à la ligne de commande MySQL/MariaDB pour la gestion de la base de données.

Supprimer toutes les données Docker

Arrête tous les conteneurs et supprime toutes les données Docker (volumes, configurations, etc.) :

wpstaging remove

Utilise cette commande lorsque tu souhaites nettoyer complètement ton environnement Docker ou avant de désinstaller WP Staging CLI.

Flag de chemin d’environnement

Toutes les commandes de conteneur prennent en charge le flag --env-path pour spécifier un emplacement d’environnement Docker personnalisé :

wpstaging start --env-path=/custom/path
wpstaging stop --env-path=/custom/path
wpstaging status --env-path=/custom/path

Par défaut : ~/wpstaging

Récapitulatif des commandes

Dépannage

Les conteneurs ne démarrent pas

• Vérifie que Docker est en cours d’exécution : docker info
• Vérifie l’absence de conflits de ports : lsof -i :80 (ou le port utilisé)
• Consulte les logs Docker : docker logs <container-name>
• Assure-toi d’avoir suffisamment d’espace disque et de mémoire

Site inaccessible

• Vérifie que les conteneurs sont en cours d’exécution : wpstaging status mysite.local
• Vérifie l’entrée dans le fichier hosts : cat /etc/hosts | grep mysite.local
• Mets à jour le fichier hosts : wpstaging update-hosts-file
• Essaie de redémarrer : wpstaging restart mysite.local

Accès au shell refusé

• Assure-toi que les conteneurs du site sont en cours d’exécution
• Essaie d’accéder en tant que root : wpstaging shell mysite.local root

Prochaines étapes

• Gérer des sites WordPress Docker – Ajouter, supprimer et configurer des sites
• Configuration Docker – Configuration avancée
• Nettoyage et maintenance – Nettoyer les ressources