2. k6 环境搭建：安装方式、Docker 部署、Cloud 与 OSS 区别及验证

在开始容量压测巡检脚本编排之前，必须完成 k6 运行环境的搭建。本章覆盖 k6 在主流操作系统上的安装方式、Docker 容器化部署、k6 Cloud 与 k6 OSS 的核心差异，以及安装后的验证方法。请根据你的实际工作环境选择对应的安装路径。

2.1 操作系统原生安装

k6 官方提供 Linux、macOS 和 Windows 三种主流操作系统的安装包。以下为各系统的推荐安装方式：

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys C5AD17C747E3415A3642D57D77C6C491D6AC1D69
echo "deb https://dl.k6.io/deb stable main" | sudo tee /etc/apt/sources.list.d/k6.list
sudo apt-get update
sudo apt-get install k6

sudo dnf install https://dl.k6.io/rpm/repo.rpm
sudo dnf install k6

brew install k6

choco install k6

# 下载对应平台压缩包
# Linux/macOS: k6-v0.49.0-linux-amd64.tar.gz
# Windows: k6-v0.49.0-windows-amd64.zip
# 解压后将 k6 二进制放入 PATH 目录

2.2 Docker 部署 k6

Docker 是运行 k6 最隔离、最可复用的方式，尤其适合 CI/CD 流水线和容器化压测环境。k6 官方镜像托管于 Docker Hub，标签与 GitHub Release 版本同步。

2.2.1 拉取并运行 k6 容器

# 拉取最新稳定版镜像
docker pull grafana/k6:latest

# 运行一个简单的测试脚本（内联脚本）
docker run --rm -i grafana/k6 run - <<EOF
import http from 'k6/http';
import { sleep } from 'k6';

export default function () {
  http.get('https://test.k6.io');
  sleep(1);
}
EOF

2.2.2 挂载本地脚本运行

# 假设本地脚本路径为 ./scripts/loadtest.js
docker run --rm -i -v $(pwd)/scripts:/scripts grafana/k6 run /scripts/loadtest.js

2.2.3 Docker Compose 集成（推荐）

# docker-compose.yml
version: '3.8'
services:
  k6:
    image: grafana/k6:latest
    container_name: k6-runner
    volumes:
      - ./scripts:/scripts
      - ./reports:/reports
    command: run /scripts/loadtest.js
    environment:
      - K6_OUT=json=/reports/result.json

2.3 k6 Cloud 与 k6 OSS 的区别

k6 提供两个主要版本：开源版（OSS）和云版（Cloud）。理解两者的差异有助于根据团队规模和压测需求做出正确选择。

2.4 验证安装

无论选择哪种安装方式，安装完成后都应执行以下验证步骤，确保 k6 可正常运行：

1. 检查版本号

   k6 version
   # 预期输出示例：k6 v0.49.0 (2024-03-15T10:00:00+0000, go1.22.1, linux/amd64)

2. 运行内置 smoke test

   k6 run --vus 1 --duration 5s -

   然后粘贴以下脚本并回车（或使用 echo 管道）：

   import http from 'k6/http';
   import { check } from 'k6';
   
   export default function () {
     const res = http.get('https://test.k6.io');
     check(res, {
       'status is 200': (r) => r.status === 200,
     });
   }

3. 检查 Docker 容器运行（如果使用 Docker）

   docker run --rm -i grafana/k6 version

4. 验证输出格式

   k6 run --vus 1 --duration 3s --out json=test-output.json - <<EOF
   import http from 'k6/http';
   export default function () { http.get('https://test.k6.io'); }
   EOF
   cat test-output.json | head -5

2.5 常见安装问题与解决