Skip to main content
Testkube 1.21 is out! A new Execution Dashboard, Webhook Credentials and Test/Suite Deprecation are some of the major enhancements, Read More

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-sidecar-scraper whether to run a scraper as a pod sidecar container
--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
--attach-debugger attach simple debugger for job, need KUBECONFIG for the agent to be active
--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
--debugger-file string store debug info into file, stdout by default
--disable-webhooks disable webhooks
-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 adds a label to execution in form of 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 is used to select tests to run using key value pair: --label key1=value1 or label expression
--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")
--go-template string go template to render (default "{{.}}")
--header stringToString headers for direct client key value pair: --header name=value (default [])
--insecure insecure connection for direct client
--namespace string Kubernetes namespace, default value read from config if set (default "testkube")
-o, --output string output type can be one of json|yaml|pretty|go (default "pretty")
--verbose show additional debug messages

SEE ALSO

  • testkube run - Runs tests, test suites, test workflows or test workflow executions