CI 및 릴리스 변수

CI 및 릴리스 파이프라인의 여러 설정은 GitHub Actions 저장소 변수(vars.* 컨텍스트)로 노출되어 있어 운영자가 pull request를 열지 않고도 값을 조정할 수 있습니다. 이 페이지에서는 .github/workflows/ci.yml과 .github/workflows/release.yml에서 테스트 실행에 영향을 주는 변수와 그 기본값, 그리고 각 변수가 적용되는 위치를 정리합니다.

변수 설정

저장소 관리자는 Settings → Secrets and variables → Actions → Variables에서 이 값들을 설정합니다. 설정되지 않거나 비어 있는 변수는 워크플로 표현식의 폴백 값을 사용합니다. worker cap은 예약된 runner에서만 적용되며, 해당 변수가 설정되어 있더라도 마찬가지입니다.

워크플로 파일이 이 설정값들의 유일한 기준이며, 테스트 스위트는 워크플로 표현식을 바이트 단위로 고정합니다: scripts/tests/package-scripts.test.js는 release.yml의 공유 worker-cap 표현식(QWEN_CI_VITEST_MAX_WORKERS에 ecs-qwen- 가드)을 고정하고, scripts/tests/no-ak-integration-ci.test.js는 ci.yml의 worker-cap 표현식을 고정하며, scripts/tests/release-workflow.test.js는 release.yml의 재시도 및 워크스페이스 테스트 타임아웃 표현식을 고정합니다. scripts/tests/package-scripts.test.js는 두 워크플로 모두에 대해 문서화된 기본값과 워크플로 위치도 확인합니다. 이 가드는 docs-only 체크가 아닌 전체 프로파일 CI 레인(test:scripts)에서 실행되므로, 이 페이지에 국한된 수정은 pull request를 열기 전에 npm run test:scripts(또는 npx vitest run --config ./scripts/tests/vitest.config.ts scripts/tests/package-scripts.test.js)로 로컬에서 검증하십시오. 문서와 워크플로가 일치하지 않는 경우 워크플로를 기준으로 하고 같은 변경에서 이 페이지를 업데이트하십시오.

변수

재시도 횟수

QWEN_CI_VITEST_RETRY와 QWEN_RELEASE_VITEST_RETRY는 Vitest에 --retry=<n>으로 전달됩니다. 각각 메인 CI 테스트 단계(npm run test:ci:workspaces 및 npm run test:scripts)와 릴리스 레인(npm run test:release:workspaces)에서 사용됩니다. 두 레인은 독립적으로 조정할 수 있도록 별도의 변수를 사용합니다.

Vitest는 동일한 실행 내에서 실패한 테스트를 다시 실행합니다. 이는 간헐적인 경합 상황에 도움이 될 수 있지만, 재시도 예산 내에서 복구된 실패는 체크를 성공으로 만들고 flaky-rerun 추적기에 실패로 기록되지 않습니다. flaky 테스트 스위트를 덮기 위해 재시도를 사용하기보다 예산을 낮게 유지하십시오. 두 변수 모두 리터럴 값 off를 받을 수 있으며, 이 경우 --retry=0을 전달하는 대신 --retry 플래그 자체를 생략합니다(--retry=0은 워크스페이스 자체의 Vitest 설정보다 우선하여 의도적인 재시도 정책을 비활성화할 수 있습니다).

워크스페이스 테스트 타임아웃

QWEN_RELEASE_WORKSPACE_TIMEOUT_MINUTES는 릴리스 파이프라인의 세 개 workspace_tests 샤드 각각에 대한 잡 레벨 timeout-minutes를 설정합니다. 이 타임아웃은 테스트 스위트 자체가 아니라 예약된 호스트의 부하 정도에 따라 크기를 결정하므로, 테스트 회귀를 가정하기보다 호스트에 경합이 있을 때 값을 올리십시오.

자체 호스팅 runner의 Vitest worker cap

QWEN_CI_VITEST_MAX_WORKERS는 아래 나열된 단계에서 Vitest 프로세스 수를 제한합니다(VITEST_MAX_THREADS / VITEST_MAX_FORKS, 대응되는 최솟값은 1로 강제됨). 이름이 ecs-qwen-으로 시작하는 예약된 자체 호스팅 runner에 적용됩니다. 이 변수는 메인 CI 워크스페이스 테스트 단계와 릴리스의 workspace_tests 및 quality_scripts 단계에서만 내보내집니다. CI 및 릴리스 워크플로에서 동일한 예약된 풀을 사용하는 다른 Vitest 통합 테스트는 이 변수를 사용하지 않고 자체 Vitest 제한을 사용합니다. web-shell E2E 스모크 테스트는 ubuntu-latest로 고정되어 있으므로 이 cap이 적용되지 않습니다. GitHub 호스팅 runner에서는 이 변수가 무시되고 Vitest가 자체 기본값을 사용합니다.

테스트 실행 외의 관련 변수

release.yml은 또한 QWEN_RELEASE_STATIC_TIMEOUT_MINUTES(기본값 60, quality_static lint 레인 제어)와 QWEN_RELEASE_BUILD_TIMEOUT_MINUTES(기본값 45, quality_build 패키징 레인 제어)를 노출합니다. 이 변수들은 테스트 실행이 아닌 정적 린팅 및 아티팩트 빌드를 제어하므로 이 페이지의 테스트 실행 범위 밖에 있습니다.