#CI/CD with Salesforce by using Jenskin #Vietnam engineer in Japan

1. Sử dụng CI pipeline bằng Jenkins
cho Salesforce
Created Date 2021/2/21

2. Mục lục
Tại sao nên sử dụng CI với
Salesforce Development?
Continuous Integration
(CI) là gì?
Cấu hình Jenkins CI
Pipeline cho Salesforce

3. Continuous Integration (CI) là
gì?

4. Continuous Integration
Định nghĩa
CI là quá trình tích hợp các phiên bản mã nguồn của các lập trình viên
trên một bản chính thường xuyên.
Các bước cơ bản
• Đẩy code lên source control.
• Kiểm tra convention tự động.
• Đóng gói, đẩy code lên môi trường tạm thời.
• Chạy test tự động, phát hiện lỗi nếu có.
Kết quả
Đảm bảo mã nguồn được tích hợp vào bản chính luôn thoả mãn yêu
cầu về convention và hạn chế phát sinh code degration.
Tích hợp liên tục
Source: https://developers.redhat.com/blog/2017/09/06/continuous-integration-a-typical-process/

5. Tại sao nên sử dụng CI với
Salesforce Development?

6. Tại sao nên sử dụng CI với Salesforce Development?
2
3
1 Version Control (+ SFDX)
Đảm bảo source deploy được
Tự động hoá unit test
Source: https://www.soliantconsulting.com/blog/salesforce-continuous-integration/

7. Cấu hình Jenkins CI Pipeline cho
Salesforce

8. Jenkins CI
2
3
1
Platform Agnostic, Self-Contained, Free Open Source CI Server
Dễ cài đặt và cấu hình
Khả năng mở rộng
Source:
https://www.simplilearn.com/tutorials/jenkins-tutorial/what-is-jenkins
https://dzone.com/articles/how-to-setup-scalable-jenkins-on-top-of-a-kubernet

9. Jenkins CI
Hướng dẫn chính thức của Salesforce:
https://developer.salesforce.com/docs/atlas.en-
us.sfdx_dev.meta/sfdx_dev/sfdx_dev_ci_jenkins.htm
Source:
https://www.simplilearn.com/tutorials/jenkins-tutorial/what-is-jenkins
https://dzone.com/articles/how-to-setup-scalable-jenkins-on-top-of-a-kubernet

10. Jenkins CI
Hướng dẫn của Hiếu:
•Cài đặt Jenkins CI
•Chuẩn bị môi trường cho Jenkins
•Tạo Private Key và Certificate File cho JWT Authentication Flow
•Tạo Conntected App ở môi trường org DevHub
•Chuẩn bị Jenkinsfile
•Thiết lập Jenkins và project
•Tạo Github webhook để tự động kích hoạt Jenkins
Source:
https://www.simplilearn.com/tutorials/jenkins-tutorial/what-is-jenkins
https://dzone.com/articles/how-to-setup-scalable-jenkins-on-top-of-a-kubernet

11. Cài đặt Jenkins CI
Build Docker image từ dockerfile
https://gist.github.com/kagoromo/6ac88cab9351
8f6ad75e8c2cfb1c4d2c
Chạy dòng lệnh như comment.

12. Cài đặt Jenkins CI
Tìm password khởi tạo từ Container
Log trong Docker
Copy password từ Container Log.

13. Cài đặt Jenkins CI
Thiết lập ban đầu Jenkins từ giao diện
web
Giao diện web của Jenkins có ở:
http://localhost:8080/
Nhập password ở bước trước.
Continue.
Chọn Recommended Plugins.
Continue.

14. Cài đặt Jenkins CI
Thiết lập ban đầu Jenkins từ giao diện
web
Giao diện web của Jenkins có ở:
http://localhost:8080/
Nhập password ở bước trước.
Continue.
Chọn Recommended Plugins.
Continue.

15. Cài đặt Jenkins CI
Tạo tài khoản Admin
Nhập thông tin đăng nhập tuỳ ý.
Save and Continue.

16. Cài đặt Jenkins CI
Tạo tài khoản Admin
Nhập thông tin đăng nhập tuỳ ý.
Save and Continue.

17. Chuẩn bị môi trường cho Jenkins
Tạo Private Key và Certificate File cho
JWT Authentication Flow
https://developer.salesforce.com/docs/atlas.en-
us.sfdx_dev.meta/sfdx_dev/sfdx_dev_auth_key_
and_cert.htm

18. Chuẩn bị môi trường cho Jenkins
Tạo Connected App ở môi trường org
DevHub
https://developer.salesforce.com/docs/atlas.en-
us.sfdx_dev.meta/sfdx_dev/sfdx_dev_auth_conn
ected_app.htm

19. Chuẩn bị môi trường cho Jenkins
Chuẩn bị Jenkinsfile
• Jenkinsfile có thể được coi như là kịch bản của
CI workflow
• Jenkinsfile đặt ở directory gốc của repo (cùng
tầng với .git)
• Nội dung Jenkinsfile gồm nhiều bước, thực tế
khi thực hiện các tác vụ bằng tay như thế nào
thì trong Jenkinsfile cũng định nghĩa tương tự.
Jenkinsfile + Sample Github repo:
https://github.com/kagoromo/sfdx-jenkins-
package/blob/master/Jenkinsfile

20. Thiết lập Jenkins và project
Thiết lập Global properties
Là các biến được sử dụng trong Jenkinsfile

21. Thiết lập Jenkins và project
Định nghĩa toolbelt SFDX cho Jenkins
Workflow cần SFDX để chạy.
Định nghĩa custom tool để Jenkins có thể gọi
được SFDX.
*Thêm plugin Custom Tools từ Manage Jenkins >
Plugin Manager nếu chưa có.

22. Thiết lập Jenkins và project
Định nghĩa Credentials
Credentials ở đây hiểu là:
・ server.key file dùng trong JWT
Authentication Flow để Jenkins đăng nhập
vào SF DevHub org.
・ Github Personal Access Token để Jenkins
có thể đăng nhập vào Github.
https://docs.github.com/en/github/authentic
ating-to-github/creating-a-personal-access-
token

23. Thiết lập Jenkins và project
Tạo project
Sử dụng Multibranch Pipeline để Jenkins tự động
scan tất cả các branch có thay đổi và chạy test.

24. Thiết lập Jenkins và project
Tạo project
Tối thiểu cần chỉ định Github Credential, địa chỉ
Github repo.

25. Thiết lập Jenkins và project
Click Build Now.

26. Tạo Github webhook để tự động kích hoạt Jenkins