gitlab-qa 2.10.1 → 2.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a981ec97a4a08163435c08feb00b34fb32c787774f57b9ef1f720e7de88545ee
-  data.tar.gz: 4f6d6779f9a5bf70848861f65b1f2be6389a6ef0778089174876796726c11b17
+  metadata.gz: fbdc07d475c334682d19f722cc53a23ecc9e701e0faf1e44d17d6177649ea97a
+  data.tar.gz: 3d6dd8396cae8b7ed3ebe0a54143b024651baf8eb2e9c3664607933a33bf9299
 SHA512:
-  metadata.gz: '0239d4c312308f526e6b2e34267c4170350cb59e7f3b830576b7860bbe904bccb57249b6531fc7df9a1eb7fd73687b0b84c54895413636d01a578533fbeb1f26'
-  data.tar.gz: 6430539d6ec3f6cbcbbba26bd33ac56bddc894defe7fbbd6d5f20a76b1c6037824de639a0a764a2c6a9b9706d72e3429c2aee3f1475b933635750416f64ef687
+  metadata.gz: b3f1b8e302f00c3f01d7d0aa98d8b2ede1e35205b3e7ee30db30defbe5d2dee8f9e43d1123a0bf8a54300ddfc14ab5f260ae7e0354dbf309ff94ccc90b4bf108
+  data.tar.gz: 578b24ccbc63f39637a7b00d26ba05bd5de70bc48516253d9e195bfa43c1d6b1be1e913b3aa2f67d6b7bf63168b8c67a3e669e681875ca450c73a523f48ab6c1

data/.gitlab-ci.yml

@@ -272,3 +272,20 @@ notify_upstream_commit:failure:
   script:
     - bin/notify_upstream_commit failure
   when: on_failure
+
+.notify_slack: &notify_slack
+  image: alpine
+  stage: notify
+  dependencies: []
+  cache: {}
+  before_script:
+    - apk update && apk add git curl bash
+  only:
+    variables:
+      - $TOP_UPSTREAM_SOURCE_JOB
+
+notify_slack:
+  <<: *notify_slack
+  script:
+    - bin/slack quality-alerts "☠️ Pipeline on \`$CI_BUILD_REF_NAME\` failed! ☠️ Commit \`$(git log -1 --oneline | sed 's|\"|\\\\\"|g')\` See $CI_PIPELINE_URL (triggered from $TOP_UPSTREAM_SOURCE_JOB)" ci_failing
+  when: on_failure

data/bin/slack

@@ -0,0 +1,14 @@
+#!/bin/bash
+# Sends Slack notification MSG to CI_SLACK_WEBHOOK_URL (which needs to be set).
+# ICON_EMOJI needs to be set to an icon emoji name (without the `:` around it).
+
+CHANNEL=$1
+MSG=$2
+ICON_EMOJI=$3
+
+if [ -z "$CHANNEL" ] || [ -z "$CI_SLACK_WEBHOOK_URL" ] || [ -z "$MSG" ] || [ -z "$ICON_EMOJI" ]; then
+    echo "Missing argument(s) - Use: $0 channel message icon_emoji"
+    echo "and set CI_SLACK_WEBHOOK_URL environment variable."
+else
+    curl -X POST --data-urlencode 'payload={"channel": "#'"$CHANNEL"'", "username": "GitLab QA Bot", "text": "'"$MSG"'", "icon_emoji": "'":$ICON_EMOJI:"'"}' "$CI_SLACK_WEBHOOK_URL"
+fi

data/docs/run_qa_against_gdk.md

@@ -11,7 +11,7 @@ make a few changes to your `gdk/gitlab/config/gitlab.yml` file.
 1. Enable the `sshd` service by uncommenting the relevant line in your
    `Procfile`.
 1. Edit `openssh/sshd_config` and
-   - set `ListenAddress` to `192.168.0.12`
+   - set `ListenAddress` to `192.168.0.12:2222`
    - add `AcceptEnv GIT_PROTOCOL` to allow use of [Git protocol v2][Git protocol]
 1. Restart your GDK
 1. Run the QA scenario as follows:

data/docs/running_against_remote_grid.md

@@ -0,0 +1,27 @@
+# Run QA tests against a remote Selenium grid
+
+The QA tests have the ability to be run against a local or remote grid.
+
+I.e, if you have a Selenium server set up at http://localhost:4444 or if you have a SauceLabs / BrowserStack account.
+
+## Variables
+
+| Variable                  | Description                                                    | Default  | Example(s)                     |
+|---------------------------|----------------------------------------------------------------|----------|--------------------------------|
+| QA_BROWSER                | Browser to run against                                         | "chrome" | "chrome" "firefox"             |
+| 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_ACCESS_KEY | Key/Token paired with `QA_REMOTE_GRID_USERNAME`                |          |                                |
+
+## Examples
+
+*Run QA Smoke Tests against firefox on SauceLabs*
+
+```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
+```

data/docs/what_tests_can_be_run.md

@@ -26,7 +26,7 @@ our Omnibus package works, can be updated / upgraded to EE etc.).
 For more details on the internals, please read the
 [How it works](./how_it_works.md) documentation.
 
-## Supported environment variables
+## Supported GitLab environment variables
 
 * `GITLAB_USERNAME` - username to use when signing into GitLab
 * `GITLAB_PASSWORD` - password to use when signing into GitLab
@@ -51,6 +51,10 @@ For more details on the internals, please read the
 * `QA_LOG_PATH` - path to output debug logging to. If not set logging will be output to STDOUT
 * `QA_CAN_TEST_GIT_PROTOCOL_V2` - set to `false` to skip tests that require Git protocol v2 if your environment doesn't support it.
 
+## [Supported Remote Grid environment variables](./running_against_remote_grid.md)
+
+## Examples
+
 ### `Test::Instance::Image CE|EE|<full image address>`
 
 This tests that a GitLab Docker container works as expected by running

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

@@ -7,6 +7,11 @@ module Gitlab
         extend self
 
         ENV_VARIABLES = {
+          'QA_REMOTE_GRID' => :remote_grid,
+          'QA_REMOTE_GRID_USERNAME' => :remote_grid_username,
+          'QA_REMOTE_GRID_ACCESS_KEY' => :remote_grid_access_key,
+          'QA_REMOTE_GRID_PROTOCOL' => :remote_grid_protocol,
+          'QA_BROWSER' => :browser,
           'GITLAB_ADMIN_USERNAME' => :admin_username,
           'GITLAB_ADMIN_PASSWORD' => :admin_password,
           'GITLAB_USERNAME' => :user_username,

data/lib/gitlab/qa/version.rb

@@ -1,5 +1,5 @@
 module Gitlab
   module QA
-    VERSION = '2.10.1'.freeze
+    VERSION = '2.11.0'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gitlab-qa
 version: !ruby/object:Gem::Version
-  version: 2.10.1
+  version: 2.11.0
 platform: ruby
 authors:
 - Grzegorz Bizon
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-12-11 00:00:00.000000000 Z
+date: 2019-01-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: climate_control
@@ -133,10 +133,12 @@ files:
 - bin/notify_upstream_commit
 - bin/qa
 - bin/setup
+- bin/slack
 - docs/README.md
 - docs/architecture.md
 - docs/how_it_works.md
 - docs/run_qa_against_gdk.md
+- docs/running_against_remote_grid.md
 - docs/trainings.md
 - docs/waits.md
 - docs/what_tests_can_be_run.md