Maistra OpenShift Test Tool

A testing tool for running Maistra Service Mesh tasks on an OpenShift 4.x cluster.

Introduction

This project aims to automate Maistra Service Mesh tasks on an OpenShift 4.x Cluster.

The testing tasks are based on istio.io Doc Tasks

Versions

Name	Version
OS	Linux
Golang	1.13+
OpenSSl	1.1.1+
oc client	4.x

Testing Prerequisite

1. An oc client can be downloaded from mirror openshift-v4 clients. Extract the openshift-client-...tar.gz file and move both oc and kubectl binaries into a local PATH directory.

2. Access an OpenShift cluster from command line before running tests. Run a login command. oc login -u [user] -p [token] --server=[OCP API server]

3. RedHat Service Mesh Operator has been installed on the OpenShift cluster.

Testing

• A main test is in the tests directory. All test cases are in the test_cases.go and are mapped to the implementations in the pkg directory.

• In order to save results in a XML report, we can run a go test command with "github.com/jstemmer/go-junit-report".

  $ go get -u github.com/jstemmer/go-junit-report
  

• Optionally to run all the test cases customizing the SMCP namespace and the SMCP name: A user can update the expected values in the tests/test.env.

• By default, the tests/test.env file uses export SAMPLEARCH=x86

  • For Power environment testing, a user can update the tests/test.env file export SAMPLEARCH=p
  • For Z environment testing, a user can update the tests/test.env file export SAMPLEARCH=z

• To run all the test cases: cd tests; go test -timeout 2h -v.

  The -timeout flag is necessary when running all tests or several major test cases. Otherwise, a go test command falls into panic after 10 minutes.

  $ cd tests
  $ go test -timeout 2h -v 2>&1 | tee >(${GOPATH}/bin/go-junit-report > results.xml) test.log
  

• To run a single test case: e.g. cd tests; go test -run A1 -timeout 2h -v

  Test cases shortname and mapping are in the tests/test_cases.go file.

License

Maistra OpenShift Test Tool is Apache 2.0 licensed