bin/jenkins_funcs.sh

#!/bin/bash

# This file contains bash functions which may be of use to our Jenkins jobs.


function process_git {
  # Do not echo all commands to terminal.
  set +x
  local git_dir_path="${1}" ; shift || :
  local post_clone_command="${1}" ; shift || :

  # Do git processing for this Jenkins job which includes:
  # - Recognizing existing git repo if appropriate.
  # - Cloning git repo.
  # - Running caller's post_clone_command.

  # Description of argument(s):
  # git_dir_path                    The location of the git dir path (e.g.
  #                                 "/home/johndoe/git/").  If the
  #                                 git_dir_path already exists and it was
  #                                 specified explicitly by the user, this
  #                                 function will neither clone the git repo
  #                                 to this path nor run the
  #                                 post_clone_commands, i.e. the indicated
  #                                 git repo will be used as-is.
  # post_clone_command              Any valid bash command to be run after git
  #                                 clone of openbmc-test-automation. Note
  #                                 that this is intended primarily for Open
  #                                 BMC Test code developers who may wish to
  #                                 cherry pick code changes for testing.

  if [ -d "${git_dir_path}" -a "${git_dir_path}" != "${WORKSPACE}" ] ; then
    echo "\"${git_dir_path}\" already exists and is not the standard" \
         "location of \"${WORKSPACE}\" so no git processing is required."
    return
  fi

  # Echo all subsequent commands to terminal.
  set -x
  mkdir -p "${git_dir_path}" || return 1
  cd "${git_dir_path}" || return 1

  echo "Remove old git repo files."
  rm -Rf ./openbmc-build-scripts
  rm -Rf ./openbmc-test-automation

  git clone https://gerrit.openbmc-project.xyz/openbmc/openbmc-build-scripts\
    || return 1
  git clone https://github.com/openbmc/openbmc-test-automation.git || return 1

  if [ ! -z "${post_clone_command}" ] ; then
    cd openbmc-test-automation || return 1
    echo "Run the caller's post clone command."
    eval "${post_clone_command}" || return 1
  fi

}


function process_docker {
  # Do not echo all commands to terminal.
  set +x
  local git_dir_path="${1}" ; shift || :

  # Source the docker script to prepare our environment for calling docker.

  # Description of argument(s):
  # git_dir_path                    The location of the git dir path (e.g.
  #                                 "/home/johndoe/git/") to be used.

  # Set global DOCKER_IMG_NAME.
  DOCKER_IMG_NAME="openbmc/obmc-docker-image"

  echo "Build the docker image required to execute the robot tests."
  # Echo all subsequent commands to terminal.
  set -x
  cd "${git_dir_path}openbmc-build-scripts" || return 1
  . "./scripts/build-qemu-robot-docker.sh" || return 1

  cd "${git_dir_path}" || return 1

}


if ! test "${stock_robot_program_parms+defined}" ; then
  readonly stock_robot_program_parms="openbmc_host openbmc_username"\
" openbmc_password os_host os_username os_password quiet debug test_mode"
  readonly master_robot_gen_parms="console consolecolors outputdir output log"\
" report loglevel include"
fi
function run_docker_robot {
  # Do not echo all commands to terminal.
  set +x
  local robot_file_path="${1}" ; shift || :
  local robot_pgm_parms="${1-}" ; shift || :
  local robot_gen_parms="${1:-${master_robot_gen_parms}}" ; shift || :

  # Compose a robot command string and run it in a docker environment.

  # Description of argument(s):
  # robot_file_path                 The file path of the robot file (with or
  #                                 without .robot suffix).  This file path is
  #                                 relative to the base git repository.
  # robot_pgm_parms                 A space-separated list of parms which are
  #                                 to be passed to the robot program via the
  #                                 -v robot parameter.  These parms will be
  #                                 processed in addition to the
  #                                 stock_robot_program_parms listed above.
  # robot_gen_parms                 A space-separated list of general robot
  #                                 parameters understood by the robot program
  #                                 (e.g. consolecolors, etc).

  # Strip, then re-append ".robot" so that the user can pass with or without
  # the .robot suffix.
  robot_file_path="${robot_file_path%.robot}.robot"

  # Determine the robot_file_name form the robot_file_path.
  local robot_file_name="${robot_file_path%.robot}"
  robot_file_name="${robot_file_name##*/}"
  local robot_short_file_name="${robot_file_name%.robot}"

  # Set default values for robot_gen_parms.
  local dft_console=dotted
  local dft_consolecolors=off
  local dft_outputdir=/status_dir
  local dft_output=${robot_short_file_name}.output.xml
  local dft_log=${robot_short_file_name}.log.html
  local dft_report=${robot_short_file_name}.report.html
  local dft_loglevel='TRACE'
  local dft_include=''

  local cmd_buf
  # Loop through robot general parms setting any that have no value to a
  # default value (defined above).
  for parm_name in ${robot_gen_parms} ; do
    # If the parm already has a value, continue to next loop iteration.
    [ ! -z "${!parm_name-}" ] && continue || :
    cmd_buf="${parm_name}=\"\${dft_${parm_name}}\""
    eval ${cmd_buf}
  done

  local robot_cmd_buf='robot'
  # Process our stock robot program parms along with the caller's
  # robot_pgm_parms to add to the robot_cmd_buf.
  local parm_name
  local escape_quote_char="'\''"
  for parm_name in ${stock_robot_program_parms} ${robot_pgm_parms} ; do
    [ -z "${parm_name-}" ] && continue
    robot_cmd_buf="${robot_cmd_buf} -v ${parm_name}:${!parm_name-}"
  done

  # Process the robot general parms to add to the robot_cmd_buf.
  for parm_name in ${robot_gen_parms} ; do
    robot_cmd_buf="${robot_cmd_buf} --${parm_name}=${!parm_name-}"
  done

  # Finally append the robot file path to the robot_cmd_buf.
  additional_parms=" ${additional_parms-}"
  robot_cmd_buf="${robot_cmd_buf}${additional_parms} ${HOME}/openbmc-test"
  robot_cmd_buf="${robot_cmd_buf}-automation/${robot_file_path}"

  # Run the docker container to execute the code update.
  # The test results will be put in ${WORKSPACE}.

  cmd_buf="docker run --user=root --env=HOME=${HOME} --env=PYTHONPATH=${HOME}"
  cmd_buf="${cmd_buf}/openbmc-test-automation/lib --workdir=${HOME} --volume"
  cmd_buf="${cmd_buf}=${git_dir_path}:${HOME} --volume=${WORKSPACE}:/status_"
  cmd_buf="${cmd_buf}dir --tty ${DOCKER_IMG_NAME} python -m ${robot_cmd_buf}"
  # Echo all subsequent commands to terminal.
  set -x
  eval "${cmd_buf}"

}