#!/bin/bash #================================================= # COMMON VARIABLES #================================================= #================================================= # PERSONAL HELPERS #================================================= #================================================= # EXPERIMENTAL HELPERS #================================================= ynh_maintenance_mode_ON () { # Load value of $path and $domain from the config if their not set if [ -z $path ]; then path=$(ynh_app_setting_get $app path) fi if [ -z $domain ]; then domain=$(ynh_app_setting_get $app domain) fi mkdir -p /var/www/html/ # Create an html to serve as maintenance notice echo "
This app has been put under maintenance by your administrator at $(date)
Please wait until the maintenance operation is done. This page will be reloaded as soon as your app will be back.
" > "/var/www/html/maintenance.$app.html" # Create a new nginx config file to redirect all access to the app to the maintenance notice instead. echo "# All request to the app will be redirected to ${path}_maintenance and fall on the maintenance notice rewrite ^${path}/(.*)$ ${path}_maintenance/? redirect; # Use another location, to not be in conflict with the original config file location ${path}_maintenance/ { alias /var/www/html/ ; try_files maintenance.$app.html =503; # Include SSOWAT user panel. include conf.d/yunohost_panel.conf.inc; }" > "/etc/nginx/conf.d/$domain.d/maintenance.$app.conf" # The current config file will redirect all requests to the root of the app. # To keep the full path, we can use the following rewrite rule: # rewrite ^${path}/(.*)$ ${path}_maintenance/\$1? redirect; # The difference will be in the $1 at the end, which keep the following queries. # But, if it works perfectly for a html request, there's an issue with any php files. # This files are treated as simple files, and will be downloaded by the browser. # Would be really be nice to be able to fix that issue. So that, when the page is reloaded after the maintenance, the user will be redirected to the real page he was. systemctl reload nginx } ynh_maintenance_mode_OFF () { # Load value of $path and $domain from the config if their not set if [ -z $path ]; then path=$(ynh_app_setting_get $app path) fi if [ -z $domain ]; then domain=$(ynh_app_setting_get $app domain) fi # Rewrite the nginx config file to redirect from ${path}_maintenance to the real url of the app. echo "rewrite ^${path}_maintenance/(.*)$ ${path}/\$1 redirect;" > "/etc/nginx/conf.d/$domain.d/maintenance.$app.conf" systemctl reload nginx # Sleep 4 seconds to let the browser reload the pages and redirect the user to the app. sleep 4 # Then remove the temporary files used for the maintenance. rm "/var/www/html/maintenance.$app.html" rm "/etc/nginx/conf.d/$domain.d/maintenance.$app.conf" systemctl reload nginx } #================================================= # Check the amount of available RAM # # usage: ynh_check_ram [--required=RAM required in Mb] [--no_swap|--only_swap] [--free_ram] # | arg: -r, --required= - Amount of RAM required in Mb. The helper will return 0 is there's enough RAM, or 1 otherwise. # If --required isn't set, the helper will print the amount of RAM, in Mb. # | arg: -s, --no_swap - Ignore swap # | arg: -o, --only_swap - Ignore real RAM, consider only swap. # | arg: -f, --free_ram - Count only free RAM, not the total amount of RAM available. ynh_check_ram () { # Declare an array to define the options of this helper. declare -Ar args_array=( [r]=required= [s]=no_swap [o]=only_swap [f]=free_ram ) local required local no_swap local only_swap # Manage arguments with getopts ynh_handle_getopts_args "$@" required=${required:-} no_swap=${no_swap:-0} only_swap=${only_swap:-0} local total_ram=$(vmstat --stats --unit M | grep "total memory" | awk '{print $1}') local total_swap=$(vmstat --stats --unit M | grep "total swap" | awk '{print $1}') local total_ram_swap=$(( total_ram + total_swap )) local free_ram=$(vmstat --stats --unit M | grep "free memory" | awk '{print $1}') local free_swap=$(vmstat --stats --unit M | grep "free swap" | awk '{print $1}') local free_ram_swap=$(( free_ram + free_swap )) # Use the total amount of ram local ram=$total_ram_swap if [ $free_ram -eq 1 ] then # Use the total amount of free ram ram=$free_ram_swap if [ $no_swap -eq 1 ] then # Use only the amount of free ram ram=$free_ram elif [ $only_swap -eq 1 ] then # Use only the amount of free swap ram=$free_swap fi else if [ $no_swap -eq 1 ] then # Use only the amount of free ram ram=$total_ram elif [ $only_swap -eq 1 ] then # Use only the amount of free swap ram=$total_swap fi fi if [ -n "$required" ] then # Return 1 if the amount of ram isn't enough. if [ $ram -lt $required ] then return 1 else return 0 fi # If no RAM is required, return the amount of available ram. else echo $ram fi }