feat(stack): added new cli cmd option to run a custom command on top of image

This will be a helper code to run full text search or API calls

scripts/rcstack/rcstack

@@ -875,6 +875,7 b' rcstack_cli_usage() {'
   echo
   # :command.usage_commands
   printf "%s\n" "Commands:"
+  printf "  %s   run a custom command on top of docker image from RhodeCode\n" "cmd                "
   printf "  %s   print out stored docker image version\n" "image-info         "
   printf "  %s   set version to .runtime.env file\n" "set-runtime-image  "
   printf "  %s   get current docker info\n" "docker-info        "
@@ -903,6 +904,49 b' rcstack_cli_usage() {'
 }
 
 # :command.usage
+rcstack_cli_cmd_usage() {
+  if [[ -n $long_usage ]]; then
+    printf "rcstack cli cmd - run a custom command on top of docker image from RhodeCode\n"
+    echo
+
+  else
+    printf "rcstack cli cmd - run a custom command on top of docker image from RhodeCode\n"
+    echo
+
+  fi
+
+  printf "%s\n" "Usage:"
+  printf "  rcstack cli cmd [OPTIONS] [CALL ARGUMENTS...]\n"
+  printf "  rcstack cli cmd --help | -h\n"
+  echo
+
+  # :command.long_usage
+  if [[ -n $long_usage ]]; then
+    printf "%s\n" "Options:"
+
+    # :command.usage_flags
+    # :flag.usage
+    printf "  %s\n" "--env-file-path ENV_FILE_PATH"
+    printf "    Set custom env file\n"
+    printf "    Default: $PWD/.custom/.runtime.env\n"
+    echo
+
+    # :command.usage_fixed_flags
+    printf "  %s\n" "--help, -h"
+    printf "    Show this help\n"
+    echo
+
+    # :command.usage_args
+    printf "%s\n" "Arguments:"
+
+    echo "  CALL ARGUMENTS..."
+    printf "    call arguments\n"
+    echo
+
+  fi
+}
+
+# :command.usage
 rcstack_cli_image_info_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack cli image-info - print out stored docker image version\n"
@@ -3517,6 +3561,45 b' rcstack_stack_monitor_restart_unhealthy_command() {'
 }
 
 # :command.function
+rcstack_cli_cmd_command() {
+  # src/cli_cmd_command.sh
+  check_bootstrap
+
+  DEBUG=${args[--debug]}
+  ENV_FILE=${args[--env-file-path]}
+
+  printf "attaching $PWD/config/_shared \t\tunder: /vol/confvolume\n"
+
+  #printf "attaching rc_reposvolume \t\tunder: /vol/repovolume\n"
+  #printf "attaching \$PWD/.custom/storage \t\tunder: /vol/backupvolume\n"
+
+  if [ ${#other_args[@]} -eq 0 ]; then
+      other_args[${#other_args[@]}]="echo 'please provide a valid cmd arg...'"
+  fi
+
+  CMD_RHODECODE="\
+  RC_ENV_FILE=$ENV_FILE docker compose \
+  --env-file $ENV_FILE \
+  $ENV_EXPAND \
+  -p cmd-run \
+  -f docker-compose-base.yaml \
+  -f docker-compose-apps.yaml \
+  run \
+  --volume=$PWD/config/_shared:/vol/confvolume \
+  --workdir=/vol/confvolume \
+  -it \
+  vcsserver"
+
+  if [[ $DEBUG ]]; then
+      echo $CMD_RHODECODE
+    echo ${other_args[*]}
+  fi
+
+  eval "${CMD_RHODECODE} ${other_args[*]}"
+
+}
+
+# :command.function
 rcstack_cli_image_info_command() {
   # src/cli_image_info_command.sh
 
@@ -5687,6 +5770,13 b' rcstack_cli_parse_requirements() {'
   case $action in
     -*) ;;
 
+    cmd)
+      action="cmd"
+      shift
+      rcstack_cli_cmd_parse_requirements "$@"
+      shift $#
+      ;;
+
     image-info)
       action="image-info"
       shift
@@ -5815,6 +5905,75 b' rcstack_cli_parse_requirements() {'
 }
 
 # :command.parse_requirements
+rcstack_cli_cmd_parse_requirements() {
+  # :command.fixed_flags_filter
+  while [[ $# -gt 0 ]]; do
+    case "${1:-}" in
+      --help | -h)
+        long_usage=yes
+        rcstack_cli_cmd_usage
+        exit
+        ;;
+
+      *)
+        break
+        ;;
+
+    esac
+  done
+
+  # :command.command_filter
+  action="cli cmd"
+
+  # :command.parse_requirements_while
+  while [[ $# -gt 0 ]]; do
+    key="$1"
+    case "$key" in
+      # :flag.case
+      --env-file-path)
+
+        # :flag.case_arg
+        if [[ -n ${2+x} ]]; then
+          # :flag.validations
+          if [[ -n $(validate_file_exists "$2") ]]; then
+            printf "validation error in %s:\n%s\n" "--env-file-path ENV_FILE_PATH" "$(validate_file_exists "$2")" >&2
+            exit 1
+          fi
+
+          args['--env-file-path']="$2"
+          shift
+          shift
+        else
+          printf "%s\n" "--env-file-path requires an argument: --env-file-path ENV_FILE_PATH" >&2
+          exit 1
+        fi
+        ;;
+
+      --)
+        shift
+        other_args+=("$@")
+        break
+        ;;
+
+      -?*)
+        other_args+=("$1")
+        shift
+        ;;
+
+      *)
+        # :command.parse_requirements_case
+        # :command.parse_requirements_case_catch_all
+        other_args+=("$1")
+        shift
+
+        ;;
+
+    esac
+  done
+
+}
+
+# :command.parse_requirements
 rcstack_cli_image_info_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
@@ -7230,6 +7389,7 b' run() {'
     "stack-monitor") rcstack_stack_monitor_command ;;
     "stack-monitor restart-unhealthy") rcstack_stack_monitor_restart_unhealthy_command ;;
     "cli") rcstack_cli_command ;;
+    "cli cmd") rcstack_cli_cmd_command ;;
     "cli image-info") rcstack_cli_image_info_command ;;
     "cli set-runtime-image") rcstack_cli_set_runtime_image_command ;;
     "cli docker-info") rcstack_cli_docker_info_command ;;