testrunner.sh

#!/bin/bash
#
#TODO: 
# run docker in background
# check if docker finished with error or not
# Print/return the docker id which run this, so it can be provided later as reference for any operations - say should be able to run shell on a failed/successful testrun
# may be a debug option?
# may be more options to pass to run_tests.sh? - this is important
# collect_support_data - this will collect all required details to debug the failures and optionally upload to ftp or something including the failed container? (only collecting data for contrail-test not contrail cluster setup logs) - we may not need to get container as it is reproducable, just need to collect logs, configs, etc.
#
# Write a structured file (yaml?) in the run_path, with contrail-test docker name /id and other metadata about test run. - this would be make it easier to do rebuild and all
#
##
# $TEST_RUN_CMD - this environment variable will be passed to container and this command will be used to run the test
# $EXTRA_RUN_TEST_ARGS - any extra arguments for run_tests.sh
##

docker=docker
feature=sanity
test_tags=${TEST_TAGS:-''}
scenarios=''
run_path="${HOME}/contrail-test-runs"
arg_shell=''
declare -a arg_env
SCRIPT_TIMESTAMP=${SCRIPT_TIMESTAMP:-`date +"%Y_%m_%d_%H_%M_%S"`}
DEFAULT_CI_IMAGE='cirros'
CI_IMAGE_ORIG=${CI_IMAGE:-$DEFAULT_CI_IMAGE}
# ansi colors for formatting heredoc
ESC=$(printf "\e")
GREEN="$ESC[0;32m"
NO_COLOR="$ESC[0;0m"
RED="$ESC[0;31m"
CONTRAIL_TEST_FOLDER="/contrail-test"

trap finish EXIT SIGHUP SIGINT SIGTERM

finish () {
    rm -f $tempfile $run_log
    tput init
}

function have_command {
    type "$1" >/dev/null 2>/dev/null
}

try_wget () {
    wget -q --spider $1;
    return $?
}

usage () {
    cat <<EOF

Usage: $0 <Subcommand> [OPTIONS|-h]
Run Contrail test suite in docker container

${GREEN}Subcommands:
$GREEN  run 	$NO_COLOR Run contrail-test container
$GREEN  rebuild $NO_COLOR Rebuild the container provided
$GREEN  list    $NO_COLOR List contrail-test containers
$GREEN  load 	$NO_COLOR Load the container image from the filepath provided (tar, tar.gz, tar.bz2)

${GREEN}Run $0 <Subcommand> -h|--help to get subcommand specific help $NO_COLOR
EOF
    }

red () {
    echo "$RED $@${NO_COLOR}"
}

green () {
    echo "$GREEN $@${NO_COLOR}"
}

nocolor () {
    echo "$NO_COLOR $@"
}

# Provided Docker image available?
is_image_available () {
    tag=${1:-$pos_arg}
    repo=${tag%:*}
    version=${tag##*:}
    $docker images $repo | grep -q $version
}

# Is container available?
is_container_available () {
    container=${1:-$pos_arg}
    docker ps -a -q -f id=$container | grep -q [[:alnum:]] || docker ps -a -q -f name=$container | grep -q [[:alnum:]]
}

get_container_name () {
    local name
    name=`$docker ps -a -q -f id=$pos_arg --format "{{.Names}}"`
    if [ `echo $name | grep -c [[:alnum:]]` -ne 0 ]; then
        echo $name
    else
        $docker ps -a -q -f name=$pos_arg --format "{{.Names}}"
    fi
}

clear_colors () {
    RED="";
    GREEN=""
}

add_contrail_env () {
    EXTRA_RUN_TEST_ARGS=${testcase:-${EXTRA_RUN_TEST_ARGS:-''}}
    arg_env[0]=" -e TEST_RUN_CMD='$TEST_RUN_CMD' -e EXTRA_RUN_TEST_ARGS='$EXTRA_RUN_TEST_ARGS' "
    n=1
    if [[ $params_file ]] && [[ $params_file == *.yml || $params_file == *.yaml ]]; then
        arg_env[$n]=" -e TEST_CONFIG_FILE=$CONTRAIL_TEST_FOLDER/contrail_test_input.yaml"
        n=$(($n+1))
    fi
    for i in `env | grep '^CT_' | sed 's/ /\|/'`; do
        var=`echo ${i/CT_/} | sed -e 's/|/ /g' -e "s/\(.*\)=\(.*\)/\1='\2'/g"`
        arg_env[$n]=" -e $var "
        n=$(($n+1))
    done
}

select_image () {
    local name
    name=${1:-$image_name}
    if [[ $name ]]; then
        if ! is_image_available $image_name; then
            red "Docker image is not available: $pos_arg"
            exit 4
        else
            image_name=$name
        fi
    else
        if [ `$docker images -q | wc -l` -eq 1 ]; then
            image_name=`$docker images --format "{{.Repository}}:{{.Tag}}"`
        else
            red "Error identifying docker image, please provide image tag found from \"$0 list -i\""
            exit 4
        fi
    fi
}

make_entrypoint_tempest () {
	#Function to generate a shell script, that will be used as an entry for tempest run
cat <<EOF
#!/bin/bash -x
cd /tempest
source testbed_env
chmod +x tempest_run.sh
/tempest/tempest_run.sh
cp result*.xml ./logs
cp build_id.txt ./logs
EOF
}

docker_run () {
    if [[ -e $mount_local ]]; then
        mount_local=`readlink -f $mount_local`
        if [[ -d $mount_local/contrail-test && -d $mount_local/contrail-test-ci ]]; then
            temp_dir=`mktemp -d`
            rsync -a -f"+ */" -f"- *" $mount_local/contrail-test-ci/* $temp_dir
            rsync -a -f"+ */" -f"- *" $mount_local/contrail-test/* $temp_dir
            for i in `find $mount_local/contrail-test-ci/ -not \( -path $mount_local/contrail-test-ci/.git\* -prune \) -type f -print`; do
                d=`echo $i | sed "s#$mount_local/contrail-test-ci/##"`
                s=`echo $i | sed "s#$mount_local#/combined/#"`
                ln -s $s $temp_dir/$d
            done
            for i in `find $mount_local/contrail-test/ -not \( -path $mount_local/contrail-test/.git\* -prune \) -type f -print`; do
                d=`echo $i | sed "s#$mount_local/contrail-test/##"`
                s=`echo $i | sed "s#$mount_local#/combined/#"`
                ln -s $s $temp_dir/$d
            done
	    CONTRAIL_TEST_FOLDER="/contrail-test-local"
            local_vol=" -v $mount_local:/combined -v $temp_dir:${CONTRAIL_TEST_FOLDER} "
            dont_write_byte_code_arg=" -e PYTHONDONTWRITEBYTECODE=1 "
        else
            echo "ERROR: Mount local directory ($mount_local) should have contrail-test and contrail-test-ci cloned"
            exit 1
        fi
    fi
    # Volumes to be mounted to container

    arg_base_vol=" -v ${run_path}/${SCRIPT_TIMESTAMP}/logs:${CONTRAIL_TEST_FOLDER}/logs \
        -v ${run_path}/${SCRIPT_TIMESTAMP}/reports:${CONTRAIL_TEST_FOLDER}/report \
        -v ${run_path}/${SCRIPT_TIMESTAMP}:/${CONTRAIL_TEST_FOLDER}.save \
        -v /etc/localtime:/etc/localtime:ro \
        -v /etc/hosts:/etc/hosts:ro"

    if [ -f /etc/timezone ] ; then
        arg_base_vol="$arg_base_vol -v /etc/timezone:/etc/timezone:ro "
    fi

    #In case of tempest , mount the tempest directory
    if [[ $tempest_dir ]]; then
        arg_base_vol="$arg_base_vol -v $tempest_dir:/tempest"
        mkdir -p $tempest_dir/logs
        make_entrypoint_tempest > ${tempest_dir}/tempest_entrypoint.sh
        chmod +x ${tempest_dir}/tempest_entrypoint.sh
    fi

    if [[ -n $ssh_key_file ]]; then
        ssh_key_file=`readlink -f $ssh_key_file`
        if [[ -n $ssh_pub_key_file ]]; then
            ssh_pub_key_file=`readlink -f $ssh_pub_key_file`
        else
            ssh_pub_key_file="${ssh_key_file}.pub"
        fi
        if [[ -f $ssh_key_file && -f $ssh_pub_key_file ]] ; then
            key_vol=" -v $ssh_key_file:/root/.ssh/id_rsa:ro -v $ssh_pub_key_file:/root/.ssh/id_rsa.pub:ro "
        else
            echo "ERROR! provided ssh key files does not exist or not accessible"
            exit 1
        fi
    fi

    if [[ $testbed ]]; then
        arg_testbed_vol=" -v $testbed:/opt/contrail/utils/fabfile/testbeds/testbed.py:ro "
    elif [[ $params_file ]] && [[ $params_file == *.yml || $params_file == *.yaml ]]; then
        arg_params_vol=" -v $params_file:$CONTRAIL_TEST_FOLDER/contrail_test_input.yaml:ro"
    fi


    # Leave shell
    if [[ $shell ]]; then
        arg_shell=" -it --entrypoint=/bin/bash "
    else
        if [[ $tempest_dir ]]; then
            arg_shell=" --entrypoint=/tempest/tempest_entrypoint.sh "
        else
            arg_shell=" --entrypoint=/entrypoint.sh "
        fi
    fi

    # Keep the container
    if [[ $rm ]]; then
        arg_rm=" --rm=true "
    else
        arg_rm=" --rm=false "
    fi

    add_contrail_env

    ##
    # Docker run
    ##
    select_image $image_name

    # Set ci_image in case of ci
    if [[ $image_name =~ contrail-test-ci || $use_ci_image ]]; then
        ci_image_arg=" -e CI_IMAGE=$CI_IMAGE_ORIG -e ci_image=$CI_IMAGE_ORIG"
    fi

    ct_folder=" -e CONTRAIL_TEST_FOLDER=${CONTRAIL_TEST_FOLDER}"

    run_log=$(mktemp /tmp/contrail_test_XXXXXXXXX.log)
	run_n=1

    # Execute docker run, if it failed (exit with non-zero), check if it encountered container start timeout error.
    # If it is, delete the old container if running, and try again.
    # If it failed because of any other reason, just leave it
	while [ $run_n -le 5 ]; do
	    run_docker_cmd; rv=$?
	    if [ $rv -eq 0 ]; then
	        break
	    else
	        if [[ `grep -c "docker: Error response from daemon: containerd:" $run_log` -ne 0 ]]; then
	            echo "Docker run failed, retrying (${run_n}/5)".
	            $docker rm -f $name || true
	        else
	            break
	        fi
	    fi
	    run_n=$(($run_n+1))
	done
	return $rv
}

run_docker_cmd () {
    # Run container in background
    tempfile=$(mktemp /tmp/contrail_test_XXXXXXXXX)
    name=$(basename $tempfile)
    if [[ -n $background ]]; then
        echo "$docker run --privileged ${arg_env[*]} $arg_base_vol $local_vol $key_vol $arg_testbed_vol $arg_params_vol --name $name $ci_image_arg $ct_folder -e FEATURE=$feature -e TEST_TAGS=$test_tags $dont_write_byte_code_arg -e SCENARIOS=$scenarios -d $arg_rm $arg_shell -t $image_name" > $tempfile
        id=. $tempfile
        $docker ps -a --format "ID: {{.ID}}, Name: {{.Names}}" -f id=$id
    else
        echo "$docker run --privileged ${arg_env[*]} $arg_base_vol $local_vol $key_vol $arg_testbed_vol $arg_params_vol --name $name $ci_image_arg $ct_folder -e FEATURE=$feature -e TEST_TAGS=$test_tags $dont_write_byte_code_arg -e SCENARIOS=$scenarios $arg_bg $arg_rm $arg_shell -t $image_name" > $tempfile
    fi
    bash $tempfile | tee $run_log; rv=${PIPESTATUS[0]}
    return $rv
}

check_docker () {
    # IS docker runnable?
    $docker  -v &> /dev/null ; rv=$?

    if [ $rv -ne 0 ]; then
        red "docker is not installed, please install docker or docker-engine (https://docs.docker.com/engine/installation/)"
        exit 3
    fi
}

prerun () {
    run_path=`readlink -f $run_path`

    # Create log directory if not exist
    mkdir -p ${run_path}/${SCRIPT_TIMESTAMP}/{logs,reports}

    if [[ $testbed ]]; then
        testbed=`readlink -f $testbed`
        if [ ! -f $testbed ]; then
            red "testbed path ($testbed) doesn't exist"
            exit 1
        fi
    elif [[ $params_file ]] && [[ $params_file == *.yml || $params_file == *.yaml ]]; then
        params_file=`readlink -f $params_file`
        if [ ! -f $params_file ]; then
            red "params_file path ($params_file) doesn't exist"
            exit 1
        fi
    fi
}

run () {

    usage () {
        cat <<EOF

Usage: $0 run [OPTIONS] (<image_tag>)
Run Contrail test suite in docker container

$GREEN  -p, --run-path RUNPATH          $NO_COLOR Directory path on the host, in which contrail-test save all the
                                            results and other data. Default: $HOME/contrail-test-runs/
$GREEN  -s, --shell                     $NO_COLOR Do not run tests, but leave a shell, this is useful for debugging.
$GREEN  -S, --scenarios SCENARIOS                     $NO_COLOR list of scenarios that need to run as part rally tests. If empty ,
                                            runs all the tests under ./rally/scenarios
$GREEN  -i, --use-ci-image              $NO_COLOR Use ci image, by default it will use the image name "$DEFAULT_CI_IMAGE",
                                                  One may override this by setting the environment variable \$CI_IMAGE
$GREEN  -r, --rm	                    $NO_COLOR Remove the container on container exit, Default: Container will be kept.
$GREEN  -b, --background                $NO_COLOR run the container in background
$GREEN  -n, --no-color                  $NO_COLOR Disable output coloring
$GREEN  -z, --tempest_dir TEMPEST DIR           $NO_COLOR Path to the tempest , where it is cloned
$GREEN  -t, --testbed TESTBED           $NO_COLOR Path to testbed file in the host,
                                            Default: /opt/contrail/utils/fabfile/testbeds/testbed.py
$GREEN  -k, --ssh-key FILE_PATH         $NO_COLOR ssh key file path - in case of using key based ssh to cluster nodes.
                                                  Default: $HOME/.ssh/id_rsa
$GREEN  -K, --ssh-public-key FILE_PATH  $NO_COLOR ssh public key file path. Default: <ssh-key provided>.pub
$GREEN  -P, --params-file PARAMS_FILE   $NO_COLOR Optional Sanity Params ini file or yml file
$GREEN  -f, --feature FEATURE           $NO_COLOR Features or Tags to test - valid options are sanity, quick_sanity,
                                            ci_sanity, ci_sanity_WIP, ci_svc_sanity, upgrade, webui_sanity,
                                            ci_webui_sanity, devstack_sanity, upgrade_only. Default: sanity
                                            NOTE: this is only valid for Full contrail-test suite.
$GREEN -T, --test-tags TEST_TAGS        $NO_COLOR test tags to run specific tests
$GREEN -c, --testcase TESTCASE          $NO_COLOR testcase to execute
$GREEN -m, --mount_local path          $NO_COLOR mount a local folder which has contrail-test and contrail-test-ci
NOTE: Either testbed.py (-t) or params-file required

${GREEN}Possitional Parameters:

  <image_tag>       $NO_COLOR Docker image tag to run (Run "$0 list -i" to list all images available)


EOF
    }

    while getopts "ibhf:t:p:sS:k:K:nrT:P:m:j:c:z:" flag; do
        case "$flag" in
            t) testbed=$OPTARG;;
            z) tempest_dir=$OPTARG;;
            P) params_file=$OPTARG;;
            f) feature=$OPTARG;;
            p) run_path=$OPTARG;;
            s) shell=1;;
            S) scenarios=$OPTARG;;
            i) use_ci_image=1;;
            k) ssh_key_file=$OPTARG;;
            K) ssh_pub_key_file=$OPTARG;;
            b) background=1;;
            r) rm=1;;
            h) usage; exit;;
            n) clear_colors ;;
            T) test_tags=$OPTARG;;
            m) mount_local=$OPTARG;;
            c) testcase=$OPTARG;;
        esac
    done

    shift $(( OPTIND - 1 ))
    pos_arg=$1

    image_name=$pos_arg
    check_docker
    prerun
    docker_run; rv=$?
    exit $rv
}

list () {

    usage () {
        cat <<EOF

Usage: $0 list [OPTIONS]
List contrail-test containers

$GREEN  -i, --images        $NO_COLOR affect the operations on ALL available entities
$GREEN  -c, --containers    $NO_COLOR affect the operations on ALL available entities
$GREEN  -a, --all	        $NO_COLOR affect the operations on ALL available entities
EOF
    }

    while getopts "ahic" f; do
        case "$f" in
            h) usage; exit;;
            a) all=1;;
            i) images==1;;
            c) containers==1;;
        esac
    done


# Making args for "all"
    if [[ -n $all ]]; then
        arg_list_all=" -a "
    fi

    if [[ -n $images ]]; then
        list_images=1;
    elif [[ -n $containers ]]; then
        list_containers=1
    else
        list_all=1
    fi
    check_docker

    # List containers
    #TODO: list in better format, list different stuffs like latest containers, failed containers, running containers, finished containers etc
    #   able to provide filters
    if [[ -n $list_all || -n $list_images ]]; then
        echo; echo "$GREEN=========== Images =============$NO_COLOR"
        docker images  | awk 'BEGIN {printf "%-50s %-20s %-20s\n", "IMAGE","IMAGE ID", "VIRTUAL SIZE"}
                            /(contrail-test|contrail_test|rally)/ {printf "%-50s %-20s %-20s\n", $1":"$2, $3, $(NF-1)" "$NF}'
    fi
    if [[ -n $list_all || -n $list_containers ]]; then
        echo;echo "$GREEN=========== Container Instances =============$NO_COLOR"
        $docker ps $arg_list_all -f name=contrail_test_
    fi
    exit 0
}

pull () {

    usage () {
        cat <<EOF

Usage: $0 pull RemoteRegistry/image:tag
download the docker image to local system from remote registry

${GREEN}Possitional Parameters:

  <image>       $NO_COLOR remote image
                eg: $0 pull myregistry.local:5000/contrail-test-test:4.1.0.0-6

EOF
    }

    while getopts "h" f; do
        case "$f" in
            h) usage; exit;;
        esac
    done

    shift $(( OPTIND - 1 ))
    image=$1

    check_docker

    # Load container image
    echo "Pulling the image"
    $docker pull $image; rv=$?

    if [ $rv -eq 0 ]; then
        echo "Successfully pulled the image $image"
    else
        echo "Failed to download the image $image"
    fi
    exit $rv
}

load () {

    usage () {
        cat <<EOF

Usage: $0 load DOCKER-IMAGE-URL
Load the docker image to local system

${GREEN}Possitional Parameters:

  <docker-image-url>       $NO_COLOR Docker image tar.gz url. Supports three modes:
                           http[s] url: example, http://myrepo/contrail-test-images/docker-image-contrail-test-ci-kilo-3.0-2709.tar.gz
                           file path: example  /root/docker-image-contrail-test-ci-kilo-3.0-2709.tar.gz

EOF
    }

    while getopts "h" f; do
        case "$f" in
            h) usage; exit;;
        esac
    done

    shift $(( OPTIND - 1 ))
    image_url=$1

    check_docker

    # Load container image
    if [[ $image_url =~ ^http[s]*:// ]]; then
        if try_wget $image_url; then
            tmp=$(mktemp -d)
            wget $image_url -O $tmp/docker-image.tar.gz
            echo "Loading the image"
            $docker load < $tmp/docker-image.tar.gz; rv=$?
	    rm -f $tmp/docker-image.tar.gz
        else
            echo "ERROR! $image_url is not accessible."
            exit 1
        fi
    elif [ -f $image_url ]; then
        echo "Loading the image"
        $docker load < $image_url; rv=$?
    else
        echo "ERROR: Local path $image_url is not accessible"
        exit 1
    fi

    if [ $rv -eq 0 ]; then
        echo "Successfully Loaded the image $image_url"
    else
        echo "Failed loading the image $image_url"
    fi
    exit $rv
}

rebuild () {
    usage () {
        cat <<EOF


Usage: $0 rebuild [OPTIONS] <container id/name>
Rebuild contrail-test containers

$GREEN  -p, --run-path RUNPATH          $NO_COLOR Directory path on the host, in which contrail-test save all the
                                            results and other data. Default: $HOME/contrail-test-runs/
$GREEN  -s, --shell                     $NO_COLOR Do not run tests, but leave a shell, this is useful for debugging.
$GREEN  -r, --rm	                    $NO_COLOR Remove the container on container exit, Default: Container will be kept.
$GREEN  -b, --background                $NO_COLOR run the container in background
$GREEN  -n, --no-color                  $NO_COLOR Disable output coloring
$GREEN  -t, --testbed TESTBED           $NO_COLOR Path to testbed file in the host,
$GREEN  -i, --use-ci-image              $NO_COLOR Use ci image, by default it will use the image name "$DEFAULT_CI_IMAGE",
                                                  One may override this by setting the environment variable \$CI_IMAGE
$GREEN  -P, --params-file PARAMS_FILE   $NO_COLOR Optional Sanity Params ini file
$GREEN  -k, --ssh-private-key FILE_PATH $NO_COLOR ssh private key file path - in case of using key based ssh to cluster nodes.
$GREEN  -f, --feature FEATURE           $NO_COLOR Features or Tags to test - valid options are sanity, quick_sanity,
                                            ci_sanity, ci_sanity_WIP, ci_svc_sanity, upgrade, webui_sanity,
                                            ci_webui_sanity, devstack_sanity, upgrade_only. Default: sanity
                                            NOTE: this is only valid for Full contrail-test suite.
$GREEN  -T, --test-tags TEST_TAGS           $NO_COLOR test tags to run tests,
NOTE: Either testbd.py (-t) or params-file required

${GREEN}Possitional Parameters:

  <container id/name>       $NO_COLOR The container ID or name ( "$0 list -ca" to list all containers)

EOF
    }

    while getopts "ibhf:t:p:sk:nrT:P:j:" flag; do
        case "$flag" in
            t) testbed=$OPTARG;;
            P) params_file=$OPTARG;;
            i) use_ci_image=1;;
            r) rm=1;;
            f) feature=$OPTARG;;
            p) run_path=$OPTARG;;
            s) shell=1;;
            k) ssh_key_file=$OPTARG;;
            b) background=1;;
            h) usage; exit;;
            n) clear_colors ;;
            j) test_tags=$OPTARG;;
        esac
    done

    shift $(( OPTIND - 1 ))
    pos_arg=$1

    container_name=`get_container_name`
    if is_container_available; then
        green "rebuilding container - $pos_arg"
        green "This process will create an image with the container $pos_arg"
        green "Creating the image img_${container_name}"
        $docker commit $pos_arg img_${container_name}
        image_name="img_${container_name}"
    else
        red "Provided container ($pos_arg) is not available"
        exit 6
    fi
    check_docker
    prerun
    docker_run; rv=$?
    exit $rv
}


## Main code Starts here

for arg in "$@"; do
    shift
    case "$arg" in
        "--help") set -- "$@" "-h" ;;
        "--testbed") set -- "$@" "-t" ;;
        "--feature") set -- "$@" "-f" ;;
        "--log-path") set -- "$@" "-p" ;;
        "--shell") set == "$@" "-s";;
        "--scenarios") set == "$@" "-S";;
        "--ssh-key") set == "$@" "-k";;
        "--ssh-public-key") set == "$@" "-K";;
        "--background") set == "$@" "-b";;
        "--no-color") set == "$@" "-n";;
        "--all") set == "$@" "-a" ;;
        "--params-file") set == "$@" "-P" ;;
        "--use-ci-image") set == "$@" "-i" ;;
        *) set -- "$@" "$arg"
    esac
done

subcommand=$1; shift;
if [[ $subcommand == '-h' || $subcommand == '' ]]; then
    usage
    exit
else
    $subcommand $@
fi

if [ $? = 127 ]; then
    echo "Error: '$subcommand' is not a known subcommand." >&2
    echo "       Run '$0 --help' for a list of known subcommands." >&2
    exit 1
fi