Skip to content

iter8 launch

iter8 launch

Launch an experiment in the local environment

Synopsis

Launch an experiment in the local environment.

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

Use the dry option to simulate an experiment. This creates the experiment.yaml file but does not run the experiment.

iter8 launch \
--set http.url=https://httpbin.org/get \
--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 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 experiment.yaml file
  -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")
      --runDir string            directory where experiment is run; contains experiment.yaml (default ".")
      --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

  -l, --loglevel string   trace, debug, info, warning, error, fatal, panic (default "info")

SEE ALSO

  • iter8 - Kubernetes release optimizer
Auto generated by spf13/cobra on 12-Jul-2022
Back to top