grafana / k6

A modern load testing tool, using Go and JavaScript - https://k6.io
GNU Affero General Public License v3.0
23.98k stars 1.2k forks source link

man page for k6 #2347

Open na-- opened 2 years ago

na-- commented 2 years ago

Feature Description

The current .deb and .rpm packages don't have a man page. This is a problem for *nix users that are used to these, especially for CLI tooks like k6.

Suggested Solution (optional)

We should probably add at least a basic manpage with the main options and a link to https://k6.io/docs/. In the future, we can expand that to sub-pages (e.g. man k6-run) and auto-generate them, but we should at least start somewhere.

Already existing or connected issues / PRs (optional)

Somewhat loosely related issues: https://github.com/grafana/k6/issues/2154, https://github.com/grafana/k6/issues/1970

chenrui333 commented 2 years ago

however the tldr actually works

$ tldr k6

  Open source load testing tool and SaaS for engineering teams.
  More information: <https://k6.io>.

  Run load test locally:

      k6 run script.js

  Run load test locally with a given number of virtual users and duration:

      k6 run --vus 10 --duration 30s script.js

  Run load test locally with a given environment variable:

      k6 run -e HOSTNAME=example.com script.js

  Run load test locally using InfluxDB to store results:

      k6 run --out influxdb=http://localhost:8086/k6db script.js

  Run load test locally and discard response bodies (significantly faster):

      k6 run --discard-response-bodies script.js

  Run load test locally using the base JavaScript compatibility mode (significantly faster):

      k6 run --compatibility-mode=base script.js

  Log in to cloud service using secret token:

      k6 login cloud --token secret

  Run load test on cloud infrastructure:

      k6 cloud script.js