เหตุใด build.number“ การละเมิด” ของการกำหนดเวอร์ชันความหมาย?

ผมได้อธิบายที่เสนอสร้างระบบ (Gradle / Artifactory / เจนกินส์ / Chef) ให้เป็นหนึ่งในสถาปนิกอาวุโสของเราและเขาได้แสดงความคิดเห็นกับฉันว่าฉันเรียงลำดับของการไม่เห็นด้วย แต่ผมไม่ได้มีประสบการณ์มากพอที่จะจริงๆชั่งน้ำหนักใน

โครงการนี้สร้างไลบรารี Java (JAR) เป็นสิ่งประดิษฐ์ที่ทีมอื่นนำมาใช้ซ้ำ สำหรับการกำหนดเวอร์ชันฉันต้องการใช้ความหมายของ:

<major>.<minor>.<patch>

โดยที่patchระบุถึงการแก้ไขบั๊ก / ฉุกเฉินminorระบุรีลีสที่เข้ากันได้แบบย้อนหลังและmajorบ่งชี้ถึงการปรับเปลี่ยนขนาดใหญ่ของ API และ / หรือการเปลี่ยนแปลงที่เข้ากันไม่ได้ด้านหลัง

ตราบใดที่การส่งมอบตรงนี้คือสิ่งที่ฉันต้องการ: นักพัฒนาให้รหัสบางส่วน; สิ่งนี้ทริกเกอร์การสร้างสภาพแวดล้อม QA / TEST การทดสอบบางอย่างถูกเรียกใช้ (บางแบบอัตโนมัติและแบบทดสอบด้วยตนเอง) หากการทดสอบทั้งหมดผ่านไปแล้วบิลด์โปรดักชั่นจะเผยแพร่ JAR ไปยัง repo ภายในองค์กรของเรา ณ จุดนี้ JAR ควรได้รับการกำหนดเวอร์ชันอย่างถูกต้องและความคิดของฉันคือการใช้สิ่งbuild.numberที่สร้างขึ้นโดยอัตโนมัติและจัดทำโดยเครื่องมือ CI ของเราเพื่อทำหน้าที่เป็นหมายเลขโปรแกรมแก้ไข

ดังนั้นการกำหนดเวอร์ชันจะเป็น:

<major>.<minor>.<build.number>

อีกครั้งที่build.numberมีให้โดยเครื่องมือ CI

สถาปนิกปฏิเสธสิ่งนี้โดยบอกว่าการใช้หมายเลขการสร้าง CI นั้นเป็น "การละเมิด" ของการกำหนดเวอร์ชันเชิงความหมาย

คำถามของฉันคือ: ถูกต้องและถ้าเป็นเช่นนั้นทำไม? และถ้าไม่ทำไมไม่

หมายเลขบิลด์ของคุณจะไม่ถูกรีเซ็ตเป็น 0 เมื่อรุ่นรองและรุ่นใหญ่เพิ่มขึ้นนี่เป็นการละเมิดข้อกำหนดส่วนที่ 7 และ 8 ของสเป็ค :

รุ่นรอง Y (xYz | x> 0) จะต้องเพิ่มขึ้นหากมีการแนะนำฟังก์ชั่นใหม่เข้ากันได้กับ API สาธารณะ ต้องเพิ่มขึ้นหากฟังก์ชัน API สาธารณะใด ๆ ถูกทำเครื่องหมายว่าเลิกใช้แล้ว มันอาจจะเพิ่มขึ้นหากมีการใช้งานฟังก์ชั่นใหม่ ๆ หรือการปรับปรุงอย่างมากภายในรหัสส่วนตัว อาจรวมถึงการเปลี่ยนแปลงระดับแพทช์ ต้องแก้ไขเวอร์ชันของตัวแก้ไขเป็น 0 เมื่อมีการเพิ่มรุ่นรอง

รุ่นหลัก X (Xyz | X> 0) จะต้องเพิ่มขึ้นหากมีการแนะนำการเปลี่ยนแปลงย้อนหลังที่เข้ากันไม่ได้กับ API สาธารณะ อาจรวมถึงการเปลี่ยนแปลงเล็กน้อยและระดับแพทช์ ต้องติดตั้ง Patch และเวอร์ชันรองเป็น 0 เมื่อมีการเพิ่มรุ่นหลัก

ดังนั้นต้องมีการจัดเตรียมหมายเลขรุ่น (หลัก, รองลงมา, แพตช์) ด้วยตนเองเนื่องจากจะใช้เพื่อบอกผู้ใช้ของคุณเกี่ยวกับการเปลี่ยนแปลงในที่เดียวโดยไม่ต้องดูการเปลี่ยนแปลงหรือเอกสารอื่น ๆ ของคุณ

หากคุณต้องการรวมหมายเลขบิลด์ของคุณคุณสามารถต่อท้ายหมายเลข+(ส่วนที่ 10):

Build metadata MAY สามารถแสดงได้โดยผนวกเครื่องหมายบวกและชุดของตัวระบุจุดที่คั่นด้วยจุดต่อจากแพทช์หรือเวอร์ชั่นก่อนวางจำหน่าย ตัวระบุต้องประกอบด้วยตัวอักษรและตัวเลข ASCII เท่านั้น [0-9A-Za-z-] ตัวระบุต้องไม่เว้นว่าง Build metadata SHOULD จะถูกละเว้นเมื่อพิจารณาถึงความสำคัญของเวอร์ชัน ดังนั้นสองเวอร์ชันที่แตกต่างกันเฉพาะในข้อมูลเมตาของบิลด์มีความสำคัญเท่ากัน ตัวอย่าง: 1.0.0-alpha + 001, 1.0.0 + 20130313144700, 1.0.0-beta + exp.sha.5114f85

เหตุผลหนึ่งก็คือแพตช์อาจต้องมีหลายบิลด์ดังนั้นถ้าคุณมีเวอร์ชัน 5.7 และคุณต้องการแพตช์เป็น 5.7.1 แต่การแก้ไขข้อบกพร่อง 2 ครั้งแรกของคุณล้มเหลวในการสร้างเมื่อพวกเขาถูกส่งไปยังระบบ CI แล้วคุณจะ ที่ 5.7.3 ก่อนที่คุณจะเปิดตัวแพตช์แรก!

คำตอบก็คือใช้ตัวเลข 4 หลัก (เนื่องจากระบบของ Microsoft มีแนวโน้ม) ที่ 4 คือหมายเลขบิลด์และใช้ "สำหรับข้อมูลเท่านั้น" โดยทั่วไปแล้วคนใส่หมายเลขรุ่นที่เก็บไว้ในนั้น (ถ้าพวกเขาใช้ SVN หรือ TFS หรือคล้ายกัน) ซึ่งเป็นเรื่องที่ดีมากในขณะที่คุณสามารถตรวจสอบว่าการกระทำที่แน่นอนถูกนำมาใช้ในการสร้างไบนารี หากคุณไม่มีสิ่งนั้นหมายเลขการสร้าง CI นั้นเป็นการประมาณที่สมเหตุสมผล (เนื่องจากคุณหวังว่าระบบ CI ของคุณสามารถจดจำหมายเลขการสร้างและผูกเข้ากับประวัติ repo ได้ แต่คุณไม่ได้พึ่งพา CI ระบบจดจำพวกเขา - คุณไม่สามารถลบงานสร้างเก่าได้)

สิ่งหนึ่งที่ควรทราบ Microsoft schema สำหรับการกำหนดเวอร์ชันใช้ตำแหน่งที่ 3 สำหรับหมายเลขบิลด์ Chrome ใช้หมายเลขเพียง 1 หมายเลข Ubuntu ใช้วันที่ ไม่มี "มาตรฐาน" ให้ใช้ยกเว้นว่าตัวเลขทั้งหมดจะต้องเพิ่มขึ้น