Class: Gitlab::QA::Component::Specs

Inherits:
Scenario::Template show all
Defined in:
lib/gitlab/qa/component/specs.rb

Overview

This class represents GitLab QA specs image that is implemented in the ‘qa/` directory located in GitLab CE / EE repositories.

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods inherited from Scenario::Template

perform

Constructor Details

#initialize ⇒ Specs

Returns a new instance of Specs.



16
17
18
19
20
21
22
23
24
25
26
27
 
# File 'lib/gitlab/qa/component/specs.rb', line 16

def initialize
  @docker = Docker::Engine.new(stream_output: true) # stream test output directly instead of through logger
  @env = {}
  @volumes = {}
  @additional_hosts = []
  @default_volumes = { '/var/run/docker.sock' => '/var/run/docker.sock' }
  return if Runtime::Env.qa_knapsack_report_path.blank?

  @default_volumes[Runtime::Env.qa_knapsack_report_path] = File.join(
    Docker::Volumes::QA_CONTAINER_WORKDIR, 'knapsack'
  )
end

Instance Attribute Details

#additional_hosts ⇒ Object

Returns the value of attribute additional_hosts.



14
15
16
 
# File 'lib/gitlab/qa/component/specs.rb', line 14

def additional_hosts
  @additional_hosts
end

#args ⇒ Object

Returns the value of attribute args.



14
15
16
 
# File 'lib/gitlab/qa/component/specs.rb', line 14

def args
  @args
end

#env ⇒ Object

Returns the value of attribute env.



14
15
16
 
# File 'lib/gitlab/qa/component/specs.rb', line 14

def env
  @env
end

#hostname ⇒ Object

Returns the value of attribute hostname.



14
15
16
 
# File 'lib/gitlab/qa/component/specs.rb', line 14

def hostname
  @hostname
end

#network ⇒ Object

Returns the value of attribute network.



14
15
16
 
# File 'lib/gitlab/qa/component/specs.rb', line 14

def network
  @network
end

#release ⇒ Object

Returns the value of attribute release.



14
15
16
 
# File 'lib/gitlab/qa/component/specs.rb', line 14

def release
  @release
end

#runner_network ⇒ Object

Returns the value of attribute runner_network.



14
15
16
 
# File 'lib/gitlab/qa/component/specs.rb', line 14

def runner_network
  @runner_network
end

#suite ⇒ Object

Returns the value of attribute suite.



14
15
16
 
# File 'lib/gitlab/qa/component/specs.rb', line 14

def suite
  @suite
end

#volumes ⇒ Object

Returns the value of attribute volumes.



14
15
16
 
# File 'lib/gitlab/qa/component/specs.rb', line 14

def volumes
  @volumes
end

Instance Method Details

#perform ⇒ Object

Raises:

  • (ArgumentError) 


29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
 
# File 'lib/gitlab/qa/component/specs.rb', line 29

def perform
  return Runtime::Logger.info("Skipping tests.") if skip_tests?

  raise ArgumentError unless [suite, release].all?

  docker_pull_qa_image_if_needed

  Runtime::Logger.info("Running test suite `#{suite}` for #{release.project_name}")

  name = "#{release.project_name}-qa-#{SecureRandom.hex(4)}"

  feature_flag_sets = []

  # When `args` includes `[..., "--disable-feature", "a", "--enable-feature", "b", "--set-feature-flags", "c=enable", ...]`
  # `feature_flag_sets` will be set to `[["--disable-feature", "a"], ["--enable-feature", "b"], ["--set-feature-flags", "c=enable"]]`
  # This will result in tests running three times, once with each feature flag option.
  while (index = args&.index { |x| x =~ /--.*-feature/ })
    feature_flag_sets << args.slice!(index, 2)
  end

  # When `args` do not have any feature flag options, we add [] so that test is run exactly once.
  feature_flag_sets << [] unless feature_flag_sets.any?

  feature_flag_sets.each do |feature_flag_set|
    @docker.run(image: qa_image, args: [suite, *args_with_flags(args, feature_flag_set)]) do |command|
      command << "-t --rm --net=#{network || 'bridge'}"

      unless hostname.nil?
        command << "--hostname #{hostname}"
        command.env('QA_HOSTNAME', hostname)
      end

      if Runtime::Env.docker_add_hosts.present? || additional_hosts.present?
        hosts = Runtime::Env.docker_add_hosts.concat(additional_hosts).map { |host| "--add-host=#{host} " }.join
        command << hosts # override /etc/hosts in docker container when test runs
      end

      Runtime::Env.variables.merge(env).each do |key, value|
        command.env(key, value)
      end

      command.volume(
        File.join(Runtime::Env.host_artifacts_dir, name),
        File.join(Docker::Volumes::QA_CONTAINER_WORKDIR, 'tmp')
      )

      volumes.to_h.merge(default_volumes).each { |to, from| command.volume(to, from) }

      command.name(name)
    end
  end
end