gitlab-org--gitlab-foss/qa
Rémy Coutable 65faebb955 Merge branch 'qa/gb/rspec-decouple-test-instance-address' into 'master'
Decouple QA test subject's address from Capybara/RSpec

Closes gitlab-qa#88

See merge request gitlab-org/gitlab-ce!15310
2017-11-10 12:50:49 +00:00
..
bin Fix bootable scenario arguments for OptionParser 2017-11-10 11:11:22 +00:00
qa Fix bootable scenario arguments for OptionParser 2017-11-10 11:11:22 +00:00
spec Refactor QA specs runners and improve specs 2017-11-10 09:57:47 +01:00
.gitignore Make it possible to define global scenario attributes 2017-11-09 11:53:57 +00:00
.rspec
Dockerfile Use latest chrome and chrome driver in GitLab QA 2017-06-27 12:13:05 +02:00
Gemfile Add byebug to GitLab QA gem list for debugging 2017-10-03 22:42:49 -07:00
Gemfile.lock Update QA Nokogiri to 1.8.1 2017-10-05 11:54:05 +02:00
qa.rb Make it possible to define global scenario attributes 2017-11-09 11:53:57 +00:00
README.md Use the default password from the GDK's root user 2017-10-05 12:37:16 +02:00

GitLab QA - Integration tests for GitLab

This directory contains integration tests for GitLab.

It is part of the GitLab QA project.

What is it?

GitLab QA is an integration tests suite for GitLab.

These are black-box and entirely click-driven integration tests you can run against any existing instance.

How does it work?

  1. When we release a new version of GitLab, we build a Docker images for it.
  2. Along with GitLab Docker Images we also build and publish GitLab QA images.
  3. GitLab QA project uses these images to execute integration tests.

How can I use it?

You can use GitLab QA to exercise tests on any live instance! For example, the following call would login to a local GDK instance and run all specs in qa/specs/features:

bin/qa Test::Instance http://localhost:3000

Running specific tests

You can also supply specific tests to run as another parameter. For example, to test the EE license specs, you can run:

EE_LICENSE="<YOUR LICENSE KEY>" bin/qa Test::Instance http://localhost qa/ee

Overriding the authenticated user

Unless told otherwise, the QA tests will run as the default root user seeded by the GDK.

If you need to authenticate as a different user, you can provide the GITLAB_USERNAME and GITLAB_PASSWORD environment variables:

GITLAB_USERNAME=jsmith GITLAB_PASSWORD=password bin/qa Test::Instance https://gitlab.example.com

All supported environment variables are here.