Installation et mise à jour de Droopler en un coup d'œil
Droptica est une agence Drupal. Dans notre travail, nous nous retrouvons très souvent à construire des sites web d'entreprise sur Drupal. Pour ne pas réinventer la roue à chaque fois, nous avons créé Droopler. Droopler est un outil open-source de pointe pour construire des sites web, basé sur la dernière version de Drupal. Le système a été conçu pour permettre une modification facile et flexible du contenu qui a fière allure sur chaque appareil. Vous pouvez en savoir plus sur www.droopler.com.
Une version démo du système est disponible à https://droopler-demo.droptica.com/
Avant de pouvoir vous familiariser avec les possibilités et fonctionnalités offertes par Droopler, je vais vous guider dans le processus d'installation.
Prérequis techniques
Plusieurs prérequis techniques doivent être remplis avant de commencer l'installation. La pile suivante est requise pour installer Droopler :
- Apache (ou un autre serveur web),
- SQLite, MySQL, MariaDB, PostgreSQL ou une autre base de données;
- PHP 7.
La plupart des fournisseurs d'hébergement mutualisé (sharehost) offrent une telle pile. Avant de commencer le processus d'installation, il convient de vérifier si la version de PHP est réglée sur 7.
Configuration de Droopler
Le processus d'installation suivant est destiné aux utilisateurs qui n'ont pas d'accès root au système d'exploitation (hébergement mutualisé, etc.).
Étape 1 – Téléchargement des fichiers sur le serveur
Les étapes suivantes doivent être exécutées dans le répertoire vers lequel le domaine est pointé (DocumentRoot).
Méthode 1
Cette méthode peut être utilisée si votre fournisseur d'hébergement offre un accès au serveur via SSH.
Important: avant d'utiliser cette méthode pour configurer Droopler, assurez-vous que les commandes telles que
composer --help
npm help
gulp -version
sont disponibles. Si l'exécution des commandes ci-dessus ne renvoie pas de message "commande introuvable" ou d'autres erreurs, vous pouvez continuer. Sinon, passez directement à la méthode 2 :-)
Dans cette méthode, vous devez simplement exécuter les commandes listées ci-dessous pour télécharger les fichiers nécessaires :
git clone -b no_web https://github.com/droptica/droopler_project
cd droopler_project
composer install
composer drupal-scaffold
composer install
À ce stade, vous devez simplement compiler les fichiers SCSS en CSS. Pour ce faire, suivez simplement les instructions ci-dessous :
cd web/themes/custom/droopler_subtheme
npm install
npm install --global gulp-cli
gulp compile
Méthode 2
1. Téléchargez le package clé en main depuis https://www.droopler.com/download
2. Décompressez le package téléchargé et téléchargez-le sur le serveur via FTP.
Étape 2 - configuration de Droopler
Lancez votre navigateur et entrez l'adresse. Vous serez automatiquement redirigé vers l'assistant de configuration de Droopler. Suivez les instructions de l'assistant pour compléter le processus d'installation.
Configurer Droopler dans Docker en utilisant l'outil dcon
Important: L'accès root au système d'exploitation est nécessaire pour réaliser les étapes ci-dessous.
Installez l'outil dcon, selon les instructions sur https://github.com/droptica/docker-console, et exécutez un conteneur https://github.com/droptica/nginx-proxy .
Nous avons écrit plus d'informations sur l'exécution de dcon et nginx-proxy dans l'un de nos articles précédents.
Pour exécuter des conteneurs Docker sur lesquels Droopler fonctionnera, vous avez besoin d'un fichier docker-compose.yml. Vous pouvez télécharger un emballage d'exemple, où vous trouverez les fichiers nécessaires.
git clone https://github.com/DropticaExamples/droopler-wrapper-example.git
Modifiez le paramètre VIRTUAL_HOST à l'adresse de domaine de votre propre page dans le fichier docker-compose.yml téléchargé. Lorsque vous publiez votre site en ligne, il est également conseillé de supprimer ou de commenter le conteneur phpmyadmin pour des raisons de sécurité.
Maintenant, vous devez télécharger le dépôt Droopler dans le répertoire /app – exécutez la commande suivante dans le répertoire où vous avez téléchargé le dépôt (wrapper) au préalable :
git clone https://github.com/droptica/droopler_project app
Pour construire et lancer les conteneurs Docker, exécutez les commandes suivantes dans la console :
dcon update-images
dcon up
Tout ce que vous avez à faire est de lancer l'installation d'un profil Droopler :
dcon build-profile
Il vous sera demandé de saisir un jeton GitHub. Copiez le lien et chargez la page, un jeton sera généré, que vous devez copier dans la console et confirmer en appuyant sur entrer.
Après avoir effectué plusieurs opérations, Droopler sera prêt pour le premier lancement. Démarrez le navigateur et entrez l'adresse de votre page.
Mise à jour
Droopler est constamment développé et enrichi de nouvelles fonctionnalités. Afin de développer ces fonctionnalités sur votre site web, vous devriez vous assurer de mettre à jour le système régulièrement. Les mises à jour incluent également des correctifs de sécurité.
IMPORTANT! Nous vous conseillons fortement de faire une sauvegarde de vos fichiers et de votre base de données, ainsi que d'activer le mode maintenance – example.com/admin/config/development/maintenance – avant de mettre à jour Droopler.
Vous pouvez mettre à jour Droopler de l'une des deux manières :
Méthode 1
Si vous avez installé Droopler en téléchargeant le code source depuis le dépôt https://github.com/droptica/droopler_project, cette méthode vous est destinée :)
Connectez-vous au serveur via SSH et exécutez la commande git pull dans le répertoire où vous avez téléchargé le dépôt au préalable.
La prochaine étape dépend de si vous avez installé l'outil dcon ou non. Si dcon est disponible, exécutez la commande suivante :
dcon compose-updateCependant, si vous n'avez pas installé dcon, vous devrez exécuter :
composer update
Méthode 2
Téléchargez un nouvel assemblage depuis https://www.droopler.com/download
Le package téléchargé doit être décompressé et téléchargé sur le serveur via FTP, remplaçant les fichiers existants sur le serveur.
Lancez votre navigateur et allez sur www.example.com/update.php
Conclusion
Félicitations! Vous venez d'apprendre plusieurs façons de configurer et de mettre à jour Droopler, une distribution Drupal. Comme vous pouvez le voir, c'est vraiment facile :-) Cependant, si vous rencontrez des problèmes que vous ne pouvez pas résoudre vous-même, laissez-nous un message. Nous serons ravis de vous aider!
