Skip to main content
New to Testkube? Unleash the power of cloud native testing in Kubernetes with Testkube. Get Started >

testkube_run_test

testkube run test​

Starts new test

Synopsis​

Starts new test based on Test Custom Resource name, returns results to console

testkube run test <testName> [flags]

Options​

      --args stringArray                           executor binary additional arguments
      --args-mode string                           usage mode for argumnets. one of append|override|replace (default "append")
      --artifact-dir stringArray                   artifact dirs for scraping
      --artifact-mask stringArray                  regexp to filter scraped artifacts, single or comma separated, like report/.* or .*\.json,.*\.js$
      --artifact-omit-folder-per-execution         don't store artifacts in execution folder
      --artifact-shared-between-pods               whether to share volume between pods
      --artifact-storage-bucket string             artifact storage bucket
      --artifact-storage-class-name string         artifact storage class name for container executor
      --artifact-use-default-storage-class-name    whether to use default storage class name
      --artifact-volume-mount-path string          artifact volume mount path for container executor
      --command stringArray                        command passed to image in executor
      --concurrency int                            concurrency level for multiple test execution (default 10)
      --context string                             running context description for test execution
      --copy-files stringArray                     file path mappings from host to pod of form source:destination
  -d, --download-artifacts                         download artifacts automatically
      --download-dir string                        download dir (default "artifacts")
      --execute-postrun-script-before-scraping     whether to execute postrun scipt before scraping or not (prebuilt executor only)
      --execution-label stringToString             execution-label key value pair: --execution-label key1=value1 (default [])
      --execution-namespace string                 namespace for test execution (Pro edition only)
      --format string                              data format for storing files, one of folder|archive (default "folder")
      --git-branch string                          if uri is git repository we can set additional branch parameter
      --git-commit string                          if uri is git repository we can use commit id (sha) parameter
      --git-path string                            if repository is big we need to define additional path to directory/file to checkout partially
      --git-working-dir string                     if repository contains multiple directories with tests (like monorepo) and one starting directory we can set working directory parameter
  -h, --help                                       help for test
      --http-proxy string                          http proxy for executor containers
      --https-proxy string                         https proxy for executor containers
      --image string                               override executor container image
      --iterations int                             how many times to run the test (default 1)
      --job-template string                        job template file path for extensions to job template
      --job-template-reference string              reference to job template to use for the test
  -l, --label strings                              label key value pair: --label key1=value1
      --mask stringArray                           regexp to filter downloaded files, single or comma separated, like report/.* or .*\.json,.*\.js$
      --mount-configmap stringToString             config map value pair for mounting it to executor pod: --mount-configmap configmap_name=configmap_mountpath (default [])
      --mount-secret stringToString                secret value pair for mounting it to executor pod: --mount-secret secret_name=secret_mountpath (default [])
  -n, --name string                                execution name, if empty will be autogenerated
      --negative-test                              negative test, if enabled, makes failure an expected and correct test result. If the test fails the result will be set to success, and vice versa
      --postrun-script string                      path to script to be run after test execution
      --prerun-script string                       path to script to be run before test execution
      --pvc-template string                        pvc template file path for extensions to pvc template
      --pvc-template-reference string              reference to pvc template to use for the test
      --scraper-template string                    scraper template file path for extensions to scraper template
      --scraper-template-reference string          reference to scraper template to use for the test
  -s, --secret-variable stringArray                execution secret variable passed to executor
      --secret-variable-reference stringToString   secret variable references in a form name1=secret_name1=secret_key1 (default [])
      --silent                                     don't print intermediate test execution
      --slave-pod-limits-cpu string                slave pod resource limits cpu
      --slave-pod-limits-memory string             slave pod resource limits memory
      --slave-pod-requests-cpu string              slave pod resource requests cpu
      --slave-pod-requests-memory string           slave pod resource requests memory
      --slave-pod-template string                  slave pod template file path for extensions to slave pod template
      --slave-pod-template-reference string        reference to slave pod template to use for the test
      --source-scripts                             run scripts using source command (container executor only)
      --upload-timeout string                      timeout to use when uploading files, example: 30s
  -v, --variable stringArray                       execution variable passed to executor
      --variable-configmap stringArray             config map name used to map all keys to basis variables
      --variable-secret stringArray                secret name used to map all keys to secret variables
      --variables-file string                      variables file path, e.g. postman env file - will be passed to executor if supported
  -f, --watch                                      watch for changes after start

Options inherited from parent commands​

  -a, --api-uri string     api uri, default value read from config if set (default "http://localhost:8088")
  -c, --client string      client used for connecting to Testkube API one of proxy|direct|cluster (default "proxy")
      --insecure           insecure connection for direct client
      --namespace string   Kubernetes namespace, default value read from config if set (default "testkube")
      --oauth-enabled      enable oauth
      --verbose            show additional debug messages

SEE ALSO​