Merge "Adapted function test for E release"
[nonrtric.git] / test / common / ricsimulator_api_functions.sh
1 #!/bin/bash
2
3 #  ============LICENSE_START===============================================
4 #  Copyright (C) 2020 Nordix Foundation. All rights reserved.
5 #  ========================================================================
6 #  Licensed under the Apache License, Version 2.0 (the "License");
7 #  you may not use this file except in compliance with the License.
8 #  You may obtain a copy of the License at
9 #
10 #       http://www.apache.org/licenses/LICENSE-2.0
11 #
12 #  Unless required by applicable law or agreed to in writing, software
13 #  distributed under the License is distributed on an "AS IS" BASIS,
14 #  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15 #  See the License for the specific language governing permissions and
16 #  limitations under the License.
17 #  ============LICENSE_END=================================================
18 #
19
20 # This is a script that contains container/service management functions and test functions for RICSIM A1 simulators
21
22 ################ Test engine functions ################
23
24 # Create the image var used during the test
25 # arg: <image-tag-suffix> (selects staging, snapshot, release etc)
26 # <image-tag-suffix> is present only for images with staging, snapshot,release tags
27 __RICSIM_imagesetup() {
28         __check_and_create_image_var RICSIM "RIC_SIM_IMAGE" "RIC_SIM_IMAGE_BASE" "RIC_SIM_IMAGE_TAG" $1 "$RIC_SIM_DISPLAY_NAME"
29 }
30
31 # Pull image from remote repo or use locally built image
32 # arg: <pull-policy-override> <pull-policy-original>
33 # <pull-policy-override> Shall be used for images allowing overriding. For example use a local image when test is started to use released images
34 # <pull-policy-original> Shall be used for images that does not allow overriding
35 # Both var may contain: 'remote', 'remote-remove' or 'local'
36 __RICSIM_imagepull() {
37         __check_and_pull_image $1 "$RIC_SIM_DISPLAY_NAME" $RIC_SIM_PREFIX"_"$RIC_SIM_BASE RIC_SIM_IMAGE
38 }
39
40 # Generate a string for each included image using the app display name and a docker images format string
41 # If a custom image repo is used then also the source image from the local repo is listed
42 # arg: <docker-images-format-string> <file-to-append>
43 __RICSIM_image_data() {
44         echo -e "$RIC_SIM_DISPLAY_NAME\t$(docker images --format $1 $RIC_SIM_IMAGE)" >>   $2
45         if [ ! -z "$RIC_SIM_IMAGE_SOURCE" ]; then
46                 echo -e "-- source image --\t$(docker images --format $1 $RIC_SIM_IMAGE_SOURCE)" >>   $2
47         fi
48 }
49
50 # Scale kubernetes resources to zero
51 # All resources shall be ordered to be scaled to 0, if relevant. If not relevant to scale, then do no action.
52 # This function is called for apps fully managed by the test script
53 __RICSIM_kube_scale_zero() {
54         __kube_scale_all_resources $KUBE_NONRTRIC_NAMESPACE autotest RICSIM
55 }
56
57 # Scale kubernetes resources to zero and wait until this has been accomplished, if relevant. If not relevant to scale, then do no action.
58 # This function is called for prestarted apps not managed by the test script.
59 __RICSIM_kube_scale_zero_and_wait() {
60         __kube_scale_and_wait_all_resources $KUBE_NONRTRIC_NAMESPACE app nonrtric-a1simulator
61 }
62
63 # Delete all kube resouces for the app
64 # This function is called for apps managed by the test script.
65 __RICSIM_kube_delete_all() {
66         __kube_delete_all_resources $KUBE_NONRTRIC_NAMESPACE autotest RICSIM
67 }
68
69 # Store docker logs
70 # This function is called for apps managed by the test script.
71 # args: <log-dir> <file-prexix>
72 __RICSIM_store_docker_logs() {
73         rics=$(docker ps --filter "name=$RIC_SIM_PREFIX" --filter "network=$DOCKER_SIM_NWNAME" --filter "status=running" --format {{.Names}})
74         for ric in $rics; do
75                 docker logs $ric > $1$2_$ric.log 2>&1
76         done
77 }
78
79 #######################################################
80
81
82 RIC_SIM_HTTPX="http"
83 RIC_SIM_HOST=$RIC_SIM_HTTPX"://"$LOCALHOST_NAME
84 RIC_SIM_PORT=$RIC_SIM_INTERNAL_PORT
85
86
87 #Vars for A1 interface version and container count
88 G1_A1_VERSION=""
89 G2_A1_VERSION=""
90 G3_A1_VERSION=""
91 G4_A1_VERSION=""
92 G5_A1_VERSION=""
93 G1_COUNT=0
94 G2_COUNT=0
95 G3_COUNT=0
96 G4_COUNT=0
97 G5_COUNT=0
98
99
100 ###########################
101 ### RIC Simulator functions
102 ###########################
103
104 use_simulator_http() {
105         echo -e $BOLD"RICSIM protocol setting"$EBOLD
106         echo -e " Using $BOLD http $EBOLD towards the simulators"
107         RIC_SIM_HTTPX="http"
108         RIC_SIM_HOST=$RIC_SIM_HTTPX"://"$LOCALHOST_NAME
109         RIC_SIM_PORT=$RIC_SIM_INTERNAL_PORT
110         echo ""
111 }
112
113 use_simulator_https() {
114         echo -e $BOLD"RICSIM protocol setting"$EBOLD
115         echo -e " Using $BOLD https $EBOLD towards the simulators"
116         RIC_SIM_HTTPX="https"
117         RIC_SIM_HOST=$RIC_SIM_HTTPX"://"$LOCALHOST_NAME
118         RIC_SIM_PORT=$RIC_SIM_INTERNAL_SECURE_PORT
119         echo ""
120 }
121
122 # Start one group (ricsim_g1, ricsim_g2 .. ricsim_g5) with a number of RIC Simulators using a given A interface
123 # 'ricsim' may be set on command line to other prefix
124 # args:  ricsim_g1|ricsim_g2|ricsim_g3|ricsim_g4|ricsim_g5 <count> <interface-id>
125 # (Function for test scripts)
126 start_ric_simulators() {
127
128         echo -e $BOLD"Starting $RIC_SIM_DISPLAY_NAME"$EBOLD
129
130         if [ $RUNMODE == "KUBE" ]; then
131
132                 # Check if app shall be fully managed by the test script
133                 __check_included_image "RICSIM"
134                 retcode_i=$?
135
136                 # Check if app shall only be used by the testscipt
137                 __check_prestarted_image "RICSIM"
138                 retcode_p=$?
139
140                 if [ $retcode_i -ne 0 ] && [ $retcode_p -ne 0 ]; then
141                         echo -e $RED"The $1 app is not included as managed nor prestarted in this test script"$ERED
142                         echo -e $RED"The $1 will not be started"$ERED
143                         exit
144                 fi
145                 if [ $retcode_i -eq 0 ] && [ $retcode_p -eq 0 ]; then
146                         echo -e $RED"The $1 stub app is included both as managed and prestarted in this test script"$ERED
147                         echo -e $RED"The $1 will not be started"$ERED
148                         exit
149                 fi
150
151                 if [ $retcode_p -eq 0 ]; then
152                         echo -e " Using existing $1 statefulset and service"
153                         echo " Using existing simulator deployment and service for statefulset $1"
154                         echo " Setting $1 replicas=$2"
155                         __kube_scale statefulset $1 $KUBE_NONRTRIC_NAMESPACE $2
156                         echo ""
157                         return
158                 fi
159         fi
160
161         RIC1=$RIC_SIM_PREFIX"_g1"
162         RIC2=$RIC_SIM_PREFIX"_g2"
163         RIC3=$RIC_SIM_PREFIX"_g3"
164         RIC4=$RIC_SIM_PREFIX"_g4"
165         RIC5=$RIC_SIM_PREFIX"_g5"
166
167         if [ $# != 3 ]; then
168                 ((RES_CONF_FAIL++))
169                 __print_err "need three args,  $RIC1|$RIC2|$RIC3|$RIC4|$RIC5 <count> <interface-id>" $@
170                 exit 1
171         fi
172
173         echo " $2 simulators using basename: $1 on interface: $3"
174         #Set env var for simulator count and A1 interface vesion for the given group
175         if [ $1 == "$RIC1" ]; then
176                 G1_COUNT=$2
177                 G1_A1_VERSION=$3
178         elif [ $1 == "$RIC2" ]; then
179                 G2_COUNT=$2
180                 G2_A1_VERSION=$3
181         elif [ $1 == "$RIC3" ]; then
182                 G3_COUNT=$2
183                 G3_A1_VERSION=$3
184         elif [ $1 == "$RIC4" ]; then
185                 G4_COUNT=$2
186                 G4_A1_VERSION=$3
187         elif [ $1 == "$RIC5" ]; then
188                 G5_COUNT=$2
189                 G5_A1_VERSION=$3
190         else
191                 ((RES_CONF_FAIL++))
192                 __print_err "need three args, $RIC1|$RIC2|$RIC3|$RIC4|$RIC5 <count> <interface-id>" $@
193                 exit 1
194         fi
195
196         if [ $RUNMODE == "KUBE" ]; then
197
198                 if [ $retcode_i -eq 0 ]; then
199
200                         #export needed env var for statefulset
201                         export RIC_SIM_SET_NAME=$(echo "$1" | tr '_' '-')  #kube does not accept underscore in names
202                         export KUBE_NONRTRIC_NAMESPACE
203                         export RIC_SIM_IMAGE
204                         #Adding 1 more instance, instance 0 is never used. This is done to keep test scripts compatible
205                         # with docker that starts instance index on 1.....
206                         export RIC_SIM_COUNT=$(($2+1))
207                         export A1_VERSION=$3
208                         export RIC_SIM_INTERNAL_PORT
209                         export RIC_SIM_INTERNAL_SECURE_PORT
210
211                         echo -e " Creating $POLICY_AGENT_APP_NAME app and expose service"
212
213                         #Check if nonrtric namespace exists, if not create it
214                         __kube_create_namespace $KUBE_NONRTRIC_NAMESPACE
215
216                         # Create service
217                         input_yaml=$SIM_GROUP"/"$RIC_SIM_COMPOSE_DIR"/"svc.yaml
218                         output_yaml=$PWD/tmp/ric_${1}_svc.yaml
219                         __kube_create_instance service $RIC_SIM_SET_NAME $input_yaml $output_yaml
220
221                         # Create app
222                         input_yaml=$SIM_GROUP"/"$RIC_SIM_COMPOSE_DIR"/"app.yaml
223                         output_yaml=$PWD/tmp/pa_${1}_app.yaml
224                         __kube_create_instance app $RIC_SIM_SET_NAME $input_yaml $output_yaml
225
226                         #Using only instance from index 1 to keep compatability with docker
227                         for (( count=1; count<${RIC_SIM_COUNT}; count++ )); do
228                                 host=$(__find_sim_host $RIC_SIM_SET_NAME"-"$count)
229                                 __check_service_start $RIC_SIM_SET_NAME"-"$count $host"/"
230                         done
231                 fi
232         else
233
234                 __check_included_image 'RICSIM'
235                 if [ $? -eq 1 ]; then
236                         echo -e $RED"The Near-RT RIC Simulator app is not included as managed in this test script"$ERED
237                         echo -e $RED"Near-RT RIC Simulator will not be started"$ERED
238                         exit 1
239                 fi
240
241                 # Create .env file to compose project, all ric container will get this prefix
242                 echo "COMPOSE_PROJECT_NAME="$RIC_SIM_PREFIX > $SIM_GROUP/$RIC_SIM_COMPOSE_DIR/.env
243
244                 export G1_A1_VERSION
245                 export G2_A1_VERSION
246                 export G3_A1_VERSION
247                 export G4_A1_VERSION
248                 export G5_A1_VERSION
249                 export RIC_SIM_INTERNAL_PORT
250                 export RIC_SIM_INTERNAL_SECURE_PORT
251                 export RIC_SIM_CERT_MOUNT_DIR
252                 export DOCKER_SIM_NWNAME
253                 export RIC_SIM_DISPLAY_NAME
254
255                 docker_args="--scale g1=$G1_COUNT --scale g2=$G2_COUNT --scale g3=$G3_COUNT --scale g4=$G4_COUNT --scale g5=$G5_COUNT"
256                 app_data=""
257                 cntr=1
258                 while [ $cntr -le $2 ]; do
259                         app=$1"_"$cntr
260                         app_data="$app_data $app"
261                         let cntr=cntr+1
262                 done
263
264                 __start_container $RIC_SIM_COMPOSE_DIR "" "$docker_args" $2 $app_data
265
266                 cntr=1
267                 while [ $cntr -le $2 ]; do
268                         app=$1"_"$cntr
269                         localport=0
270
271                         while [ $localport -eq 0 ]; do
272                                 echo -ne " Waiting for container ${app} to publish its ports...${SAMELINE}"
273                                 localport=$(__find_sim_port $app)
274                                 sleep 0.5
275                                 echo -ne " Waiting for container ${app} to publish its ports...retrying....${SAMELINE}"
276                         done
277                         echo -e " Waiting for container ${app} to publish its ports...retrying....$GREEN OK $EGREEN"
278                         __check_service_start $app $RIC_SIM_HOST":"$localport$RIC_SIM_ALIVE_URL
279                         let cntr=cntr+1
280                 done
281         fi
282         echo ""
283         return 0
284 }
285
286 # Translate ric name to kube host name
287 # args: <ric-name>
288 # For test scripts
289 get_kube_sim_host() {
290         name=$(echo "$1" | tr '_' '-')  #kube does not accept underscore in names
291         #example gnb_1_2 -> gnb-1-2
292         set_name=$(echo $name | rev | cut -d- -f2- | rev) # Cut index part of ric name to get the name of statefulset
293         # example gnb-g1-2 -> gnb-g1 where gnb-g1-2 is the ric name and gnb-g1 is the set name
294         echo $name"."$set_name"."$KUBE_NONRTRIC_NAMESPACE
295 }
296
297 # Helper function to get a the port of a specific ric simulator
298 # args: <ric-id>
299 # (Not for test scripts)
300 __find_sim_port() {
301     name=$1" " #Space appended to prevent matching 10 if 1 is desired....
302     cmdstr="docker inspect --format='{{(index (index .NetworkSettings.Ports \"$RIC_SIM_PORT/tcp\") 0).HostPort}}' ${name}"
303     res=$(eval $cmdstr)
304         if [[ "$res" =~ ^[0-9]+$ ]]; then
305                 echo $res
306         else
307                 echo "0"
308     fi
309 }
310
311 # Helper function to get a the port and host name of a specific ric simulator
312 # args: <ric-id>
313 # (Not for test scripts)
314 __find_sim_host() {
315         if [ $RUNMODE == "KUBE" ]; then
316                 ricname=$(echo "$1" | tr '_' '-')
317                 for timeout in {1..500}; do   # long waiting time needed in case of starting large number of sims
318                         host=$(kubectl get pod $ricname  -n $KUBE_NONRTRIC_NAMESPACE -o jsonpath='{.status.podIP}' 2> /dev/null)
319                         if [ ! -z "$host" ]; then
320                                 echo $RIC_SIM_HTTPX"://"$host":"$RIC_SIM_PORT
321                                 return 0
322                         fi
323                         sleep 0.5
324                 done
325                 echo "host-not-found-fatal-error"
326         else
327                 name=$1" " #Space appended to prevent matching 10 if 1 is desired....
328                 cmdstr="docker inspect --format='{{(index (index .NetworkSettings.Ports \"$RIC_SIM_PORT/tcp\") 0).HostPort}}' ${name}"
329                 res=$(eval $cmdstr)
330                 if [[ "$res" =~ ^[0-9]+$ ]]; then
331                         echo $RIC_SIM_HOST:$res
332                         return 0
333                 else
334                         echo "0"
335                 fi
336         fi
337         return 1
338 }
339
340 # Generate a UUID to use as prefix for policy ids
341 generate_policy_uuid() {
342         UUID=$(python3 -c 'import sys,uuid; sys.stdout.write(uuid.uuid4().hex)')
343         #Reduce length to make space for serial id, uses 'a' as marker where the serial id is added
344         UUID=${UUID:0:${#UUID}-4}"a"
345 }
346
347 # Excute a curl cmd towards a ricsimulator and check the response code.
348 # args: <expected-response-code> <curl-cmd-string>
349 __execute_curl_to_sim() {
350         echo ${FUNCNAME[1]} "line: "${BASH_LINENO[1]} >> $HTTPLOG
351         proxyflag=""
352         if [ $RUNMODE == "KUBE" ]; then
353                 if [ ! -z "$KUBE_PROXY_PATH" ]; then
354                         if [ $KUBE_PROXY_HTTPX == "http" ]; then
355                                 proxyflag=" --proxy $KUBE_PROXY_PATH"
356                         else
357                                 proxyflag=" --proxy-insecure --proxy $KUBE_PROXY_PATH"
358                         fi
359                 fi
360         fi
361         echo " CMD: $2 $proxyflag" >> $HTTPLOG
362         res="$($2 $proxyflag)"
363         echo " RESP: $res" >> $HTTPLOG
364         retcode=$?
365     if [ $retcode -ne 0 ]; then
366                 ((RES_CONF_FAIL++))
367                 echo " RETCODE: "$retcode
368         echo -e $RED" FAIL - fatal error when executing curl."$ERED
369         return 1
370     fi
371     status=${res:${#res}-3}
372     if [ $status -eq $1 ]; then
373         echo -e $GREEN" OK"$EGREEN
374         return 0
375     fi
376     echo -e $RED" FAIL - expected http response: "$1" but got http response: "$status $ERED
377         ((RES_CONF_FAIL++))
378     return 1
379 }
380
381 # Tests if a variable value in the ricsimulator is equal to a target value and and optional timeout.
382 # Arg: <ric-id> <variable-name> <target-value> - This test set pass or fail depending on if the variable is
383 # equal to the target or not.
384 # Arg: <ric-id> <variable-name> <target-value> <timeout-in-sec>  - This test waits up to the timeout seconds
385 # before setting pass or fail depending on if the variable value becomes equal to the target
386 # value or not.
387 # (Function for test scripts)
388 sim_equal() {
389
390         if [ $# -eq 3 ] || [ $# -eq 4 ]; then
391                 host=$(__find_sim_host $1)
392                 __var_test $1 "$host/counter/" $2 "=" $3 $4
393                 return 0
394         else
395                 __print_err "needs three or four args: <ric-id> <sim-param> <target-value> [ timeout ]"
396                 return 1
397         fi
398 }
399
400 # Print a variable value from the RIC sim.
401 # args: <ric-id> <variable-name>
402 # (Function for test scripts)
403 sim_print() {
404
405         if [ $# != 2 ]; then
406         __print_err "need two args, <ric-id> <sim-param>" $@
407                 exit 1
408         fi
409         host=$(__find_sim_host $1)
410         echo -e $BOLD"INFO(${BASH_LINENO[0]}): $1, $2 = $(__do_curl $host/counter/$2)"$EBOLD
411 }
412
413 # Tests if a variable value in the RIC simulator contains the target string and and optional timeout
414 # Arg: <ric-id> <variable-name> <target-value> - This test set pass or fail depending on if the variable contains
415 # the target or not.
416 # Arg: <ric-id> <variable-name> <target-value> <timeout-in-sec>  - This test waits up to the timeout seconds
417 # before setting pass or fail depending on if the variable value contains the target
418 # value or not.
419 # (Function for test scripts)
420 sim_contains_str() {
421
422         if [ $# -eq 3 ] || [ $# -eq 4 ]; then
423                 host=$(__find_sim_host $1)
424                 __var_test $1 "$host/counter/" $2 "contain_str" $3 $4
425                 return 0
426         else
427                 __print_err "needs three or four args: <ric-id> <sim-param> <target-value> [ timeout ]"
428                 return 1
429         fi
430 }
431
432 # Simulator API: Put a policy type in a ric
433 # args: <response-code> <ric-id> <policy-type-id> <policy-type-file>
434 # (Function for test scripts)
435 sim_put_policy_type() {
436         __log_conf_start $@
437         if [ $# -ne 4 ]; then
438                 __print_err "<response-code> <ric-id> <policy-type-id> <policy-type-file>" $@
439                 return 1
440         fi
441         host=$(__find_sim_host $2)
442     curlString="curl -X PUT -skw %{http_code} "$host"/policytype?id="$3" -H Content-Type:application/json --data-binary @"$4
443         __execute_curl_to_sim $1 "$curlString"
444         return $?
445 }
446
447 # Simulator API: Delete a policy type in a ric
448 # <response-code> <ric-id> <policy-type-id>
449 # (Function for test scripts)
450 sim_delete_policy_type() {
451         __log_conf_start $@
452         if [ $# -ne 3 ]; then
453                 __print_err "<response-code> <ric-id> <policy_type_id>" $@
454                 return 1
455         fi
456         host=$(__find_sim_host $2)
457     curlString="curl -X DELETE -skw %{http_code} "$host"/policytype?id="$3
458     __execute_curl_to_sim $1 "$curlString"
459         return $?
460 }
461
462 # Simulator API: Delete instances (and status), for one ric
463 # <response-code> <ric-id>
464 # (Function for test scripts)
465 sim_post_delete_instances() {
466         __log_conf_start $@
467         if [ $# -ne 2 ]; then
468                 __print_err "<response-code> <ric-id>" $@
469                 return 1
470         fi
471         host=$(__find_sim_host $2)
472     curlString="curl -X POST -skw %{http_code} "$host"/deleteinstances"
473     __execute_curl_to_sim $1 "$curlString"
474         return $?
475 }
476
477 # Simulator API: Delete all (instances/types/statuses/settings), for one ric
478 # <response-code> <ric-id>
479 # (Function for test scripts)
480 sim_post_delete_all() {
481         __log_conf_start $@
482         if [ $# -ne 2 ]; then
483                 __print_err "<response-code> <numericic-id>" $@
484                 return 1
485         fi
486         host=$(__find_sim_host $2)
487     curlString="curl -X POST -skw %{http_code} "$host"/deleteall"
488     __execute_curl_to_sim $1 "$curlString"
489         return $?
490 }
491
492 # Simulator API: Set (or reset) response code for next A1 message, for one ric
493 # <response-code> <ric-id> [<forced_response_code>]
494 # (Function for test scripts)
495 sim_post_forcedresponse() {
496         __log_conf_start $@
497         if [ $# -ne 3 ]; then
498                 __print_err "<response-code> <ric-id> <forced_response_code>" $@
499                 return 1
500         fi
501         host=$(__find_sim_host $2)
502     curlString="curl -X POST -skw %{http_code} "$host"/forceresponse"
503         if [ $# -eq 3 ]; then
504                 curlString=$curlString"?code="$3
505         fi
506     __execute_curl_to_sim $1 "$curlString"
507         return $?
508 }
509
510 # Simulator API: Set (or reset) A1 response delay, for one ric
511 # <response-code> <ric-id> [<delay-in-seconds>]
512 # (Function for test scripts)
513 sim_post_forcedelay() {
514         __log_conf_start $@
515         if [ $# -ne 3 ]; then
516                 __print_err "<response-code> <ric-id> [<delay-in-seconds>]" $@
517                 return 1
518         fi
519         host=$(__find_sim_host $2)
520     curlString="curl -X POST -skw %{http_code} $host/forcedelay"
521         if [ $# -eq 3 ]; then
522                 curlString=$curlString"?delay="$3
523         fi
524     __execute_curl_to_sim $1 "$curlString"
525         return $?
526 }