From 7ebcead8cfd2edb810dd0cbda816b6cfbd170fe3 Mon Sep 17 00:00:00 2001 From: GitLab Bot Date: Mon, 9 Mar 2020 18:07:59 +0000 Subject: Add latest changes from gitlab-org/gitlab@master --- .../testing_guide/end_to_end/rspec_metadata_tests.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 doc/development/testing_guide/end_to_end/rspec_metadata_tests.md (limited to 'doc/development/testing_guide/end_to_end/rspec_metadata_tests.md') diff --git a/doc/development/testing_guide/end_to_end/rspec_metadata_tests.md b/doc/development/testing_guide/end_to_end/rspec_metadata_tests.md new file mode 100644 index 00000000000..abc7c88b4f2 --- /dev/null +++ b/doc/development/testing_guide/end_to_end/rspec_metadata_tests.md @@ -0,0 +1,13 @@ +# RSpec metadata for end-to-end tests + +This is a partial list of the [RSpec metadata](https://relishapp.com/rspec/rspec-core/docs/metadata/user-defined-metadata) +(a.k.a. tags) that are used in our end-to-end tests. + + + +| Tag | Description | +|-|-| +| `:elasticsearch` | The test requires an Elasticsearch service. It is used by the [instance-level scenario](https://gitlab.com/gitlab-org/gitlab-qa#definitions) [`Test::Integration::Elasticsearch`](https://gitlab.com/gitlab-org/gitlab/-/blob/72b62b51bdf513e2936301cb6c7c91ec27c35b4d/qa/qa/ee/scenario/test/integration/elasticsearch.rb) to include only tests that require Elasticsearch. | +| `:orchestrated` | The GitLab instance under test may be [configured by `gitlab-qa`](https://gitlab.com/gitlab-org/gitlab-qa/-/blob/master/docs/what_tests_can_be_run.md#orchestrated-tests) to be different to the default GitLab configuration, or `gitlab-qa` may launch additional services in separate docker containers, or both. Tests tagged with `:orchestrated` are excluded when testing environments where we can't dynamically modify GitLab's configuration (for example, Staging). | +| `:quarantine` | The test has been [quarantined](https://about.gitlab.com/handbook/engineering/quality/guidelines/debugging-qa-test-failures/#quarantining-tests), will run in a separate job that only includes quarantined tests, and is allowed to fail. The test will be skipped in its regular job so that if it fails it will not hold up the pipeline. | +| `:requires_admin` | The test requires an admin account. Tests with the tag are excluded when run against Canary and Production environments. | -- cgit v1.2.1