You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/sources/k6/next/extensions/run-extensions-using-binary-provisioning.md
+3-14Lines changed: 3 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,18 +17,17 @@ This is an experimental feature. Breaking changes might occur prior to the featu
17
17
18
18
k6 supports [extensions](https://grafana.com/docs/k6/<K6_VERSION>/extensions/) as a way of extending k6 native functionality, and support a wider variety of use cases.
19
19
20
-
Using k6 with extensions locally requires users to build a [custom k6 binary](https://grafana.com/docs/k6/<K6_VERSION>/extensions/#xk6-makes-custom-binaries) that includes the extension, which can then be used to run a test script. With the Binary Provisioning feature, Grafana Cloud k6 users can run tests with a [limited set of extensions](https://grafana.com/docs/grafana-cloud/testing/k6/author-run/use-k6-extensions/#supported-extensions-in-grafana-cloud), without having to manually build a k6 binary.
20
+
Using k6 with extensions locally requires users to build a [custom k6 binary](https://grafana.com/docs/k6/<K6_VERSION>/extensions/#xk6-makes-custom-binaries) that includes the extension, which can then be used to run a test script. With the Binary Provisioning feature, k6 users can run tests with a [limited set of extensions](https://grafana.com/docs/grafana-cloud/testing/k6/author-run/use-k6-extensions/#supported-extensions-in-grafana-cloud), without having to manually build a k6 binary.
21
21
22
-
The `archive` and `inspect` commands also support Binary Provisioning to allow creating archives for Grafana Cloud.
22
+
The `archive` and `inspect` commands also support Binary Provisioning to allow creating archives.
23
23
24
24
## Before you begin
25
25
26
26
To use Binary Provisioning, you'll need:
27
27
28
28
- k6 v1.0 or greater [installed on your machine](https://grafana.com/docs/k6/latest/set-up/install-k6/).
29
-
- A [Grafana Cloud account](https://grafana.com/auth/sign-up/create-user).
30
29
31
-
## Set the Binary Provsioning environment flag
30
+
## Set the Binary Provisioning environment flag
32
31
33
32
To enable Binary Provisioning, you must set the `K6_BINARY_PROVISIONING` environment variable to `true`:
To use Binary Provisioning, you must [authenticate to Grafana Cloud](https://grafana.com/docs/grafana-cloud/testing/k6/author-run/tokens-and-cli-authentication/#authenticate-with-the-login-command) using the `k6 cloud login` command:
55
-
56
-
```bash
57
-
k6 cloud login --token <API_TOKEN>
58
-
```
59
-
60
51
## Run a test
61
52
62
53
After setting the `K6_BINARY_PROVISIONING` environment variable and logging in to Grafana Cloud, you can run a test using the `k6 cloud run` command:
@@ -118,5 +109,3 @@ The output includes information about which dependencies were detected, and the
118
109
119
110
- Only extensions supported in Grafana Cloud are supported.
120
111
- Output extensions are not supported.
121
-
- Running scripts from stdin is not supported.
122
-
- Only files with extensions `.js`, `.ts` or `.tar` can be used. Other extensions will not invoke the Binary Provisioning mechanism.
0 commit comments