Skip to content

iter8 k launch

iter8 k launch

Launch an experiment inside a Kubernetes cluster

Synopsis

Launch an experiment inside a Kubernetes cluster. 

iter8 k launch --set "tasks={http}" --set http.url=https://httpbin.org/get \
--set runner=job

Use the dry option to simulate a Kubernetes experiment. This creates the manifest.yaml file, but does not run the experiment, and does not deploy any experiment resource objects in the cluster.

iter8 k launch \
--set http.url=https://httpbin.org/get \
--set runner=job \
--dry

The launch command creates the 'charts' subdirectory under the current working directory, downloads the Iter8 experiment chart, and places it under 'charts'. This behavior can be controlled using various launch flags.

This command supports setting values using the same mechanisms as in Helm. Please see https://helm.sh/docs/chart_template_guide/values_files/ for more detailed descriptions. In particular, this command supports the --set, --set-file, --set-string, and -f (--values) options all of which have the same behavior as in Helm.

iter8 k launch [flags]

Options

  -c, --chartName string         name of the experiment chart (default "iter8")
      --chartsParentDir string   directory under which the charts folder is located (default ".")
      --dry                      simulate an experiment launch; outputs manifest.yaml file
  -g, --group string             name of the experiment group (default "default")
  -h, --help                     help for launch
      --noDownload               reuse local charts dir - do not download from remoteFolderURL; if local charts are present, this flag is required - set it to true or false; if local charts are absent, do not use this flag
      --remoteFolderURL string   URL of the remote folder containing the Iter8 experiment chart. Accepts any URL supported by https://github.com/hashicorp/go-getter (default "github.com/iter8-tools/iter8.git?ref=v0.11.8//charts")
      --set stringArray          set values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
      --set-file stringArray     set values from respective files specified via the command line (can specify multiple or separate values with commas: key1=path1,key2=path2)
      --set-string stringArray   set STRING values on the command line (can specify multiple or separate values with commas: key1=val1,key2=val2)
  -f, --values strings           specify values in a YAML file or a URL (can specify multiple)

Options inherited from parent commands

      --kube-apiserver string       the address and the port for the Kubernetes API server
      --kube-as-group stringArray   group to impersonate for the operation, this flag can be repeated to specify multiple groups.
      --kube-as-user string         username to impersonate for the operation
      --kube-ca-file string         the certificate authority file for the Kubernetes API server connection
      --kube-context string         name of the kubeconfig context to use
      --kube-token string           bearer token used for authentication
      --kubeconfig string           path to the kubeconfig file
  -l, --loglevel string             trace, debug, info, warning, error, fatal, panic (default "info")
  -n, --namespace string            namespace scope for this request

SEE ALSO

  • iter8 k - Work with Kubernetes experiments
Auto generated by spf13/cobra on 12-Jul-2022
Back to top