gitlab-qa 7.13.2 → 7.13.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b871a70af32053e7d32aee98e213a86bcf4e8d05d69fad97bf8180a0bd618656
-  data.tar.gz: 73d91628111ea86a9e7c13cf1ff11b21e60ed14ba028d722becba4c1df65e606
+  metadata.gz: 8d3ffb02978235a44a7335c81ba6c2e4929e103194f25d496e71b3c2e97d43d2
+  data.tar.gz: 66d345d1c84916c55cedaed33b25074d5cfd6f06eb40f31fa6570cc2425c56dc
 SHA512:
-  metadata.gz: 3cf779ac1691072e13d3e616906200b291ef88f755985ae75ec24cc87e8a176acd9d120a9034011546253d7ea065b07d4b1d6fc45cb4f3d7a12324fbfc81115f
-  data.tar.gz: 56c646ad59e829fe29f3227d5d0bd169d2088d049b02866e9aca2b5ba0471cf335674c2611f97deb8415ff424edbe78159e77e38a245d080e0dd739beae8acd4
+  metadata.gz: 0f2b8e1bec8128104d81d79d2ec5dc86d08d13bd7fa988f44ffe312569875f9d0ab6f864356dfc804c5ba2207ffc05e6260669cbbf19c0ba9e0a9fbb8e8c5fa5
+  data.tar.gz: 8ca3dde5565b4ae744791ff1faec00088a0573102de1545f20c8192f00f08b7dad25f64e34a5c06b1cfbf066d248895926a99adb3260577d1febf16feb417df2

data/docs/running_against_remote_grid.md

@@ -8,20 +8,49 @@ I.e, if you have a Selenium server set up at http://localhost:4444 or if you hav
 
 | Variable                  | Description                                                    | Default  | Example(s)                     |
 |---------------------------|----------------------------------------------------------------|----------|--------------------------------|
-| QA_BROWSER                | Browser to run against                                         | "chrome" | "chrome" "firefox"             |
+| QA_BROWSER                | Browser to run against                                         | "chrome" | "chrome" "firefox" "safari"    |
 | QA_REMOTE_GRID_PROTOCOL   | Protocol to use                                                | "http"   | "http" "https"                 |
 | QA_REMOTE_GRID            | Remote grid to run tests against                               |          | "localhost:3000" "provider:80" |
-| QA_REMOTE_GRID_USERNAME   | Username to specify in the remote grid. "USERNAME@provider:80" |          |                                |
+| QA_REMOTE_GRID_USERNAME   | Username to specify in the remote grid. "USERNAME@provider:80" |          | "gitlab-sl"                    |
 | QA_REMOTE_GRID_ACCESS_KEY | Key/Token paired with `QA_REMOTE_GRID_USERNAME`                |          |                                |
+| QA_REMOTE_TUNNEL_ID       | Name of the remote tunnel to use                               | "gitlab-sl_tunnel_id" |                                |
+| QA_REMOTE_MOBILE_DEVICE_NAME | Name of mobile device to test against. `QA_BROWSER` must be set to `safari` for iOS devices and `chrome` for Android devices.                                                |          | "iPhone 12 Simulator"          |
 
-## Examples
+## Testing with Sauce Labs
 
-*Run QA Smoke Tests against firefox on SauceLabs*
+Running directly against an environment like staging is not recommended because test logs expose credentials. Therefore, it is best practice and the default to use a tunnel.
 
-```bash
-$ QA_BROWSER=firefox \
-  QA_REMOTE_GRID=ondemand.saucelabs.com:80 \
-  QA_REMOTE_GRID_USERNAME=user \
-  QA_REMOTE_GRID_ACCESS_KEY=privatetoken \
-  gitlab-qa Test::Instance::All --tags smoke
+To install a tunnel, follow these [instructions](https://docs.saucelabs.com/secure-connections/sauce-connect/installation). 
+
+To start the tunnel, copy the run command in **Sauce Labs > Tunnels** and run it in the terminal. You must be logged in to Sauce Labs. Use the credentials in 1Password to log in.
+
+It is highly recommended to use `GITLAB_QA_ACCESS_TOKEN` to speed up tests and reduce flakiness.
+
+
+### Run a test in a desktop browser
+
+While tunnel is running, to test against a local instance in a desktop browser, run:
+```shell
+$ QA_BROWSER="safari" \
+  QA_REMOTE_GRID="ondemand.saucelabs.com:80" \
+  QA_REMOTE_GRID_USERNAME="gitlab-sl" \
+  QA_REMOTE_GRID_ACCESS_KEY="<access key found in Sauce Lab account>" \
+  GITLAB_QA_ACCESS_TOKEN="<token>" \
+  gitlab-qa Test::Instance::Any <CE|EE> http://<local_ip>:3000 -- -- <relative_spec_path>
 ```
+
+### Run a test in a mobile device browser
+
+`QA_REMOTE_MOBILE_DEVICE_NAME` can be any device name in the [supported browser devices](https://saucelabs.com/platform/supported-browsers-devices) in the Emulators/simulators list, and the latest versions of Android or iOS. You must set `QA_BROWSER` to `safari` for iOS devices and `chrome` for Android devices.```
+
+```shell
+$ QA_BROWSER="safari" \
+  QA_REMOTE_MOBILE_DEVICE_NAME="iPhone 12 Simulator" \
+  QA_REMOTE_GRID="ondemand.saucelabs.com:80" \
+  QA_REMOTE_GRID_USERNAME="gitlab-sl" \
+  QA_REMOTE_GRID_ACCESS_KEY="<found in Sauce Lab account>" \
+  GITLAB_QA_ACCESS_TOKEN="<token>" \
+  gitlab-qa Test::Instance::Any <CE|EE> http://<local_ip>:3000 -- -- <relative_spec_path>
+```
+
+Results can be watched in real time in Sauce Labs under AUTOMATED > Test Results

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

@@ -15,6 +15,8 @@ module Gitlab
           'QA_REMOTE_GRID_USERNAME' => :remote_grid_username,
           'QA_REMOTE_GRID_ACCESS_KEY' => :remote_grid_access_key,
           'QA_REMOTE_GRID_PROTOCOL' => :remote_grid_protocol,
+          'QA_REMOTE_MOBILE_DEVICE_NAME' => :remote_mobile_device_name,
+          'QA_REMOTE_TUNNEL_ID' => :remote_tunnel_id,
           'QA_BROWSER' => :browser,
           'QA_ADDITIONAL_REPOSITORY_STORAGE' => :qa_additional_repository_storage,
           'QA_PRAEFECT_REPOSITORY_STORAGE' => :qa_praefect_repository_storage,

data/lib/gitlab/qa/runtime/omnibus_configurations/license_mode.rb

@@ -7,7 +7,7 @@ module Gitlab
         class LicenseMode < Default
           def configuration
             <<~OMNIBUS
-              gitlab_rails['env'] = { 'GITLAB_LICENSE_MODE' => 'test', 'CUSTOMER_PORTAL_URL' => 'https://customers.stg.gitlab.com' }
+              gitlab_rails['env'] = { 'GITLAB_LICENSE_MODE' => 'test', 'CUSTOMER_PORTAL_URL' => 'https://customers.staging.gitlab.com' }
             OMNIBUS
           end
         end

data/lib/gitlab/qa/version.rb

@@ -1,5 +1,5 @@
 module Gitlab
   module QA
-    VERSION = '7.13.2'.freeze
+    VERSION = '7.13.3'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitlab-qa
 version: !ruby/object:Gem::Version
-  version: 7.13.2
+  version: 7.13.3
 platform: ruby
 authors:
 - GitLab Quality
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-10-29 00:00:00.000000000 Z
+date: 2021-11-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: climate_control