test/

README

Hub Tests

Hub tests consist of following parts:

• Unit tests $ make test
• REST API tests $ make test-api

All tests can be executed with $ make test-all which will run all available tests.

For API E2E / integration tests, refer to https://github.com/konveyor/go-konveyor-tests

General information

• Tests are written in golang to fit well to the Konveyor project components.
• Each test is responsible for setup its test data and clean it when finished.
• The main way of interacting with Hub is its API, to make testing easier, following tools are provided:
  • RichClient from binding package that provides methods working with Hub resources (like RichClient.Application.Create(&testApp)). This is a preffered option.
  • addon.Client provides API methods like Get/Post/etc. it can be accessed from RichClient.Client
  • test/assertion package provides Should/Must and other equality assertions.
  • Hub's API package provides predefined routes and resources struct definition.

REST API

API tests can be executed on locally running Hub in development mode (without other Konveyor components using DISCONNECTED=1).

$ export DISCONNECTED=1
$ make run

$ export HUB_BASE_URL=http://localhost:8080
$ go test -v ./test/api/

Or tests can run against running Konveyor installation (example with minikube below).

$ export HUB_BASE_URL="http://$(minikube ip)/hub"
$ export HUB_USERNAME="admin"
$ export HUB_PASSWORD="..."
$ go test -v ./test/api/

Sample output

$ make test-api 
echo "Using Hub API from http://192.168.39.236/hub"
Using Hub API from http://192.168.39.236/hub
go test -v ./test/api/...
{"level":"info","ts":1679056454.0379033,"logger":"addon","msg":"Addon (adapter) created."}
{"level":"info","ts":1679056454.041117,"logger":"addon","msg":"|201|  POST /hub/auth/login"}
...
=== RUN   TestApplicationUpdateName
=== RUN   TestApplicationUpdateName/Update_application_Pathfinder
{"level":"info","ts":1679056454.1980724,"logger":"addon","msg":"|201|  POST /hub/applications"}
{"level":"info","ts":1679056454.2010725,"logger":"addon","msg":"|204|  PUT /hub/applications/1"}
{"level":"info","ts":1679056454.2033865,"logger":"addon","msg":"|200|  GET /hub/applications/1"}
{"level":"info","ts":1679056454.2071495,"logger":"addon","msg":"|204|  DELETE /hub/applications/1"}
=== RUN   TestApplicationUpdateName/Update_application_Minimal_application
{"level":"info","ts":1679056454.2095335,"logger":"addon","msg":"|201|  POST /hub/applications"}
{"level":"info","ts":1679056454.2123275,"logger":"addon","msg":"|204|  PUT /hub/applications/1"}
{"level":"info","ts":1679056454.2146227,"logger":"addon","msg":"|200|  GET /hub/applications/1"}
{"level":"info","ts":1679056454.2210302,"logger":"addon","msg":"|204|  DELETE /hub/applications/1"}
--- PASS: TestApplicationUpdateName (0.03s)
    --- PASS: TestApplicationUpdateName/Update_application_Pathfinder (0.01s)
    --- PASS: TestApplicationUpdateName/Update_application_Minimal_application (0.01s)
PASS
ok  	github.com/konveyor/tackle2-hub/test/api/application	0.194s

HTTPS

binding.Client validates SSL certificate. In order to add not trusted CA, it is needed import certificate chain to the local machine.

The chain.pem file can be downloaded with web browser from Konveyor UI page (certificate details) and imported. Example:

# cp apps-mig09-...-chain.pem /etc/pki/ca-trust/source/anchors/
# update-ca-trust