openqa-advanced-retrigger-jobs: Add usage+help

Author: okurz

openqa-advanced-retrigger-jobs

@@ -15,6 +15,44 @@ Usage: $0 [OPTIONS]
 
 Retrigger openQA jobs based on database queries.
 
+By default retriggers openQA jobs with result '$result' since '$failed_since'
+on '$host'.
+
+Can be restricted to jobs that ran on worker by setting the variable 'WORKER'
+and optionally 'INSTANCE'.
+
+Needs SSH access to the target openQA host '$host'.
+
+Options:
+ -h, --help         display this help
+EOF
+    exit "$1"
+}
+
+opts=$(getopt -o h -l help -n "$0" -- "$@") || usage 1
+eval set -- "$opts"
+while true; do
+    case "$1" in
+        -h | --help) usage 0 ;;
+        --)
+            shift
+            break
+            ;;
+        *) break ;;
+    esac
+done
+
+[ "$dry_run" = "1" ] && client_prefix="echo"
+sql_command="select id from jobs where (${worker_string}${result} and clone_id is null and t_finished >= '$failed_since'$additional_filters);"
+# shellcheck disable=SC2029
+job_ids=${JOB_IDS:-$(ssh "$host" "sudo -u geekotest psql --no-align --tuples-only --command=\"$sql_command\" openqa")}
+
+usage() {
+    cat << EOF
+Usage: $0 [OPTIONS]
+
+Retrigger openQA jobs based on database queries.
+
 By default retriggers openQA jobs with '$result' since '$failed_since' on
 '$host'.