Installer WordPress avec Docker

Démarrage rapide

1. Téléchargez un exemple de modèle de docker-compose pour wordpress:

git clone https://github.com/kassambara/wordpress-docker-compose
cd wordpress-docker-compose

2. Démarrer l’Installation WordPress avec docker-compose

Vous pouvez utiliser soit les commandes standard docker-composer, soit la commande make.

• Utilisation des commandes de raccourci make (facile pour les systèmes Unix (MAC, Linux)):

make install

• Utilisation des commandes standard docker-compose:

# Construisez des images, puis commencez
docker-compose up -d --build
# Vérifiez la disponibilité des services : MySQL, Nginx/Wordpress
docker-compose run --rm healthcheck

3. Configurer wordpress manuellement

• Visitez votre site à l’adresse http://localhost pour commencer à configurer votre installation wordpress.
• Visitez l’interface phpMyAdmin de votre base de données à l’adresse http://localhost:8080. Identification par défauts:
  • Username: root
  • Password: password

Installation et configuration automatique du docker wordpress:

• Utilisation des commandes de raccourci make (facile pour les systèmes Unix (MAC, Linux)):

make autoinstall

• Utilisation des commandes standard docker-compose:

# Créer des images dockers et lancer wordpress
docker-compose up -d --build
# Configuration automatique de wordpress
docker-compose -f docker-compose.yml -f wp-auto-config.yml run --rm wp-auto-config

• Visitez votre site à l’adresse suivante : http://localhost

Ensemble de commandes utiles à connaître:

• Utilisation des commandes de raccourci make (facile pour les systèmes Unix (MAC, Linux)):

# Arrêtez et supprimez les conteneurs docker de WordPress
make down
# Construire et démarrer le site wordpress
make start
# Tout réinitialiser
make reset

• Utilisation des commandes standard docker-compose:

# Arrêter et supprimer les conteneurs
docker-compose down
# Construire et démarrer le site wordpress
docker-compose up -d --build
# Tout réinitialiser
docker-compose down
rm -rf mysql/* wordpress/*

Étape 1. Téléchargez un modèle de docker-compose pour WordPress

Téléchargez un modèle à partir de Github à l’adresse kassambara/wordpress-docker-compose

git clone https://github.com/kassambara/wordpress-docker-compose
cd wordpress-docker-compose

Modèle d’arborescence de répertoires:

files/wordpress-docker-compose
├── LICENSE
├── Makefile
├── README.Rmd
├── README.md
├── config
│   └── php.conf.ini
├── docker-compose-onlinehost.yml
├── docker-compose.yml
├── mysql
├── setup-onlinehost.sh
├── wordpress
├── wp-auto-config.yml
└── wpcli
    ├── Dockerfile
    ├── Makefile
    └── entrypoint.sh

Dossiers essentiels:

• mysql : Fichiers de base de données MySQL pour MariaDB
• wordpress : Fichiers web WordPress
• wpcli contient un exemple de Dockerfile pour construire le CLI de WordPress.

Dossiers essentiels:

• Fichier .env : contient les variables d’environnement requises pour l’installation de wordpress
• docker-compose.yml : docker-compose définissant les services WordPress
• Makefile : Ensemble de lignes de commande bash simples pour construire, installer et configurer WordPress, ainsi que pour démarrer et arrêter les conteneurs dockers.

Étape 2. Inspecter le contenu des fichiers de configuration (facultatif)

Étape 3. Modifier les variables d’environnement de configuration du Docker WordPress

Un fichier .env a été inclus pour définir facilement les variables d’environnement docker-compose sans avoir à modifier le fichier de configuration docker-compose.yml lui-même.

Des valeurs par défaut ont été fournies afin de permettre une mise en service rapide à des fins de test. Il appartient à l’utilisateur de les modifier pour les adapter au mieux à ses préférences de déploiement.

Ouvrez le fichier .env et mettez le contenu à jour si vous le souhaitez. Par exemple, il suffit de changer le nom du projet et votre mot de passe (pour la base de données et wordpress admin).

# Ouvrir le dossier
nano .env

Contenu:

# 1/ Nom de Project -------------------------------------------------
# Doit être en minuscules, sans espaces et sans caractères de chemins invalides.
# Sera également utilisé comme nom de la base de données de WP
COMPOSE_PROJECT_NAME=wordpress

# 2/ Base de données login et mot de passe -----------------------------------------
# Définir un utilisateur de la base de données non root si vous le souhaitez (facultatif)
DATABASE_PASSWORD=password
DATABASE_USER=root

# 3/ Pour l'autoinstallation et l'auto-configuration WordPress-------------------
WORDPRESS_WEBSITE_TITLE="My Blog"

# URL : Utilisez ceci pour localhost
WORDPRESS_WEBSITE_URL="http://localhost"
WORDPRESS_WEBSITE_URL_WITHOUT_HTTP=localhost
# Or this for online hosting (remove the # comment prefix)
# WORDPRESS_WEBSITE_URL="http://www.example.com"
# WORDPRESS_WEBSITE_URL_WITHOUT_HTTP="www.example.com"
WORDPRESS_WEBSITE_POST_URL_STRUCTURE="/blog/%postname%/"

# Identification de l'administrateur du site web. Précisez un mot de passe fort 
WORDPRESS_ADMIN_USER="wordpress"
WORDPRESS_ADMIN_PASSWORD="wordpress"
WORDPRESS_ADMIN_EMAIL="your-email@example.com"

# 4/ Versions des logiciels-----------------------------------------------
WORDPRESS_VERSION=latest
MARIADB_VERSION=latest

# 5/ Ports: Peut être changés -------------------------------------------
PHPMYADMIN_PORT=8080

# 6/ Volumes sur l'hôte--------------------------------------------------
WORDPRESS_DATA_DIR=./wordpress

# 7/ Vérification de la disponibilité des services d'hébergement (serveur mysql et woordpress)
# Temps d'attente en seconde
WAIT_BEFORE_HOSTS=5
WAIT_AFTER_HOSTS=5
WAIT_HOSTS_TIMEOUT=300
WAIT_SLEEP_INTERVAL=60
WAIT_HOST_CONNECT_TIMEOUT=5

# 8/ Utilisé seulement pour le déploiement en ligne -------------------------------
WORDPRESS_WEBSITE_URL_WITHOUT_WWW=example.com
PHPMYADMIN_WEBSITE_URL_WITHOUT_HTTP=sql.example.com

Étape 4. Installer WordPress en utilisant docker-compose

Deux méthodes sont disponibles pour installer et configurer votre site web WordPress:

1. Installation automatique + configuration manuelle
2. Installation automatique + configuration automatique

docker-compose build
docker-compose up -d 
docker-compose run --rm healthcheck

make install

docker-compose down
rm -rf mysql/* wordpress/*

# Créer des images dockers et lancer wordpress
docker-compose up -d --build
# Configuration automatique de wordpress
docker-compose -f docker-compose.yml -f wp-auto-config.yml run --rm wp-auto-config

make autoinstall

Étape 5. Accès à votre site web

1. Visitez votre site web wordpress à l’adresse http://localhost. Identification par défaut pour admin (http://localhost/wp-login.php):
   • Username: wordpress
   • Password: wordpress

2. Visitez votre base de données via phpMyAdmin à l’adresse http://localhost:8080
   • Username: root
   • Password: password

Arrêt et nettoyage

Cette section présente un ensemble de commandes utiles à connaître.

1. Fermeture des conteneurs et des dépendances du docker WordPress. La commande docker-composer down supprime les conteneurs et le réseau par défaut, mais préserve votre base de données WordPress.

# Arrêter et supprimer les conteneurs
docker-compose down

2. (Re)démarrer les conteneurs docker-compose de WordPress

docker-compose up -d

3. Réinitialisez tout

• Arrêter et supprimer les conteneurs
• Supprimer les fichiers wordpress et mysql installés

docker-compose down
rm -rf mysql/* wordpress/*

# Construire et démarrer le site wordpress
make start
# Arrêtez et supprimez les conteneurs docker de WordPress
make down
# Tout réinitialiser
make reset

Conseils de débogage sur Windows

Si vous rencontrez une erreur sur le conteneur mysql comme celle-ci:

[ERROR] Plugin ‘InnoDB’ registration as a STORAGE ENGINE failed.
[ERROR] Unknown/unsupported storage engine: InnoDB

veuillez ajouter ce qui suit à la strophe mysql:

command: --innodb-flush-method=fsync --innodb-use-native-aio=0

Cela est dû en partie au fait que Windows (ou plus précisément NTFS) ne prend pas en charge les I/O asynchrones (voir ceci pour plus de détails).

Résumé

Ce tutoriel fournit un guide pratique pour WordPress pour le développement local en utilisant le docker compose.

Références

• WordPress : avec le serveur web Nginx dans le Docker
• Quickstart : Compose and WordPress
• WordPress, la voie automatisée (partie 1) : configuration