# Testkube Documentation > Testkube is the open testing platform for AI-driven engineering teams. It provides a single platform for creating, running and analyzing tests across any testing tool, any environment and any pipeline, with tests executed inside your own Kubernetes clusters. Key concepts for working with Testkube: - **Test Workflows** define how a test runs: the testing tool and its container image, the steps, the sources to check out, the artifacts to collect and the resources to use. They are written in YAML and work with any testing tool, such as k6, Playwright, Cypress, Postman or pytest. See [Test Workflows](https://docs.testkube.io/articles/test-workflows.md). - **The Control Plane** stores Testkube resources and execution results, and exposes the Testkube Dashboard. It runs either in the cloud, hosted by Testkube, or on-prem in your own infrastructure. See [Installation overview](https://docs.testkube.io/articles/install/overview.md). - **Testkube Runners** are deployed in your infrastructure to run tests, listen to Kubernetes events, sync resources and send webhooks. The Runner is open source and can also run standalone, without a Control Plane. See [Testkube Runners](https://docs.testkube.io/articles/agents-overview.md) and [Testkube Open Source](https://docs.testkube.io/articles/open-source.md). - **The Testkube CLI** (`testkube`) manages a Testkube installation and its resources, and runs Test Workflows. See [Installing the Testkube CLI](https://docs.testkube.io/articles/install/cli.md) and the [CLI Commands Reference](https://docs.testkube.io/cli/testkube.md). If you are an AI agent working with Testkube, two tools give you more than these pages do: - Connect to the [Testkube MCP Server](https://docs.testkube.io/articles/mcp-overview.md) to list, run and inspect Test Workflows, executions and artifacts directly. The Control Plane hosts an [MCP endpoint](https://docs.testkube.io/articles/mcp-hosted.md), and `testkube mcp serve` runs one locally. - Install the [Testkube Agent Skills](https://docs.testkube.io/articles/testkube-skills.md) for guidance on creating, running and debugging tests with Testkube. Some features are available only in Testkube Commercial. The [Feature Comparison](https://docs.testkube.io/articles/install/feature-comparison.md) lists the differences between Testkube Commercial and Testkube Open Source. Every page below is linked as Markdown. Each section ends with a link to one file that holds the full text of all its pages, for when you need a whole topic; [llms-full.txt](https://docs.testkube.io/llms-full.txt) lists those files with their sizes. ## Overview - [Welcome to the Testkube Documentation!](https://docs.testkube.io/index.md): Documentation for Testkube, the open testing platform for creating, running and analyzing tests with any tool, in any environment and pipeline. - [Testkube Open Source](https://docs.testkube.io/articles/open-source.md): What the open source Standalone Runner does without a Control Plane, with links to getting started, the feature comparison, migrating to Commercial and MIT/TCL licensing. - [Testkube Changelog](https://docs.testkube.io/changelog.md): Release notes for the Testkube Control Plane and Runner, with the newest release first. - [All "Overview" pages in one file](https://docs.testkube.io/llms-full/overview.txt): The full Markdown of the 3 pages listed in this section. ## Quickstart - [Getting Started with Testkube Open Source](https://docs.testkube.io/articles/getting-started-with-open-source.md): Install the Testkube CLI and the open source Standalone Runner, then create, run and watch a k6 Test Workflow and fetch its logs, artifacts and Execution Viewer link. - [All "Quickstart" pages in one file](https://docs.testkube.io/llms-full/quickstart.txt): The full Markdown of the 1 page listed in this section. ## Quickstart: Testkube Commercial - [Quickstart Overview](https://docs.testkube.io/articles/tutorial/quickstart/overview.md): Choose between the Individual Evaluation, Team Evaluation and Enterprise POC installation paths, get an evaluation license, or explore the Cloud trial without installing. - [Try Testkube on your machine](https://docs.testkube.io/articles/tutorial/quickstart/individual-evaluation.md): Install a Testkube On-Prem trial on macOS or Linux with one installer command and Docker, run a first Test Workflow, and check or remove the trial from the CLI. - [Troubleshoot the local trial](https://docs.testkube.io/articles/tutorial/quickstart/troubleshoot-local-trial.md): Fixes for each failed step of the local trial installer, covering Docker, CPU and memory, network, the kind cluster, Testkube services and the license, plus how to start over. - [Testkube Team Evaluation](https://docs.testkube.io/articles/tutorial/quickstart/team-evaluation.md): Install Testkube On-Prem with Helm or sign in to the Cloud Control Plane, run a sample k6 Test Workflow, inspect its execution, and trigger it from CI/CD, a schedule or a Kubernetes event. - [Testkube Enterprise Proof of Concept](https://docs.testkube.io/articles/tutorial/quickstart/enterprise-poc.md): How to plan and run a multi-sprint enterprise proof of concept of Testkube, from success criteria, stakeholders and capability checklists to phased execution and wrap-up. - [All "Quickstart: Testkube Commercial" pages in one file](https://docs.testkube.io/llms-full/quickstart-testkube-commercial.txt): The full Markdown of the 5 pages listed in this section. ## Installation - [Testkube Installation Overview](https://docs.testkube.io/articles/install/overview.md): Compare the On-Prem Control Plane, Cloud Control Plane and open source Standalone Runner deployment options, with the architecture of each and where to start installing. - [Installation FAQ](https://docs.testkube.io/articles/install/faq.md): Answers to installation questions about OpenShift, joining a Control Plane from OSS, required infrastructure, air-gapped environments, exposing Testkube and reaching the system under test. - [All "Installation" pages in one file](https://docs.testkube.io/llms-full/installation.txt): The full Markdown of the 2 pages listed in this section. ## Installation: Standalone Runner - [The Testkube Runner](https://docs.testkube.io/articles/install/standalone-agent.md): Install the open source Runner in Standalone Mode with the CLI or Helm, see its limitations, and configure storage, PostgreSQL, OpenShift, AWS or a Control Plane connection. - [Testkube Runner Feature Comparison](https://docs.testkube.io/articles/install/feature-comparison.md): Table of which features work with the Runner in Standalone Mode and which need a Control Plane, such as the Dashboard, SSO, RBAC, Insights, AI Agents and the MCP Server. - [Testkube Runner with local Kubernetes](https://docs.testkube.io/articles/install/quickstart-no-k8s.md): Create a local Kubernetes cluster with kind, minikube, k3s or Docker Desktop so you can install the Testkube Runner without access to a remote cluster. - [Migrating the Standalone Agent from MongoDB to PostgreSQL](https://docs.testkube.io/articles/install/mongo-to-postgres-migration.md): Move the Test Workflow execution history and numbering of a standalone agent from MongoDB to PostgreSQL with the convert job, with switchover steps, Helm values, flags and troubleshooting. - [Switching Between Testkube OSS and Pro Modes](https://docs.testkube.io/articles/install/oss-to-cloud.md): Use `testkube pro connect` to move a standalone OSS installation to the Control Plane with its execution history, and `testkube pro disconnect` to revert, with flags and error handling. - [All "Installation: Standalone Runner" pages in one file](https://docs.testkube.io/llms-full/installation-standalone-runner.txt): The full Markdown of the 5 pages listed in this section. ## Installation: On-Prem Control Plane - [Testkube Production Install with Helm](https://docs.testkube.io/articles/install/install-with-helm.md): Install Testkube On-Prem for production with Helm, covering resource requirements, license, domain exposure through Ingress or Gateway API, Dex auth, metrics and shared secrets. - [Customizing your Testkube On-Prem Installation](https://docs.testkube.io/articles/install/advanced-install.md): On-Prem Helm settings for the master password, artifact cleanup, TLS, organization bootstrap, custom ingress, namespaces, external PostgreSQL, NATS, MinIO or Dex, and offline licenses. - [Configuring SSO / Identity Providers](https://docs.testkube.io/articles/auth.md): Configure Dex in Testkube On-Prem to authenticate users with static users or an OIDC identity provider such as Google, Okta or Azure AD. - [Installation with S3 Storage and IAM Authentication](https://docs.testkube.io/articles/install/s3-storage.md): Configure the On-Prem Control Plane to store artifacts in AWS S3 with IAM role authentication, including the IAM policy, trust relationship, Helm values and bucket CORS. - [Using Istio](https://docs.testkube.io/articles/istio.md): Testkube compatibility with Istio, and the Helm values needed without native sidecars, such as disabling sidecar injection for executions and holding pods until the proxy is ready. - [Installation Using Vault](https://docs.testkube.io/articles/vault-install.md): Inject the Dex config, MinIO credentials, license key and private CA certificate into the Control Plane and Runner with the HashiCorp Vault sidecar injector, with Istio troubleshooting. - [Using a private certificate authority (CA)](https://docs.testkube.io/articles/private-ca.md): Make the Control Plane, Runner, Test Workflows, Git checkouts and Connected MCP Servers trust certificates signed by a private certificate authority through a CA bundle secret. - [MongoDB administration](https://docs.testkube.io/articles/mongodb-administration.md): Connect a legacy MongoDB-based Testkube deployment to an external MongoDB instance, configure SSL connections and purge old data with TTL indexes. - [Offline Usage Export](https://docs.testkube.io/articles/usage-export-job.md): Generate an encrypted usage report for license reporting from an on-prem Control Plane with `testkube pro export usage` or Helm, with flags, values and troubleshooting. - [High Availability Configuration](https://docs.testkube.io/articles/ha.md): Configure replicas, topology spread constraints, priority classes and dedicated nodes for a highly available Control Plane and Runner, with example Helm values and caveats. - [Pod Security Standards](https://docs.testkube.io/articles/pod-security-standards.md): Bring the Control Plane and Runner into compliance with the Kubernetes restricted Pod Security Standard by fixing NATS volume ownership and setting non-root security contexts. - [Deploying on OpenShift](https://docs.testkube.io/articles/deploying-on-openshift.md): Expose the On-Prem Control Plane on OpenShift with Routes and custom certificates, and let OpenShift assign `fsGroup` for Test Workflow pods. - [Deploying on AWS EKS](https://docs.testkube.io/articles/install/deploy-on-aws-eks.md): Deploy Testkube On-Prem on Amazon EKS with S3 storage through EKS Pod Identity or IRSA, RDS or Aurora PostgreSQL, Nginx or ALB ingress, production hardening and troubleshooting. - [Repackaging Testkube for Different Distributions](https://docs.testkube.io/articles/repackaging-testkube.md): Example Dockerfiles for rebuilding Testkube images on other base images such as Red Hat UBI, which Testkube does not officially support, with links to the source Dockerfiles. - [Using Global Parameters in Testkube Helm Charts](https://docs.testkube.io/articles/global-parameters-in-testkube-helm-charts.md): Set global Helm values such as `imageRegistry`, `imagePullSecrets`, labels and security contexts across the Control Plane and Runner charts, and see how they override per-service values. - [Air-Gapped and Offline Installation](https://docs.testkube.io/articles/install/air-gapped.md): Install the On-Prem Control Plane and Runners in a fully disconnected network by mirroring every image to an internal registry, overriding the registry in Helm and using an offline license. - [Image Inventory](https://docs.testkube.io/articles/inventory/images.md): List of the container images used by the Runner and Control Plane Helm charts in on-premise installations, with vulnerability reports, to mirror for air-gapped installs. - [Distributed Tracing (OpenTelemetry)](https://docs.testkube.io/articles/tracing.md): Export OpenTelemetry traces from the On-Prem Control Plane and the Runner over OTLP HTTP by setting environment variables for the endpoint, service name and sample rate. - [Mongo to Postgres Migration](https://docs.testkube.io/articles/convert.md): Migrate on-prem Control Plane data from MongoDB to PostgreSQL with the convert utility, run through Docker or a Helm job, with settings, migrated collections, examples and limitations. - [All "Installation: On-Prem Control Plane" pages in one file](https://docs.testkube.io/llms-full/installation-on-prem-control-plane.txt): The full Markdown of the 19 pages listed in this section. ## Installation: Cloud Control Plane - [Testkube Cloud Control Plane](https://docs.testkube.io/articles/install/cloud-overview.md): How the Cloud Control Plane hosted by Testkube works with Runners in your infrastructure, how to get started, and which egress and ingress traffic to allow. - [Custom SSO](https://docs.testkube.io/articles/custom-sso.md): Login options for the Cloud Control Plane and how to set up IdP-initiated login from Okta with an OIDC application. - [All "Installation: Cloud Control Plane" pages in one file](https://docs.testkube.io/llms-full/installation-cloud-control-plane.txt): The full Markdown of the 2 pages listed in this section. ## Installation: Upgrade & Uninstall - [Upgrade & Uninstall](https://docs.testkube.io/articles/upgrade-uninstall.md): Upgrade Testkube with Helm or `testkube upgrade` and uninstall it with `testkube purge` or `helm uninstall`, for both Open Source and Commercial installations. - [Testkube Enterprise Post-Upgrade Runbook](https://docs.testkube.io/articles/post-upgrade-runbook.md): Checklist to validate an on-premises Testkube Enterprise upgrade, covering workloads, migrations, license, SSO, storage, execution, ingress, Runners, integrations and rollback readiness. - [All "Installation: Upgrade & Uninstall" pages in one file](https://docs.testkube.io/llms-full/installation-upgrade-and-uninstall.txt): The full Markdown of the 2 pages listed in this section. ## Core Concepts - [Testkube in the STLC](https://docs.testkube.io/articles/testing-pipeline.md): Where Testkube fits in the software testing lifecycle (STLC), with the five steps of test execution it handles (define, trigger, scale, troubleshoot, analyze) and who is involved in each. - [Defining Tests](https://docs.testkube.io/articles/defining-tests.md): How Testkube defines test executions with Test Workflows and Workflow Templates, covering test retrieval, parameters, result collection, orchestration and labeling. - [Triggering Tests](https://docs.testkube.io/articles/triggering-tests.md): Overview of the ways to trigger tests in Testkube, from CI/CD integrations, Kubernetes and Git event Triggers and schedules to the CLI, Dashboard, REST API and Execution CRDs. - [Running and Scaling Tests](https://docs.testkube.io/articles/running-scaling-tests.md): How Testkube runs and scales tests on Kubernetes, covering parallelization, sharding, pod affinity and topology spread, plus resource collision and security considerations. - [Troubleshooting Tests](https://docs.testkube.io/articles/troubleshooting-tests.md): How Testkube helps troubleshoot failed tests by collecting logs, artifacts and JUnit reports, with log highlighting, log comparison and AI Insights in the Dashboard. - [Analyzing Results](https://docs.testkube.io/articles/analyzing-results.md): Tactical versus strategic test reporting, and how the Test Insights module in Testkube answers questions about test duration, resource use, pass/fail trends and flakiness. - [All "Core Concepts" pages in one file](https://docs.testkube.io/llms-full/core-concepts.txt): The full Markdown of the 6 pages listed in this section. ## Using Testkube - [Using Testkube](https://docs.testkube.io/articles/using-testkube.md): Entry point to the usage docs, linking to Environments, the Dashboard, Test Workflows, triggering, results, administration, the CLI, Testkube AI and best practices. - [All "Using Testkube" pages in one file](https://docs.testkube.io/llms-full/using-testkube.txt): The full Markdown of the 1 page listed in this section. ## Using Testkube: Test Workflows - [Test Workflows](https://docs.testkube.io/articles/test-workflows.md): Overview of the Test Workflow YAML structure, from content sources, container settings and steps to artifacts, cron schedules, tags, Runner targets and templates. - [Workflows Walkthrough](https://docs.testkube.io/articles/testworkflows-showcase.md): Interactive walkthrough of Test Workflow concepts, from a simple Workflow to parallel cross-browser runs, Services, TestTriggers, Webhooks and AI failure triage. - [Test Workflows Examples - Basics](https://docs.testkube.io/articles/test-workflows-examples-basics.md): Short Test Workflow examples for running images and shell commands, fetching Git content, nested and conditional steps, retries, timeouts, artifacts and Job or Pod settings. - [Running Test Workflows](https://docs.testkube.io/articles/test-workflows-running.md): Run Test Workflows on specific Runners using Independent, Grouped and Global runner modes, labels, the target property and replication, and run Silent Executions. - [Test Workflows CLI Commands](https://docs.testkube.io/articles/test-workflows-creating.md): Create, get, run, rerun, check the status of and delete Test Workflows with the Testkube CLI, including label filtering and the `tw` alias. - [Test Workflows - Content](https://docs.testkube.io/articles/test-workflows-content.md): Provide test files to a Test Workflow from Git repositories (token, GitHub App or SSH auth), static files, Secrets, config maps, tarballs, OCI artifacts, object storage and shared volumes. - [Finding Your Git Provider Token](https://docs.testkube.io/articles/git-provider-tokens.md): Create a read-only personal access or API token in GitHub, GitLab or Bitbucket for cloning test code in a Test Workflow. - [Sharing Data Between Steps](https://docs.testkube.io/articles/test-workflows-step-sharing.md): Pass data between steps of one Test Workflow with output values in `/testkube/outputs` and step results directories, and read an earlier step's status and exit code. - [Sharing Data Between Executions](https://docs.testkube.io/articles/test-workflows-execution-sharing.md): Pass data between Test Workflow executions run with execute, using output values read with execution(), artifact contents with read_artifact() and fetch blocks (not in Standalone Mode). - [Rerunning Failed Tests](https://docs.testkube.io/articles/test-workflows-rerun.md): Rerun a Test Workflow execution and narrow it to the test cases that failed, using execution lineage, the rerun reference and a failure record kept as an output or artifact (not in Standalone Mode). - [Test Workflows Artifacts](https://docs.testkube.io/articles/test-workflows-artifacts.md): Collect files from Test Workflow steps with the artifacts property, compress them, gather them from parallel steps, and see which JUnit, performance and Influx reports Testkube extracts. - [Dependency Caching](https://docs.testkube.io/articles/test-workflows-dependency-cache.md): Cache dependency directories between Test Workflow executions with a step cache block, covering keys and restore keys, scope, pull request isolation, performance, expiration settings and limits. - [Test Workflows – Expressions](https://docs.testkube.io/articles/test-workflows-expressions.md): Reference for the Test Workflow expression language, with its operators, built-in variables such as config, execution and step, and functions for casting, JSON, shell quoting, files and execution data. - [Test Workflows Parameterization](https://docs.testkube.io/articles/test-workflows-examples-configuration.md): Parameterize Test Workflows with config parameters and environment variables, source values from config maps, Secrets and Credentials, and set them from the Dashboard, the CLI or an execute step. - [Test Workflows - Services](https://docs.testkube.io/articles/test-workflows-services.md): Run databases, workers or the system under test as Test Workflow services, with readiness probes, logs, file transfer and JMeter, Selenium and MongoDB examples (not in Standalone Mode). - [Test Workflows - Parallel Steps](https://docs.testkube.io/articles/test-workflows-parallel.md): Spread a Test Workflow step across pods with `parallel`, using `failFast`, `transfer`, `fetch` and `paused`, with sharded Playwright and Cypress and distributed k6 examples (not in Standalone Mode). - [Test Workflows - Matrix and Sharding](https://docs.testkube.io/articles/test-workflows-matrix-and-sharding.md): Run services, execute and parallel steps for every matrix combination or split data across shards with `matrix`, `shards`, `count` and `maxCount`, including dynamic sharding (not in Standalone Mode). - [Workflow Concurrency & Queueing](https://docs.testkube.io/articles/test-workflows-concurrency-queueing.md): Limit concurrent executions of a Test Workflow or a group of them with spec.concurrency, and how the Runner concurrency limit, Environment queue limit and execution timeouts apply (not in Standalone Mode). - [Test Workflow Timeouts](https://docs.testkube.io/articles/test-workflows-timeouts.md): Reference for Test Workflow timeouts, covering the queue and initialization timeouts under spec.timeouts, step timeouts, Job activeDeadlineSeconds and system safeguards, and when to use each. - [Failure Reasons](https://docs.testkube.io/articles/test-workflows-failure-reasons.md): Reference for the messages, reason codes and status details types Testkube records when an execution does not pass, and how to filter lists and call webhooks by failure type. - [Test Workflows - Job and Pod Configuration](https://docs.testkube.io/articles/test-workflows-job-and-pod.md): Configure the Kubernetes Job and Pod of a Test Workflow, including labels, namespace, `activeDeadlineSeconds`, security context and `fsGroup` defaulting, service account, affinity and volumes. - [Execution Tags](https://docs.testkube.io/articles/execution-tags.md): Tag Test Workflow executions in the Workflow definition, CLI, TestTriggers or REST API, edit tags after a run, and filter executions by service, Git branch or failure category. - [Advanced Workflow Orchestration](https://docs.testkube.io/articles/test-workflows-test-suites.md): Orchestrate other Test Workflows from a Workflow with execute, covering parallelism, label selectors, Runner targets, branching on results, nesting and passing config or files (not in Standalone Mode). - [Migrating Tests, Test Suites and Executors to Test Workflows and Test Workflow Templates](https://docs.testkube.io/articles/test-workflow-migration.md): Generate Test Workflows and Test Workflow Templates from legacy Tests, Test Suites and Executors with the `testkube migrate` command, with before and after examples. - [Test Workflow Templates](https://docs.testkube.io/articles/test-workflow-templates.md): Define reusable Test Workflow Templates and apply them with use or template, with details on inlining, isolation and ordering, global templates and the official templates. - [Test Workflows - High-Level Architecture](https://docs.testkube.io/articles/test-workflows-high-level-architecture.md): How Testkube turns a Test Workflow into Kubernetes Jobs and Pods, covering container merging, pure steps, the init process, image metadata from private registries and deleting a Workflow mid-run. - [Viewing Open Source Executions](https://docs.testkube.io/articles/viewing-oss-executions.md): View an Open Source Workflow execution's steps, logs, artifacts and JUnit reports in a hosted read-only viewer with the `testkube view` command, including its flags, limits and privacy. - [Test Workflow Best Practices](https://docs.testkube.io/articles/test-workflows-best-practices.md): Recommendations for authoring Test Workflows, covering images, resources, artifacts, timeouts, error handling, scheduling, security and tool-specific tips for k6, Playwright, Cypress, JMeter and others. - [Test Workflows Using Vault](https://docs.testkube.io/articles/vault.md): Inject HashiCorp Vault secrets into Test Workflow pods with the Vault sidecar injector and a reusable Test Workflow Template, with fixes for port conflicts and Istio. - [Capturing Logs from your Application](https://docs.testkube.io/articles/tw-capture-logs.md): Collect logs from the pods of the application under test in a Test Workflow with kubectl logs, packaged as a reusable Test Workflow Template that takes a label selector. - [Remote Workflow Execution](https://docs.testkube.io/articles/remote-workflow-execution.md): Trigger a Workflow in another Environment from a Test Workflow with the Testkube CLI, collect its logs and artifacts, and coordinate executions across Environments with execute. - [Custom Artifact Upload](https://docs.testkube.io/articles/custom-minio-artifact-upload.md): Example Test Workflow step that copies artifacts to your own S3 or MinIO bucket with the `mc` client, retrying on failure and running even when earlier steps fail. - [Enforce Policies to Standardize Test Workflows](https://docs.testkube.io/articles/enforcing-workflow-policies.md): Enforce standards on Test Workflows with Kyverno admission policies, with a validate policy that flags latest image tags and a mutate policy that adds labels. - [Looping Test Workflow Executions from Workflows](https://docs.testkube.io/articles/loop-execution-workflows.md): Example Test Workflow that uses a service running the Testkube CLI in a loop to trigger another Workflow repeatedly as Silent Executions until it ends. - [Creating your own Workflow Templates](https://docs.testkube.io/articles/examples/create-your-own-examples.md): Publish your own Test Workflow Templates to the Dashboard wizard using the required labels and annotations, applied with kubectl or packaged in a Helm chart. - [All "Using Testkube: Test Workflows" pages in one file](https://docs.testkube.io/llms-full/using-testkube-test-workflows.txt): The full Markdown of the 35 pages listed in this section. ## Using Testkube: Triggering Test Workflows - [Triggering Test Workflows](https://docs.testkube.io/articles/triggering-overview.md): List of the ways to trigger a Test Workflow, from the Dashboard, CI/CD, schedules, Kubernetes and Git events, Execution CRDs, the CLI, the REST API or another Workflow, with links to each. - [Using Testkube from CI/CD](https://docs.testkube.io/articles/cicd-overview.md): Trigger Test Workflows from CI/CD with the native Jenkins, GitHub and Azure DevOps integrations or the Testkube CLI Docker image, with links to tutorials for each CI/CD tool. - [Kubernetes Event Triggers](https://docs.testkube.io/articles/test-triggers.md): Run Test Workflows on Kubernetes events with TestTriggers, covering listeners, selectors, custom resources, events, match conditions, resource conditions and probes, Runner targets and action parameters. - [Scheduling Workflows](https://docs.testkube.io/articles/scheduling-tests.md): Schedule Test Workflows with cron expressions in spec.events.cronjob or from the Dashboard, skip schedules without a matching Runner, and how scheduling works in connected and standalone mode. - [Testkube Execution CRDs](https://docs.testkube.io/articles/test-executions.md): Trigger a Test Workflow by creating a TestWorkflowExecution custom resource, with config parameters, execution tags and a Runner target. - [Git Event Triggers](https://docs.testkube.io/articles/git-triggers.md): Run Test Workflows when a Git repository changes using TestTriggers with git-push, git-tag-push and git-pull-request events, branch, tag and path filters, and the exported Git variables. - [HTTP Event Triggers](https://docs.testkube.io/articles/http-triggers.md): Configure a TestTrigger that polls an HTTP endpoint and runs a Test Workflow when a JSON field, response header or the body hash changes, with examples and field defaults. - [All "Using Testkube: Triggering Test Workflows" pages in one file](https://docs.testkube.io/llms-full/using-testkube-triggering-test-workflows.txt): The full Markdown of the 7 pages listed in this section. ## Using Testkube: Testkube CLI - [Testkube CLI](https://docs.testkube.io/articles/cli.md): Entry point to the Testkube CLI documentation, linking to installation, CLI context management, the Docker CLI image, Runner commands and the command reference. - [Installing the Testkube CLI](https://docs.testkube.io/articles/install/cli.md): Install the Testkube CLI with Homebrew, Chocolatey, apt, the install script or a manual download, then check the client and server versions with `testkube version`. - [Managing CLI Context](https://docs.testkube.io/articles/managing-cli-context.md): Connect the Testkube CLI to a Standalone Runner with `testkube set context`, or to a Control Plane with `testkube login`, including self-hosted instances, SSO and API Tokens. - [Testkube Docker CLI](https://docs.testkube.io/articles/testkube-cli-docker.md): Pull or build the `kubeshop/testkube-cli` Docker image and run Testkube CLI commands from a container, choosing a client type and mounting an existing configuration. - [All "Using Testkube: Testkube CLI" pages in one file](https://docs.testkube.io/llms-full/using-testkube-testkube-cli.txt): The full Markdown of the 4 pages listed in this section. ## Using Testkube: Testkube Dashboard - [Testkube Dashboard](https://docs.testkube.io/articles/testkube-dashboard-explore.md): Tour of the Testkube Dashboard home page, covering the Organization and Environment selectors, the left navigation pane, Workflow Insights and Recent Executions. - [Workflows Overview](https://docs.testkube.io/articles/testkube-dashboard-workflows-overview.md): How the Workflows Overview in the Dashboard lists the Workflows in an Environment, with Grid and Table views, search, filters and saved Custom Views. - [Workflow Wizard](https://docs.testkube.io/articles/test-workflows-create-wizard.md): Create a Test Workflow in the Dashboard with the five-step Wizard and automatic test discovery, from an example, by combining existing Workflows, from the Marketplace or from YAML. - [Workflow Details](https://docs.testkube.io/articles/testkube-dashboard-workflow-details.md): Run, monitor and configure a Workflow in the Dashboard through its Overview, Executions, CLI Commands, CI/CD Integration and Settings tabs, including scheduling and silent executions. - [Workflow YAML Editor](https://docs.testkube.io/articles/testkube-dashboard-workflow-editor.md): Features of the Dashboard YAML editor for Workflows, from toolbar actions and the inline-templates diff view to autocomplete, documentation hovers, error markers and template links. - [Workflow Execution Details](https://docs.testkube.io/articles/testkube-dashboard-execution-details.md): Inspect a Workflow execution in the Dashboard through its Log Output, Artifacts, Resource Usage, Flowchart, CLI Commands, Events and Workflow Definition tabs, and search or compare logs. - [Workflow Templates](https://docs.testkube.io/articles/testkube-dashboard-workflows-templates.md): View, edit and create Workflow Templates in the Dashboard, including template settings and the Git Content, Static Content, Testing Tool and Import from YAML options. - [Testkube Executions](https://docs.testkube.io/articles/testkube-dashboard-executions.md): How the Executions page of the Dashboard lists every Execution in an Environment, with filters, Live data, Workflow health, status icons and a Timeline view with resource usage. - [Integrations Overview](https://docs.testkube.io/articles/integrations-dashboard-explore.md): Tour of the Integrations section of the Dashboard and its Kubernetes Event Triggers, Webhooks, CI/CD Tools and Integration Examples tabs. - [Kubernetes Triggers](https://docs.testkube.io/articles/integrations-triggers.md): Create and manage Kubernetes Triggers in the Dashboard, from the trigger condition and action wizard to the Settings, Resource Group and YAML Definition tabs. - [Integrations Webhooks](https://docs.testkube.io/articles/integrations-webhooks.md): Create and manage Webhooks in the Dashboard, setting the condition, target URI, custom payload and headers, Resource Group and YAML Definition, and injecting Credentials. - [Centralized GitHub App](https://docs.testkube.io/articles/github-app-auth.md): Connect GitHub organizations to a Testkube Organization through the shared Testkube GitHub App so Test Workflows clone private repositories with short-lived tokens, plus self-hosted setup and IP allow lists. - [Custom Views](https://docs.testkube.io/articles/testkube-dashboard-custom-views.md): Save search and filter criteria as private or shared Custom Views in the Workflow Catalog and the Executions dashboard. - [Global Settings](https://docs.testkube.io/articles/settings-dashboard-explore.md): Where to find the Organization and Environment settings in the Dashboard, and which roles are allowed to change each. - [All "Using Testkube: Testkube Dashboard" pages in one file](https://docs.testkube.io/llms-full/using-testkube-testkube-dashboard.txt): The full Markdown of the 14 pages listed in this section. ## Using Testkube: Testkube Environments - [Environment Management](https://docs.testkube.io/articles/environment-management.md): Create a Testkube Environment and manage its settings, including Runners and registration token rotation, Members and roles, keyword handling, queueing and concurrency limits, and the MCP Server. - [Testkube Runners](https://docs.testkube.io/articles/agents-overview.md): How Testkube Runners work, covering the execution, listener, GitOps and webhooks capabilities, adding and managing Runners, labels and modes, key rotation, and Fixed and Floating licenses. - [Installing Testkube Runner with Helm Charts](https://docs.testkube.io/articles/multi-agent-runner-helm-chart.md): Install a Runner with the `testkube-runner` Helm Chart, including self-registering Runners, labels and runner mode, execution namespaces, ServiceAccounts, Global Templates and listener namespaces. - [Running Test Workflows in a sandboxed container runtime](https://docs.testkube.io/articles/test-workflows-sandboxed-runtime.md): Run Test Workflow pods under gVisor by assigning the runtime class with cluster admission policies and running executions in a sandbox namespace. - [Testkube Runner CLI Commands](https://docs.testkube.io/articles/multi-agent-cli.md): Use Testkube CLI commands to create, install, update, list, disable, delete and uninstall Runners, rotate their secret keys, assign Floating licenses and update labels. - [All "Using Testkube: Testkube Environments" pages in one file](https://docs.testkube.io/llms-full/using-testkube-testkube-environments.txt): The full Markdown of the 5 pages listed in this section. ## Using Testkube: Working with Results - [Working with Results](https://docs.testkube.io/articles/results-overview.md): Index of the Testkube features for working with results, from Workflow Health, logs, artifacts and JUnit reports to Insights metrics and Status Pages. - [Workflow Health & Flakiness](https://docs.testkube.io/articles/workflow-health.md): How Testkube calculates Workflow Health from the pass rate and flip rate of the last 10 runs, what flakiness means, and how the score maps to sunny, cloudy and stormy statuses. - [Logs & Artifacts](https://docs.testkube.io/articles/logs-and-artifacts.md): How Testkube collects logs per container and uploaded artifacts for a Workflow execution, and how to view them, compare logs between steps and retrieve them with the CLI. - [Log Highlighting](https://docs.testkube.io/articles/log-highlighting.md): Use keyword highlighting in execution logs to jump between relevant lines, choose the active highlight categories and add custom keyword categories. - [JUnit Processing and Visualization](https://docs.testkube.io/articles/test-workflows-reports.md): How Testkube extracts JUnit XML reports from artifacts and shows them in the execution Overview, Reports tab and Insights, with commands to produce reports from Playwright, Cypress, Pytest, Go and other tools. - [Resource Metrics](https://docs.testkube.io/articles/resource-metrics.md): CPU, memory, network and disk metrics Testkube collects for each Workflow execution, how to read the Resource Usage charts for multi-step and parallel runs, and the aggregates available in Insights. - [AI Analysis for Failed Workflows](https://docs.testkube.io/articles/AI-test-insights.md): Analyze a failed or aborted Workflow Execution with the AI Assistant, using the AI Analyze button in the Dashboard or a prompt in a chat. - [Test Insights](https://docs.testkube.io/articles/test-insights.md): Analyze execution results in Insights with boards and analyses, covering granular metrics, time series measures, aggregates, segments, chart types, drilling into executions, and efficiency and pass/fail charts. - [Functional Metrics in Insights](https://docs.testkube.io/articles/functional-metrics-in-insights.md): The six JUnit test case and test suite metric series ingested into Insights, such as `test_count_failed` and `test_duration_ms`, with example pass/fail, failure and duration charts. - [Performance Metrics](https://docs.testkube.io/articles/performance-metrics-in-insights.md): Export k6, Artillery and JMeter reports as artifacts so Testkube ingests them as granular metrics in Insights, with metric key mappings, segmentation, canonical cross-tool metrics and troubleshooting. - [Resource Metrics in Insights](https://docs.testkube.io/articles/resource-metrics-in-insights.md): Reference for the CPU, memory, network and disk usage metrics and the min, max, average and sum aggregates you can chart across executions in Insights. - [Custom Metrics with Influx Line Protocol](https://docs.testkube.io/articles/custom-metrics-in-insights.md): Capture custom metrics from any Workflow step by writing InfluxDB Line Protocol to a .lp or .influx artifact, with the line format, supported field types, metric keys and troubleshooting. - [Status Pages](https://docs.testkube.io/articles/status-pages.md): Create a Status Page for an Environment by grouping scheduled tests into services, and understand service statuses, operability, incidents and their severity levels, and public or private visibility. - [All "Using Testkube: Working with Results" pages in one file](https://docs.testkube.io/llms-full/using-testkube-working-with-results.txt): The full Markdown of the 13 pages listed in this section. ## Using Testkube: Administration - [Testkube Administration](https://docs.testkube.io/articles/administration-overview.md): Entry point to Testkube administration topics, linking to Organizations, Environments, Runners, Members, Teams, Resource Groups, access management, API Tokens, Audit Logs and Credentials. - [Organization Management](https://docs.testkube.io/articles/organization-management.md): Tour of the Organization Management panels, covering Environments, Members, Teams, Resource Groups, API Tokens, Product Features, Usage and Billing, Settings and the Audit Log. - [Member Management](https://docs.testkube.io/articles/member-management.md): Invite and manage Organization members, covering full and read-only seats, roles, invitations, bulk actions, display names, the Org-wide Read role for API tokens and the read-only cap. - [Testkube Teams](https://docs.testkube.io/articles/teams.md): Create Teams of Organization members, edit Team settings and add or remove Team Members, so a Team can be given a Role in Environments or Resource Groups. - [Resource Groups](https://docs.testkube.io/articles/resource-groups.md): Group Workflows, Workflow Templates, Triggers and Webhooks across Environments into Resource Groups, and assign Members or Teams a Role as collaborators. - [Resource Access Management](https://docs.testkube.io/articles/resource-access-management.md): How Testkube resolves access to Resources from Organization, Environment and Resource Group roles, including which role wins when they overlap, with recommendations. - [API Token Management](https://docs.testkube.io/articles/api-token-management.md): Create API Tokens for machine-to-machine access from CI pipelines and services, and choose between admin and member roles with Read, Run or Write permissions per Environment. - [Testkube Audit Logs](https://docs.testkube.io/articles/audit-logs.md): View, filter and export the Organization Audit Log, see how AI and MCP tool calls are recorded, and set retention and console logging for Testkube On-Prem. - [Testkube Credentials](https://docs.testkube.io/articles/credential-management.md): Store Secret, Variable and Vault credentials at Organization, Environment, Resource Group or Workflow scope, use them with credential(), and set up the on-prem Vault backend. - [All "Using Testkube: Administration" pages in one file](https://docs.testkube.io/llms-full/using-testkube-administration.txt): The full Markdown of the 9 pages listed in this section. ## Using Testkube: Testkube AI - [Testkube AI Overview](https://docs.testkube.io/articles/testkube-ai-overview.md): Map of Testkube AI features, covering the AI Assistant, default and custom AI Agents, AI Agent Triggers, AI Models, the Testkube MCP Server and Agent Skills, with links to each. - [AI usage, seats, and limits](https://docs.testkube.io/articles/ai-usage.md): Where to find AI usage, what a test creation seat allows, what an AI session and an MCP call count as, and how many AI tokens are used. - [Testkube AI Configuration Quick Start](https://docs.testkube.io/articles/ai-enabling.md): Enable the AI Assistant in Testkube Cloud, or deploy the AI service on-prem with the minimal Helm values for PostgreSQL, the LLM API key and a custom LLM endpoint. - [AI Governance](https://docs.testkube.io/articles/ai-governance.md): Control how AI is used in your Organization, from who can use each AI Agent and model to token limits, pauses, tracing and the MCP Audit log. - [AI Agent access](https://docs.testkube.io/articles/ai-agent-access.md): Choose who can use an AI Agent and see its chats, by role, Resource Group, or only its creator, and review access across an Environment. - [Model access](https://docs.testkube.io/articles/ai-model-access.md): Limit which AI models Members and AI Agents can use, and review the models of an Environment. - [AI token limits and pauses](https://docs.testkube.io/articles/ai-token-limits.md): Cap how many AI tokens a Member, an AI Agent, an Environment or the Organization can use, pause AI at any of those levels, and see what people get when a limit is reached. - [AI tracing](https://docs.testkube.io/articles/ai-tracing.md): Send OpenTelemetry traces of your organization's AI work to AWS CloudWatch or any OTLP endpoint. - [Create your first test with AI](https://docs.testkube.io/articles/ai-test-creation-getting-started.md): Describe a test in the Test Catalog, follow the AI in chat, review the generated files and execution results, and add another test case, using a Playwright TodoMVC example. - [Work with a GitHub repository](https://docs.testkube.io/articles/ai-test-creation-github.md): Import a GitHub repository into an AI Test Creation Test Bundle, ask the AI for a focused test change, review the diff and run it, then push to a branch and open a pull request. - [Work with a GitLab repository](https://docs.testkube.io/articles/ai-test-creation-gitlab.md): Connect GitLab to AI Test Creation with OAuth or an access token, enable repositories, import one into a Test Bundle, push changes for a merge request, and manage the connection. - [Work with Test Bundles and multiple chats](https://docs.testkube.io/articles/ai-test-creation-test-bundles.md): Organize AI Test Creation work in a Test Bundle by starting and switching between chats, sharing guidance through Attached Context, and knowing what the bundle and each chat own. - [AI Test Creation](https://docs.testkube.io/articles/ai-test-creation.md): How AI Test Creation sessions run in isolated Sandboxes, and how to install and secure it on Testkube On-Prem with Helm, covering models, PostgreSQL, network egress, keys and image registries. - [AI Assistant](https://docs.testkube.io/articles/ai-assistant-overview.md): Open the AI Assistant from the Dashboard in overlay or docked mode, switch between chats, and select the AI Agent and model for a conversation. - [Testkube AI Agents](https://docs.testkube.io/articles/ai-agents.md): Concepts behind AI Agents, including the four default agents, the Dashboard agent templates, task-focused versus guidance agents, and example use cases for QA and DevOps teams. - [AI Agent Chats](https://docs.testkube.io/articles/using-ai-agents.md): Review and filter AI Agent Chats, inspect MCP tool calls, approve tool requests, send follow-up prompts, and start a chat from the Chats panel, an AI Agent or the AI Analyze button. - [Managing Testkube AI Agents](https://docs.testkube.io/articles/defining-ai-agents.md): Create an AI Agent from scratch or from a template, write its instructions, limit who can use it, and choose which MCP Server tools it can call with or without approval. - [Connected MCP Servers for AI Agents](https://docs.testkube.io/articles/mcp-servers-for-ai-agents.md): Connect external MCP Servers for AI Agents from the registry or by URL, choose shared-key or per-person OAuth sign-in, and set up OAuth clients and trusted hosts. - [Configuring AI Models](https://docs.testkube.io/articles/ai-models.md): Add custom OpenAI, Anthropic or OpenAI-compatible models in the Models tab alongside read-only platform models, set extra headers and query parameters, and pick a model per AI Chat. - [AI Agent Triggers](https://docs.testkube.io/articles/ai-triggers.md): Run AI Agents automatically when Test Workflow executions finish, with event, label selector, trigger mode and prompt template settings, plus a cron scheduler workflow pattern. - [AI Agent Examples Overview](https://docs.testkube.io/articles/ai-agent-examples-overview.md): Index of example AI Agent configurations for QA, DevOps and cross-functional use, with a table of which external MCP Servers add what to each agent. - [Testkube Remediation Agent](https://docs.testkube.io/articles/remediation-agent.md): Example AI Agent that investigates a failed execution, inspects recent commits through the GitHub MCP Server and opens a pull request with a suggested fix, with its prompt and tool list. - [Testkube Flakiness Analysis Agent](https://docs.testkube.io/articles/flakiness-analysis-agent.md): Example AI Agent that aggregates failing tests across a Workflow's recent executions to detect flakiness and checks test source changes through the GitHub MCP Server, with its prompt and tools. - [Testkube Dependency Impact Analyzer Agent](https://docs.testkube.io/articles/dependency-impact-agent.md): Example AI Agent that maps the blast radius of a failed Test Workflow by finding other workflows that share its container images, git repositories or target services, with prompt and tools. - [Testkube Infrastructure Triage Agent](https://docs.testkube.io/articles/infrastructure-triage-agent.md): Example AI Agent that classifies failed executions as infrastructure issues (OOM, timeout, network, eviction) or real test failures and tags them, with its prompt, tools and trigger setup. - [Testkube Incident Correlator Agent](https://docs.testkube.io/articles/incident-correlator-agent.md): Example AI Agent that groups Test Workflow failures from the same time window, decides whether they share a systemic root cause and tags them with an incident ID, with prompt, tools and trigger. - [Testkube Execution Cost Analyzer Agent](https://docs.testkube.io/articles/execution-cost-agent.md): Example AI Agent that ranks Test Workflows by execution time and resource use and recommends savings such as fewer runs, right-sized resources and parallelization, with its prompt and tools. - [Testkube Onboarding Guide Agent](https://docs.testkube.io/articles/onboarding-guide-agent.md): Example read-only AI Agent that explains an Environment's Test Workflows, labels, Resource Groups and runners to new team members and links to the Dashboard, with its prompt and tools. - [Testkube Security & Compliance Reviewer Agent](https://docs.testkube.io/articles/security-compliance-agent.md): Example AI Agent that audits Test Workflow definitions for unpinned images, secrets written into definitions and missing resource limits or timeouts, then reports a compliance score, with its prompt and tools. - [More AI Agent Ideas](https://docs.testkube.io/articles/ai-agent-ideas.md): Sample prompts and tool lists for more AI Agents, such as a performance regression detector, resource right-sizer, health auditor and capacity planner, plus ideas built on external MCP Servers. - [Testkube MCP Server](https://docs.testkube.io/articles/mcp-overview.md): What the Testkube MCP Server lets AI tools do, the hosted, CLI and Docker setup options, and the full list of MCP tools for workflows, executions, artifacts, queries and Insights boards. - [Testkube Control Plane MCP Endpoint](https://docs.testkube.io/articles/mcp-hosted.md): Connect AI tools to the Control Plane MCP endpoint with OAuth or an API token, find the endpoint URL, and enable the endpoint for self-hosted installations through Helm and Dex. - [Testkube MCP Server with CLI](https://docs.testkube.io/articles/mcp-cli.md): Run the Testkube MCP Server locally with `testkube mcp serve`, authenticate by login or API key, and choose between stdio and shttp transports, with environment variable mode and troubleshooting. - [Testkube MCP Server with Docker](https://docs.testkube.io/articles/mcp-docker.md): Run the Testkube MCP Server from the `kubeshop/testkube-mcp-server` Docker image with an API token, and configure VS Code, Cursor, Claude Desktop and Claude Code to use it over stdio or shttp. - [Testkube MCP Server Configuration Examples](https://docs.testkube.io/articles/mcp-configuration.md): Configuration snippets for connecting GitHub Copilot in VS Code, Cursor, Claude Desktop and Claude Code to the Testkube MCP Server through the hosted endpoint, CLI or Docker, with example prompts. - [Testkube MCP Server Security & Compliance](https://docs.testkube.io/articles/mcp-security.md): How the Testkube MCP Server authenticates with OAuth, API tokens or user JWTs, respects RBAC and audit logging, and what to consider for data flow, token permissions, firewalls and proxies. - [Testkube Agent Skills](https://docs.testkube.io/articles/testkube-skills.md): Install the open source Testkube Agent Skills in Claude Code, GitHub Copilot, Codex or Cursor so a coding agent can discover tests, author TestWorkflow YAML, and run and diagnose executions. - [Testkube AI Configuration Reference](https://docs.testkube.io/articles/ai-configuration.md): Reference for configuring Testkube AI on-prem through the Helm inference block, with provider examples, thinking levels, API mode, Claude models, the MCP encryption key and environment variables. - [Use Alternative Models with Testkube AI](https://docs.testkube.io/articles/ai-model-proxies.md): Connect Testkube AI to Claude through a LiteLLM proxy or to locally served models through vLLM using the OpenAI Compatible provider, with Kubernetes manifests, a smoke test and production notes. - [Testkube AI Architecture](https://docs.testkube.io/articles/ai-architecture.md): How the Testkube AI Service works, covering the LangGraph agent loop, MCP and built-in tools, the AI Agent Trigger pipeline, human-in-the-loop tool approval, session persistence and security. - [All "Using Testkube: Testkube AI" pages in one file](https://docs.testkube.io/llms-full/using-testkube-testkube-ai.txt): The full Markdown of the 40 pages listed in this section. ## Using Testkube: Best Practices - [GitOps with Testkube](https://docs.testkube.io/articles/gitops-overview.md): How Testkube fits GitOps, covering the Runner GitOps capability that syncs CRDs to the Control Plane, resource ownership, pausing sync, Kubernetes Event Triggers and ArgoCD or Flux practices. - [Ephemeral Environments](https://docs.testkube.io/articles/ephemeral-environments.md): Run Test Workflows in short-lived namespaces or clusters, either with a dedicated runner per ephemeral environment or with a Standalone Runner and a runtime `executionNamespace` parameter. - [Environments and Access Control Best Practices](https://docs.testkube.io/articles/environments-best-practices.md): Patterns for structuring Environments, Teams and Resource Groups, from one project-centric Environment to hard isolation with separate Environments, plus SSO and SCIM user provisioning. - [Local Test Development and Execution](https://docs.testkube.io/articles/local-dev-loop.md): Run uncommitted local tests in a local minikube cluster by mounting the test folder and overriding git content with a TestWorkflowTemplate, with silent executions and Tilt automation. - [All "Using Testkube: Best Practices" pages in one file](https://docs.testkube.io/llms-full/using-testkube-best-practices.txt): The full Markdown of the 4 pages listed in this section. ## Examples & Guides - [Testkube Examples and Guides](https://docs.testkube.io/articles/examples/overview.md): Index of example Test Workflows by testing tool, grouped into load and performance, end-to-end and browser, API, unit and integration, and infrastructure testing. - [All "Examples & Guides" pages in one file](https://docs.testkube.io/llms-full/examples-and-guides.txt): The full Markdown of the 1 page listed in this section. ## Examples & Guides: Load & Performance Testing - [Basic K6 Example](https://docs.testkube.io/articles/examples/k6-basic.md): Example Test Workflow that runs an inline k6 script, uploads its HTML report and summary.json for performance metrics, plus a variant using the official k6 Template. - [Distributed K6 Example](https://docs.testkube.io/articles/examples/k6-distributed.md): Example Test Workflow that spreads a k6 load test from Git across a configurable number of parallel workers using execution segments; not available with a standalone Runner. - [Basic JMeter Framework Example](https://docs.testkube.io/articles/examples/jmeter-basic.md): Example Test Workflow that runs a JMeter JMX test from GitHub and uploads the dashboard report, whose statistics.json Testkube ingests as Performance Metrics. - [Distributed JMeter Example](https://docs.testkube.io/articles/examples/jmeter-distributed.md): Example Test Workflow that starts five JMeter remote workers as services and runs a controller against them with a JMX file from Git; not available with a standalone Runner. - [Using JMeter plugins](https://docs.testkube.io/articles/examples/jmeter-plugins.md): Load JMeter plugin jars stored alongside your tests in a private Git repository by setting `search_paths` and `plugin_dependency_paths` in a Test Workflow. - [Basic Gatling Example](https://docs.testkube.io/articles/examples/gatling-basic.md): Example Test Workflow that runs a Gatling load test from GitHub through the official Gradle template and uploads the generated report as an artifact. - [Basic Locust Example](https://docs.testkube.io/articles/examples/locust-basic.md): Example Test Workflow that runs a headless Locust load test from GitHub and uploads its HTML report as an artifact. - [Distributed Locust Example](https://docs.testkube.io/articles/examples/locust-distributed.md): Example Test Workflow that runs a Locust master as a service and a configurable number of parallel Locust workers; not available with a standalone Runner. - [Basic Artillery Example](https://docs.testkube.io/articles/examples/artillery-basic.md): Example Test Workflow that runs an Artillery test from GitHub and uploads its JSON report for Performance Metrics, plus a variant using the official Artillery Template. - [All "Examples & Guides: Load & Performance Testing" pages in one file](https://docs.testkube.io/llms-full/examples-and-guides-load-and-performance-testing.txt): The full Markdown of the 9 pages listed in this section. ## Examples & Guides: End-to-End & Browser Testing - [Basic Cypress Framework Example](https://docs.testkube.io/articles/examples/cypress-basic.md): Example Test Workflow that runs a Cypress project from GitHub and uploads the recorded videos as artifacts, plus a variant using the official Cypress Template. - [Sharded Cypress Example](https://docs.testkube.io/articles/examples/cypress-sharded.md): Example Test Workflow that shards the Cypress test files in cypress/e2e across up to five parallel workers; not available with a standalone Runner. - [Basic Playwright Framework Example](https://docs.testkube.io/articles/examples/playwright-basic.md): Example Test Workflow that runs a Playwright project from GitHub and uploads its HTML and trace reports, plus a variant using the official Playwright Template. - [Sharded Playwright Example](https://docs.testkube.io/articles/examples/playwright-sharded.md): Example Test Workflow that splits Playwright tests into two shards, fetches each blob report and merges them into one HTML report; not available with a standalone Runner. - [Playwright - Rerun Failed Tests](https://docs.testkube.io/articles/examples/playwright-rerun.md): Example Test Workflow that reruns only the failed Playwright tests of an earlier, unrelated execution by downloading its .last-run.json artifact with the Testkube CLI. - [Basic Selenium Example](https://docs.testkube.io/articles/examples/selenium-basic.md): Example Test Workflow that runs a Java Selenium test with Maven against a Chrome engine started as a service and uploads the reports; not available with a standalone Runner. - [Advanced Selenium Example](https://docs.testkube.io/articles/examples/selenium-advanced.md): Example Test Workflow that runs a Java Selenium test with Maven in parallel against Chrome, Edge and Firefox services using a matrix; not available with a standalone Runner. - [Basic Robot Framework Example](https://docs.testkube.io/articles/examples/robot-framework-basic.md): Example Test Workflow that runs a Robot Framework test from GitHub and uploads the generated HTML report as an artifact. - [Parallelized Robot Framework Example](https://docs.testkube.io/articles/examples/robot-framework-parallel.md): Example Test Workflow that runs a Robot Framework browser test on Firefox, Chromium and WebKit in parallel with a matrix; not available with a standalone Runner. - [All "Examples & Guides: End-to-End & Browser Testing" pages in one file](https://docs.testkube.io/llms-full/examples-and-guides-end-to-end-and-browser-testing.txt): The full Markdown of the 9 pages listed in this section. ## Examples & Guides: API Testing - [Basic Postman Example](https://docs.testkube.io/articles/examples/postman-basic.md): Example Test Workflow that runs a Postman collection from GitHub with the newman image, plus a variant using the official Postman Template. - [Basic SoapUI Example](https://docs.testkube.io/articles/examples/soapui-basic.md): Example Test Workflow that runs all tests in a SoapUI project from GitHub with the SoapUI test runner image and default container resources. - [Basic REST Assured Example](https://docs.testkube.io/articles/examples/rest-assured-basic.md): Example Test Workflow that runs REST Assured API tests in a Gradle project from GitHub and uploads the JUnit and HTML reports as artifacts. - [Basic Curl Example](https://docs.testkube.io/articles/examples/curl-basic.md): Example Test Workflow with a single step that runs a curl command against a URL and shows the result in the log output. - [All "Examples & Guides: API Testing" pages in one file](https://docs.testkube.io/llms-full/examples-and-guides-api-testing.txt): The full Markdown of the 4 pages listed in this section. ## Examples & Guides: Unit & Integration Testing - [Basic Pytest Example](https://docs.testkube.io/articles/examples/pytest-basic.md): Example Test Workflow that runs Pytest tests from a GitHub folder in a Python image, with the results shown in the log output. - [Basic Maven Example](https://docs.testkube.io/articles/examples/maven-basic.md): Example Test Workflow that runs the tests of a Maven project from GitHub, plus a variant using the official Maven Template. - [Basic Gradle Example](https://docs.testkube.io/articles/examples/gradle-basic.md): Example Test Workflow that runs the tests of a Gradle project from GitHub with `gradle test`, plus a variant using the official Gradle Template. - [Basic NUnit Example](https://docs.testkube.io/articles/examples/nunit-basic.md): Example Test Workflow that runs NUnit tests from a Git repository with `dotnet test` and produces a JUnit-compatible report for the JUnit Report tab. - [Using TestContainers with Testkube](https://docs.testkube.io/articles/examples/test-containers-basic.md): Run TestContainers tests in a Test Workflow by starting a Docker-in-Docker service and pointing DOCKER_HOST at it; not available with a standalone Runner. - [All "Examples & Guides: Unit & Integration Testing" pages in one file](https://docs.testkube.io/llms-full/examples-and-guides-unit-and-integration-testing.txt): The full Markdown of the 5 pages listed in this section. ## Examples & Guides: Infrastructure Testing - [Testkube Marketplace](https://docs.testkube.io/articles/examples/marketplace.md): Browse and install reusable infrastructure validation Test Workflows from the Testkube Marketplace with the Dashboard wizard or the `testkube marketplace` CLI commands. - [Basic Chainsaw Example](https://docs.testkube.io/articles/examples/chainsaw-basic.md): Example Test Workflow that runs a Chainsaw test from GitHub with a JUnit report, and the custom ServiceAccount and ClusterRole it needs to create namespaces. - [Validating Kubernetes Clusters with Kubectl](https://docs.testkube.io/articles/examples/kubectl-basic.md): Run kubectl commands in Test Workflow steps to check cluster health, deployments and resources, including the RBAC setup, security considerations and troubleshooting. - [All "Examples & Guides: Infrastructure Testing" pages in one file](https://docs.testkube.io/llms-full/examples-and-guides-infrastructure-testing.txt): The full Markdown of the 3 pages listed in this section. ## Examples & Guides: Tutorials - [Testing a Sample Application](https://docs.testkube.io/articles/tutorial/example.md): Tutorial that runs black-box and Cypress end-to-end tests on a three-tier sample application, covering Test Workflow config parameters and private Git repository authentication. - [All "Examples & Guides: Tutorials" pages in one file](https://docs.testkube.io/llms-full/examples-and-guides-tutorials.txt): The full Markdown of the 1 page listed in this section. ## Integrations - [Testkube Integrations Overview](https://docs.testkube.io/articles/integrations.md): Index of Testkube integrations by category, linking to the CI/CD, GitOps, progressive delivery, event-driven automation, alerting, observability and SCIM pages. - [All "Integrations" pages in one file](https://docs.testkube.io/llms-full/integrations.txt): The full Markdown of the 1 page listed in this section. ## Integrations: Version Control - [GitHub](https://docs.testkube.io/articles/git-integration.md): Connect a GitHub repository to an Environment so pull request, push and release events run existing or auto-generated Test Workflows and post check-runs, PR comments and AI analysis back. - [All "Integrations: Version Control" pages in one file](https://docs.testkube.io/llms-full/integrations-version-control.txt): The full Markdown of the 1 page listed in this section. ## Integrations: CI/CD Pipelines - [Testkube GitHub Action](https://docs.testkube.io/articles/github-actions.md): Run Testkube CLI commands from GitHub workflows with the `setup-testkube` action, with EKS and GKE examples, and configure a GitHub App on-prem for cloning and the GitHub integration. - [Testkube Gitlab CI](https://docs.testkube.io/articles/gitlab.md): Run Test Workflows from a GitLab CI pipeline with the Testkube CLI image, with examples for the Testkube Control Plane and for open source installs on your own cluster, EKS and GKE. - [Testkube Jenkins Pipelines](https://docs.testkube.io/articles/jenkins.md): Run Test Workflows from Jenkins pipelines in Groovy, using the Testkube CLI image on Kubernetes, a CLI install on virtual machines with EKS or GKE, or the Testkube CLI Jenkins Plugin. - [Testkube Jenkins UI](https://docs.testkube.io/articles/jenkins-ui.md): Set up a Jenkins Freestyle Project that runs a Test Workflow with the Testkube CLI Jenkins Plugin, which works only with the cloud-hosted Testkube Control Plane. - [Testkube Azure DevOps Pipelines](https://docs.testkube.io/articles/azure.md): Run Test Workflows from Azure DevOps Pipelines with the Testkube CLI extension, with azure-pipelines.yml examples for the Testkube Control Plane, open source installs, EKS and GKE. - [Testkube CircleCI](https://docs.testkube.io/articles/circleci.md): Run Test Workflows from a CircleCI pipeline with the Testkube CLI image, with config examples for the Testkube Control Plane and for open source installs using a kubeconfig, EKS or GKE. - [Testkube Tekton Integration](https://docs.testkube.io/articles/tekton.md): Run Testkube CLI commands from a Tekton pipeline by creating a Testkube Task, a Pipeline and a PipelineRun that runs a Test Workflow. - [All "Integrations: CI/CD Pipelines" pages in one file](https://docs.testkube.io/llms-full/integrations-ci-cd-pipelines.txt): The full Markdown of the 7 pages listed in this section. ## Integrations: GitOps - [Using Testkube with ArgoCD](https://docs.testkube.io/articles/argocd-integration.md): Manage Testkube resources and Runners with ArgoCD and run Test Workflows after a sync with a PostSync resource hook or a Kubernetes Event Trigger, without ArgoCD pruning execution pods. - [GitOps Testing with Flux](https://docs.testkube.io/articles/flux-integration.md): Sync Test Workflows from a GitHub repository to your cluster with Flux, from flux bootstrap and a Git source to a Kustomization, then verify that the Test Workflow was created. - [All "Integrations: GitOps" pages in one file](https://docs.testkube.io/llms-full/integrations-gitops.txt): The full Markdown of the 2 pages listed in this section. ## Integrations: Progressive Delivery - [Using Testkube with Argo Rollouts](https://docs.testkube.io/articles/argorollouts-integration.md): Validate Canary and Blue-Green deployments in Argo Rollouts with an AnalysisTemplate whose Kubernetes Job runs a Test Workflow through the Testkube CLI. - [Using Testkube with Kargo](https://docs.testkube.io/articles/kargo-integration.md): Use a Test Workflow as the Kargo verification of a Stage, with an AnalysisTemplate that runs it on a named Runner so that only verified Freight is promoted to the next Stage. - [All "Integrations: Progressive Delivery" pages in one file](https://docs.testkube.io/llms-full/integrations-progressive-delivery.txt): The full Markdown of the 2 pages listed in this section. ## Integrations: Event-Driven Automation - [Integrating Testkube with Argo Events](https://docs.testkube.io/articles/argoevents-integration.md): Trigger a Test Workflow from Argo Events when a Kubernetes resource changes, using an EventSource and a Sensor that calls the Testkube execution API, shown with a config map example. - [Using Testkube with Argo Workflows](https://docs.testkube.io/articles/argoworkflows-integration.md): Run Testkube CLI commands from Argo Workflows with a reusable WorkflowTemplate that sets the Testkube context, runs a Test Workflow and waits for its result. - [Emitting Standard CDEvents](https://docs.testkube.io/articles/cd-events.md): Emit standard CDEvents to a webhook endpoint by setting Helm values on a Runner with the webhooks capability, then test it with a Test Workflow and compare with a sample event. - [Kubernetes Events](https://docs.testkube.io/articles/k8s-events.md): Reference for the Kubernetes Events Testkube emits for TestWorkflow executions and resource lifecycle changes, with the Helm value that enables them, their structure and kubectl queries. - [Webhooks](https://docs.testkube.io/articles/webhooks.md): Create and configure Webhooks that send HTTP payloads on Test Workflow events, with payload templates and variables, supported event types, WebhookTemplates, URL masking and disabling. - [All "Integrations: Event-Driven Automation" pages in one file](https://docs.testkube.io/llms-full/integrations-event-driven-automation.txt): The full Markdown of the 5 pages listed in this section. ## Integrations: Collaboration & Alerting - [Integrating with Slack Using Webhooks](https://docs.testkube.io/articles/slack-integration.md): Send Test Workflow notifications to a Slack channel by creating a Slack app with an incoming webhook and a Testkube Webhook with a custom payload, from the Dashboard or the CLI. - [Microsoft Teams](https://docs.testkube.io/articles/teams-integration.md): Send a message to a Microsoft Teams channel when a Test Workflow execution finishes, using a Teams incoming webhook and a Testkube Webhook with a payload template. - [Atlassian Jira](https://docs.testkube.io/articles/jira-integration.md): Create Atlassian Jira issues for failed Test Workflow executions with a reusable WebhookTemplate, a Secret for the Jira API token and label selectors that limit which Workflows create issues. - [Backstage Integration](https://docs.testkube.io/articles/backstage-integration.md): Install and configure the Testkube Backstage UI and backend plugins to add a Testkube dashboard page and per-entity test summary tabs, for Testkube Enterprise or a Standalone Runner. - [All "Integrations: Collaboration & Alerting" pages in one file](https://docs.testkube.io/llms-full/integrations-collaboration-and-alerting.txt): The full Markdown of the 4 pages listed in this section. ## Integrations: Observability & Reporting - [Testkube Runner Metrics](https://docs.testkube.io/articles/metrics.md): Reference for the Prometheus metrics the Testkube Runner API Server exposes at /metrics, with the Runner capabilities each one needs, a ServiceMonitor for scraping and a Grafana dashboard. - [Control Plane Metrics](https://docs.testkube.io/articles/control-plane-metrics.md): Reference for the Prometheus metrics the Control Plane exposes, including scheduler queue metrics, the settings that enable them, their labels and the mapping from Runner metrics. - [Integrating with Grafana Using Webhooks](https://docs.testkube.io/articles/grafana.md): Create incidents in Grafana when a test fails by installing the Grafana Incoming Webhooks integration and pointing a Testkube Webhook, created in the Dashboard, at its endpoint. - [Datadog](https://docs.testkube.io/articles/datadog-junit.md): Upload JUnit XML reports from a Test Workflow to Datadog Test Visibility with a reusable TestWorkflowTemplate that runs `datadog-ci junit upload`, a pattern that also fits other CLI tools. - [Using Allure Reports in your Workflows](https://docs.testkube.io/articles/allure-reports.md): Example Test Workflow that runs Pytest tests and then generates an Allure report, which is saved as an artifact and opened from the Artifacts tab in the Dashboard. - [All "Integrations: Observability & Reporting" pages in one file](https://docs.testkube.io/llms-full/integrations-observability-and-reporting.txt): The full Markdown of the 5 pages listed in this section. ## Integrations: Identity Mgmt - [SCIM Integration Guide](https://docs.testkube.io/articles/scim.md): Provision users and teams from Okta or Microsoft Entra ID with SCIM, covering role and entitlement URNs, the response format setting, on-prem enablement and troubleshooting. - [All "Integrations: Identity Mgmt" pages in one file](https://docs.testkube.io/llms-full/integrations-identity-mgmt.txt): The full Markdown of the 1 page listed in this section. ## Reference - [Reference Documentation](https://docs.testkube.io/articles/reference.md): Entry point to the Testkube reference documentation, linking to the CLI command reference, the Runner and Control Plane OpenAPI definitions, the architecture overview and the CRDs. - [Commercial Licensing Overview](https://docs.testkube.io/articles/licensing.md): How commercial Testkube licensing works for Cloud and On-Prem Control Plane deployments, covering full and read-only users, fixed and floating Runner licenses and license validation. - [Testkube Architecture](https://docs.testkube.io/articles/architecture.md): How the Testkube Control Plane and Runners fit together, with Runner capabilities, the on-prem components and their dependencies, the ports each integration uses and S3 access. - [Testkube Resource Management](https://docs.testkube.io/articles/testkube-resource-management.md): How Testkube stores Test Workflows, Webhooks and Triggers in the Control Plane instead of Runner CRDs as of v2.7, and what the automatic migration changes for users. - [Helm Components](https://docs.testkube.io/articles/helm-components.md): List of the components and Docker images that the Testkube On-Prem Helm Chart installs for the Control Plane and the Runner, including Dex, MinIO, PostgreSQL and NATS. - [Telemetry](https://docs.testkube.io/articles/telemetry.md): What telemetry the local trial installer, the Dashboard and the API server collect, and how to opt out in the CLI, the Runner and the Control Plane API. - [Trial Limits & Demo Data](https://docs.testkube.io/articles/trial-limits.md): What to expect during the Testkube trial - the trial limits, the resources on the hosted runner, and the demo data we pre-seed into your environment. - [Legacy Deprecations](https://docs.testkube.io/articles/legacy-deprecation.md): List of the legacy functionality removed in Testkube v1.21.1, including Tests, Test Suites, Executors and Sources, and what the removal means for CLI commands, APIs and CRDs. - [All "Reference" pages in one file](https://docs.testkube.io/llms-full/reference.txt): The full Markdown of the 8 pages listed in this section. ## Reference: Testkube CRDs - [Testkube Custom Resources](https://docs.testkube.io/articles/crds.md): Overview of the Testkube Custom Resource groups used by Standalone Runner and GitOps deployments, with links to each CRD reference and kubectl commands to check the installed CRDs. - [All "Reference: Testkube CRDs" pages in one file](https://docs.testkube.io/llms-full/reference-testkube-crds.txt): The full Markdown of the 1 page listed in this section. ## Reference: Testkube CLI - [CLI Configuration File](https://docs.testkube.io/articles/cli-config-reference.md): Structure of the `config.json` file in which the Testkube CLI stores its configuration, with a pointer to the `testkube config` command for changing it. - [All "Reference: Testkube CLI" pages in one file](https://docs.testkube.io/llms-full/reference-testkube-cli.txt): The full Markdown of the 1 page listed in this section. ## Reference: Open Source - [Contributing to Testkube Open Source](https://docs.testkube.io/articles/contributing.md): How to contribute to the open source Testkube Runner repository, with the contribution workflow, local setup with Tilt, verification commands, coding standards and where to get help. - [Open Source Licensing FAQ](https://docs.testkube.io/articles/testkube-licensing-FAQ.md): Answers on how the open source Testkube Runner is licensed under the MIT license and the Testkube Community License (TCL), including which features fall under each. - [All "Reference: Open Source" pages in one file](https://docs.testkube.io/llms-full/reference-open-source.txt): The full Markdown of the 2 pages listed in this section. ## Optional - [CLI Commands Reference](https://docs.testkube.io/cli/testkube.md): Every `testkube` CLI command and its flags. - [OpenAPI Definitions](https://docs.testkube.io/openapi/overview.md): The Runner API and the Control Plane API. - [Runner API OpenAPI specification](https://docs.testkube.io/openapi/testkube-agent-openapi.yaml) - [Control Plane API OpenAPI specification](https://docs.testkube.io/openapi/testkube-control-plane-openapi.yaml)