gitlab-qa 15.6.0 → 15.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b800bf0843ad8f6c636de6f83713ed9c6c631d90d4140ce14670e88af7228be9
-  data.tar.gz: 90b75c71cd03df92f810505e5f1c920845f482d508aff47fdd9a40041cfe9521
+  metadata.gz: 283e2b2d77e4f2a18d03c454e268b88d4bcaba6662086efe37f2045fd5a2efca
+  data.tar.gz: a7ca80f1ba2e9244c7b6046d47e5b154278fe062774583e8874f1da6956890e7
 SHA512:
-  metadata.gz: 6b73f4e3a80917e77422b1a49ce6e2c2ea6525d9c5bc6ceac42495e781baa555ba2b96b2f22bee9bef7eeaa5def8053758ae71ee762bba046674a75015e2d06e
-  data.tar.gz: ef66c9ed5786f1cc3bc2d31b6b75929c94a3737ed1af492b5d73992c2f0fa63f08d5726da3c69ba6485f8892c7e8b0b0c9d61ceedbdf655b30a4fc3fafcd56f1
+  metadata.gz: 77c08d80779857be0baf10a0e1690d8c96e6c107a467f7005ec1f4714ffda321e54a1bab4713a79e52570d9403e8bde33ba7b9b74c135d009a2df590cc904322
+  data.tar.gz: b70bc89223d607c828ecacc91b3d433f9a38a420929ca95a97d0a6574618c921e457ca58164353b30574e3a6eb7165cc3a4a6623e45d6672ef178b0a0bc795e6

data/Gemfile.lock

@@ -1,8 +1,8 @@
 PATH
   remote: .
   specs:
-    gitlab-qa (15.6.0)
-      activesupport (>= 6.1, < 7.2)
+    gitlab-qa (15.7.1)
+      activesupport (>= 6.1, < 8)
       ffi (~> 1.17)
       gitlab (~> 4.19)
       http (~> 5.0)
@@ -15,23 +15,24 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (7.1.2)
+    activesupport (7.2.1.2)
       base64
       bigdecimal
-      concurrent-ruby (~> 1.0, >= 1.0.2)
+      concurrent-ruby (~> 1.0, >= 1.3.1)
       connection_pool (>= 2.2.5)
       drb
       i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
       minitest (>= 5.1)
-      mutex_m
-      tzinfo (~> 2.0)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
     addressable (2.8.1)
       public_suffix (>= 2.0.2, < 6.0)
     ast (2.4.2)
     backport (1.2.0)
-    base64 (0.2.0)
+    base64 (0.3.0)
     benchmark (0.2.0)
-    bigdecimal (3.1.5)
+    bigdecimal (3.3.1)
     byebug (11.1.3)
     claide (1.1.0)
     claide-plugins (0.9.2)
@@ -41,8 +42,8 @@ GEM
     climate_control (1.0.1)
     coderay (1.1.3)
     colored2 (3.1.2)
-    concurrent-ruby (1.2.2)
-    connection_pool (2.4.1)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.4)
     cork (0.3.0)
       colored2 (~> 3.1)
     crack (0.4.5)
@@ -67,8 +68,7 @@ GEM
     docile (1.4.0)
     domain_name (0.5.20190701)
       unf (>= 0.0.5, < 1.0.0)
-    drb (2.2.0)
-      ruby2_keywords
+    drb (2.2.3)
     e2mmap (0.1.0)
     faraday (1.10.2)
       faraday-em_http (~> 1.0)
@@ -126,7 +126,7 @@ GEM
     httparty (0.20.0)
       mime-types (~> 3.0)
       multi_xml (>= 0.5.2)
-    i18n (1.14.1)
+    i18n (1.14.7)
       concurrent-ruby (~> 1.0)
     jaro_winkler (1.5.6)
     json (2.6.3)
@@ -138,15 +138,15 @@ GEM
     llhttp-ffi (0.4.0)
       ffi-compiler (~> 1.0)
       rake (~> 13.0)
+    logger (1.7.0)
     method_source (1.0.0)
     mime-types (3.4.1)
       mime-types-data (~> 3.2015)
     mime-types-data (3.2022.0105)
     mini_portile2 (2.8.0)
-    minitest (5.21.1)
+    minitest (5.26.1)
     multi_xml (0.6.0)
     multipart-post (2.2.3)
-    mutex_m (0.2.0)
     nap (1.1.0)
     no_proxy_fix (0.1.2)
     nokogiri (1.13.9)
@@ -223,6 +223,7 @@ GEM
     sawyer (0.9.2)
       addressable (>= 2.3.5)
       faraday (>= 0.17.3, < 3)
+    securerandom (0.4.1)
     simplecov (0.22.0)
       docile (~> 1.1)
       simplecov-html (~> 0.11)

data/gitlab-qa.gemspec

@@ -36,7 +36,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'timecop', '~> 0.9.5'
   spec.add_development_dependency 'webmock', '3.7.0'
 
-  spec.add_runtime_dependency 'activesupport', '>= 6.1', '< 7.2'
+  spec.add_runtime_dependency 'activesupport', '>= 6.1', '< 8'
   spec.add_runtime_dependency 'ffi', '~> 1.17'
   spec.add_runtime_dependency 'gitlab', '~> 4.19'
   spec.add_runtime_dependency 'http', '~> 5.0'

data/lib/gitlab/qa/runtime/env.rb

@@ -46,6 +46,7 @@ module Gitlab
           'CI_PROJECT_DIR' => :ci_project_dir,
           'CI_RUNNER_ID' => :ci_runner_id,
           'CI_SERVER_HOST' => :ci_server_host,
+          'CI_SERVER_URL' => :ci_server_url,
           'CI_SERVER_PERSONAL_ACCESS_TOKEN' => :ci_server_personal_access_token,
           'COLORIZED_LOGS' => :colorized_logs,
           'CLOUDSDK_CORE_PROJECT' => :cloudsdk_core_project,

data/lib/gitlab/qa/support/gitlab_version_info.rb

@@ -24,6 +24,15 @@ module Gitlab
         # @param [String] semver_component version number component for previous version detection - major|minor|patch
         # @return [Gem::Version]
         def previous_version(semver_component)
+          # Check for environment variable override
+          override_key = "QA_PREVIOUS_#{semver_component.upcase}_OVERRIDE"
+          override_value = ENV.fetch(override_key, nil)
+
+          if override_value && !override_value.empty?
+            logger.info("Using override for previous #{semver_component}: #{override_value}")
+            return Gem::Version.new(override_value)
+          end
+
           case semver_component
           when "major"
             previous_major
@@ -60,7 +69,10 @@ module Gitlab
           # check if version is already a patch version
           return version if version.to_s.split('.').size == 3
 
-          versions.find { |ver| ver.to_s.match?(/^#{version}\./) }.tap do |ver|
+          result = versions.find { |ver| ver.to_s.match?(/^#{version}\./) }
+          result ||= handle_latest_patch_prerelease_fallback(version) if current_version.include?('-pre')
+
+          result.tap do |ver|
             raise_version_not_found("Latest patch version for version #{version}") unless ver
           end
         end
@@ -88,6 +100,49 @@ module Gitlab
 
         private
 
+        def handle_latest_patch_prerelease_fallback(version)
+          return unless version.to_s.match?(/^\d+$/)
+
+          log_fallback_info("major", version.to_s)
+
+          fallback_major = version.segments[0] - 1
+          return unless fallback_major.positive?
+
+          result = versions.find { |ver| ver.to_s.match?(/^#{fallback_major}\./) }
+          logger.warn("🔄 Using fallback major version: #{result}") if result
+          result
+        end
+
+        def find_previous_minor_version
+          target_minor = current_minor - 1
+          result = versions.find { |version| version.to_s.match?(/^#{current_major}\.#{target_minor}/) }
+
+          return result if result
+          return unless current_version.include?('-pre')
+
+          find_previous_minor_prerelease_fallback(target_minor)
+        end
+
+        def find_previous_minor_prerelease_fallback(target_minor)
+          log_fallback_info("minor", "#{current_major}.#{target_minor}")
+
+          result = find_fallback_minor_version(target_minor)
+          return result if result
+
+          result = previous_major
+          logger.warn("🔄 Falling back to previous major version: #{result}") if result
+          result
+        end
+
+        def find_fallback_minor_version(target_minor)
+          fallback_minor_version = target_minor - 1
+          return unless fallback_minor_version >= 0
+
+          result = versions.find { |version| version.to_s.match?(/^#{current_major}\.#{fallback_minor_version}/) }
+          logger.warn("🔄 Using fallback minor version: #{result}") if result
+          result
+        end
+
         MAX_TAGS_HTTP_REQUESTS = 50
         # https://docs.docker.com/docker-hub/api/latest/#tag/images/operation/GetNamespacesRepositoriesImages
         TAGS_PER_PAGE = 100
@@ -138,7 +193,8 @@ module Gitlab
           return fallback_minor unless tags
           return previous_major if current_minor.zero?
 
-          versions.find { |version| version.to_s.match?(/^#{current_major}\.#{current_minor - 1}/) }.tap do |ver|
+          result = find_previous_minor_version
+          result.tap do |ver|
             raise_version_not_found("Previous minor version for current version #{current_version}") unless ver
           end
         end
@@ -242,7 +298,105 @@ module Gitlab
         end
 
         def raise_version_not_found(error_prefix)
-          raise(VersionNotFoundError, "#{error_prefix} not available on Dockerhub (yet)")
+          error_message = build_detailed_error_message(error_prefix)
+          raise(VersionNotFoundError, error_message)
+        end
+
+        # Build a detailed, helpful error message for version not found scenarios
+        def build_detailed_error_message(error_prefix)
+          separator = "=" * 80
+
+          message = <<~ERROR
+
+            #{separator}
+            🚨 GITLAB QA VERSION DETECTION ERROR 🚨
+            #{separator}
+
+            #{error_prefix} not available on Dockerhub (yet)
+
+            CONTEXT:
+            • Current version: #{current_version}
+            • Looking for: #{describe_missing_version}
+            • This typically happens during GitLab's monthly release cycle
+
+            WHY THIS HAPPENS:
+            During the 1-day window between VERSION file updates and actual release:
+            1. VERSION file gets updated to next version (e.g., 18.9.0-pre)
+            2. Upgrade tests look for previous version (e.g., 18.8.x)
+            3. But that version hasn't been released to Docker Hub yet
+
+            SOLUTIONS:
+            1. WAIT: This will resolve automatically after the release (usually within 24 hours)
+            2. OVERRIDE: Set environment variable to use a known version:
+               #{suggest_override_variable}
+            3. SKIP: Temporarily disable these upgrade tests during pre-release periods
+            4. VERIFY: Check available versions on Docker Hub:
+               https://hub.docker.com/r/gitlab/gitlab-#{edition}/tags
+
+            MORE INFO:
+            • Documentation: https://docs.gitlab.com/ee/development/testing_guide/end_to_end/
+            • Release schedule: https://about.gitlab.com/releases/
+            • Report issues: https://gitlab.com/gitlab-org/gitlab-qa/-/issues
+
+            #{separator}
+          ERROR
+
+          message.strip
+        end
+
+        # Describe what version we're looking for based on current context
+        def describe_missing_version
+          if current_version.include?('-pre')
+            if current_minor.positive?
+              "#{current_major}.#{current_minor - 1}.x versions (previous minor)"
+            else
+              "#{current_major - 1}.x.x versions (previous major)"
+            end
+          else
+            "Previous version for #{current_version}"
+          end
+        end
+
+        # Suggest appropriate override environment variable
+        def suggest_override_variable
+          if current_version.include?('-pre')
+            if current_minor.positive?
+              suggested_version = "#{current_major}.#{current_minor - 1}.0"
+              "export QA_PREVIOUS_MINOR_OVERRIDE=#{suggested_version}"
+            else
+              suggested_version = "#{current_major - 1}.12.0"
+              "export QA_PREVIOUS_MAJOR_OVERRIDE=#{suggested_version}"
+            end
+          else
+            "export QA_PREVIOUS_MINOR_OVERRIDE=<version>"
+          end
+        end
+
+        # Log helpful information when using fallback logic
+        def log_fallback_info(upgrade_type, missing_version)
+          separator = "-" * 60
+
+          logger.warn(<<~WARNING.strip)
+            #{separator}
+            🚨 PRE-RELEASE VERSION FALLBACK ACTIVATED
+            #{separator}
+
+            Target #{upgrade_type} version #{missing_version} not found for pre-release #{current_version}
+
+            This is NORMAL during GitLab's monthly release cycle!
+
+            • Reason: #{missing_version} hasn't been released to Docker Hub yet
+            • Action: Falling back to older available version
+            • Impact: Tests will run against older version (still valid)
+
+            To override this behavior, set:
+            #{suggest_override_variable}
+
+            Or check available versions:
+            https://hub.docker.com/r/gitlab/gitlab-#{edition}/tags
+
+            #{separator}
+          WARNING
         end
       end
     end

data/lib/gitlab/qa/version.rb

@@ -2,6 +2,6 @@
 
 module Gitlab
   module QA
-    VERSION = '15.6.0'
+    VERSION = '15.7.1'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitlab-qa
 version: !ruby/object:Gem::Version
-  version: 15.6.0
+  version: 15.7.1
 platform: ruby
 authors:
 - GitLab Quality
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-10-28 00:00:00.000000000 Z
+date: 2026-01-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: climate_control
@@ -201,7 +201,7 @@ dependencies:
         version: '6.1'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '7.2'
+        version: '8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -211,7 +211,7 @@ dependencies:
         version: '6.1'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '7.2'
+        version: '8'
 - !ruby/object:Gem::Dependency
   name: ffi
   requirement: !ruby/object:Gem::Requirement