Chainguard Container for k6

Load testing tool for testing APIs, microservices, and websites.

Chainguard Containers are regularly-updated, secure-by-default container images.

Download this Container Image

For those with access, this container image is available on cgr.dev:

docker pull cgr.dev/ORGANIZATION/k6:latest

Be sure to replace the ORGANIZATION placeholder with the name used for your organization's private repository within the Chainguard Registry.

Compatibility Notes

Chainguard's k6 image is comparable to the upstream k6 image from Grafana. Switching to the Chainguard image should not require any changes to your existing setup.

Getting Started

Create and initialize a new script by running the following command:

docker run --rm -u $(id -u) -v $PWD:/app -w /app cgr.dev/ORGANIZATION/k6:latest new

This command creates a new script file named script.js in the current directory. You can also specify a different file name as an argument to the k6 new command, for example k6 new my-test.js.

Run k6 with the following command:

docker run --rm -i cgr.dev/ORGANIZATION/k6:latest run - <script.js

When using the k6 docker image, the script file will not be available to the container as it runs, meaning that just passing the script name won't work. Instead you must tell k6 to read stdin by passing the file name as -. Then you pipe the actual file into the container with < or equivalent. This will cause the file to be redirected into the container and be read by k6.

Documentation and Resources

• Run k6 scripts with TestRun CRD
• Running k6
• Using k6

What are Chainguard Containers?

Chainguard Containers are minimal container images that are secure by default.

In many cases, the Chainguard Containers tagged as :latest contain only an open-source application and its runtime dependencies. These minimal container images typically do not contain a shell or package manager. Chainguard Containers are built with Wolfi, our Linux undistro designed to produce container images that meet the requirements of a more secure software supply chain.

The main features of Chainguard Containers include:

• Minimal design, without unnecessary software bloat
• Daily builds to ensure container images are up-to-date with available security patches
• High quality build-time SBOMs attesting to the provenance of all artifacts within the image
• Verifiable signatures provided by Sigstore
• Reproducible builds with Cosign and apko (read more about reproducibility)

For cases where you need container images with shells and package managers to build or debug, most Chainguard Containers come paired with a -dev variant.

Although the -dev container image variants have similar security features as their more minimal versions, they feature additional software that is typically not necessary in production environments. We recommend using multi-stage builds to leverage the -dev variants, copying application artifacts into a final minimal container that offers a reduced attack surface that won’t allow package installations or logins.

Learn More

To better understand how to work with Chainguard Containers, please visit Chainguard Academy and Chainguard Courses.

In addition to Containers, Chainguard offers VMs and Libraries. Contact Chainguard to access additional products.

Trademarks

This software listing is packaged by Chainguard. The trademarks set forth in this offering are owned by their respective companies, and use of them does not imply any affiliation, sponsorship, or endorsement by such companies.