일부 테스트는 특정 환경이나 특정 파이프라인 또는 job에서 실행되도록 설계됩니다. only와 except 메타데이터로 테스트 실행 컨텍스트를 지정할 수 있습니다.

사용 가능한 스위치#

예시#

Only#

지정한 컨텍스트에서만 테스트를 실행합니다.

매칭 방식은 다음과 같습니다.

• 환경에는 정규식을 사용합니다.
• 파이프라인에는 문자열 매칭을 사용합니다.
• job에는 정규식 또는 문자열 매칭을 사용합니다
• 일반 조건에는 람다 또는 참·거짓 값을 사용합니다

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#

지정한 컨텍스트를 제외한 일반적인 컨텍스트에서 테스트를 실행합니다.

매칭 방식은 다음과 같습니다.

• 환경에는 정규식을 사용합니다.
• 파이프라인에는 문자열 매칭을 사용합니다.
• job에는 정규식 또는 문자열 매칭을 사용합니다
• 일반 조건에는 람다 또는 참·거짓 값을 사용합니다

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을 대상으로 실행할 때만 테스트를 격리합니다.

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