Tự động hóa kiểm tra khói hàng đêm với Broma để phát hiện hồi quy
Tổng quan
Kiểm tra khói (smoke test) hàng đêm giúp bạn có được cái nhìn nhanh và đáng tin cậy về việc liệu một bản phát hành gần đây có phá vỡ bất kỳ chức năng quan trọng nào hay không. Với Broma, bạn có thể xây dựng một quy trình tái sử dụng được, mở một danh sách URL, thực hiện một vài thao tác thiết yếu (đăng nhập, xác minh các thành phần giao diện, chụp ảnh màn hình) và ghi lại kết quả đạt/lỗi—all mà không cần viết code. Trình xây dựng hướng dẫn được hỗ trợ bởi AI cho phép bạn mô tả bài kiểm tra bằng ngôn ngữ thông thường, trong khi tính năng quản lý hồ sơ của Broma giữ riêng biệt thông tin đăng nhập, cookie và tiện ích mở rộng khỏi phiên duyệt web hàng ngày của bạn.
Tại sao kiểm tra khói hàng đêm lại quan trọng
- Tốc độ: Một bài kiểm tra khói hoàn tất trong vài phút, nhanh hơn nhiều so với một bộ kiểm tra hồi quy đầy đủ.
- Phát hiện sớm: Việc phát hiện nút đăng nhập bị hỏng hoặc tiêu đề bị thiếu ngay khi nó xuất hiện trong production giúp tiết kiệm các yêu cầu hỗ trợ.
- Tự động hóa: Lên lịch chạy định kỳ giúp loại bỏ lỗi của con người và đảm bảo tính nhất quán qua từng bản phát hành.
- Khả năng hiển thị: Nhật ký và ảnh chụp màn hình cung cấp cho nhóm phát triển bằng chứng cụ thể để ưu tiên xử lý.
Tạo hồ sơ Broma dành riêng cho kiểm thử
- Tạo một hồ sơ mới – Trong Trình quản lý hồ sơ của Broma, nhấp vào Hồ sơ mới và đặt tên là
SmokeTest. - Thêm thông tin đăng nhập – Dán tên người dùng/mật khẩu tài khoản dịch vụ hoặc khóa API vào phần Thông tin đăng nhập.
- Nhập cookie – Nếu trang web sử dụng session cookie, hãy nhập chúng ngay. Điều này giúp bạn tránh việc phải đăng nhập lại nhiều lần.
- Cài đặt các tiện ích mở rộng cần thiết – Đối với OCR hoặc giám sát mạng, chỉ kích hoạt các tiện ích mở rộng như Readability hoặc Network Monitor cho hồ sơ này.
- Đặt proxy (nếu cần) – Sử dụng trường proxy tích hợp sẵn để định tuyến các bài kiểm tra qua proxy công ty của bạn.
Soạn quy trình bằng AI
Trình đại lý AI của Broma chạy trên máy của bạn (qua khóa API hoặc đăng ký ChatGPT/Claude). Không cần giấy phép bổ sung.
Ví dụ về lời nhắc AI
Tôi cần một bài kiểm tra khói thực hiện các bước sau:
1. Mở https://app.example.com/dashboard
2. Chờ tối đa 10 giây cho phần tử có data-testid="dashboard-header"
3. Nếu phần tử xuất hiện, chụp ảnh màn hình và ghi lại "ĐẠT"
4. Nếu hết thời gian chờ, chụp ảnh màn hình, thực hiện OCR trên trang để tìm văn bản lỗi và ghi lại "LỖI"
5. Lặp lại các bước 1‑4 cho từng URL trong danh sách lưu trong biến có tên urls.
Xây dựng quy trình từng bước
- Mở trang – Kéo hành động “Mở URL” và dán URL đầu tiên từ biến
urls. - Chờ phần tử – Sử dụng bộ chọn
data-testid="dashboard-header". Broma hiển thị bản xem trước của phần tử trong giao diện người dùng. - Nhánh – Thêm điều kiện Nếu tồn tại. Nếu đúng, thêm hành động Chụp ảnh màn hình và Ghi lại ĐẠT.
- Ngược lại – Thêm hành động Chụp ảnh màn hình, Đọc văn bản OCR và Ghi lại LỖI cùng với thông báo lỗi đã trích xuất.
- Lặp lại – Kết nối nút Duyệt qua để lặp qua các URL còn lại.
Lưu quy trình
Đặt tên rõ ràng cho quy trình, ví dụ: Nightly Smoke Test. Broma tự động lưu một bản sao của sơ đồ quy trình, các bộ chọn cơ bản và bất kỳ biểu thức JavaScript ngắn nào bạn chỉnh sửa.
Lên lịch và quản lý các lần chạy
- Windows Task Scheduler – Tạo tác vụ lên lịch chạy
Broma.exevới các tham số--run-workflow "Nightly Smoke Test" --profile SmokeTestvào lúc 02:00 AM. - Bộ lập lịch tích hợp của Broma – Nếu bạn thích, sử dụng tab Lịch trong Broma: đặt lặp lại hàng ngày, chọn thời gian và bật “Chạy trong nền”.
- Nhật ký chạy – Mỗi lần thực hiện sẽ tạo một tệp nhật ký có dấu thời gian trong
C:\Users\[User]\AppData\Local\Broma\Logs. Nhật ký bao gồm:- Thời điểm bắt đầu/kết thúc
- Số lần đạt/lỗi theo URL
- Đường dẫn đến ảnh chụp màn hình
- Văn bản lỗi đã trích xuất bằng OCR (nếu có)
- Cảnh báo qua email – Thêm một đoạn script PowerShell đơn giản vào tác vụ để đọc nhật ký mới nhất và gửi email nếu có bất kỳ mục LỖI nào. Ví dụ:
# Đọc nhật ký gần nhất
$log = Get-Content "C:\Users\User\AppData\Local\Broma\Logs\smoke-$(Get-Date -Format 'yyyyMMdd').log"
if ($log -match "LỖI") {
Send-MailMessage -From "broma@company.com" -To "devteam@company.com" -Subject "Smoke Test Failure" -Body "Xem ảnh chụp màn hình đính kèm." -SmtpServer "mail.company.com" -Attachments @(Get-ChildItem "C:\Users\User\AppData\Local\Broma\Logs\*.png")
}
Giải thích nhật ký và cảnh báo
- Mục ĐẠT xác nhận rằng phần tử giao diện người dùng đã có mặt và ảnh chụp màn hình hiển thị trang hoạt động bình thường.
- Mục LỖI bao gồm văn bản lỗi đã được trích xuất bằng OCR, giúp nhà phát triển dễ dàng xem, ví dụ: “Thông tin đăng nhập không hợp lệ” hoặc “Hết thời gian chờ mạng”. Đính kèm ảnh chụp màn hình để có thêm ngữ cảnh trực quan.
- Báo cáo tóm tắt – Cuối mỗi lần chạy, Broma có thể tạo một báo cáo Markdown ngắn gọn mà bạn có thể đăng lên Slack hoặc hệ thống vé.
Bảo trì quy trình khi trang web thay đổi
Ngay cả khi có các bộ chọn linh hoạt, thiết kế lại trang web vẫn có thể phá vỡ quy trình. Trình kiểm tra bộ chọn của Broma cho phép bạn xem trước cách bộ chọn hoạt động trên trang hiện tại và đề xuất các phương án dự phòng như >, ~ hoặc các thuộc tính thay thế.
Ví dụ về một bộ chọn có thể tồn tại qua các thay đổi
Bộ chọn gốc: [href="/dashboard"]
Trang web mới sử dụng ID động: [data-testid^="dash-"]
Bạn có thể chỉnh sửa bộ chọn trong giao diện quy trình, sau đó nhấp vào Kiểm tra bộ chọn để xác minh nó khớp với phần tử mới. Nếu bạn cần phương án dự phòng, hãy thêm một bộ chọn thứ hai trong nút Nếu tồn tại bằng điều kiện or.
Tái sử dụng quy trình trên toàn nhóm
Vì Broma lưu các quy trình dưới dạng tệp JSON trong thư mục AppData của người dùng, bạn có thể lưu trữ chúng trong hệ thống kiểm soát phiên bản:
- Xuất quy trình qua File → Export.
- Thêm tệp
.bromavào kho Git. - Các thành viên mới trong nhóm nhập quy trình qua File → Import.
Mỗi nhà phát triển giữ hồ sơ riêng của mình, do đó thông tin đăng nhập không bao giờ bị rò rỉ giữa các tài khoản. Quy trình giống nhau có thể được chạy từ các hồ sơ khác nhau, đảm bảo sự cô lập trong khi vẫn giữ một nguồn sự thật duy nhất.
Khắc phục sự cố thường gặp
| Triệu chứng | Nguyên nhân có thể | Giải pháp nhanh |
|---|---|---|
| Không có ảnh chụp màn hình được tạo | Tiện ích mở rộng chụp ảnh màn hình bị tắt trong hồ sơ | Kích hoạt tiện ích mở rộng trong Cài đặt hồ sơ |
| OCR trả về văn bản trống | Ảnh chụp màn hình không rõ nét hoặc ngôn ngữ không khớp | Điều chỉnh chất lượng ảnh chụp màn hình hoặc đặt ngôn ngữ OCR trong tùy chọn quy trình |
| Tác vụ không bao giờ bắt đầu | Tài khoản người dùng không khớp trong Windows Task Scheduler | Chạy tác vụ với cùng tài khoản sở hữu hồ sơ Broma |
| Quy trình bị treo ở bước chờ | Bộ chọn không bao giờ xuất hiện do độ trễ mạng | Tăng thời gian chờ hoặc thêm bước Network idle trước khi chờ |
Nếu một quy trình bị hỏng sau khi trang web được cập nhật, hãy mở Broma, chọn bước gặp lỗi và nhấp vào Preview. Điều này hiển thị DOM hiện tại xung quanh bộ chọn, giúp bạn xác định phần tử mới cần nhắm mục tiêu.
Suy ngẫm cuối cùng
Một bài kiểm tra khói hàng đêm được xây dựng bằng Broma cung cấp một mạng lưới an toàn bảo trì thấp cho mọi bản phát hành. Bằng cách tận dụng hướng dẫn của AI, sự cô lập hồ sơ và tính năng lên lịch tích hợp, bạn có được một quy trình kiểm tra hồi quy mạnh mẽ có thể mở rộng từ một người hoạt động độc lập đến cả một cơ quan. Bắt đầu với một trang quan trọng duy nhất, mở rộng danh sách URL và dần dần thêm nhiều kiểm tra hơn khi bạn tự tin. Kết quả là một quy trình có thể lặp lại, có thể kiểm toán được, giúp các ứng dụng web của bạn hoạt động trơn tru—ngày này qua ngày khác.
Tài liệu tham khảo nội bộ
- Trình quản lý hồ sơ Broma – hướng dẫn chi tiết về cách lưu trữ thông tin đăng nhập.
- Thiết lập Trình đại lý AI – cấu hình khóa API cho ChatGPT hoặc Claude.
- Script phân tích nhật ký – ví dụ PowerShell để trích xuất xu hướng từ nhật ký chạy hàng đêm.
