serveurs:sinp-paca:cms-docker-devel [CBNA SINP]

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Développer un thème Wordpress avec Docker ======

===== Installation et configuration =====

  * Au préalable, installer Git, Docker et Docker-Compose sur votre machine de développement
    * Vous pouvez suivre [[serveurs:installation:docker|la procédure d'installation de Docker et Docker-Compose sous Debian 10]]
  * Commencer par cloner en local le dépôt [[https://github.com/cbn-alpin/sinp-paca-srv|cbn-alpin/sinp-paca-srv]] : ''git clone git@github.com:cbn-alpin/sinp-paca-srv.git''
  * En ligne de commande, se placer dans le dossier suivant : ''cd sinp-paca-srv/web-srv/docker/cms.silene.eu''
  * Créer un fichier //.env// adapté à votre environnement en se basant sur //.env.sample// : ''cp .env.sample .env''
    * Utiliser la commande ''id'' dans un terminal pour afficher vos identifiants numériques correspondant à votre utilisateur  (=UID) et groupe (=GID). Renseigner la propriété //WP_DEV_FPM_USER// avec au format //UID:GID//.
    * Si vous n'avez pas la possibilité de créer le lien symbolique comme indiqué ci-dessous, vous pouvez indiquer le chemin vers le dossier local de votre thème en cours de création dans la propriété //WP_DEV_THEME_PATH//.
    * Enfin, la propriété //WP_DEV_THEME_NAME// permet d'indiquer le nom du dossier du thème (par défaut "//silene//") qui sera placé dans le dossier ///var/www/html/wp-content/themes/// du container //cms-wordpress//.
  * Dans le dossier //wordpress// créer un lien symbolique vers le dossier hébergeant votre thème en cours de création : ''ln -s <mon-chemin-vers-theme> wordpress/theme''
  * Il est maintenant temps de construire les containers :
    * Créer le réseau Docker utilisé par nos "stack" : ''docker network create nginx-proxy''
    * Construire la stack "cms.silene.eu" normalement : ''docker-compose up --build''
    * Une fois la construction achevé, arrêter tout : '' CTRL+C ''
    * Relancer mais en mode DEV cette fois : ''docker-compose -f docker-compose.yml -f docker-compose.dev.yml up -d''
    * Se connecter au container //cms-wordpress// en tant que //root// : ''docker exec -it --user root cms-wordpress /bin/bash''
      * Changer le propriétaire et groupe du contenu du dossier "///var/www/html//" récursivement pour lui donner le même utilisateur et groupe que celui utilisé par FPM dans le container Worpdress en mode DEV (c'est à dire les votre sur l'hôte) : ''cd /var/www/html ; chown -R <votre-uid>:<votre-gid> .''
      * Vérifier aussi que tout les dossiers ont bien les droits //755// et les fichiers //644// sinon cela risque de poser problème avec le container Nginx (erreur 403). Au besoin, utiliser les commandes suivantes :
        * Changer les droits des dossiers : ''cd /var/www/html ; find . -type d -exec chmod 755 {} \;''
        * Changer les droits des fichiers : ''cd /var/www/html ; find . -type d -exec chmod 755 {} \;''
      * Les commandes précédentes peuvent afficher des erreurs qui sont dues au montage du dossier du thème //Silene// en lecture seule. Ils peuvent être ignoré.
    * Finaliser en arrêtant puis relançant la stack : ''docker-compose down ; docker-compose -f docker-compose.yml -f docker-compose.dev.yml up -d ''
  * Pour lancer localement en mode développement le CMS Worpdress utiliser la commande suivante (l'ordre d'appel des fichiers //.yml// est important) : ''docker-compose -f docker-compose.yml -f docker-compose.dev.yml up''
    * Le CMS devrait être accessible sur l'adresse locale : http://127.0.0.1:50080
    * Note : l'option ''-d'' permet de lancer la "stack" en tant que "//daemon//" et de ne plus voir les logs des services dans le terminal : ''docker-compose -f docker-compose.yml -f docker-compose.dev.yml up -d''


===== Commandes utiles =====
  * Pour accéder au container Nginx en tant que root : ''<nowiki> docker exec -it --user root cms-nginx /bin/bash </nowiki>''
  * Pour accéder au container Wordpress en tant que root : ''<nowiki> docker exec -it cms-wordpress --user root /bin/bash </nowiki>''
  * Effacer tous les volumes (**ATTENTION** : supprime toutes les données !) : ''<nowiki> docker-compose down --volumes </nowiki>''
  * Pour voir si tout vos paramètres sont correctement pris en compte par Docker Compose : ''<nowiki> docker-compose -f docker-compose.yml -f docker-compose.dev.yml config </nowiki>''


===== Notes sur la gestion des permissions =====
  * Le dossier de travail local du thème est partagé avec 2 containers (//cms-nginx//, //cms-wordpress//). Afin qu'il soit accessible par les utilisateurs de ces containers, il est nécessaire de s'assurer que les dossiers qu'il contient ont bien les droits 755 et les fichiers 644 (au moins durant la phase de développement). Lorsque c'est possible, il est aussi plus pratique que l'utilisateur de l'application du container (PHP-FPM ou Nginx) utilise le même UID et GID que votre utilisateur local.
  * Pour le container //cms-wordpress// (basé sur l'image PHP officiel - variante FPM), il est nécessaire de le lancer avec un utilisateur dont l'id est identique à celui de votre utilisateur local (généralement 1000). C'est ce que permet de faire l'attribut "//user://" du service //cms-wordpress// dans le fichier //docker-compose.dev.yml//. De cette façon, toute modification effectuée sur les fichiers locaux sera répercuté dans le container et restera accessible par l'utilisateur de //PHP-FPM//. Voir la section "Running as an arbitrary user" dans [[https://hub.docker.com/_/wordpress/|la documentation concernant l'image Wordpress]] et la même dans [[https://hub.docker.com/_/php|la documentation de l'image PHP]].
  * Concernant le container //cms-nginx//, le changement d'utilisateur n'étant pas évidant, il suffit de s'assurer pour le dossier de travail local que :
    * les dossiers aient des droits en lecture et exécution pour "les autres" (=5).
    * les fichiers aient des droits en lecture pour "les autres" (=4).