![ใช้งาน MSBuild ทาไม?
หลังจากที่เรา build Git ของเราผ่านแล้ว ตอนนี้เราได้ Source Code มาอยู่ที่เครื่อง
แล้วนะครับ ปกติจะอยู่ที่ C:Program Files (x86)Jenkinsjobs[ชื่อ
item ที่เราตั้ง]workspace
เพราะเราทา Web App ด้วย MVC ซึ่งพัฒนาจาก MS. visual studio
เพราะเป็นโปรแกรมที่ติดตั้งมาพร้อมกับ visual studio เพื่อใช้ในการ build โปรแกรม
ซึ่งถ้าเราต้องการเช็คว่าโปรแกรมเรา build Source Code ของ VS ได้ไหม มี
Error หรือ Warnings หรือป่าว และใช้งาน test อื่นๆต่อไป เราควรจะใช้ MSBuild
ในการ build ให้สาเร็จเสียก่อน](https://image.slidesharecdn.com/jenkinsci-150924063503-lva1-app6892/85/Jenkins-Git-MSBuild-NUnit-21-320.jpg)
Jenkins, Git, MSBuild, NUnit
- 1. Jenkins CI What is it?
- 2. ก่อนแรกมาทาความรู้จักกับ CI ก่อนนะครับ CI (Continuous Integration) คือแนวคิด ทัศนะคติ รวมไป ถึงวัฒนธรรมของทีมและองค์กร สิ่งที่ทีมพัฒนาควรจะตกลงร่วมกันในการพัฒนา 1. เมื่อมีเราทาการดึง code จาก repository ล่าสุดลงมาแล้ว จะต้อง สามารถ build และทดสอบผ่านทั้งหมดอยู่เสมอ 2. ทุกๆ คนจะต้องทาการ check-in code ไปยัง repository ทุกๆ ชั่วโมง หรือ ทุกๆ การเปลี่ยนแปลง ยิ่งทาบ่อยยิ่งดี เพราะว่าการ check-in มัน จะทาให้เกิดการพูดคุยภายในทีมอยู่เสมอ
- 3. จากข้อตกลงข้างต้นนั้น เราจะทาให้มันเกิดขึ้นได้อย่างไรล่ะ? 1. ก่อนที่จะทาการ Check-in code ของคุณไปยัง repository นั้น จะต้องทาการ build และต้องทดสอบผ่านทั้งหมด 2. แจ้งหรือตะโกนบอกให้ทีมรู้ว่า เราทาการแก้ไข code แล้วนะ เพื่อให้แต่ละคนทาการดึง code ล่าสุดลงมา เพื่อทาให้มั่นใจว่าการ integrate มันผ่านและทางานได้จริงๆ นะ 3. ทาการ Check-in code ไปยัง repository 4. จะต้องมีเครื่อง server หรือเครื่องแยกออกมา ทาการดึง code ล่าสุดจาก repository ลงมา แล้วทาการ build และ ทดสอบทั้งหมดอีกครั้ง เพื่อให้มั่นใจ ว่าทุกๆ อย่างผ่านนะ และในขั้นตอนนี้จะทาให้ไม่เกิดคาพูดที่ว่า มันสามารถทางานได้บน เครื่องผม/หนู นะ!! ดังนั้นถ้าเกิดปัญหาหรือข้อผิดพลาดขึ้นมาก็กลับไปแก้ไขใหม่หรือ rollback กลับไป และกลับไปทาข้อ 1 อีกครั้ง 5. เมื่อข้อ 4 ผ่านแล้ว ให้บอกทุกๆ คนในทีมทาการดึง code ชุดล่าสุดจาก repository ลงมาอีกครั้งหนึ่ง
- 4. แล้วเราจะลดขั้นตอนการทางานได้อย่างไรล่ะ? คาถามนี้แหละ เป็นเหตุผลที่ต้องให้ทีมเริ่มมองหาเครื่องมือมาช่วยทาในข้อ 4 เพื่อ รวบรวมขั้นตอนการทางานจากขั้นตอนการทางานของแต่ละคนในทีม ซึ่งทุกคนจะต้อง ทางานด้วยขั้นตอนเหมือนกันด้วยนะ ตัวอย่างเครื่องมือข้างต้นก็เช่น SVN (Subversion) CVS (Concurrent Versions System) GIT และอื่นๆ อีกมากมาย
- 5. กับมาที่ Jenkins มันคืออะไร? Jenkins ก็คือ open source continuous integration tools เขียนโดย java และยัง support พวก source code management อย่าง git, svn, cvs อีกด้วย สรุปก็คือ Jenkins จะเข้ามาช่วยทา CI และ Jenkins ยังสามารถเฝ้า repository ใดๆก็ได้เมื่อเกิดการ commit ขึ้น jenkins จะทาการ build version นั้นให้ทันที แล้วเราสามารถกาหนดได้ว่า หาก build สาเร็จให้ ลองรัน test case ก็ได้หรือจะให้ทาอะไร อื่นๆ ต่อไปได้ หลักการของ Jenkins คือเราจะต้องสร้าง Job ขึ้นมาก่อน แล้วกาหนดว่า Job นี้ จะใช้อะไรในการ Build หลังจาก Build สาเร็จแล้วให้ทาอะไร เมื่อได้ Job แล้วเรา ก็สามารถควบคุม Job นี้อีกทีได้เช่นตั้งเวลาการทางาน หรือจะสั่ง build โดยตรงเลย ก็ได้
- 6. สรุปแล้ว Jenkins CI ช่วยงานเรายังไง ในระบบการพัฒนา sotware ต่าง ๆ หลัก ๆ แล้วจะไม่พ้นในระบบการพัฒนาที่เป็น Design -> Dev -> Test -> Deploy CI มันคือกระบวนการที่ทาให้การส่งผ่านแต่ละขั้นตอนมันเกิดการ continuous คือต่อเนื่องนั่นเอง แต่เดิม Design เสร็จแล้ว Dev ต้องเขียน โปรแกรมเพื่อเปลี่ยน Design ให้เป็น หน้าตาเป็นโปรแกรม Dev เสร็จแล้ว Tester ก็ต้องทาการทดสอบต่าง ๆ เมื่อเสร็จแล้วก็ค่อย Deploy คาถามคือถ้า Test ไม่ผ่านทา ยังไง? Dev ก็ต้องเอาไปแก้ แล้วให้Tester ทาการ Test อีกรอบ ถามว่าตรงนี้จะเกิด การรอไหม? ช้าไหม? คาตอบคือมันช้าแน่ ๆ ไม่มีความต่อเนื่อง พูดถึงปัญหาต่อ ถ้า Test ผ่าน ต้อง Deploy ถูกไหม ปกติก็ต้อง Deploy โดยคน หรือใช้โปรแกรมต่าง ๆ ซึ่ง สุดท้ายก็ไม่พ้นคนอยู่ดี มันเลยมี Technology เข้ามาแก้ปัญหาส่วนนี้
- 7. แก้ยังไง? จะดีไหมถ้า Tester ไม่ต้องมาทาซ้า ๆ Dev ไม่ต้องคอยบอก Tester ว่าเสร็จ แล้วนะมาเทสด้วย แต่ให้มัน Test โดยอัตโนมัตหลังจากแก้Code เสร็จเลย หรือ แทนที่พอ Test เสร็จแล้ว ผ่านแล้ว Tester ต้องบอกให้คนที่มีหน้าที่ Deploy มา Deploy ต่อ ก็ ให้มันผ่าน Test แล้ว ก็ Deploy เลย มันลดขั้นตอน ลด Overhead เกิด ความเป็น Continuous ขึ้น ทีนี้ทาไมต้อง Integration เพราะว่า Dev Test Deploy มันคนละระบบกัน เลยต้อง Integrate กันแค่นั้นเอง ทีนี้ Jenkins ทาอะไรได้บ้าง มองจากที่ใช้งาน Dev -> update code Jenkins จะทาการดึง code นั้นมาทาการ Test ด้วยโปรแกรมต่าง ๆ ที่ Tester เขียน ถ้า Test แล้วผ่าน ก็ Deploy ด้วย script หรือ Program ไปเลย Jenkins เรียกการทางานเหล่านี้ในหนึ่งกระบวกการว่า Project ใน 1 Project มีหลาย Job ทางานต่อเนื่องกันไป
- 8. วิธีติดตั้ง Jenkins (สาหรับ windows) ไปที่ Native packages ด้านขวามือ เลือก Windows เพื่อ Download Download ได้จาก https://jenkins-ci.org/
- 9. File ที่ได้จากการ download เป็น .rar ทาการแตก file .rar ออกมา จะได้ออกมาเป็นแบบนี้ เลือก setup เพื่อทาการติดตั้ง
- 10. หน้าตาของ File setup ให้ทาการติดตั้งจนเสร็จ
- 11. หน้าตาของ Jenkins สามารถ เข้าใช้งาน Jenkins ผ่านทาง web browser ได้ ด้วย url: http://localhost:8080/ 1 2 1 คือส่วนของเมนู ประกอบไปด้วย -สร้าง job ใหม่ -บุคคลที่เข้าใช้งาน -ประวัติการ build -Credentials -คิวของ job ที่กาลังทาการ build -สถานะของ job ที่กาลังทาการ build 2 คือส่วนของjob ประกอบไปด้วย S คือ status ของ job นั้น แบ่งออกเป็น 3สี คือ สีเทา = ยังไม่ได้build สีแดง = job Failed สีเหลือง = job Unstable สีน้าเงิน = job Success W คือ ค่าเฉลี่ยของการ build แต่ละครั้ง มีตั้งแต่ แจ่มใส จนถึง เมฆฝน ก็คือ build แล้ว job Success มากกว่า จนถึง job Failed มากกว่า
- 12. สิ่งที่ต้องรู้เกี่ยวกับ การเชื่อมต่อ Jenkins กับ Programs ต่างๆ 1. เราควรจะโหลดโปรแกรมเกียวกับ plugins ที่เราจะใช้งานเสียก่อน 2. Plugins ของ jenkins เป็นเพียงตัวเรียกใช้งานโปรแกรมหรือตัวเชื่อมต่อ เท่านั้น 3. ถ้าไม่มีโปรแกรม Plugins ก้อไม่สามารถใช้งานได้
- 13. การตั้งค่า Jenkins เชื่อมต่อ กับ Git (ติดตั้ง Plugin Git) ก่อนอื่นต้องทาการติดตั้ง get clients โดยสามารถ download ได้จาก https://git-scm.com/download/win เมือติดตั้งเสร็จเรียบร้อยให้กลับมาที่ Jenkins เพื่อทาการโหลด Plugin กดเข้าไปที่ Manage Jenkins -> Manage Plugins -> Available / Installed(ที่มีอยู่) ติ๊กถูกเลือก Git Plugin และ Git Client Plugin กด รอให้Jenkins ติดตั้ง Plugin จนเสร็จ ติ๊กถูกที่
- 14. การตั้งค่า Jenkins เชื่อมต่อ กับ Git (ตั้งค่า Git ให้พร้อมใช้งาน) กดเข้าไปที่ Manage Jenkins -> Configure System เลือกไปที่ Git -> Add Git ใส่ Name กับ Path to Git… เมื่อใส่เสร็จเรียบร้อย กด Save ,เสร็จการตั้งค่า Git แล้วนะครับ ^^ ในช่องนี้ให้ใส่ Path ของ Git Clients ที่เรา download มาแต่แรก เดิมทีจะอยู่ที่ C:Program FilesGitcmdgit.exe
- 15. การตั้งค่า Jenkins เชื่อมต่อ กับ MSBuild (ติดตั้ง Plugin MSBuild) โดยปกติ MSBuild จะมากับการลง MS.Visual Studio กดเข้าไปที่ Manage Jenkins -> Manage Plugins -> Available / Installed(ที่มีอยู่) ติ๊กถูกเลือก MSBuild Plugin กด รอให้Jenkins ติดตั้ง Plugin จนเสร็จ ติ๊กถูกที่
- 16. การตั้งค่า Jenkins เชื่อมต่อ กับ MSBuild (ตั้งค่า MSBuild ให้พร้อมใช้งาน) กดเข้าไปที่ Manage Jenkins -> Configure System เลือกไปที่ MSBuild -> MS Build installations... -> Add MSBuild, ใส่ Name กับ Path to MSBuild … เมื่อใส่เสร็จเรียบร้อย กด Save ,เสร็จการตั้งค่า MSBuild แล้วนะครับ ^^ ในช่องนี้ให้ใส่ Path ของ MSBuild ปกติทีจะอยู่ที่ C:WindowsMicrosoft.NETFrameworkv4.0.30319MSBuild.exe
- 17. การใช้งาน jenkins ร่วมกับ Git, MSBuild และ Nunit เริ่มจากการสร้าง job กัน Jenkins -> New item(ใหม่ Item) -> ใส่ Item name เลือก Freestyle project -> กด OK จะได้หน้าตาของ Item ที่เราสร้างขึ้นมาใหม่
- 18. ใช้งาน Git ทาไม? เพราะเป็นโปรแกรม Source Code Management หรือโปรแกรมจัดการซอส โค้ด นั้นเอง เราจึงต้องใช้งาน โปรแกรมประเภทนี้ เพื่อ ดึงซอสโค้ด มาให้jenkins ได้เรียกใช้งาน ต่างๆนาๆ แล้วใช้โปรแกรม Source Code Management ตัวอื่นมีไหม? แล้วสามารถใช้ ร่วมกับ jenkins ได้ไหม? แล้วทาไมต้องใช้ Git? คาตอบคือ มีครับ เช่น CVS, SVN เป็นต้น แล้วก็สามารถใช้ร่วมกับ jenkins ได้เช่นกัน เหตุผลที่ใช้Git เพราะเป็น Source Code Management ที่ได้รับความนิยม สูงสุดในการใช้ร่วมกับ jinkins ซึ่งทาให้หาข้อมูลได้ง่าย และที่สาคัญคนสั่งให้ทา presentation บอกให้ทา ผมจึงต้องทาครับ - -’ และควรจะ build job ให้ผ่านเพื่อให้รู้ว่าตอนนี้ เราสามารถดึง Source Code ได้แล้ว
- 19. การใช้งาน Git 1. มาที่ Source Code Management เลือกที่ Git 2. ใส่ URL ของ Git ที่ต้องการ 3.กด Add เพื่อใส่ username, password (ถ้ามี) เมื่อเซตทุกอย่างแล้ว กด Save ได้เลย
- 20. การสั่ง build Job ของ Jenkins 1. กด “Build Now” เพื่อสั่ง build ตอนนี้ Job เรากาลัง build ครับ
- 21. ใช้งาน MSBuild ทาไม? หลังจากที่เรา build Git ของเราผ่านแล้ว ตอนนี้เราได้ Source Code มาอยู่ที่เครื่อง แล้วนะครับ ปกติจะอยู่ที่ C:Program Files (x86)Jenkinsjobs[ชื่อ item ที่เราตั้ง]workspace เพราะเราทา Web App ด้วย MVC ซึ่งพัฒนาจาก MS. visual studio เพราะเป็นโปรแกรมที่ติดตั้งมาพร้อมกับ visual studio เพื่อใช้ในการ build โปรแกรม ซึ่งถ้าเราต้องการเช็คว่าโปรแกรมเรา build Source Code ของ VS ได้ไหม มี Error หรือ Warnings หรือป่าว และใช้งาน test อื่นๆต่อไป เราควรจะใช้ MSBuild ในการ build ให้สาเร็จเสียก่อน
- 22. การใช้งาน MSBuild 1. Add build step -> Build a Visual Studio… 2. MSBuild Version เลือก Version ของ .Net 3. ใส่ Path ที่เก็บ .sln (ไฟล์ที่ไว้รันโปรเจคอะครับ) 4. (ตย.)ถ้ามีปัญหา กรณี MSBuild Build Version ที่เครื่องไม่มี สามารถ ใช้คาสั่ง Command Line เปลี่ยนได้
- 23. การใช้งาน Nunit ทาไม? หลังจากที่ใช้งาน MSBuild ได้แล้ว ตอนนี้ Project เราสามารถ build Source Code ของ VS ได้แล้วนะครับ เพราะเราใช้ Nunit ในการ test Project เราจึงต้อง เชื่อมต่อ Nunit เพื่อ test job ใน jenkins และที่สาคัญเหมือนเดิมครับ คนสั่งให้ทา presentation บอกให้ทา ผมจึง ต้องทาครับ - -’ ก่อนอื่น เราต้องโหลด Nunit เพื่อเรียกใช้งาน จาก http://nunit.org/?p=download
- 24. การใช้งาน Nunit 1. Add build step -> Execute Windows batch commend 2. ใส่ “pathของNunit” ตามด้วย pathของtest ที่เราสร้างไว้ 3. กด Save
- 25. หลังจากที่ Build Now เข้ามาใน Build Hissory เพื่อดู console เลือก build ที่เราพึ่ง build ถ้าขึ้นยังงี้ คือ เราสามารถ run test ผ่านหมดแล้วนะครับ
- 26. เรามาดูที่ foder job เรา จะได้ไฟล์ .xml แบบนี้มานะครับ จากนั้นเราไปที่ Configure เพื่อ ทา report เลื่อนลงมาที่ Add post-build action -> Publish Nunit test… 1. ใส่ path ของ .xml ที่ได้มา 2. กด Save
- 27. การดู Report หลังการ Save แล้ว เข้ามาดูที่ build ล่าสุด จะได้test Result ขึ้นมา สามารถ กดไปดูได้
- 28. Test Result
- 29. การตั้งเวลาในการ poll&build 2. (ตย)การตั้งเวลา Build ทุก 10 นาที 1. (ตย)การตั้งเวลา Poll ทุก 10 นาที เมื่อเซตทุกอย่างแล้ว กด Save ได้เลย
- 30. การทาให้Jenkins build ทุกครั้งที่ git มีการ เปลี่ยนแปลง
- 31. นา link ที่เรา copy มาวางไว้ใน Webhook & Services เท่านี้ Jenkins ก็สามารถเอา Code มา build ทุกครั้งที่คุณ push ขึ้น git server แล้วครับ ***ถ้าหากคุณติดตั้ง Jenkins ไว้หลัง Router บ้านคุณเองอย่าลืมที่จะทา Port Forwarding นะครับ...!!!