Test Impact Analysis for Ruby

이 페이지는 아직 한국어로 제공되지 않으며 번역 작업 중입니다. 번역에 관한 질문이나 의견이 있으시면 언제든지 저희에게 연락해 주십시오.

Compatibility

Test Impact Analysis is only supported in the following versions and testing frameworks:

  • datadog-ci >= 1.0
  • Ruby >= 2.7
    • JRuby is not supported.
  • rspec >= 3.0.0
  • minitest >= 5.0.0
  • cucumber >= 3.0.0

Setup

Test Optimization

Prior to setting up Test Impact Analysis, set up Test Optimization for Ruby. If you are reporting data through the Agent, use v6.40 and later or v7.40 and later.

테스트 서비스를 위한 Intelligent Test Runner 활성화

Intelligent Test Runner Activation (intelligent_test_runner_activation_write) 권한이 있는 조직의 사용자는 Test Service Settings 페이지에서 Intelligent Test Runner를 활성화해야 합니다.

Intelligent test runner enabled in test service settings in the CI section of Datadog.

Run tests with Test Impact Analysis enabled

    After completing setup, run your tests as you normally do:

    DD_ENV=ci DD_SERVICE=my-app bundle exec rake test

    After completing setup, run your tests as you normally do:

    DD_ENV=ci DD_SERVICE=my-app DD_CIVISIBILITY_AGENTLESS_ENABLED=true DD_API_KEY=$DD_API_KEY bundle exec rake test

    Disabling skipping for specific tests

    You can override the Test Impact Analysis’s behavior and prevent specific tests from being skipped. These tests are referred to as unskippable tests.

    Why make tests unskippable?

    Test Impact Analysis uses code coverage data to determine whether or not tests should be skipped. In some cases, this data may not be sufficient to make this determination.

    Examples include:

    • Tests that read data from text files
    • Tests that interact with APIs outside of the code being tested (such as remote REST APIs)
    • Tests that run external processes
    • Tests that depend on global shared state (for example, caches created by a different test or process)
    • Tests that use forked processes (per test code coverage only collects coverage for the main process)
    • Integration tests that use capybara or selenium-webdriver

    Designating tests as unskippable ensures that Test Impact Analysis runs them regardless of coverage data.

    Marking tests as unskippable

      To ensure that RSpec tests within a specific block are not skipped, add the metadata key datadog_itr_unskippable with the value true to any describe, context, or it block. This marks all tests in that block as unskippable.

      # mark the whole file as unskippable
RSpec.describe MyClass, datadog_itr_unskippable: true do
  describe "#my_method" do
    context "when called without arguments" do
      it "works" do
      end
    end
  end
end

# mark one test as unskippable
RSpec.describe MyClass do
  describe "#my_method" do
    context "when called without arguments" do
      it "works", datadog_itr_unskippable: true do
      end
    end
  end
end

# mark specific block as unskippable
RSpec.describe MyClass do
  describe "#my_method", datadog_itr_unskippable: true do
    context "when called without arguments" do
      it "works" do
      end
    end
  end
end

      To mark an entire feature file as unskippable in Cucumber, use the @datadog_itr_unskippable tag. This prevents Test Impact Analysis from skipping any of the scenarios defined in that feature file.

      To make only specific scenarios unskippable, apply this tag directly to the desired scenario.

      @datadog_itr_unskippable
Feature: Unskippable feature
  Scenario: Say greetings
    When the greeter says greetings
    Then I should have heard "greetings"

Feature: An unskippable scenario

  @datadog_itr_unskippable
  Scenario: Unskippable scenario
    When the ITR wants to skip this scenario
    Then it will never be skipped

  Scenario: Skippable scenario
    When the ITR wants to skip this scenario
    Then it will be skipped

      To make an entire Minitest subclass unskippable, use the datadog_itr_unskippable method. If you want to mark specific tests within the subclass as unskippable, provide the names of these test methods as arguments to the datadog_itr_unskippable method call.

      # mark the whole class unskippable
class MyTest < Minitest::Test
  datadog_itr_unskippable

  def test_my_method
  end
end

# here only test1 and test2 are unskippab;e
class MyTest < Minitest::Test
  datadog_itr_unskippable "test1", "test2"

  def test1
  end

  def test2
  end

  def test3
  end
end

      Temporarily disabling Test Impact Analysis

      Test Impact Analysis can be disabled locally by setting the DD_CIVISIBILITY_ITR_ENABLED environment variable to false or 0.

      DD_CIVISIBILITY_ITR_ENABLED (Optional)
      Enable the Test Impact Analysis coverage and test skipping features
      Default: (true)

      Further Reading

      추가 유용한 문서, 링크 및 기사:

      Explore Test Results and PerformanceDOCUMENTATION more more Troubleshooting CI VisibilityDOCUMENTATION more more