Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Load testing: document the k6 harness (bin/load-test)

Chiusa Adatta ai principianti
  • Qualcosa non va?
#73 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
75/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
javascript
Ambito
devops, documentation, performance

Direzione di ricerca

L'issue fa riferimento a una modifica del template in components-web-app/components-web-app#93 e a un harness per test di carico k6 in bin/load-test/launch.js. Inizia esaminando il README.md in quella directory per comprendere lo scopo, le modalità e le variabili d'ambiente dell'harness. Quindi, crea una nuova pagina di documentazione sotto la sezione 'Deployment' intitolata 'Test di carico' che copra installazione, modalità di test, comportamento della cache, interpretazione dei risultati e misure di sicurezza come CONFIRM=yes. Verifica il contenuto rispetto al README e assicurati di includere collegamenti incrociati ad argomenti di documentazione correlati come la cache delle pagine e gli audit delle prestazioni.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Template change: components-web-app/components-web-app#93 (commit 7a79437). The template now ships a k6 load-test harness at bin/load-test/launch.js so clients can stress test their sites. Its README.md is the source to draw from.

Suggested content, e.g. a new page under Deployment ("Load testing"):

  • Purpose: measuring what a site can take, both from the page cache and from server-side rendering.
  • Installing k6. Run it from a cloud VM near the cluster, not a laptop: a laptop times out around 300 users and ends up measuring your Wi-Fi.
  • Modes: smoke, capacity (stepped arrival rate), surge (PEOPLE, 100 by default) and soak. Also the environment variables (see the README's table).
  • CACHE=warm|cold|mixed and what each measures. Warm tests Souin hits; cold forces server-side rendering. Cold uses a k6cb= parameter, which must never be one of the tracking parameters the Caddyfile strips, or cold becomes warm. Flush the cache after a cold run against a real site: curl -X PURGE localhost:2019/souin-api/souin/flush in the API pod.
  • Reading the summary: time to first byte for pages, API calls and assets separately, plus hit/miss/bypass counts, which say what was measured.
  • The CONFIRM=yes guard for any host that isn't local, and why: a surge test is effectively a small DoS.
  • The gzip trap: Accept-Encoding: gzip is pinned, because k6 can't decode brotli and would report it like a server error.
  • Not in CI, on purpose.
  • Cross-links: page caching, the cache warm, and the performance audit (docs#62).
Lingua principale
Vue
Stelle
0
Fork
0
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di components-web-app/docs

Tutte le issue di components-web-app/docs

Issue simili

Altre issue su DevOps

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.