Qua một vài dự án automation trong công ty, thì mình cũng vọc vạch một tý về việc sử dụng Jenkins để tạo ra những jobs đơn giản để chạy những testcase Automation trong dự án của mình. Mục đích của tài liệu này, là để note lại những kiến thức mà mình đã tìm hiểu được về Jenkins, cũng như có thể giúp các bạn chưa biết gì về Jenkin có thể có một chút kiến thức về mảng này thông qua tài liệu này. Trong tài liệu này mình sẽ hướng dẫn các bạn cài đặt Jenkins và tạo một jobs để chạy test Automation đơn giản.
1/ Cài đặt Jenkins:
Jenkins là một open source free và khá là mạnh mẽ, hỗ trợ đủ các thể loại từ git, svn, java, C#… đầu tiên mình sẽ hướng dẫn các bạn từng bước để cài đặt Jenkins.
Step 1: Cài đặt JDK 8:
- Điều kiện cần đầu tiên là các bạn phải cài đặt JDK 8 trên máy của các bạn.
- Ở bước này các bạn có thể download bộ cài đặt tại đây: https://www.oracle.com/java/technologies/javase-jdk8-downloads.html
- Sau khi download xong thì các bạn thực hiện việc cài đặt.
- Sau khi cài đặt xong, các bạn sẽ thực hiện cấu hình JAVA_HOME nhé. Các bạn có thể tham khảo tại đây: http://www.mkyong.com/java/how-to-set-java_home-on-windows-10/
Step 2: Cài đặt Apache Tomcat
- Các bạn có thể download Apache Tomcat tại link sau: https://tomcat.apache.org/download-80.cgi
- Sau khi download file zip, các bạn thực hiện giải nén.
- Để RUN được Tomcat, các bạn chạy file startup.bat trong thư mục bin của tomcat
- Sau khi run file startup.bat, các bạn truy cập vào đường dẫn: http://localhost:8080/ Tomcat start thành công sẽ có giao diện như thế này:
Step 3: Cài đặt Jenkins
- Đầu tiên các bạn truy cập vào trang chủ của Jenkins để download file jenkins.war: https://jenkins.io/download/
- Sau khi download thành công file jenkins.war, các bạn bỏ nó vào thư mục webapps của Tomcat
- Sau bước trên, các bạn thực hiện chạy file startup.bat để start Tomcat
- Sau đó truy cập vào jenkins: http://localhost:8080/jenkins/ để cấu hình nó
- Ở cửa sổ đầu tiên chúng ta cần nhập mặc khẩu mặc định.
- Mật khẩu này nằm ở đường dẫn các bạn đã thấy ở trên. Như mấy mình sẽ là: C:\Users\doan.ngoc.vu.jenkins\secrets\initialAdminPassword
- Sau khi nhập Password, sẽ qua phần cài đặt plugins cho Jenkins, và ở đây mình chọn option để jenkins tự động cài những plugins cần thiết hoặc sẽ cho phép người dùng tự chọn những plugin để cài đặt lên Jenkins.
- Sau khi cài đặt thành công các plugins cần thiết, ta sẽ khởi tạo tài khoản Admin cho Jenkins
- Sau khi tạo thành công tài khoản Admin, các bạn sẽ được custom URL để access tới jenkins, các bạn có thể tùy chỉnh theo ý muốn, có thể để sau cũng được nhé.
- Sau bước này thì đã xong việc config Jenkins.
- Start using Jenkins để bắt đầu trải nghiệm nó:
2/ Những plugins cần thiết:
Ngoài những plugins mặc đình mình đã cài đặt ở bước trên. Mình sẽ cần phải cài thêm 1 vài plugins cần thiết để phục vụ cho dự án Automation của mình. Nói sơ qua về dự án Automation của mình, thì mình xây dựng dự án bằng Maven và sử dụng thư viện Cucumber Report để xuất report kết quả test cho dự án. Nên mình sẽ cài đặt thêm 1 số plugins sau:
- Git client plugin
- Maven Integration plugin
- Cucumber reports
Để có thể cài đặt plugins bằng cách vào phần Manage Jenkins > Manage Plugins:
Lựa chọn những plugin cần thiết và thực hiện cài đặt:
3/ Tạo Jobs:
- Để tạo mới 1 jobs, các bạn vào phần New Item:
- Bước tiếp theo Chọn loại job để cấu hình:
- Bước tiếp theo ta sẽ cấu hình job để có thể chạy được file Scenario:
1/ General: Phần này sẽ điền thông tin của job
2/ Maven Info Plugin Configuration: Phần này ta sẽ cấu hình cho Maven Plugins
- Mình sẽ nhập URL cho GitHub dự án
3/ Source Code Management: Phần này mình sẽ chỉ ra repository để jenkins có thể clone source code về
4/ Builds: Phần này sẽ chỉ ra đường dẫn của file pom.xml (File cấu hình của dự án), cùng với cài đặt command để thực hiện chạy test cho Job của chúng ta.
- Source code sau khi được clone về sẽ nằm ở thử mục C:\Users\doan.ngoc.vu.jenkins\workspace, vì vậy ta sẽ trỏ về file pom.xml trong thư mục này.
- Phần Goals and options mình sẽ setting câu lệnh chạy test: -Dtest=Example_TestRunnerIT test Câu lệnh này sẽ giúp Maven thực thi file test Runner là Example_TestRunnerIT.java
5/ Post-build Actions: Phần này ta sẽ add Cucumber Reports, để sau khi chạy test sẽ xuất report cho chúng ta.
- Sau khi config xong Job, ta save lại những gì đã cài đặt.
4/ Run Job:
- Để RUN job sau khi config, các bạn bấm nút Build Now để chạy job đó
- Job sẽ bắt đầu thực thi:
- Sau khi chạy xong, các bạn có thể check report chạy test tại đây, report mình sử dụng trong dự án là Cucumber Report:
- Nội dung report sẽ hiển thị rõ ràng:
5/ Lời kết:
Qua bài viết này, mình đã giới thiệu Basic về sử dụng Jenkins trong Automation. Đây là cái nhìn sơ khai về sử dụng Jenkins trong Automation Testing. Bài sau mình sẽ giới thiệu rõ hơn về phần settings jobs. Cảm ơn các bạn đã theo dõi