diff --git a/CHANGELOG.md b/CHANGELOG.md index 5fade96..0f26c16 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -16,6 +16,8 @@ The **patch** part changes is incremented if multiple releases happen the same m ### Changed +* Readme.md : Translated to english. New contribution guidelines and misc information + ### Fixed * web-add.sh : Deleting mysql user with DROP USER to stay compatible with MariaDB 10.5+ - #78 diff --git a/INSTALL b/INSTALL deleted file mode 100644 index 92bba47..0000000 --- a/INSTALL +++ /dev/null @@ -1 +0,0 @@ -* Ajouter les autorisations sudo nécessaires diff --git a/README.md b/README.md index c6e9303..a96e0be 100644 --- a/README.md +++ b/README.md @@ -1,242 +1,48 @@ -# evoadmin-web +# Evoadmin-web -Panel d'administration de serveur web et scripts shell. +Web interface and management scripts for web hosting Project leader : ? -## Versions +## Versions & Branches - * Stable Wheezy → git checkout wheezy - * Stable Jessie → git checkout jessie - * Stretch → master +The `master` branch is ready for production. +It's compatible with the current Debian version (and few previous ones) + +Code for older Debian releases (Wheezy, Jessie) is archived on separate branches. + +The `unstable` branch contains not sufficiently tested changes that we don't consider ready for production yet. + +### Versions + +* Debian Stretch, Buster, Bullseye → use branch `master` (current stable version) +* Debian Jessie → use branch `jessie` (old, archive branch) +* Debian Wheezy → use branch `wheezy` (old, archive branch) ## Installation -Via ansible avec le role packweb-apache. Le role webapps/evoadmin-web en dépendance se charge de l'installation de l'interface et de ses scripts. +Installation should be done with Ansible. +The role `packweb-apache` will handle all dependencies (Apache, PHP, MariaDB...) installation and configuration. +It will also use the role `webapps/evoadmin-web` to setup the web-interface and management sw -### Manuelle +### Manually TODO +## Contributing -### Activation du mode Multi PHP avec des conteneurs LXC +Contributions are welcome, especially bug fixes. They will be merged in if they are consistent with our conventions and use cases. They might be rejected if they introduce complexity, cover features we don't need or don't fit "style". -Installer les paquets nécessaires : +Before starting anything of importance, we suggest opening an issue to discuss what you'd like to add or change. -~~~ -# apt install lxc debootstrap -~~~ +All modifications should be documented in the CHANGELOG file, to help review releases. We encourage atomic commits and with the CHANGELOG in the same commit. -Modifier la configuration de LXC : +# Workflow -~~~ -# cat /etc/lxc/default.conf +The ideal and most typical workflow is to create a branch, based on the `unstable` branch. The branch should have a descriptive name (a ticket/issue number is great). The branch can be treated as a pull-request or merge-request. It should be propery tested and reviewed before merging into `unstable`. -# Set the default network virtualization method. -lxc.network.type = none +Changes that don't introduce significant changes — or that must go faster that the typical workflow — can be commited directly into `unstable`. -# Mount /home into containers. -lxc.mount.entry = /home home none bind 0 0 +Hotfixes, can be prepared on a new branch, based on `master` or `unstable` (to be decided by the author). When ready, it can be merged back to `master` for immediate deployment and to `unstable` for proper backporting. -# Only one tty is enough. -# This require that you disabled others tty ([2-6]) in systemd. -lxc.tty = 1 - -# Run 64bits containers -lxc.arch = x86_64 - -# Start containers on boot by default -lxc.start.auto = 1 -~~~ - -Dans cette configuration, les containers LXC n'ont pas leur interface réseau virtualisée. Et /home de l'hôte est partagé dans les containers. - -#### PHP 5.6 - -On installe un conteneur Debian Jessie : - -~~~ -# lxc-create --name php56 --template debian --bdev dir --logfile /var/log/lxc/lxc-php56.log --logpriority INFO -- --arch amd64 --release jessie -~~~ - -Puis on installe les paquets PHP 5.6 dans ce conteneur : - -~~~ -# lxc-start -n php56 -# lxc-attach -n php56 apt install php5-fpm php5-cli php5-gd php5-imap php5-ldap php5-mcrypt php5-mysql php5-pgsql php-gettext php5-intl php5-curl php5-ssh2 libphp-phpmailer -~~~ - -#### PHP 7.0 - -On installe un conteneur Debian Stretch : - -~~~ -# lxc-create --name php70 --template debian --bdev dir --logfile /var/log/lxc/lxc-php70.log --logpriority INFO -- --arch amd64 --release stretch -~~~ - -Puis on installe les paquets PHP 7.0 dans ce conteneur : - -~~~ -# lxc-start -n php70 -# lxc-attach -n php70 apt install php-fpm php-cli php-gd php-intl php-imap php-ldap php-mcrypt php-mysql php-pgsql php-gettext php-curl php-ssh2 composer libphp-phpmailer -~~~ - -#### PHP 7.3 - -On installe un conteneur Debian Stretch : - -~~~ -# lxc-create --name php73 --template debian --bdev dir --logfile /var/log/lxc/lxc-php73.log --logpriority INFO -- --arch amd64 --release stretch -~~~ - -Puis on installe les paquets PHP 7.3 dans ce conteneur : - -~~~ -# lxc-start -n php73 -# lxc-attach -n php73 - -# apt-get update && apt-get install -y --no-install-recommends wget apt-transport-https ca-certificates gnupg -# curl https://packages.sury.org/php/apt.gpg | apt-key add -# echo "deb https://packages.sury.org/php/ stretch main" > /etc/apt/sources.list.d/sury.list -# apt-get update && apt-get install -y --no-install-recommends php7.3 php7.3-fpm php7.3-cli php7.3-curl php7.3-mysql php7.3-pgsql php7.3-ldap php7.3-imap php7.3-gd php-ssh2 php-gettext composer libphp-phpmailer -~~~ - -#### Pour toutes les versions de PHP - -Dans les containers, il faut ajouter le fichier **z-evolinux-defaults.ini** dans le dossier **conf.d** des réglages de PHP FPM et CLI - -> Pour PHP5 **/etc/php5/fpm/conf.d/z-evolinux-defaults.ini** et **/etc/php5/cli/conf.d/z-evolinux-defaults.ini** -> -> Pour PHP7.0 **/etc/php/7.0/fpm/conf.d/z-evolinux-defaults.ini** et **/etc/php/7.0/cli/conf.d/z-evolinux-defaults.ini** -> -> Pour PHP7.3 **/etc/php/7.3/fpm/conf.d/z-evolinux-defaults.ini** et **/etc/php/7.3/cli/conf.d/z-evolinux-defaults.ini** - -~~~ -[PHP] -short_open_tag = Off -expose_php = Off -display_errors = Off -log_errors = On -html_errors = Off -allow_url_fopen = Off -disable_functions = exec,shell-exec,system,passthru,putenv,popen -~~~ - -Après cela, il faut redémarrer FPM - -~~~ -# lxc-attach -n php56 /etc/init.d/php5-fpm restart -# lxc-attach -n php70 /etc/init.d/php7.0-fpm restart -# lxc-attach -n php73 /etc/init.d/php7.3-fpm restart -~~~ - -Une fois les conteneurs installés, il faut configurer evoadmin-web pour lui indiquer les versions disponibles de PHP dans **/etc/evolinux/web-add.conf** (pour *web-add.sh*) et dans **/home/evoadmin/www/conf/config.local.php** pour l'interface web - -~~~ -# cat /etc/evolinux/web-add.conf -#(...) -PHP_VERSIONS=(56 70 73) -#(...) -~~~ - -~~~ -# cat /home/evoadmin/www/conf/config.local.php -// (...) -$localconf['php_versions'] = array(70, 73); -// (...) -~~~ - -#### Apache - -Il est nécessaire d'activer le mod proxy pour apache2 si ce n'a pas déjà été fait : - -~~~ -# a2enmod proxy_fcgi -# systemctl restart apache2.service -~~~ - -Si vous rencontrez l'erreur "File not found" avec les fichiers php, bien vérifier que le rootfs des conteneurs est en 755 : - -~~~ -# chmod 755 /var/lib/lxc/php56/rootfs -# chmod 755 /var/lib/lxc/php70/rootfs -# chmod 755 /var/lib/lxc/php73/rootfs -~~~ - -#### Email - -Pour envoyer des mails, on peut installer **ssmtp** qui va forwarder les mails du conteneur vers l'hôte (à faire par conteneur via lxc-attach) : - -Avant d'installer le paquet, il faut ajouter le hostname du conteneur dans **/etc/hosts**, sinon la configuration du paquet retourne une erreur : - -~~~ -127.0.0.1 php70 -~~~ - -~~~ -# apt install ssmtp -~~~ - -Editer **/etc/ssmtp/ssmtp.conf** (remplacer example.com par le hostname complet de votre machine) : - -~~~ -root=postmaster -mailhub=127.0.0.1 -hostname=example.com -FromLineOverride=YES -~~~ - -#### PHP-CLI - - -~~~ -$ cat /usr/local/bin/exec73 -#!/bin/bash - -php_cmd=$(printf "/usr/bin/php %q" "$@" ) -lxc-attach -n php73 -- su - "$SUDO_USER" -c "$php_cmd" -~~~ - -Il faut ensuite s'assurer que ce script peut être exécuté via sudo. - - - -## Méthodes de collaboration - -Lire le fichier GUIDELINES. - -Chaque version stable a le nom de la version Debian dans une branche. (Wheezy, Jessie, …) -On ne touche pas à ces branches, sauf pour corriger un bug critique, -qu'on appellera dans le commit "Hotfix #IDBugRedmine. Description du commit/bug". -Le project leader se charge de merger les futures version (wheezy-dev, jessie-dev, …) -dans la branche stable et de faire un changelog. - -Chaque version de redmine est prévu à l'avance dans la roadmap de Redmine. -Quand une version de développement est terminé (tout les bugs fermés), -on utilisera les tags pour se repérer dans l'historique GIT. -Puis une fois que la version est décrété stable, elle sera mergé dans la branche stable. - -Pour travailler sur une version spécifique, il faut travailler dans la branche "$release". -Voir les branches sur le remote : - -``` -$ git branch -r - origin/jessie-dev - origin/wheezy-dev - origin/wheezy -``` - -Il suffira de « checkout » dessus, et commencer à commiter. Les commits doivent -être nommés "Implement #IDBugRedmine. Description feature." ou -"Fix #IDBugRedmine. Description correction du bug.". - -``` -$ git checkout wheezy-dev -[…] hack hack […] -$ git commit -$ git push -``` - -## Licence - -Evoadmin-web est un projet [Evolix](https://evolix.com) et est distribué sour licence AGPLv3, voir le fichier [LICENSE](LICENSE) pour les détails. +Other workflow are not forbidden, but should be discussed in advance. diff --git a/README.old.md b/README.old.md new file mode 100644 index 0000000..3f483cc --- /dev/null +++ b/README.old.md @@ -0,0 +1,180 @@ + +### Activation du mode Multi PHP avec des conteneurs LXC + +Installer les paquets nécessaires : + +~~~ +# apt install lxc debootstrap +~~~ + +Modifier la configuration de LXC : + +~~~ +# cat /etc/lxc/default.conf + +# Set the default network virtualization method. +lxc.network.type = none + +# Mount /home into containers. +lxc.mount.entry = /home home none bind 0 0 + +# Only one tty is enough. +# This require that you disabled others tty ([2-6]) in systemd. +lxc.tty = 1 + +# Run 64bits containers +lxc.arch = x86_64 + +# Start containers on boot by default +lxc.start.auto = 1 +~~~ + +Dans cette configuration, les containers LXC n'ont pas leur interface réseau virtualisée. Et /home de l'hôte est partagé dans les containers. + +#### PHP 5.6 + +On installe un conteneur Debian Jessie : + +~~~ +# lxc-create --name php56 --template debian --bdev dir --logfile /var/log/lxc/lxc-php56.log --logpriority INFO -- --arch amd64 --release jessie +~~~ + +Puis on installe les paquets PHP 5.6 dans ce conteneur : + +~~~ +# lxc-start -n php56 +# lxc-attach -n php56 apt install php5-fpm php5-cli php5-gd php5-imap php5-ldap php5-mcrypt php5-mysql php5-pgsql php-gettext php5-intl php5-curl php5-ssh2 libphp-phpmailer +~~~ + +#### PHP 7.0 + +On installe un conteneur Debian Stretch : + +~~~ +# lxc-create --name php70 --template debian --bdev dir --logfile /var/log/lxc/lxc-php70.log --logpriority INFO -- --arch amd64 --release stretch +~~~ + +Puis on installe les paquets PHP 7.0 dans ce conteneur : + +~~~ +# lxc-start -n php70 +# lxc-attach -n php70 apt install php-fpm php-cli php-gd php-intl php-imap php-ldap php-mcrypt php-mysql php-pgsql php-gettext php-curl php-ssh2 composer libphp-phpmailer +~~~ + +#### PHP 7.3 + +On installe un conteneur Debian Stretch : + +~~~ +# lxc-create --name php73 --template debian --bdev dir --logfile /var/log/lxc/lxc-php73.log --logpriority INFO -- --arch amd64 --release stretch +~~~ + +Puis on installe les paquets PHP 7.3 dans ce conteneur : + +~~~ +# lxc-start -n php73 +# lxc-attach -n php73 + +# apt-get update && apt-get install -y --no-install-recommends wget apt-transport-https ca-certificates gnupg +# curl https://packages.sury.org/php/apt.gpg | apt-key add +# echo "deb https://packages.sury.org/php/ stretch main" > /etc/apt/sources.list.d/sury.list +# apt-get update && apt-get install -y --no-install-recommends php7.3 php7.3-fpm php7.3-cli php7.3-curl php7.3-mysql php7.3-pgsql php7.3-ldap php7.3-imap php7.3-gd php-ssh2 php-gettext composer libphp-phpmailer +~~~ + +#### Pour toutes les versions de PHP + +Dans les containers, il faut ajouter le fichier **z-evolinux-defaults.ini** dans le dossier **conf.d** des réglages de PHP FPM et CLI + +> Pour PHP5 **/etc/php5/fpm/conf.d/z-evolinux-defaults.ini** et **/etc/php5/cli/conf.d/z-evolinux-defaults.ini** +> +> Pour PHP7.0 **/etc/php/7.0/fpm/conf.d/z-evolinux-defaults.ini** et **/etc/php/7.0/cli/conf.d/z-evolinux-defaults.ini** +> +> Pour PHP7.3 **/etc/php/7.3/fpm/conf.d/z-evolinux-defaults.ini** et **/etc/php/7.3/cli/conf.d/z-evolinux-defaults.ini** + +~~~ +[PHP] +short_open_tag = Off +expose_php = Off +display_errors = Off +log_errors = On +html_errors = Off +allow_url_fopen = Off +disable_functions = exec,shell-exec,system,passthru,putenv,popen +~~~ + +Après cela, il faut redémarrer FPM + +~~~ +# lxc-attach -n php56 /etc/init.d/php5-fpm restart +# lxc-attach -n php70 /etc/init.d/php7.0-fpm restart +# lxc-attach -n php73 /etc/init.d/php7.3-fpm restart +~~~ + +Une fois les conteneurs installés, il faut configurer evoadmin-web pour lui indiquer les versions disponibles de PHP dans **/etc/evolinux/web-add.conf** (pour *web-add.sh*) et dans **/home/evoadmin/www/conf/config.local.php** pour l'interface web + +~~~ +# cat /etc/evolinux/web-add.conf +#(...) +PHP_VERSIONS=(56 70 73) +#(...) +~~~ + +~~~ +# cat /home/evoadmin/www/conf/config.local.php +// (...) +$localconf['php_versions'] = array(70, 73); +// (...) +~~~ + +#### Apache + +Il est nécessaire d'activer le mod proxy pour apache2 si ce n'a pas déjà été fait : + +~~~ +# a2enmod proxy_fcgi +# systemctl restart apache2.service +~~~ + +Si vous rencontrez l'erreur "File not found" avec les fichiers php, bien vérifier que le rootfs des conteneurs est en 755 : + +~~~ +# chmod 755 /var/lib/lxc/php56/rootfs +# chmod 755 /var/lib/lxc/php70/rootfs +# chmod 755 /var/lib/lxc/php73/rootfs +~~~ + +#### Email + +Pour envoyer des mails, on peut installer **ssmtp** qui va forwarder les mails du conteneur vers l'hôte (à faire par conteneur via lxc-attach) : + +Avant d'installer le paquet, il faut ajouter le hostname du conteneur dans **/etc/hosts**, sinon la configuration du paquet retourne une erreur : + +~~~ +127.0.0.1 php70 +~~~ + +~~~ +# apt install ssmtp +~~~ + +Editer **/etc/ssmtp/ssmtp.conf** (remplacer example.com par le hostname complet de votre machine) : + +~~~ +root=postmaster +mailhub=127.0.0.1 +hostname=example.com +FromLineOverride=YES +~~~ + +#### PHP-CLI + + +~~~ +$ cat /usr/local/bin/exec73 +#!/bin/bash + +php_cmd=$(printf "/usr/bin/php %q" "$@" ) +lxc-attach -n php73 -- su - "$SUDO_USER" -c "$php_cmd" +~~~ + +Il faut ensuite s'assurer que ce script peut être exécuté via sudo. \ No newline at end of file diff --git a/TODO b/TODO deleted file mode 100644 index 99a0091..0000000 --- a/TODO +++ /dev/null @@ -1,7 +0,0 @@ -* Verification des paramètres passés dans le script ftpadmin.sh -* Vérifier lors de la suppression que c'est bien la personne a qui appartient le compte qui lance la commande -* Tableau "sortable" (TableKit ?) -* Mettre en place EvoLog et logger la sortie des scripts -* Validation plus (très) stricte sur les entrées de formulaire -* Listage des comptes utilisateurs -* Total espace disque FTP