{"id":25050658,"url":"https://github.com/steadybit/extension-k6","last_synced_at":"2026-03-03T13:05:00.008Z","repository":{"id":158046565,"uuid":"633757961","full_name":"steadybit/extension-k6","owner":"steadybit","description":"A Steadybit extension to run k6 load tests","archived":false,"fork":false,"pushed_at":"2026-02-20T23:10:05.000Z","size":827,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-21T04:10:13.112Z","etag":null,"topics":["k6","loadtest"],"latest_commit_sha":null,"homepage":"https://hub.steadybit.com/extension/com.steadybit.extension_k6","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/steadybit.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-04-28T08:01:17.000Z","updated_at":"2026-02-20T23:06:05.000Z","dependencies_parsed_at":"2023-12-18T15:44:23.358Z","dependency_job_id":"4a60aac2-264f-4f35-84ee-8141accb11aa","html_url":"https://github.com/steadybit/extension-k6","commit_stats":null,"previous_names":[],"tags_count":79,"template":false,"template_full_name":"steadybit/extension-scaffold","purl":"pkg:github/steadybit/extension-k6","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steadybit%2Fextension-k6","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steadybit%2Fextension-k6/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steadybit%2Fextension-k6/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steadybit%2Fextension-k6/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/steadybit","download_url":"https://codeload.github.com/steadybit/extension-k6/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/steadybit%2Fextension-k6/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29682748,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T13:29:26.630Z","status":"ssl_error","status_checked_at":"2026-02-21T13:26:50.125Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["k6","loadtest"],"created_at":"2025-02-06T09:17:19.192Z","updated_at":"2026-02-21T14:01:14.788Z","avatar_url":"https://github.com/steadybit.png","language":"Go","readme":"\u003cimg src=\"./logo.webp\" height=\"130\" align=\"right\" alt=\"K6 logo\"\u003e\n\n# Steadybit extension-k6\n\nA [Steadybit](https://www.steadybit.com/) action implementation to integrate k6 load tests into Steadybit experiments.\n\nLearn about the capabilities of this extension in our [Reliability Hub](https://hub.steadybit.com/extension/com.steadybit.extension_k6).\n\n## Configuration\n\n| Environment Variable                            | Helm value                | Meaning                                                                                                                                                                                              | Required | Default |\n|-------------------------------------------------|---------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------|---------|\n| `STEADYBIT_EXTENSION_CLOUD_API_TOKEN`           | `k6.cloudApiToken`        | K6 Cloud API Token. If provided, the extension will have the option to run load tests in the k6 cloud.                                                                                               | no      |         |\n| `STEADYBIT_EXTENSION_ENABLE_LOCATION_SELECTION` | `enableLocationSelection` | By default, the platform will select a random instance when executing actions from this extension. If you enable location selection, users can optionally specify the location via target selection. | no      | false   |\n| `HTTPS_PROXY`                                   | via extraEnv variables    | Configure the proxy to be used for K6 Cloud communication.                                                                                                                                           | no      |         |\n\nThe extension supports all environment variables provided by [steadybit/extension-kit](https://github.com/steadybit/extension-kit#environment-variables).\n\n## Installation\n\n### Kubernetes\n\nDetailed information about agent and extension installation in kubernetes can also be found in\nour [documentation](https://docs.steadybit.com/install-and-configure/install-agent/install-on-kubernetes).\n\n#### Recommended (via agent helm chart)\n\nAll extensions provide a helm chart that is also integrated in the\n[helm-chart](https://github.com/steadybit/helm-charts/tree/main/charts/steadybit-agent) of the agent.\n\nYou must provide additional values to activate this extension.\n\n```\n--set extension-k6.enabled=true \\\n```\n\nIf you want to use K6 Cloud you need to provide a k6 cloud api token. You can add it for example with `--set extension-k6.k6.cloudApiToken=\"111-222-333\"`\n\nAdditional configuration options can be found in\nthe [helm-chart](https://github.com/steadybit/extension-k6/blob/main/charts/steadybit-extension-k6/values.yaml) of the\nextension.\n\n#### Alternative (via own helm chart)\n\nIf you need more control, you can install the extension via its\ndedicated [helm-chart](https://github.com/steadybit/extension-k6/blob/main/charts/steadybit-extension-k6).\n\n```bash\nhelm repo add steadybit-extension-k6 https://steadybit.github.io/extension-k6\nhelm repo update\nhelm upgrade steadybit-extension-k6 \\\n    --install \\\n    --wait \\\n    --timeout 5m0s \\\n    --create-namespace \\\n    --namespace steadybit-agent \\\n    --set k6.cloudApiToken=\"111-222-333\" \\\n    steadybit-extension-k6/steadybit-extension-k6\n```\n\n### Linux Package\n\nPlease use\nour [agent-linux.sh script](https://docs.steadybit.com/install-and-configure/install-agent/install-on-linux-hosts)\nto install the extension on your Linux machine. The script will download the latest version of the extension and install\nit using the package manager.\n\nAfter installing, configure the extension by editing `/etc/steadybit/extension-k6` and then restart the service.\n\n## Extension registration\n\nMake sure that the extension is registered with the agent. In most cases this is done automatically. Please refer to\nthe [documentation](https://docs.steadybit.com/install-and-configure/install-agent/extension-registration) for more\ninformation about extension registration and how to verify.\n\n## Proxy\nTo communicate to K6 Cloud via a proxy, we need the environment variable `https_proxy` to be set.\nThis can be set via helm using the extraEnv variable\n\n```bash\n--set \"extraEnv[0].name=HTTPS_PROXY\" \\\n--set \"extraEnv[0].value=https:\\\\user:pwd@CompanyProxy.com:8888\"\n```\n\n## Location Selection\nWhen multiple k6 extensions are deployed in different subsystems (e.g., multiple Kubernetes clusters), it can be tricky to ensure that the load test is performed from the right location when testing cluster-internal URLs or having different load testing hardware sizings.\nTo solve this, you can activate the location selection feature.\nOnce you do that, the k6 extension discovers itself as a k6 location.\nWhen configuring the experiment, you can optionally define which extension's deployment should execute the loadtest.\nAlso, the execution locations are part of Steadybit's environment concept, so you can assign permissions for execution locations.\n\n### Migration Guideline\nBefore activating the location selection feature, be sure to follow these steps:\n1. The installed agent version needs to be \u003e= 2.0.47, and - only for on-prem customers - the platform version needs to be \u003e=2.2.2\n2. Activate the location selection via environment or helm variable when deploying the latest extension version (see [configuration options](#configuration).\n3. Configure every environment that should be able to run k6 load tests by including the execution location in the environment configuration.\n\t One option is to add the statement `or target via the query language.type=\"com.steadybit.extension_k6.location\"` to your existing query.\n\t You can also filter the available execution locations down, e.g., via the clustername by using `(target.type=\"com.steadybit.extension_k6.location\" and k8s.cluster-name=\"CLUSTER-NAME\")`\n\n## Version and Revision\n\nThe version and revision of the extension:\n- are printed during the startup of the extension\n- are added as a Docker label to the image\n- are available via the `version.txt`/`revision.txt` files in the root of the image\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteadybit%2Fextension-k6","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsteadybit%2Fextension-k6","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteadybit%2Fextension-k6/lists"}