atlassian/jira-performance-tests

Jira Performance Tests (JPT) 本地Docker镜像

镜像概述和主要用途

本镜像为本地部署的Docker镜像，用于对指定的Jira Cloud租户执行Jira Performance Tests (JPT)。主要用途是通过模拟真实用户操作和负载场景，评估Jira Cloud租户的性能表现，包括响应时间、吞吐量、稳定性等关键指标，帮助用户在系统上线、版本更新或架构调整前验证性能达标情况。

核心功能和特性

• 多场景性能测试：支持负载测试（验证系统在预期负载下的性能）、压力测试（确定系统极限容量）等多种测试场景。
• 真实用户行为模拟：集成Jira Cloud API，模拟用户登录、创建/更新任务、查询数据、评论等常见操作。
• 可配置测试参数：支持自定义并发用户数、测试持续时间、操作频率等关键参数，适配不同测试需求。
• 详细测试报告：自动生成包含响应时间分布、错误率、吞吐量等指标的结构化报告（如HTML、JSON格式）。
• 轻量级本地部署：基于Docker容器化，无需复杂依赖配置，可快速在本地环境或CI/CD流水线中集成。

使用场景和适用范围

使用场景

• 上线前性能验证：在Jira Cloud租户正式投入使用前，验证其在预期用户规模下的性能是否满足业务需求。
• 版本更新回归测试：Jira Cloud版本更新后，通过对比历史测试数据，确认性能无退化。
• 高负载场景评估：模拟促销活动、项目集中交付等高峰期用户行为，评估系统稳定性和瓶颈。
• 架构优化效果验证：对Jira Cloud租户进行架构调整（如扩容、缓存策略优化）后，验证性能提升效果。

适用范围

• 负责Jira Cloud租户管理的DevOps团队、QA团队或系统管理员。
• 需要定期评估Jira Cloud性能的企业或组织。
• 集成性能测试到CI/CD流程中的开发团队。

使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+版本）或Docker Desktop。
• 拥有目标Jira Cloud租户的管理员权限，可生成API令牌（需开启Jira Cloud API访问权限）。
• 本地环境网络可访问Jira Cloud服务端点（https://.atlassian.net）。

镜像拉取

从Docker镜像仓库拉取最新版本：

bash
docker pull atlassian/jira-performance-test:latest

基本运行命令（docker run）

通过docker run命令启动容器，需指定Jira Cloud租户信息、测试参数等环境变量。示例如下：

bash
docker run -d \
  --name jpt-test \
  -e JIRA_CLOUD_URL="https://your-tenant.atlassian.net" \
  -e JIRA_USER_EMAIL="admin@example.com" \
  -e JIRA_API_TOKEN="your-api-token" \
  -e TEST_SCENARIO="load" \
  -e CONCURRENT_USERS=50 \
  -e TEST_DURATION="300s" \
  -v $(pwd)/reports:/app/reports \
  atlassian/jira-performance-test:latest

docker-compose配置示例

通过docker-compose.yml定义服务，便于管理多环境配置或集成到现有部署流程：

yaml
version: '3.8'

services:
  jpt:
    image: atlassian/jira-performance-test:latest
    container_name: jpt-test
    environment:
      - JIRA_CLOUD_URL=https://your-tenant.atlassian.net
      - JIRA_USER_EMAIL=admin@example.com
      - JIRA_API_TOKEN=your-api-token
      - TEST_SCENARIO=stress
      - CONCURRENT_USERS=100
      - TEST_DURATION=600s
      - RAMP_UP_TIME=60s  # 并发用户数逐步增加的时间（可选）
      - RAMP_DOWN_TIME=60s  # 并发用户数逐步减少的时间（可选）
    volumes:
      - ./reports:/app/reports  # 挂载本地目录存储测试报告
    restart: on-failure  # 测试失败时自动重启（可选）

启动服务：

bash
docker-compose up -d

环境变量说明

测试报告查看

测试完成后，报告默认存储在容器内/app/reports目录（可通过REPORT_OUTPUT_PATH自定义）。若通过-v参数挂载本地目录（如示例中的./reports），可直接在本地查看：

bash
# 查看报告文件列表
ls ./reports

# 打开HTML报告（需本地浏览器支持）
open ./reports/jpt-report.html  # macOS
# 或
xdg-open ./reports/jpt-report.html  # Linux

报告包含以下关键指标：

• 平均响应时间、95%响应时间、最大响应时间
• 每秒请求数（RPS）、成功请求率、错误率
• 各操作类型（如创建任务、查询任务）的性能明细
• 系统资源使用趋势图（如CPU、内存，需宿主机支持）

注意事项

• API令牌安全：JIRA_API_TOKEN为敏感信息，建议通过环境变量注入而非硬编码，生产环境中可结合Docker Secrets或Kubernetes Secrets管理。
• 测试影响：性能测试可能对Jira Cloud租户产生临时负载，建议在非业务高峰期执行，并提前通知租户用户。
• 网络环境：确保本地网络与Jira Cloud的连接稳定，网络延迟可能影响测试结果准确性。
• 版本兼容性：镜像版本需与Jira Cloud API版本兼容，建议使用最新镜像以适配API更新。