This is brief guide to get you up and running with Red Sky Ops as quickly as possible.
You must have a Kubernetes cluster. Additionally, you will need a local configured copy of
kubectl. The Red Sky Ops Tool will use the same configuration as
$HOME/.kube/config) to connect to your cluster.
A local install of Kustomize (v3.1.0+) is required to build the objects for your cluster.
If you are planing to create the simple experiment from this guide, a minikube cluster is preferred.
Install the Red Sky Ops Tool
Download and install the
redskyctl binary for your platform. You will need to rename the downloaded file and mark it as executable.
For more details, see the installation guide.
Initialize the Red Sky Ops Manager
Once you have the Red Sky Ops Tool you can initialize the manager in your cluster:
$ redskyctl init
Create a Simple Experiment
Generally you will want to write your own experiments to run trials on your own applications. For the purposes of this guide we can use the simple example found in the
k8s-experiment repository on GitHub:
$ kustomize build github.com/redskyops/k8s-experiment//examples/simple | kubectl apply -f -
Run a Trial
With your experiment created, you can be begin running trials by suggesting parameter assignments locally. Each trial will create one or more Kubernetes jobs and will conclude by collecting a small number of metric values indicative of the performance for the trial.
To interactively create a new trial for the example experiment, run:
$ redskyctl suggest --interactive simple
You will be prompted to enter a value for each parameter in the experiment and a new trial will be created. You can monitor the progress using
$ kubectl get trials
When running interactive trials in a single namespace, be sure only trial is active at a time.
Removing the Experiment
To clean up the data from your experiment, simply delete the experiment. The delete will cascade to the associated trials and other Kubernetes objects:
$ kubectl delete experiment simple
Congratulations! You just ran your first experiment. You can move on to a more advanced tutorial or browse the rest of the documentation to learn more about the Red Sky Ops Kubernetes experimentation product.