Skip to content

Latest commit

 

History

History
90 lines (48 loc) · 3.77 KB

README.adoc

File metadata and controls

90 lines (48 loc) · 3.77 KB

Hack Scripts

Description

The following are brief summaries for each hack script. Most of these hack scripts accept a --help option to provide information on the different options available.

Starts and stops an OpenShift cluster on AWS as well as provides information about the running OpenShift cluster. You must have an AWS account as well as an OpenShift pull secret to use this.

Used by the Kiali server build targets in order to confirm the version of Go is compatible with Kiali.

Runs the Kiali molecule tests on a Kind Kubernetes cluster. This utilizes kind to start and stop a k8s cluster and the run-molecule-tests.sh script to run the molecule tests. Use this in a cron job to periodically run the molecule tests on kind.

Runs the Kiali molecule tests on a minikube Kubernetes cluster. This utilizes the k8s-minikube.sh script to start and stop a minikube VM and the run-molecule-tests.sh script to run the molecule tests. Use this in a cron job to periodically run the molecule tests on minikube.

Runs the Kiali molecule tests on an existing OpenShift cluster. Utilizes the run-molecule-tests.sh script to run the molecule tests. Use this in a cron job to periodically run the molecule tests.

Configures an installed operator so you can enable and disable operator features (see https://kiali.io/docs/faq/installation/#operator-configuration)

Runs OpenShift on the local machine using CRC.

A testing utility that can be used to decode JWT encoded tokens generated by the Kiali server.

A testing utility that can be used to encode JWT tokens. Developers use this to generate unauthorized tokens and pass them to Kiali to try to see if the Kiali authentication mechanism can be thwarted.

Starts and stops a Kubernetes cluster via minikube as well as provides information about the running Kubernetes cluster. This can optionally install Dex OpenID Connect provider which is useful for testing Kiali’s OpenID authentication integration.

Use this to access the Kiali UI that is installed locally in minikube or kind.

Removes all remnants of Kiali and Kiali Operator from a cluster.

Runs Kiali on the local machine while having it connect to a remote k8s cluster. This is useful for development and debugging.

Runs the suite of molecule tests on a running OpenShift or minikube cluster.

Runs a local Prometheus in docker and scrapes the Kiali server and operator that is running in an OpenShift cluster.

Running Molecule Tests Periodically

Testing on Minikube

You can do this for a cron job in order to periodically run the Molecule tests on Minikube. If Minikube is not yet started, this script will start one for you (using k8s-minikube.sh) with Dex installed so the OIDC tests can run:

hack/ci-minikube-molecule-tests.sh

There are several options you can pass to that script - pass in --help to see what is applicable for you.

Testing on OpenShift

If you have a cluster running - one that was installed locally via ocp4_setup_upi_kvm - you can do this for a cron job in order to periodically run the Molecule tests:

hack/ci-openshift-molecule-tests.sh

There are several options you can pass to that script - pass in --help to see what is applicable for you.