Running the Toolkit

The toolkit has both CLI options and a Web interface.

CLI

To use the CLI, follow these steps:

Pre Requisites:

  1. You will first need to download the toolkit.sh by running the following:

curl -LsSO https://toolkit.re.domino.tech/toolkit.sh && chmod a+x ./toolkit.sh
./toolkit.sh

  1. Access to the kubernetes cluster

Once you have this you can run any of the following commands

./toolkit.sh help

toolkit.sh version: master, n/a

Usage: toolkit.sh [command] [options]

Commands:
  install [options]  Install and start the admin toolkit
  uninstall          Uninstall the admin toolkit, deleting all resources
  start              Starts the admin toolkit if it is stopped
  stop               Stops the admin toolkit if it is running
  status             Shows whether admin toolkit is installed and running
  test    [options]  Run tests with given options and upload html report to S3
  pytest  [options]  Run pytest directly, see https://docs.pytest.org/en/7.1.x/how-to/usage.html
  exec    [command]  Execute a command in the toolkit container (by default /bin/bash), useful for debugging
  logs               Show toolkit container logs
  version            Show toolkit container version
  get-password       Retrieve the admin toolkit UI username and password
  help               Get this help message

`install` command options:
  ./toolkit.sh install --tag|-t tag              Run specific docker image tag of the admin toolkit
  ./toolkit.sh install --daemonset               Enable daemonset functionality
  ./toolkit.sh install --daemonset-port|-d port  Set the host port the daemonset listens on. Default is port 5000.
  ./toolkit.sh install --no-ingress              Disable ingress route to toolkit pod.


`test` command options:
  ./toolkit.sh test --help                  Show help including choice of parameters
  ./toolkit.sh test --exclude               Exclude tests for specific features
  ./toolkit.sh test --log-cli-level DEBUG   Show extra debugging output
  ./toolkit.sh test --local-only            Copy HTML file to host and do not send the report output to Domino's S3

Web Interface

To use the Web interface, navigate to the following URL in your web browser:

This will bring up the Web interface, where you can perform various tasks using the toolkit.

You will be asked to login, you can get the credentials by doing one of the following steps (both require you to have kubernetes access):

  1. Use the toolkit.sh

./toolkit.sh get-password

  1. Run the following kubectl command

# on macOS, it may be necessary to use base64 -D instead of -d
kubectl get secret -n {platform namespace} domino-admin-toolkit-http -ojsonpath='{.data.admin-password}' | base64 -d; echo

From here you can click the run report button to run a fresh report:

Toolkit Web Interface