1 # Copyright (c) 2018 Cisco and/or its affiliates.
2 # Licensed under the Apache License, Version 2.0 (the "License");
3 # you may not use this file except in compliance with the License.
4 # You may obtain a copy of the License at:
6 # http://www.apache.org/licenses/LICENSE-2.0
8 # Unless required by applicable law or agreed to in writing, software
9 # distributed under the License is distributed on an "AS IS" BASIS,
10 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
11 # See the License for the specific language governing permissions and
12 # limitations under the License.
16 # This library defines functions used mainly by per patch entry scripts.
17 # Generally, the functions assume "common.sh" library has been sourced already.
18 # Keep functions ordered alphabetically, please.
20 function archive_test_results () {
23 # - ${1}: Directory to archive to. Required. Parent has to exist.
25 # - TARGET - Target directory.
27 # - ARCHIVE_DIR - Path to where robot result files are created in.
28 # - VPP_DIR - Path to existing directory, root for to relative paths.
29 # Directories updated:
30 # - ${1} - Created, and robot and parsing files are moved/created there.
32 # - die - Print to stderr and exit, defined in common.sh
36 cd "${VPP_DIR}" || die "Change directory command failed."
37 TARGET="$(readlink -f "$1")"
38 mkdir -p "${TARGET}" || die "Directory creation failed."
39 for filename in "output.xml" "log.html" "report.html"; do
40 mv "${ARCHIVE_DIR}/${filename}" "${TARGET}/${filename}" || {
41 die "Attempt to move '${filename}' failed."
47 function archive_parse_test_results () {
50 # - ${1}: Directory to archive to. Required. Parent has to exist.
52 # - TARGET - Target directory.
54 # - die - Print to stderr and exit, defined in common.sh
55 # - archive_test_results - Archiving results.
56 # - parse_bmrr_results - See definition in this file.
60 archive_test_results "$1" || die
61 parse_bmrr_results "${TARGET}" || {
62 die "The function should have died on error."
67 function build_vpp_ubuntu_amd64 () {
69 # This function is using Vagrant script to build VPP with all dependencies
70 # that is ARCH/OS aware. VPP repo is SSOT for building mechanics and CSIT
71 # is consuming artifacts. This way if VPP will introduce change in building
72 # mechanics they will not be blocked by CSIT repo.
74 # - ${1} - String identifier for echo, can be unset.
76 # - VPP_DIR - Path to existing directory, parent to accessed directories.
77 # Directories updated:
78 # - ${VPP_DIR} - Whole subtree, many files (re)created by the build process.
80 # - die - Print to stderr and exit, defined in common.sh
84 cd "${VPP_DIR}" || die "Change directory command failed."
85 echo 'Building using "make build-root/vagrant/build.sh"'
86 build-root/vagrant/"build.sh" || die "Vagrant VPP build script failed."
87 echo "*******************************************************************"
88 echo "* VPP ${1-} BUILD SUCCESSFULLY COMPLETED" || {
89 die "Argument not found."
91 echo "*******************************************************************"
95 function compare_test_results () {
98 # - VPP_DIR - Path to directory with VPP git repo (at least built parts).
99 # - ARCHIVE_DIR - Path to where robot result files are created in.
100 # - PYTHON_SCRIPTS_DIR - Path to directory holding comparison utility.
101 # Directories recreated:
102 # - csit_parent - Sibling to csit directory, for holding results
105 # - die - Print to stderr and exit, defined in common.sh
106 # - parse_bmrr_results - See definition in this file.
108 # - 0 - If the comparison utility sees no regression (nor data error).
109 # - 1 - If the comparison utility sees a regression (or data error).
113 cd "${VPP_DIR}" || die "Change directory operation failed."
114 # Reusing CSIT main virtualenv.
115 pip install -r "${PYTHON_SCRIPTS_DIR}/perpatch_requirements.txt" || {
116 die "Perpatch Python requirements installation failed."
118 python "${PYTHON_SCRIPTS_DIR}/compare_perpatch.py"
119 # The exit code determines the vote result.
123 function download_builds () {
125 # This is mostly useful only for Sandbox testing, to avoid recompilation.
128 # - ${1} - URL to download VPP builds from.
130 # - VPP_DIR - Path to WORKSPACE, parent of created directories.
131 # Directories created:
132 # - archive - Ends up empty, not to be confused with ${ARCHIVE_DIR}.
133 # - build_current - Holding built artifacts of the patch under test (PUT).
134 # - built_parent - Holding built artifacts of parent of PUT.
136 # - die - Print to stderr and exit, defined in common.sh
140 cd "${VPP_DIR}" || die "Change directory operation failed."
141 dirs=("build-root" "build_parent" "build_current" "archive" "csit_current")
142 rm -rf ${dirs[@]} || {
143 die "Directory removal failed."
145 wget -N --progress=dot:giga "${1}" || die "Wget download failed."
146 unzip "archive.zip" || die "Archive extraction failed."
147 mv "archive/build_parent" ./ || die "Move operation failed."
148 mv "archive/build_current" ./ || die "Move operation failed."
152 function initialize_csit_dirs () {
154 # This could be in prepare_test, but download_builds also needs this.
157 # - VPP_DIR - Path to WORKSPACE, parent of created directories.
158 # Directories created:
159 # - csit_current - Holding test results of the patch under test (PUT).
160 # - csit_parent - Holding test results of parent of PUT.
162 # - die - Print to stderr and exit, defined in common.sh
166 cd "${VPP_DIR}" || die "Change directory operation failed."
167 rm -rf "csit_current" "csit_parent" || {
168 die "Directory deletion failed."
170 mkdir -p "csit_current" "csit_parent" || {
171 die "Directory creation failed."
176 function parse_bmrr_results () {
178 # Currently "parsing" is just two greps.
179 # TODO: Re-use PAL parsing code, make parsing more general and centralized.
182 # - ${1} - Path to (existing) directory holding robot output.xml result.
184 # - output.xml - From argument location.
186 # - results.txt - (Re)created, in argument location.
188 # - die - Print to stderr and exit, defined in common.sh
192 rel_dir="$(readlink -e "${1}")" || die "Readlink failed."
193 in_file="${rel_dir}/output.xml"
194 out_file="${rel_dir}/results.txt"
195 # TODO: Do we need to check echo exit code explicitly?
196 echo "Parsing ${in_file} putting results into ${out_file}"
197 echo "TODO: Re-use parts of PAL when they support subsample test parsing."
198 pattern='Maximum Receive Rate trial results in packets'
199 pattern+=' per second: .*\]</status>'
200 grep -o "${pattern}" "${in_file}" | grep -o '\[.*\]' > "${out_file}" || {
201 die "Some parsing grep command has failed."
206 function select_build () {
209 # - ${1} - Path to directory to copy VPP artifacts from. Required.
211 # - DOWNLOAD_DIR - Path to directory where Robot takes builds to test from.
212 # - VPP_DIR - Path to existing directory, root for relative paths.
214 # - ${1} - Existing directory with built new VPP artifacts (and DPDK).
215 # Directories updated:
216 # - ${DOWNLOAD_DIR} - Old content removed, .deb files from ${1} copied here.
218 # - die - Print to stderr and exit, defined in common.sh
222 cd "${VPP_DIR}" || die "Change directory operation failed."
223 source_dir="$(readlink -e "$1")"
224 rm -rf "${DOWNLOAD_DIR}"/* || die "Cleanup of download dir failed."
225 cp "${source_dir}"/*".deb" "${DOWNLOAD_DIR}" || die "Copy operation failed."
226 # TODO: Is there a nice way to create symlinks,
227 # so that if job fails on robot, results can be archived?
231 function set_aside_commit_build_artifacts () {
233 # Function is copying VPP built artifacts from actual checkout commit for
234 # further use and clean git.
236 # - VPP_DIR - Path to existing directory, parent to accessed directories.
238 # - build-root - Existing directory with built VPP artifacts (also DPDK).
239 # Directories updated:
240 # - ${VPP_DIR} - A local git repository, parent commit gets checked out.
241 # - build_current - Old contents removed, content of build-root copied here.
243 # - die - Print to stderr and exit, defined in common.sh
247 cd "${VPP_DIR}" || die "Change directory operation failed."
248 rm -rf "build_current" || die "Remove operation failed."
249 mkdir -p "build_current" || die "Directory creation failed."
250 mv "build-root"/*".deb" "build_current"/ || die "Move operation failed."
251 # The previous build could have left some incompatible leftovers,
252 # e.g. DPDK artifacts of different version (in build/external).
253 # Also, there usually is a copy of dpdk artifact in build-root.
254 git clean -dffx "build"/ "build-root"/ || die "Git clean operation failed."
255 # Finally, check out the parent commit.
256 git checkout HEAD~ || die "Git checkout operation failed."
257 # Display any other leftovers.
258 git status || die "Git status operation failed."
262 function set_aside_parent_build_artifacts () {
264 # Function is copying VPP built artifacts from parent checkout commit for
265 # further use. Checkout to parent is not part of this function.
267 # - VPP_DIR - Path to existing directory, parent of accessed directories.
269 # - build-root - Existing directory with built VPP artifacts (also DPDK).
270 # Directories updated:
271 # - build_parent - Old directory removed, build-root debs moved here.
273 # - die - Print to stderr and exit, defined in common.sh
277 cd "${VPP_DIR}" || die "Change directory operation failed."
278 rm -rf "build_parent" || die "Remove failed."
279 mkdir -p "build_parent" || die "Directory creation operation failed."
280 mv "build-root"/*".deb" "build_parent"/ || die "Move operation failed."
284 function set_perpatch_dut () {
287 # - DUT - CSIT test/ subdirectory containing suites to execute.
289 # TODO: Detect DUT from job name, when we have more than just VPP perpatch.
297 function set_perpatch_vpp_dir () {
300 # - CSIT_DIR - Path to existing root of local CSIT git repository.
302 # - VPP_DIR - Path to existing root of local VPP git repository.
304 # - die - Print to stderr and exit, defined in common.sh
308 # In perpatch, CSIT is cloned inside VPP clone.
309 VPP_DIR="$(readlink -e "${CSIT_DIR}/..")" || die "Readlink failed."