5 phút đọcRead in English
Từ một run fail tới ticket Jira, rồi quay lại
Quản lý defect với Jira bằng một repro test: run fail thành Bug trên Jira ra sao, VibeQA ghi gì lên ticket, và kết nối Jira hiện còn giới hạn gì.
Run hằng đêm của suite Checkout trong dự án Storefront chuyển đỏ. Test fail đã thêm hai sản phẩm vào giỏ,
mở /cart, rồi không bấm được nút Pay: trên màn hình 375px, phần tóm tắt giỏ hàng che mất nút. Giờ phải
có người viết lỗi này lên Jira, và sau đó phải có người kiểm xem bản fix có hiệu quả không.
Khi quản lý defect với Jira bằng VibeQA, cả hai việc đều xoay quanh một thứ: repro test. Nó kiểm hành vi đúng, nên fail khi bug còn đó và pass khi bug đã được sửa. Một defect trong VibeQA là một ticket Jira (hoặc một ghi chú đơn giản) cộng với test đó.
Defect có thể bắt đầu từ hai chỗ.
Từ một run fail: Báo lỗi
Mở run bị fail và chọn Báo lỗi. Hộp thoại hỏi lỗi được theo dõi ở đâu:
- Tạo ticket Jira (khuyến nghị). VibeQA tạo một Bug trong dự án Jira bạn chọn. Jira giữ người xử lý, độ ưu tiên và thảo luận; VibeQA giữ repro.
- Liên kết ticket đã có. Đã có người tạo ticket rồi. VibeQA thêm run này vào ticket dưới dạng comment.
- Chỉ lưu trong VibeQA. Không dùng tracker. Không có gì tự re-verify; sau khi sửa, bạn bấm Re-verify ngay.
Phần mô tả được viết sẵn từ run: các bước của test fail cho tới bước hỏng, kết quả kỳ vọng, kết quả thực tế, và một dòng ghi nền tảng, URL của app, phiên bản suite và id của run. Bạn sửa được mọi chỗ trước khi gửi. Tài khoản test và mật khẩu không bao giờ được đưa vào ticket.
Phiên bản suite vừa fail trở thành repro. Nó đang fail, nên nó đã chứng minh được bug.
Có hai giới hạn cần biết. Ảnh chụp màn hình, video và trace vẫn nằm ở trang run trong VibeQA; chúng không được đính kèm vào ticket Jira, chỉ được mô tả. Và repro là cả phiên bản suite, không chỉ riêng test fail, nên mỗi lần re-verify sẽ chạy mọi test trong phiên bản đó.
Từ Jira: Theo dõi ticket Jira
Đôi khi bug tới Jira trước và chưa run nào của VibeQA bắt được nó. Ở trang Defect, chọn Theo dõi ticket Jira và dán một key như SHOP-431 hoặc một link. VibeQA tìm ticket và hiện key, trạng thái và người báo.
Sau đó bạn chọn repro test:
- Tokay viết từ ticket. Tokay đọc ticket và viết một test kiểm hành vi đúng. Đây là bản nháp như mọi bản nháp khác: bạn review trong Test case, và re-verify chỉ bắt đầu sau khi có người duyệt. Nội dung ticket được coi là dữ liệu, không phải chỉ dẫn.
- Dùng test case sẵn có. Chọn một case từ một suite đã duyệt, hoặc mọi test trong suite đó. VibeQA chạy nó một lần ngay để chứng minh hôm nay nó fail.
Lần chạy chứng minh này quan trọng. Một repro pass trong khi bug vẫn còn sẽ báo "đã sửa" cho một bản fix chưa từng có. Vì vậy defect hiện kết quả của lần chạy đó: "Repro fail hôm nay, đúng như mong đợi", hoặc, nếu nó pass, "Repro pass hôm nay: kiểm lại xem nó có bắt được bug không".
Quản lý defect với Jira trên bảng defect
Trang Defect liệt kê các defect đang mở của mọi dự án bạn thấy được, chia ba phần:
| Phần | Gồm những gì |
|---|---|
| Cần xem | Vẫn còn lỗi, flaky, hoặc repro test bị hỏng |
| Chờ sửa | Chưa re-verify; chờ ticket chuyển trạng thái |
| Đã sửa | Lần re-verify gần nhất pass. Đóng ở đây hoặc trên Jira |
Bạn lọc được theo kết luận và theo dự án. Mỗi dòng hiện suite repro và lần re-verify mới nhất, kèm số run pass.
"Đã đăng lên Jira" cho bạn thấy gì
Mỗi trang defect có mục Đã đăng lên Jira. Nó hiện comment VibeQA để lại trên ticket sau lần re-verify gần nhất: kết luận, số run pass, id các run (run fail được đánh dấu) và link quay về defect. Khi các run còn đang chạy, nó báo VibeQA sẽ comment khi tất cả chạy xong. Nếu dự án chưa kết nối Jira, hoặc defect không có ticket, nó nói đúng như vậy. Nếu đăng thất bại, VibeQA tiếp tục thử lại và mục này cho bạn biết.
Nội dung ticket hiện trong VibeQA lấy từ Jira, nhưng nó không quyết định gì cả. Chỉ repro test quyết định kết luận.
Đóng defect
Đóng defect đưa nó ra khỏi bảng và dừng re-verify. Kết luận gần nhất vẫn được giữ trên trang. Owner và admin được đóng defect; member báo lỗi và re-verify được, nhưng không đóng được.
Kết nối Jira
Owner và admin kết nối Jira trong Tích hợp bằng ba thứ:
- Site URL của site Atlassian Cloud, ví dụ
https://acme.atlassian.net. Chỉ nhận siteatlassian.net. - Email tài khoản Atlassian.
- Một API token tạo ở id.atlassian.com. VibeQA kiểm tra với Atlassian rồi lưu mã hoá.
Kết nối có thể dùng cho cả tổ chức hoặc cho một dự án. Dự án có kết nối riêng sẽ dùng kết nối đó thay cho kết nối của tổ chức.
Để re-verify khi ticket chuyển trạng thái, tạo webhook ngay trên trang đó, dán URL và signing secret vào Jira (Settings → System → Webhooks, "Issue updated"), rồi chọn trạng thái có nghĩa là "kiểm ngay". Mặc định là Ready for QA.
Hiện chưa có OAuth. API token của Atlassian hành động với tư cách người tạo ra nó, thấy những gì người đó thấy, và hết hạn (chậm nhất sau một năm). VibeQA không tự gia hạn được; khi token hết hạn, cần có người kết nối lại bằng token mới.
Chuyện gì xảy ra tiếp theo
Khi ticket chuyển sang Ready for QA, VibeQA chạy repro test ba lần và gộp kết quả thành một kết luận. Vì sao là ba lần, và mỗi kết luận nghĩa là gì, là chủ đề của bài tiếp theo: Vì sao một bản fix phải chạy ba lần mới được coi là đã fix.