Varaverk/common.sh

#!/bin/bash
# -----------------------------------------------------------------------------------------------
# ----------------- UNRAID OPS COMMON LIBRARY (STABLE FRAMEWORK v1) ----------------------------
# -----------------------------------------------------------------------------------------------
# Version:  1.1
# Changed:  format_duration moved here from daily_sync.sh for shared use
#           SSH_KEY collision documented — gitea key renamed GITEA_SSH_KEY in Master.conf
#           Version and changelog tracking added
# -----------------------------------------------------------------------------------------------
 
# ICONS
ICON_INFO="ℹ️"
ICON_WARN="⚠️"
ICON_ERROR="❌"
ICON_SUCCESS="✅"
ICON_RUN="🚀"
ICON_STOP="🛑"
ICON_RETRY="🔁"
ICON_SYNC="🔄"
ICON_GEAR="⚙️"
 
# OUTPUT
info()    { echo "$ICON_INFO  [INFO]  $*"; }
warn()    { echo "$ICON_WARN  [WARN]  $*"; }
error()   { echo "$ICON_ERROR [ERROR] $*"; }
success() { echo "$ICON_SUCCESS [OK]  $*"; }
 
log() {
    [[ "${ENABLE_LOGGING:-false}" == true ]] && echo "[LOG] $*"
}
 
# -----------------------------------------------------------------------------------------------
# DURATION FORMATTER
# Converts raw seconds to human readable format — e.g. 10m53s or 47s
# Used by rsync.sh and daily_sync.sh
# -----------------------------------------------------------------------------------------------
format_duration() {
    local secs=$1
    local mins=$((secs / 60))
    local rem=$((secs % 60))
    [[ $mins -gt 0 ]] && echo "${mins}m${rem}s" || echo "${rem}s"
}
 
# -----------------------------------------------------------------------------------------------
# ARG PARSER
# -----------------------------------------------------------------------------------------------
parse_args() {
    ENABLE_LOGGING=${ENABLE_LOGGING:-false}
    DRY_RUN=${DRY_RUN:-false}
    SHOW_STATUS=${SHOW_STATUS:-false}
 
    CLEAN_ARGS=()
 
    for ARG in "$@"; do
        if [[ "$ARG" == *=* ]]; then
            VAR="${ARG%%=*}"
            VAL="${ARG#*=}"
 
            case "$VAR" in
                LOG)
                    [[ "$VAL" == "true" ]]  && ENABLE_LOGGING=true
                    [[ "$VAL" == "false" ]] && ENABLE_LOGGING=false
                    ;;
                *)
                    if declare -p "$VAR" &>/dev/null; then
                        printf -v "$VAR" '%s' "$VAL"
                        log "Set $VAR=$VAL"
                    else
                        warn "Unknown variable: $VAR"
                    fi
                    ;;
            esac
        else
            case "$ARG" in
                --dry-run|-n)       DRY_RUN=true ;;
                --log)              ENABLE_LOGGING=true ;;
                --no-log)           ENABLE_LOGGING=false ;;
                --status|--summary) SHOW_STATUS=true ;;
                --help|-h)
                    echo "Usage: script <dir> [--dry-run] [--log] [--status]"
                    exit 0
                    ;;
                *) CLEAN_ARGS+=("$ARG") ;;
            esac
        fi
    done
 
    PARSED_ARGS=("${CLEAN_ARGS[@]}")
}
 
# -----------------------------------------------------------------------------------------------
# VALIDATION
# -----------------------------------------------------------------------------------------------
require_var() {
    [[ -z "${!1:-}" ]] && error "Missing required: $1" && exit 1
}
 
# -----------------------------------------------------------------------------------------------
# HOST DETECTION
# -----------------------------------------------------------------------------------------------
detect_hosts() {
    LOCAL_HOSTNAME="$(hostname)"
 
    if [[ "$LOCAL_HOSTNAME" == "$HOST1" ]]; then
        LOCAL_SERVER_NAME="$HOST1"
        REMOTE_SERVER_NAME="$HOST2"
    elif [[ "$LOCAL_HOSTNAME" == "$HOST2" ]]; then
        LOCAL_SERVER_NAME="$HOST2"
        REMOTE_SERVER_NAME="$HOST1"
    else
        error "Unknown host: $LOCAL_HOSTNAME"
        exit 1
    fi
 
    declare -A SSH_KEYS
    SSH_KEYS["$HOST1|$HOST2"]="$HOST1_SSH_KEY"
    SSH_KEYS["$HOST2|$HOST1"]="$HOST2_SSH_KEY"
 
    SSH_KEY="${SSH_KEYS[$LOCAL_SERVER_NAME|$REMOTE_SERVER_NAME]}"
 
    [[ -z "$SSH_KEY" ]] && error "Missing SSH key mapping" && exit 1
 
    info "Host: $LOCAL_SERVER_NAME → $REMOTE_SERVER_NAME"
}
 
# -----------------------------------------------------------------------------------------------
# REMOTE IP
# -----------------------------------------------------------------------------------------------
resolve_remote_ip() {
    log "Resolving remote IP..."
    REMOTE_SERVER=$(tailscale ip -4 "$REMOTE_SERVER_NAME" 2>/dev/null)
 
    [[ -z "$REMOTE_SERVER" ]] && error "Failed to resolve remote IP for $REMOTE_SERVER_NAME" && exit 1
 
    info "Remote IP: $REMOTE_SERVER"
}
 
# -----------------------------------------------------------------------------------------------
# CONNECTIVITY CHECK
# Verifies remote is reachable before attempting rsync.
# Prevents retry loop burning all attempts against an unreachable host.
# -----------------------------------------------------------------------------------------------
check_connectivity() {
    log "Checking connectivity to $REMOTE_SERVER..."
    if ! ping -c1 -W3 "$REMOTE_SERVER" &>/dev/null; then
        error "Remote $REMOTE_SERVER is unreachable — aborting"
        exit 1
    fi
    log "Remote is reachable"
}
 
# -----------------------------------------------------------------------------------------------
# CONTAINERS
# CRITICAL_CONTAINER_NAMES and DELAYED_CONTAINERS must be bash arrays before calling these.
# rsync.sh handles the read -r -a conversion from profile strings.
# -----------------------------------------------------------------------------------------------
RUNNING_CONTAINERS=()
 
stop_containers() {
    if [[ ${#CRITICAL_CONTAINER_NAMES[@]} -eq 0 ]] || \
       [[ "${CRITICAL_CONTAINER_NAMES[*]}" == "" ]]; then
        log "No containers configured for this profile, skipping stop."
        return
    fi
 
    info "Stopping containers..."
    RUNNING_CONTAINERS=()
 
    for c in "${CRITICAL_CONTAINER_NAMES[@]}"; do
        [[ -z "$c" ]] && continue
 
        info "Checking $c..."
 
        STATUS=$(ssh -i "$SSH_KEY" root@"$REMOTE_SERVER" \
            "docker inspect -f '{{.State.Running}}' $c 2>/dev/null" 2>/dev/null || echo "false")
 
        if [[ "$STATUS" == "true" ]]; then
            echo "$ICON_STOP Stopping $c..."
            RUNNING_CONTAINERS+=("$c")
 
            if ssh -i "$SSH_KEY" root@"$REMOTE_SERVER" "docker stop $c" >/dev/null; then
                success "$c stopped"
            else
                error "Failed to stop $c"
            fi
        else
            warn "$c is not running, skipping"
        fi
    done
}
 
start_containers() {
    if [[ ${#RUNNING_CONTAINERS[@]} -eq 0 ]]; then
        log "No containers to restart."
        return
    fi
 
    info "Starting containers..."
 
    for c in "${RUNNING_CONTAINERS[@]}"; do
        [[ -z "$c" ]] && continue
 
        local needs_delay=false
        for d in "${DELAYED_CONTAINERS[@]}"; do
            if [[ "$c" == "$d" ]]; then
                needs_delay=true
                break
            fi
        done
 
        if [[ "$needs_delay" == true ]]; then
            info "Waiting ${CONTAINER_DELAY}s before starting $c..."
            sleep "$CONTAINER_DELAY"
        fi
 
        echo "$ICON_RUN Starting $c..."
        if ssh -i "$SSH_KEY" root@"$REMOTE_SERVER" "docker start $c" >/dev/null; then
            success "$c started"
        else
            error "Failed to start $c"
        fi
    done
}
 
# -----------------------------------------------------------------------------------------------
# RSYNC OPTIONS
# -----------------------------------------------------------------------------------------------
get_rsync_opts() {
    if [[ -n "${PROFILE_RSYNC_OPTS[$PROFILE_NAME]:-}" ]]; then
        read -r -a RSYNC_OPTS <<< "${PROFILE_RSYNC_OPTS[$PROFILE_NAME]}"
        log "Using profile rsync opts for $PROFILE_NAME: ${RSYNC_OPTS[*]}"
    else
        RSYNC_OPTS=("${DEFAULT_RSYNC_OPTS[@]}")
        log "Using default rsync opts: ${RSYNC_OPTS[*]}"
    fi
}
 
# -----------------------------------------------------------------------------------------------
# STATUS
# -----------------------------------------------------------------------------------------------
show_status() {
    echo "===== STATUS ====="
    echo "Local:      $LOCAL_SERVER_NAME"
    echo "Remote:     $REMOTE_SERVER_NAME"
    echo "IP:         $REMOTE_SERVER"
    echo "Profile:    $PROFILE_NAME"
    echo "DryRun:     $DRY_RUN"
    echo "Logging:    $ENABLE_LOGGING"
    echo "Containers: ${CRITICAL_CONTAINER_NAMES[*]}"
    echo "Delayed:    ${DELAYED_CONTAINERS[*]}"
    echo "Excludes:   ${EXCLUDE_DIRS[*]}"
    echo "=================="
}