lzocateli/k6 repository overview

⁠k6 sobre Node.js 24 LTS hardened

Imagem para execução isolada do k6, baseada em lzocateli/node:24.15.0-bookworm, com binário oficial do k6 copiado da imagem upstream grafana/k6 fixada por digest imutável.

⁠Referência da imagem

⁠Conteúdo e finalidade

⁠Incluído

• Binário k6 versão 2.1.0.
• Runtime Node.js 24 LTS hardened herdado da imagem base.
• Execução padrão em usuário não root.

⁠Não incluído

• Scripts de teste prontos.
• Dashboard remoto, outputs externos ou credenciais.
• Extensões customizadas de k6 compiladas sob medida.

⁠Início rápido

docker pull lzocateli/k6:2.1.0-node24.15.0-bookworm
docker run --rm lzocateli/k6:2.1.0-node24.15.0-bookworm version

Exemplo com script local:

docker run --rm \
  --workdir /workspace \
  --volume "$(pwd):/workspace" \
  lzocateli/k6:2.1.0-node24.15.0-bookworm \
  run script.js

⁠Docker Compose

services:
  k6:
    image: lzocateli/k6:2.1.0-node24.15.0-bookworm
    working_dir: /workspace
    user: "node"
    volumes:
      - /caminho/absoluto/testes-k6:/workspace
    command: ["run", "script.js"]

⁠Configuração

⁠Variáveis de ambiente

⁠Portas

Nenhuma porta pública faz parte do contrato desta imagem base.

⁠Persistência e mounts

⁠Secrets

Forneça tokens e credenciais via runtime (--env-file ou secrets do orquestrador). Não grave valores sensíveis no Dockerfile nem em scripts versionados.

⁠Inicialização e ciclo de vida

A imagem inicia com k6 como entrypoint. O comando padrão version pode ser sobrescrito por run, inspect ou outros subcomandos.

⁠Segurança

• Execução como usuário node (não root).
• Sem portas expostas por padrão.
• Herda hardening e baseline de segurança da imagem base lzocateli/node.

⁠Build local

Como a base lzocateli/node:24.15.0-bookworm pode ainda não estar publicada, gere localmente antes:

docker build --pull --tag lzocateli/node:24.15.0-bookworm node

Depois gere a imagem k6:

docker build --pull --tag lzocateli/k6:2.1.0-node24.15.0-bookworm k6

⁠Tags e compatibilidade

⁠Validação

Antes da publicação, confirme:

• .gitignore e .dockerignore presentes e atualizados;
• exclusão de .env, secrets e .git do contexto Docker;
• docker buildx build --check sem erros;
• build para linux/amd64;
• k6 version executando com sucesso;
• scan de vulnerabilidades, SBOM e proveniência no workflow oficial.

⁠Publicação

Use Actions > Publicar imagem de container > Run workflow com:

• context_path: k6;
• image_name: k6;
• image_tag: 2.1.0-node24.15.0-bookworm;
• dockerfile: Dockerfile;
• platforms: linux/amd64.

⁠Operação

• Versione scripts de carga junto do código da aplicação.
• Execute testes em rede isolada para evitar impacto em produção.
• Preserve relatórios em volume do host quando necessário.

⁠Troubleshooting

⁠Limitações conhecidas

• Plataforma validada neste repositório: linux/amd64.
• Não inclui extensões customizadas do ecossistema xk6.

⁠Licenças e fontes

O badge MIT descreve somente o conteúdo original deste repositório. Componentes de terceiros permanecem sujeitos aos seus termos e avisos de licença. Consulte a política de licenciamento: https://github.com/lzocateli/containers/blob/main/LICENSING.md⁠.

⁠Histórico de alterações

• 2.1.0-node24.15.0-bookworm: atualização para k6 2.1.0 com pin por digest imutável para evitar deriva de tag e reaparição de CVEs críticos do binário Go no CI.