エンドツーエンドテスト用の RSpec メタデータ

これは、エンドツーエンドテストで使用するRSpec メタデータ(タグ) の一部です。

タグ説明 
:elasticsearchこのテストは Elasticsearch サービスを必要とします。インスタンスレベルのシナリオ Test::Integration::Elasticsearch で、Elasticsearch を必要とするテストのみを含めるために使用されます。 
:exceptテストは、指定されたものを_除き_、通常の実行コンテキストで実行されます。詳細はテストの実行コンテキストの選択を参照してください。 
:external_api_callsテストはDockerネットワークの外部ネットワークとのやり取りを必要とします。 
:feature_flagこのテストは機能フラグを使用するため、実行には管理者アカウントが必要です。scope が:global に設定されている場合、テストはすべてのライブ .com 環境でスキップされます。そうでない場合は、Canary、Production、Pre-productionでのみスキップされます。詳細は機能フラグを使ったテストを参照してください。 
:frameworkこのテストは、QA フレームワーク自体のサニティアサーションを行います。 
:geoこのテストでは、プライマリとセカンダリの 2 つの GitLab Geo インスタンスを立ち上げる必要があります。 
:gitaly_clusterテストはGitLabインスタンスに対して実行され、リポジトリはPraefectノードの後ろにある冗長化されたGitalyノードに保存されます。すべてのノードは別々のコンテナです。このタグを使用するテストでは、起動が必要なコンテナが 3 つ追加されるため、セットアップ時間が長くなります。 
:githubこのテストには GitHub パーソナルアクセストークンが必要です。 
:group_samlテストには、グループレベルで SAML SSO が有効になっている GitLab インスタンスが必要です。外部の SAML ID プロバイダと対話します。:orchestrated タグと対になっています。 
:instance_samlこのテストには、インスタンスレベルで SAML SSO が有効になっている GitLab インスタンスが必要です。外部の SAML ID プロバイダとやり取りします。:orchestrated タグと対になっています。 
:integrationsこれは、利用可能なインテグレーションをテストすることが目的です。このテストには、実行コンテキストにDockerがインストールされている必要があります。コンテナをプロビジョニングし、ローカルインスタンスに対して実行するか、gitlab-qa シナリオを使用します。Test::Integration::Integrations  
:issue,:issue_${num} 仕様に関連する可能性のあるイシューへのオプションリンク。関連するイシューの追跡に役立ち、テストレポートを作成するツールでも使用できます。現在、Allure テストレポートに自動的に追加されます。issue_1 やissue_2 などのように、オプションで数字の接尾辞を追加することで、複数のタグを使用することができます。 
:service_ping_disabledこのテストはインスタンスレベルで GitLab 設定サービス ping と相互作用し、管理エリアの設定サービス ping チェックボックスをオンまたはオフにします。このタグはservice_ping_disabled ジョブでのみテストが実行され、:orchestrated と:requires_admin タグとペアでなければなりません。 
:jiraテストには Jira Server が必要です。GitLab-QAはTest::Integration::Jira テストシナリオの実行時に Docker コンテナで Jira Server をプロビジョニングします。 
:kubernetesこのテストには、SSH トンネルの後ろで実行されるように設定された GitLab インスタンスが含まれ、TLS でアクセス可能な GitLab を実現します。このテストには、少なくとも一つのKubernetesクラスターのプロビジョニングも含まれます。このタグはしばしば:orchestrated と対になります。  
:ldap_no_serverこのテストでは、GitLabインスタンスがLDAPを使うように設定されている必要があります。:orchestrated 。オーケストレーション時に LDAP サーバーを立ち上げるわけではありません。代わりに、実行時にLDAPサーバーを作成します。 
:ldap_no_tlsこのテストでは、GitLabインスタンスがTLSを有効にしていない外部のLDAPサーバーを使うように設定されている必要があります。 
:ldap_tlsこのテストでは、GitLabインスタンスがTLSを有効にして外部のLDAPサーバーを使用するように設定されている必要があります。 
:mattermostこのテストには、GitLab インスタンス上に GitLab Mattermost サービスが必要です。 
:metricsテストには、専用のメトリクスエクスポーターがPumaとSidekiqと一緒に稼働しているGitLabインスタンスが必要です。 
:mixed_envこのテストは、gitlab_canary=true クッキーの存在に基づくトラフィックルーティングによって、ペアになったカナリアバージョンを利用できる環境でのみ実行してください。このカテゴリのテストは、混合デプロイ環境を検証するために、テストの途中でクッキーを切り替えます。 
:oauthこのテストは GitLab にログインするために外部の OmniAuth プロバイダを使用します。 
:object_storageこのテストでは、GitLabインスタンスが複数のオブジェクトストレージタイプを使用するように設定されている必要があります。オブジェクトストレージサーバーとしてMinIOを使用します。 
:onlyテストは特定の実行コンテキストでのみ実行されます。詳細については、テストの実行コンテキストの選択を参照してください。 
:orchestratedテスト対象の GitLab インスタンスは、gitlab-qa](https://gitlab.com/gitlab-org/gitlab-qa/-/blob/master/docs/what_tests_can_be_run.md#orchestrated-tests) によってデフォルトの GitLab 設定とは異なるように[設定されるかもしれませんし、gitlab-qa によって別の Docker コンテナで追加のサービスを起動するかもしれませんし、その両方かもしれません。GitLabの設定を動的に変更できない環境（例えばステージング）をテストする場合、:orchestrated のタグが付いたテストは除外されます。 
:product_groupテストが属する製品グループを指定します。包括的なグループの一覧はProduct sections, stages, groups, and categoriesを参照してください。 
:quarantineテストは隔離され、隔離されたテストのみが含まれる別のジョブで実行され、失敗してもかまいません。テストは通常のジョブでスキップされるため、失敗してもパイプラインが滞ることはありません。特定のコンテキストで実行されるテストだけを隔離することもできます。 
:relative_urlこのテストでは、相対 URL の下に GitLab インスタンスがインストールされている必要があります。 
:reliableこのテストは信頼できるテストに昇格させられました。つまり、マージリクエストを含むすべてのパイプラインで一貫してパスするということです。 
:repository_storageこのテストでは、GitLab インスタンスが複数のリポジトリストレージパスを使用するように設定されている必要があります。:orchestrated タグと対になっています。 
:requires_adminこのテストには管理者アカウントが必要です。Canary や Production 環境でこのタグを使ったテストは除外されます。 
:requires_git_protocol_v2このテストでは、Git プロトコル バージョン 2 がサーバー上で有効になっている必要があります。デフォルトでは有効になっていますが、有効になっていない場合はQA_CAN_TEST_GIT_PROTOCOL_V2 をfalse に設定することでテストをスキップできます。 
:requires_praefectこのテストでは、GitLabインスタンスがリポジトリストレージとしてGitalyクラスタ（別名Praefect）を使っていることを確認します。デフォルトで使用されていると仮定されていますが、そうでない場合はQA_CAN_TEST_PRAEFECT をfalseに設定することでテストをスキップすることができます。 
:runnerこのテストは GitLab Runner インスタンスに依存してセットアップします。 
:sanity_feature_flagsこのテストは、テストフレームワークの機能フラグ処理部分の機能を検証します。 
:skip_live_envステージング、カナリア、プロダクションのようなデプロイされた環境に対して実行する場合、このテストは除外されます。 
:skip_fips_envこのテストは、FIPS モードの環境に対して実行すると除外されます。 
:skip_signup_disabledこのテストは新規ユーザ登録に UI を使用するため、UI 経由での新規ユーザ登録を許可しない環境ではスキップされます。 
:smokeこのテストは GitLab インスタンスの基本的な機能を検証するテストスイートに属します。 
:smtpこのテストでは、GitLabインスタンスがSMTPサーバを使用するように設定されている必要があります。MailHogを使ってGitLabからのSMTP通知メール配信をテストします。 
:testcase GitLabプロジェクトのテストケースのイシューへのリンクです。 
:transientこのテストは一過性のバグをテストします。デフォルトでは除外されています。