실행 컨텍스트 선택

일부 테스트는 특정 환경이나 특정 파이프라인 또는 작업에서 실행되도록 설계되어 있습니다. onlyexcept 메타데이터를 사용하여 테스트 실행 컨텍스트를 지정할 수 있습니다.

사용 가능한 스위치

스위치 기능 유형
tld 최상위 도메인 매처 설정 String
subdomain 서브도메인 매처 설정 Array 또는 String
domain 도메인 매처 설정 String
production 프로덕션 환경 매칭 Static
pipeline 파이프라인 매칭 Array 또는 Static
job 작업 매칭 Array 또는 Static

경고: production{ <switch>: 'value' }를 동시에 지정할 수 없습니다. 이러한 옵션은 상호 배타적입니다. 프로덕션을 지정하려면, tlddomain을 독립적으로 제어할 수 있습니다.

예제

Only

지정된 컨텍스트에서만 테스트 실행

일치 사용:

  • 환경에 대한 정규식.
  • 파이프라인에 대한 문자열 일치.
  • 작업에 대한 정규식 또는 문자열 일치
  • 람다 또는 범용 조건에 대한 진리/거짓 값
테스트 실행 컨텍스트 일치
gitlab.com only: :production gitlab.com
staging.gitlab.com only: { subdomain: :staging } (staging).+.com
gitlab.com and staging.gitlab.com only: { subdomain: /(staging.)?/, domain: 'gitlab' } (staging.)?gitlab.com
dev.gitlab.org only: { tld: '.org', domain: 'gitlab', subdomain: 'dev' } (dev).gitlab.org
staging.gitlab.com and domain.gitlab.com only: { subdomain: %i[staging domain] } (staging\|domain).+.com
nightly 파이프라인 only: { pipeline: :nightly } “nightly scheduled pipeline”
nightlycanary 파이프라인 only: { pipeline: [:nightly, :canary] } “nightly scheduled pipeline”“canary”
ee:instance 작업 only: { job: 'ee:instance' } 어떤 파이프라인에서든 ee:instance 작업
임의의 quarantine 작업 only: { job: '.*quarantine' } 어떤 파이프라인의 quarantine으로 끝나는 임의의 작업
로컬 개발 환경 only: :local Runtime::Env.running_in_ci?이 false인 임의의 환경
조건을 만족하는 경우에만 실행 only: { condition: -> { ENV['TEST_ENV'] == 'true' } } TEST_ENV가 true로 설정된 임의의 실행
RSpec.describe 'Area' do
  it 'runs in any environment or pipeline' do; end
  it 'runs only in production environment', only: :production do; end

  it 'runs only in staging environment', only: { subdomain: :staging } do; end

  it 'runs in dev environment', only: { tld: '.org', domain: 'gitlab', subdomain: 'dev' } do; end

  it 'runs in prod and staging environments', only: { subdomain: /(staging.)?/, domain: 'gitlab' } {}

  it 'runs only in nightly pipeline', only: { pipeline: :nightly } do; end

  it 'runs in nightly and canary pipelines', only: { pipeline: [:nightly, :canary] } do; end

  it 'runs in specific environment matching condition', only: { condition: -> { ENV['TEST_ENV'] == 'true' } } do; end
end

Except

지정된 것을 제외한 일반적인 컨텍스트에서 테스트 실행

일치 사용:

  • 환경에 대한 정규식.
  • 파이프라인에 대한 문자열 일치.
  • 작업에 대한 정규식 또는 문자열 일치
  • 람다 또는 범용 조건에 대한 진리/거짓 값
테스트 실행 컨텍스트 일치
gitlab.com except: :production gitlab.com
staging.gitlab.com except: { subdomain: :staging } (staging).+.com
gitlab.com and staging.gitlab.com except: { subdomain: /(staging.)?/, domain: 'gitlab' } (staging.)?gitlab.com
dev.gitlab.org except: { tld: '.org', domain: 'gitlab', subdomain: 'dev' } (dev).gitlab.org
staging.gitlab.com and domain.gitlab.com except: { subdomain: %i[staging domain] } (staging\|domain).+.com
nightly 파이프라인 only: { pipeline: :nightly } “nightly scheduled pipeline”
nightlycanary 파이프라인 only: { pipeline: [:nightly, :canary] } “nightly scheduled pipeline”“canary”
ee:instance 작업 except: { job: 'ee:instance' } 어떤 파이프라인에서든 ee:instance 작업
임의의 quarantine 작업 except: { job: '.*quarantine' } 어떤 파이프라인의 quarantine으로 끝나는 임의의 작업
조건을 만족하지 않는 경우에만 실행 except: { condition: -> { ENV['TEST_ENV'] == 'true' } } TEST_ENV가 true로 설정되지 않은 임의의 실행
RSpec.describe 'Area' do
  it 'runs in any execution context except the production environment', except: :production do; end

  it 'runs in any execution context except the staging environment', except: { subdomain: :staging } do; end

  it 'runs in any execution context except the nightly pipeline', except: { pipeline: :nightly } do; end

  it 'runs in any execution context except the ee:instance job', except: { job: 'ee:instance' } do; end

  it 'runs in specific environment not matching condition', except: { condition: -> { ENV['TEST_ENV'] == 'true' } } do; end
end

사용법 노트

테스트에 before 또는 after 블록이 있는 경우, 외부 RSpec.describe 블록에 only 또는 except 메타데이터를 추가해야 합니다.

로컬 GitLab 인스턴스에서 only로 태그된 테스트를 실행하려면 다음 중 하나를 할 수 있습니다:

  • CI_PROJECT_NAME 또는 CI_JOB_NAME 환경 변수가 설정되어 있지 않도록 확인합니다.
  • 메타데이터가 only: { pipeline: :nightly }인 경우 CI_PROJECT_NAME=nightly으로 설정합니다. 메타데이터가 only: { job: 'ee:instance' }인 경우 CI_JOB_NAME=ee:instance으로 설정합니다.
  • 메타데이터를 임시로 제거합니다.

로컬에서 except로 태그된 테스트를 실행하려면 다음 중 하나를 할 수 있습니다:

  • CI_PROJECT_NAME 또는 CI_JOB_NAME 환경 변수가 설정되어 있지 않도록 확인합니다.
  • 메타데이터를 임시로 제거합니다.

특정 환경에 대한 테스트 격리하기

특정 환경에 대해 테스트를 실행해야 할 때와 같이, 해당 환경에서 테스트를 격리하는 것도 가능합니다. 구문은 동일하지만 only: { ... } 해시가 quarantine: { ... } 해시에 중첩됩니다. 예를 들어, quarantine: { only: { subdomain: :staging } }staging에서 실행될 때에만 해당 테스트를 격리합니다.

DISABLE_QUARANTINE 환경 변수로 격리 기능을 명시적으로 비활성화할 수 있습니다. 이는 로컬에서 테스트를 실행할 때 유용할 수 있습니다.