diff --git a/scripts/.fonctions b/scripts/.fonctions index 5790319..1e64377 100644 --- a/scripts/.fonctions +++ b/scripts/.fonctions @@ -2,30 +2,29 @@ ynh_version="2.4" -YNH_VERSION () { # Renvoi le numéro de version de la moulinette Yunohost +YNH_VERSION () { # Display number version of the YunoHost moulinette ynh_version=$(sudo yunohost -v | grep "moulinette:" | cut -d' ' -f2 | cut -d'.' -f1,2) } -CHECK_VAR () { # Vérifie que la variable n'est pas vide. -# $1 = Variable à vérifier -# $2 = Texte à afficher en cas d'erreur +CHECK_VAR () { # Check variable is not empty +# $1 = Checking variable +# $2 = Text to display on error test -n "$1" || (echo "$2" >&2 && false) } -EXIT_PROPERLY () { # Provoque l'arrêt du script en cas d'erreur. Et nettoye les résidus. +EXIT_PROPERLY () { # Causes the script to stop in the event of an error. And clean the residue. trap '' ERR echo -e "\e[91m \e[1m" # Shell in light red bold echo -e "!!\n $app install's script has encountered an error. Installation was cancelled.\n!!" >&2 - if type -t CLEAN_SETUP > /dev/null; then # Vérifie l'existance de la fonction avant de l'exécuter. - CLEAN_SETUP # Appel la fonction de nettoyage spécifique du script install. + if type -t CLEAN_SETUP > /dev/null; then # Checks the existence of the function before executing it. + CLEAN_SETUP # Call the specific cleanup function of the install script. fi - # Compense le bug de ssowat qui ne supprime pas l'entrée de l'app en cas d'erreur d'installation. sudo sed -i "\@\"$domain$path/\":@d" /etc/ssowat/conf.json if [ "$ynh_version" = "2.2" ]; then - /bin/bash $script_dir/remove # Appel le script remove. En 2.2, ce comportement n'est pas automatique. + /bin/bash $script_dir/remove # Call the remove script. In 2.2, this behavior is not automatic. fi ynh_die @@ -36,31 +35,28 @@ TRAP_ON () { # Activate signal capture } TRAP_OFF () { # Ignoring signal capture until TRAP_ON - # Pour une raison que j'ignore, la fonction TRAP_ON fonctionne très bien. - # Mais pas la fonction TRAP_OFF... - # Utiliser directement `trap '' ERR` dans le code pour l'utiliser, à la place de la fonction. trap '' ERR # Ignoring exit signals } -CHECK_USER () { # Vérifie la validité de l'user admin -# $1 = Variable de l'user admin. +CHECK_USER () { # Check the validity of the user admin + # $1 = User admin variable ynh_user_exists "$1" || (echo "Wrong admin" >&2 && false) } -CHECK_PATH () { # Vérifie la présence du / en début de path. Et son absence à la fin. - if [ "${path:0:1}" != "/" ]; then # Si le premier caractère n'est pas un / - path="/$path" # Ajoute un / en début de path +CHECK_PATH () { # Checks / at the beginning of the path. And his absence at the end. + if [ "${path:0:1}" != "/" ]; then # If the first character is not / + path="/$path" # Add / at the beginning of path fi - if [ "${path:${#path}-1}" == "/" ] && [ ${#path} -gt 1 ]; then # Si le dernier caractère est un / et que ce n'est pas le seul caractère. - path="${path:0:${#path}-1}" # Supprime le dernier caractère + if [ "${path:${#path}-1}" == "/" ] && [ ${#path} -gt 1 ]; then # If the last character is a / and it is not the only character. + path="${path:0:${#path}-1}" # Delete last character fi } -CHECK_DOMAINPATH () { # Vérifie la disponibilité du path et du domaine. +CHECK_DOMAINPATH () { # Checks the availability of the path and domain. sudo yunohost app checkurl $domain$path -a $app } -CHECK_FINALPATH () { # Vérifie que le dossier de destination n'est pas déjà utilisé. +CHECK_FINALPATH () { # Checks that the destination folder is not already in use. final_path=/var/www/$app if [ -e "$final_path" ] then @@ -69,28 +65,28 @@ CHECK_FINALPATH () { # Vérifie que le dossier de destination n'est pas déjà u fi } -SETUP_SOURCE () { # Télécharge la source, décompresse et copie dans $final_path -# $1 = Nom de l'archive téléchargée. +SETUP_SOURCE () { # Download source, decompress and copu into $final_path + # $1 = Nom de l'archive téléchargée. wget -nv --show-progress -i ../sources/source_url -O $1 - # Vérifie la somme de contrôle de la source téléchargée. + # Checks the checksum of the downloaded source. md5sum -c ../sources/source_md5 --status - # Décompresse la source + # Decompress source if [ "$(echo ${1##*.})" == "tgz" ]; then tar -x -f $1 elif [ "$(echo ${1##*.})" == "zip" ]; then unzip -q $1 else - false # Format d'archive non pris en charge. + false # Unsupported archive format. fi - # Copie les fichiers sources + # Copy file source sudo cp -a $(cat ../sources/source_dir)/. "$final_path" - # Copie les fichiers additionnels ou modifiés. + # Copy additional file and modified if test -e "../sources/ajouts"; then sudo cp -a ../sources/ajouts/. "$final_path" fi } -POOL_FPM () { # Créer le fichier de configuration du pool php-fpm et le configure. +POOL_FPM () { # Create the php-fpm pool configuration file and configure it. sed -i "s@__NAMETOCHANGE__@$app@g" ../conf/php-fpm.conf sed -i "s@__FINALPATH__@$final_path@g" ../conf/php-fpm.conf finalphpconf=/etc/php5/fpm/pool.d/$app.conf @@ -102,22 +98,22 @@ POOL_FPM () { # Créer le fichier de configuration du pool php-fpm et le configu sudo service php5-fpm reload } -STORE_MD5_CONFIG () { # Enregistre la somme de contrôle du fichier de config -# $1 = Nom du fichier de conf pour le stockage dans settings.yml -# $2 = Nom complet et chemin du fichier de conf. +STORE_MD5_CONFIG () { # Saves the checksum of the config file + # $1 = Name of the conf file for storage in settings.yml + # $2 = Full name and path of the conf file. ynh_app_setting_set $app $1_file_md5 $(sudo md5sum "$2" | cut -d' ' -f1) } -CHECK_MD5_CONFIG () { # Créé un backup du fichier de config si il a été modifié. -# $1 = Nom du fichier de conf pour le stockage dans settings.yml -# $2 = Nom complet et chemin du fichier de conf. +CHECK_MD5_CONFIG () { # Created a backup of the config file if it was changed. + # $1 = Name of the conf file for storage in settings.yml + # $2 = Full name and path of the conf file.onf. if [ "$(ynh_app_setting_get $app $1_file_md5)" != $(sudo md5sum "$2" | cut -d' ' -f1) ]; then sudo cp -a "$2" "$2.backup.$(date '+%d.%m.%y_%Hh%M,%Ss')" # Si le fichier de config a été modifié, créer un backup. fi } -FIND_PORT () { # Cherche un port libre. -# $1 = Numéro de port pour débuter la recherche. +FIND_PORT () { # Search free port + # $1 = Port number to start the search. port=$1 while ! sudo yunohost app checkport $port ; do port=$((port+1)) @@ -128,15 +124,15 @@ FIND_PORT () { # Cherche un port libre. ### REMOVE SCRIPT -REMOVE_NGINX_CONF () { # Suppression de la configuration nginx - if [ -e "/etc/nginx/conf.d/$domain.d/$app.conf" ]; then # Delete nginx config +REMOVE_NGINX_CONF () { # Delete nginx configuration + if [ -e "/etc/nginx/conf.d/$domain.d/$app.conf" ]; then echo "Delete nginx config" sudo rm "/etc/nginx/conf.d/$domain.d/$app.conf" sudo service nginx reload fi } -REMOVE_FPM_CONF () { # Suppression de la configuration du pool php-fpm +REMOVE_FPM_CONF () { # Delete pool php-fpm configuration if [ -e "/etc/php5/fpm/pool.d/$app.conf" ]; then # Delete fpm config echo "Delete fpm config" sudo rm "/etc/php5/fpm/pool.d/$app.conf" @@ -148,27 +144,27 @@ REMOVE_FPM_CONF () { # Suppression de la configuration du pool php-fpm sudo service php5-fpm reload } -REMOVE_LOGROTATE_CONF () { # Suppression de la configuration de logrotate +REMOVE_LOGROTATE_CONF () { # Delete logrotate configuration if [ -e "/etc/logrotate.d/$app" ]; then echo "Delete logrotate config" sudo rm "/etc/logrotate.d/$app" fi } -SECURE_REMOVE () { # Suppression de dossier avec vérification des variables - chaine="$1" # L'argument doit être donné entre quotes simple '', pour éviter d'interpréter les variables. +SECURE_REMOVE () { # Deleting a folder with variable verification + chaine="$1" # The argument must be given between simple quotes '', to avoid interpreting the variables. no_var=0 - while (echo "$chaine" | grep -q '\$') # Boucle tant qu'il y a des $ dans la chaine + while (echo "$chaine" | grep -q '\$') # Loop as long as there are $ in the string do no_var=1 - global_var=$(echo "$chaine" | cut -d '$' -f 2) # Isole la première variable trouvée. - only_var=\$$(expr "$global_var" : '\([A-Za-z0-9_]*\)') # Isole complètement la variable en ajoutant le $ au début et en gardant uniquement le nom de la variable. Se débarrasse surtout du / et d'un éventuel chemin derrière. - real_var=$(eval "echo ${only_var}") # `eval "echo ${var}` permet d'interpréter une variable contenue dans une variable. + global_var=$(echo "$chaine" | cut -d '$' -f 2) # Isole the first variable found. + only_var=\$$(expr "$global_var" : '\([A-Za-z0-9_]*\)') # Isole completely the variable by adding the $ at the beginning and keeping only the name of the variable. Mostly gets rid of / and a possible path behind. + real_var=$(eval "echo ${only_var}") # `eval "echo ${var}` Allows to interpret a variable contained in a variable. if test -z "$real_var" || [ "$real_var" = "/" ]; then echo "Variable $only_var is empty, suppression of $chaine cancelled." >&2 return 1 fi - chaine=$(echo "$chaine" | sed "s@$only_var@$real_var@") # remplace la variable par sa valeur dans la chaine. + chaine=$(echo "$chaine" | sed "s@$only_var@$real_var@") # Replaces variable with its value in the string. done if [ "$no_var" -eq 1 ] then diff --git a/scripts/install b/scripts/install index 4bfff72..644ac0d 100755 --- a/scripts/install +++ b/scripts/install @@ -15,9 +15,9 @@ set -eu # db names, ... # Retrieve arguments -source .fonctions # Charge les fonctions génériques habituellement utilisées dans le script +source .fonctions # Loads the generic functions usually used in the script -TRAP_ON # Active trap pour arrêter le script si une erreur est détectée. +TRAP_ON # Active trap for strop script if detect error. domain=$YNH_APP_ARG_DOMAIN path=$YNH_APP_ARG_PATH @@ -74,10 +74,10 @@ sudo sed -i "s@__NAMETOCHANGE__@$app@g" /etc/nginx/conf.d/$domain.d/$app.conf POOL_FPM -# Donne un accès public pour curl +# Public access for curl ynh_app_setting_set $app unprotected_uris "/" -# Régénère la configuration de SSOwat +# Relaod SSOwat configuration sudo yunohost app ssowatconf # Reload Nginx and regenerate SSOwat conf @@ -86,7 +86,7 @@ sudo service nginx reload if [ "$is_public" = "No" ]; then - # Retire l'accès public + # Exit public access ynh_app_setting_delete $app unprotected_uris sudo yunohost app ssowatconf fi diff --git a/scripts/remove b/scripts/remove index 9f06e3d..158e328 100755 --- a/scripts/remove +++ b/scripts/remove @@ -3,22 +3,22 @@ # Exit on command errors and treat unset variables as an error set -u -source .fonctions # Charge les fonctions génériques habituellement utilisées dans le script +source .fonctions # Loads the generic functions usually used in the script # Source app helpers source /usr/share/yunohost/helpers -# Récupère les infos de l'application. +# Get application informations. app=$YNH_APP_INSTANCE_NAME domain=$(ynh_app_setting_get $app domain) -SECURE_REMOVE '/var/www/$app' # Suppression du dossier de l'application +SECURE_REMOVE '/var/www/$app' # Delete directory application -REMOVE_NGINX_CONF # Suppression de la configuration nginx +REMOVE_NGINX_CONF # Delete nginx configuration -REMOVE_FPM_CONF # Suppression de la configuration du pool php-fpm +REMOVE_FPM_CONF # Delete pool php-fpm configuration -# Régénère la configuration de SSOwat +# Reload SSOwat configuration sudo yunohost app ssowatconf echo -e "\e[0m" # Restore normal color \ No newline at end of file diff --git a/scripts/restore b/scripts/restore index bb3d11b..0a4287d 100755 --- a/scripts/restore +++ b/scripts/restore @@ -36,7 +36,7 @@ sudo service nginx reload sudo cp -a "${backup_dir}/var/www/$app" $final_path # Set permissions -# Les fichiers appartiennent à www-data, pour permettre les mises à jour. +# The files belong to www-data, to allow for updates. sudo chown -R www-data: $final_path # Copy dedicated php-fpm process from backup folder to the right location