{"id":49500,"date":"2025-05-27T08:53:41","date_gmt":"2025-05-27T08:53:41","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=49500"},"modified":"2026-02-21T07:28:57","modified_gmt":"2026-02-21T07:28:57","slug":"gitlab-build-test-cases-tutorial-guide","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/gitlab-build-test-cases-tutorial-guide\/","title":{"rendered":"Gitlab – Build – Test Cases Tutorial Guide"},"content":{"rendered":"\n

This is relatively new Test Cases<\/strong> feature in GitLab 18.x (cloud)<\/strong> that brings native manual test case management<\/strong> into the GitLab ecosystem \u2014 part of their push towards end-to-end DevOps<\/strong>.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

\u2705 What Test Cases<\/em> in GitLab Actually Are<\/h3>\n\n\n\n

GitLab\u2019s Test Cases are structured manual tests<\/strong> designed to:<\/p>\n\n\n\n

    \n
  • Define what<\/strong> should be tested (the test step)<\/li>\n\n\n\n
  • Record how<\/strong> to verify it (expected result)<\/li>\n\n\n\n
  • Track test coverage<\/strong>, planning, and execution<\/li>\n\n\n\n
  • Link with issues<\/strong>, requirements<\/strong>, and test runs<\/strong><\/li>\n<\/ul>\n\n\n\n

    They are not automated tests<\/strong>, but they complement them<\/strong> by managing manual testing workflows<\/strong>, often needed in:<\/p>\n\n\n\n

      \n
    • UI\/UX validation<\/li>\n\n\n\n
    • Exploratory testing<\/li>\n\n\n\n
    • Compliance\/regression audits (e.g., healthcare, finance)<\/li>\n\n\n\n
    • User acceptance testing (UAT)<\/li>\n<\/ul>\n\n\n\n
      \n\n\n\n

      \ud83d\udccc Real Use Cases for GitLab Test Cases<\/h3>\n\n\n\n
      Use Case<\/th>Description<\/th><\/tr><\/thead>
      Manual QA<\/strong><\/td>QA teams can define and run manual regression tests during releases<\/td><\/tr>
      UAT for Clients<\/strong><\/td>PMs can create test cases, and clients can execute\/verify functionality before go-live<\/td><\/tr>
      Compliance Audits<\/strong><\/td>Required manual validation steps (e.g., for ISO 26262, HIPAA, etc.) can be documented and traceable<\/td><\/tr>
      Linking with Requirements<\/strong><\/td>Trace test cases back to specific requirements using Requirements Management<\/strong><\/td><\/tr>
      Defect Tracking<\/strong><\/td>Link failed test cases directly to issues\/bugs<\/strong><\/td><\/tr>
      Exploratory Testing Logs<\/strong><\/td>Document steps performed during a test session that isn’t fully scripted<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
      \n\n\n\n

      \ud83e\udde0 How to Visualize It in Workflow<\/h3>\n\n\n\n

      Let\u2019s say your team is building a Login Module<\/strong>.<\/p>\n\n\n\n

      1. Create a Test Case:<\/h4>\n\n\n\n
        \n
      • Title<\/strong>: Verify login with valid credentials<\/li>\n\n\n\n
      • Description<\/strong>: Steps: 1. Open login page 2. Enter valid email and password 3. Click \"Login\" Expected Result: - Redirects to dashboard - User's name is visible in top-right corner<\/code><\/li>\n<\/ul>\n\n\n\n

        2. Link It:<\/h4>\n\n\n\n
          \n
        • Link to:\n
            \n
          • Related Issue<\/strong>: #123 Login Feature<\/code><\/li>\n\n\n\n
          • Related Requirement<\/strong>: REQ-01-Login<\/code><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n

            3. Run It:<\/h4>\n\n\n\n
              \n
            • From a test run<\/strong>, mark the test case as:\n
                \n
              • \u2705 Passed<\/li>\n\n\n\n
              • \u274c Failed (can create bug)<\/li>\n\n\n\n
              • \u23f8\ufe0f Blocked<\/li>\n\n\n\n
              • \u26a0\ufe0f Skipped<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n

                4. Report:<\/h4>\n\n\n\n
                  \n
                • Use Test Reports<\/strong> to see pass\/fail trends, test coverage, and compliance readiness<\/li>\n<\/ul>\n\n\n\n
                  \n\n\n\n

                  \ud83d\udd27 Where You\u2019ll Find It in GitLab UI<\/h3>\n\n\n\n
                  \n

                  Navigate to your Project \u2192 Build \u2192 Test Cases<\/strong> or via https:\/\/gitlab.com\/<group>\/<project>\/-\/quality\/test_cases<\/code><\/p>\n<\/blockquote>\n\n\n\n

                  \n\n\n\n

                  \ud83e\udde9 How to Best Use It in Agile\/DevOps<\/h3>\n\n\n\n
                    \n
                  1. Sprint Planning<\/strong>\n
                      \n
                    • QA writes test cases for stories\/tickets<\/li>\n\n\n\n
                    • Links each test case to the related issue\/requirement<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                    • CI\/CD Integration<\/strong>\n
                        \n
                      • Even though test cases are manual, they sit next to pipelines and MRs, giving unified visibility<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                      • Release Testing<\/strong>\n
                          \n
                        • Create a Test Run<\/strong> per release or milestone<\/li>\n\n\n\n
                        • Execute selected test cases and record results<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                        • Post-Deployment<\/strong>\n
                            \n
                          • Run test cases as part of UAT checklist<\/strong> or rollback decision flow<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n
                            \n\n\n\n

                            \ud83e\udde0 Pro Tips<\/h3>\n\n\n\n
                              \n
                            • Use labels<\/strong> (e.g., smoke<\/code>, regression<\/code>, v18.0<\/code>) to filter\/group test cases<\/li>\n\n\n\n
                            • Combine with Test Runs<\/strong> and Requirements<\/strong> for traceability<\/li>\n\n\n\n
                            • Automate generation of issues on test failure (e.g., with scripts or API)<\/li>\n<\/ul>\n\n\n\n
                              \n\n\n\n

                              \ud83d\udcc8 When Not to Use It<\/h3>\n\n\n\n

                              If your team is fully automated in CI\/CD<\/strong> and doesn’t require formal manual validation, this feature may feel redundant. However, for product teams, QA testers, regulated industries, and enterprise clients<\/strong>, it fills a crucial gap.<\/p>\n\n\n\n

                              \n\n\n\n

                              <\/p>\n","protected":false},"excerpt":{"rendered":"

                              This is relatively new Test Cases feature in GitLab 18.x (cloud) that brings native manual test case management into the GitLab ecosystem \u2014 part of their push towards end-to-end DevOps…. <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_joinchat":[],"footnotes":""},"categories":[2],"tags":[],"class_list":["post-49500","post","type-post","status-publish","format-standard","hentry","category-uncategorised"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49500","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/comments?post=49500"}],"version-history":[{"count":2,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49500\/revisions"}],"predecessor-version":[{"id":58990,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49500\/revisions\/58990"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=49500"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=49500"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=49500"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}