os-integrations

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

OS Integrations

操作系统集成

Run Firefox
mach try
commands with pre-configured worker pool overrides for testing against alpha images.
使用预配置的工作者池覆盖运行Firefox
mach try
命令,针对alpha镜像进行测试。

Usage

使用方法

bash
undefined
bash
undefined

Run with preset (dry-run to preview)

使用预设运行(dry-run用于预览)

uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --dry-run
uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --dry-run

Push to try server

推送到try服务器

uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --push
uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --push

Filter to specific test types (recommended)

过滤到特定测试类型(推荐)

uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 -t xpcshell -t mochitest-browser-chrome --push uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 -t mochitest-devtools-chrome -t mochitest-chrome-1proc --dry-run
uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 -t xpcshell -t mochitest-browser-chrome --push uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 -t mochitest-devtools-chrome -t mochitest-chrome-1proc --dry-run

Override query (advanced)

覆盖查询(高级)

uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 -q "test-windows11-64-24h2" --push
undefined
uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 -q "test-windows11-64-24h2" --push
undefined

Build Behavior

构建行为

By default, the script reuses builds from the latest mozilla-central decision task (skipping the 45+ minute Firefox build). Use
--fresh-build
to force a full build instead:
bash
undefined
默认情况下,脚本会重用最新mozilla-central决策任务中的构建结果(跳过45分钟以上的Firefox构建)。使用
--fresh-build
强制进行完整构建:
bash
undefined

Default: reuses existing Firefox builds

默认:重用现有Firefox构建

uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 -t xpcshell --push
uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 -t xpcshell --push

Use a specific decision task

使用特定决策任务

uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --task-id ABC123 -t mochitest-browser-chrome --push
uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --task-id ABC123 -t mochitest-browser-chrome --push

Force a fresh Firefox build

强制进行全新Firefox构建

uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --fresh-build --push
undefined
uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --fresh-build --push
undefined

Watching Test Results

查看测试结果

Use
--watch
to automatically monitor test results with lumberjackth after pushing:
bash
undefined
推送后使用
--watch
自动通过lumberjackth监控测试结果:
bash
undefined

Push and watch all test results

推送并查看所有测试结果

uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 -t xpcshell --watch
uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 -t xpcshell --watch

Watch with filter (regex)

带过滤的查看(正则表达式)

uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --watch --watch-filter "xpcshell|mochitest"
uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --watch --watch-filter "xpcshell|mochitest"

Combine with fresh build and watch

结合全新构建和查看

uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --fresh-build -t xpcshell --watch
undefined
uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --fresh-build -t xpcshell --watch
undefined

Watching Lando Job Status

查看Lando任务状态

Use
--watch-lando
to poll the Lando landing job status until it lands or fails:
bash
undefined
使用
--watch-lando
轮询Lando提交任务状态,直到任务完成或失败:
bash
undefined

Push and watch Lando job (polls every 90 seconds by default)

推送并查看Lando任务(默认每90秒轮询一次)

uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 -t xpcshell --watch-lando
uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 -t xpcshell --watch-lando

Custom polling interval (in seconds)

自定义轮询间隔(秒)

uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --watch-lando --lando-interval 60
uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --watch-lando --lando-interval 60

Combine with test watching (Lando check runs first, then test watching)

结合测试查看(先运行Lando检查,再查看测试结果)

uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --watch-lando --watch
undefined
uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --watch-lando --watch
undefined

Named Query Sets

命名查询集

Use
--query-set
to run a predefined set of test queries. Query sets can bundle specific suites with their own settings (e.g., skipping os-integration):
bash
undefined
使用
--query-set
运行预定义的测试查询集。查询集可以将特定测试套件与其自身设置捆绑(例如,跳过操作系统集成测试):
bash
undefined

Run targeted test suites

运行目标测试套件

uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --query-set targeted --push
uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --query-set targeted --push

Preview what a query set will run

预览查询集将运行的内容

uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --query-set targeted --dry-run
uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --query-set targeted --dry-run

Watch results from a query set

查看查询集的结果

uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --query-set targeted --watch

Query sets are defined per-preset in `references/presets.yml` under the `query_sets` key.
uv run ~/.claude/skills/os-integrations/scripts/run_try.py win11-24h2 --query-set targeted --watch

查询集在`references/presets.yml`中的`query_sets`键下按预设定义。

Common Test Types

常见测试类型

Use
-t
to filter to specific test suites:
  • xpcshell
    - XPCShell tests
  • mochitest-browser-chrome
    - Browser chrome mochitests
  • mochitest-chrome-1proc
    - Chrome mochitests (single process)
  • mochitest-devtools-chrome
    - DevTools mochitests
  • mochitest-plain
    - Plain mochitests
  • reftest
    - Reference tests
  • crashtest
    - Crash tests
使用
-t
过滤到特定测试套件:
  • xpcshell
    - XPCShell测试
  • mochitest-browser-chrome
    - 浏览器Chrome mochitest测试
  • mochitest-chrome-1proc
    - Chrome mochitest测试(单进程)
  • mochitest-devtools-chrome
    - DevTools mochitest测试
  • mochitest-plain
    - 基础mochitest测试
  • reftest
    - 参考测试
  • crashtest
    - 崩溃测试

Available Presets

可用预设

  • win11-24h2
    - Windows 11 24H2 standard
  • win11-25h2
    - Windows 11 25H2 (redirects 24H2 tasks to 25H2 alpha pools)
  • win11-hw
    - Windows 11 hardware workers
  • win10-2009
    - Windows 10 2009
  • win11-amd
    - Windows 11 AMD configuration
  • win11-source
    - Source image testing
  • b-win2022
    - Build worker testing
  • win11-arm64
    - ARM64 architecture
  • win11-24h2
    - Windows 11 24H2标准版
  • win11-25h2
    - Windows 11 25H2(将24H2任务重定向到25H2 alpha池)
  • win11-hw
    - Windows 11硬件工作者
  • win10-2009
    - Windows 10 2009
  • win11-amd
    - Windows 11 AMD配置
  • win11-source
    - 源镜像测试
  • b-win2022
    - 构建工作者测试
  • win11-arm64
    - ARM64架构

Prerequisites

前提条件

  • Firefox repository at
    ~/firefox
  • Must be on a feature branch (not main/master)
  • Mozilla Auth0 authentication (for Lando-based pushes)
  • Firefox代码库位于
    ~/firefox
  • 必须处于功能分支(而非main/master分支)
  • Mozilla Auth0身份验证(用于基于Lando的推送)

Additional Documentation

其他文档

  • Presets Configuration: See
    references/presets.yml
  • Linux Worker Overrides: See
    references/linux-worker-overrides.md
  • Pushing to Try: See
    references/pushing-to-try.md
  • Script Help: Run
    uv run ~/.claude/skills/os-integrations/scripts/run_try.py --help
  • 预设配置: 查看
    references/presets.yml
  • Linux工作者覆盖: 查看
    references/linux-worker-overrides.md
  • 推送到Try: 查看
    references/pushing-to-try.md
  • 脚本帮助: 运行
    uv run ~/.claude/skills/os-integrations/scripts/run_try.py --help

Official Documentation

官方文档

For more information on mach try and Taskcluster:
有关mach try和Taskcluster的更多信息: