Link Search Menu Expand Document

Getting Started

All you need to get started is access to a Kubernetes cluster plus kubectl and Helm installed on your machine.

  1. To install Theodolite with all its dependencies run:

     helm repo add theodolite https://cau-se.github.io/theodolite
     helm repo update
     helm install theodolite theodolite/theodolite -f https://raw.githubusercontent.com/cau-se/theodolite/master/helm/preconfigs/minimal.yaml
    
  2. Get the Theodolite examples from the Theodolite repository and cd into its example directory:

     git clone https://github.com/cau-se/theodolite.git
     cd theodolite/theodolite/examples/operator/
    
  3. Deploy the example Benchmark and package its associated Kubernetes resources in a ConfigMap:

     kubectl apply -f example-benchmark.yaml
     kubectl apply -f example-configmap.yaml
    
  4. Verify that the Benchmark has been deployed successfully:

     kubectl get benchmarks
    

    The output is similar to this:

     NAME                AGE   STATUS
     example-benchmark   81s   Ready
    
  5. Run the Benchmark by deploying an Execution:

     kubectl apply -f example-execution.yaml 
    
  6. Verify that the Executions is running:

     kubectl get executions
    

    The output is similar to this:

     NAME                           STATUS    DURATION   AGE
     theodolite-example-execution   Running   13s        14s
    

    Theodolite provides additional information on the current status of an Execution by producing Kubernetes events. To see them:

     kubectl describe execution theodolite-example-execution
    

Next Steps