ตามที่ประกาศไว้ใน บล็อกโพสต์ต้นฉบับ Bazel เวอร์ชัน 4.0 ขึ้นไปรองรับแทร็กการเผยแพร่ 2 รายการ ได้แก่ การเผยแพร่แบบต่อเนื่อง และการเผยแพร่แบบการสนับสนุนระยะยาว (LTS) หน้านี้ครอบคลุมข้อมูลล่าสุดเกี่ยวกับโมเดลการเผยแพร่ของ Bazel
เมทริกซ์การสนับสนุน
| การเผยแพร่ LTS | ระยะการสนับสนุน | เวอร์ชันล่าสุด | สิ้นสุดการสนับสนุน |
|---|---|---|---|
| Bazel 10 | ต่อเนื่อง | ดูหน้าการเผยแพร่แบบต่อเนื่อง | ไม่มี |
| Bazel 9 | ใช้งานอยู่ | 9.1.1 | ธ.ค. 2028 |
| Bazel 8 | การบำรุงรักษา | 8.7.0 | ธ.ค. 2027 |
| Bazel 7 | การบำรุงรักษา | 7.7.1 | ธ.ค. 2026 |
| Bazel 6 | เลิกใช้ | 6.6.0 | ธ.ค. 2025 |
| Bazel 5 | เลิกใช้ | 5.4.1 | ม.ค. 2025 |
| Bazel 4 | เลิกใช้ | 4.2.4 | ม.ค. 2024 |
คุณดูการเผยแพร่ LTS ของ Bazel ทั้งหมดได้ในหน้า การเผยแพร่ใน GitHub
การกำหนดเวอร์ชันที่เผยแพร่
Bazel ใช้รูปแบบการกำหนดเวอร์ชันเชิงความหมาย major.minor.patch Semantic Versioning
- การเผยแพร่เวอร์ชันหลักมีฟีเจอร์ที่เข้ากันไม่ได้กับเวอร์ชันก่อนหน้า Bazel เวอร์ชันหลักแต่ละเวอร์ชันเป็นการเผยแพร่ LTS
- การเผยแพร่เวอร์ชันย่อยมีการแก้ไขข้อบกพร่องและฟีเจอร์ที่เข้ากันได้กับเวอร์ชันก่อนหน้า ซึ่งย้ายมาจาก Branch หลัก
- การเผยแพร่เวอร์ชันแพตช์มีการแก้ไขข้อบกพร่องที่สำคัญ
นอกจากนี้ ระบบจะระบุเวอร์ชันก่อนเปิดตัวโดยการเพิ่มยัติภังค์และคำต่อท้ายวันที่ลงในหมายเลขเวอร์ชันหลักถัดไป
ตัวอย่างเช่น การเผยแพร่เวอร์ชันใหม่ของแต่ละประเภทจะทำให้ได้หมายเลขเวอร์ชันต่อไปนี้
- หลัก: 6.0.0
- ย่อย: 6.1.0
- แพตช์: 6.1.2
- ก่อนเปิดตัว: 7.0.0-pre.20230502.1
ระยะการสนับสนุน
Bazel เวอร์ชันหลักแต่ละเวอร์ชันมีระยะการสนับสนุน 4 ระยะ ดังนี้
- ต่อเนื่อง: เวอร์ชันหลักนี้ยังอยู่ในระยะก่อนเปิดตัว ทีม Bazel จะเผยแพร่เวอร์ชันต่อเนื่องจาก HEAD
- ใช้งานอยู่: เวอร์ชันหลักนี้เป็นการเผยแพร่ LTS ที่ใช้งานอยู่ในปัจจุบัน ทีม Bazel จะย้ายฟีเจอร์ที่สำคัญและการแก้ไขข้อบกพร่องไปยังการเผยแพร่เวอร์ชันย่อย
- การบำริงรักษา: เวอร์ชันหลักนี้เป็นการเผยแพร่ LTS เวอร์ชันเก่าที่อยู่ในโหมดการบำรุงรักษา ทีม Bazel สัญญาว่าจะย้ายเฉพาะการแก้ไขข้อบกพร่องที่สำคัญสำหรับปัญหาด้านความปลอดภัยและปัญหาความเข้ากันได้ของระบบปฏิบัติการไปยังการเผยแพร่ LTS นี้
- เลิกใช้: ทีม Bazel จะไม่ให้การสนับสนุนเวอร์ชันหลัก นี้อีกต่อไป ผู้ใช้ทุกคนควรย้ายข้อมูลไปยังการเผยแพร่ LTS ของ Bazel เวอร์ชันใหม่กว่า
ความถี่ในการเผยแพร่
Bazel จะเผยแพร่เวอร์ชันสำหรับแทร็กการเผยแพร่ 2 รายการเป็นประจำ
การเผยแพร่แบบต่อเนื่อง
- การเผยแพร่แบบต่อเนื่องจะประสานงานกับการเผยแพร่ Google Blaze และเผยแพร่จาก HEAD ทุกๆ 2 สัปดาห์โดยประมาณ ซึ่งเป็นการแสดงตัวอย่างการเผยแพร่ LTS ของ Bazel เวอร์ชันถัดไป
- การเผยแพร่แบบต่อเนื่องอาจมีการเปลี่ยนแปลงที่ไม่เข้ากัน เราขอแนะนำให้ใช้แฟล็กที่ไม่เข้ากัน สำหรับการเปลี่ยนแปลงที่สำคัญ ซึ่งการเปิดตัวการเปลี่ยนแปลงที่ไม่เข้ากัน ควรเป็นไปตามนโยบายความเข้ากันได้กับเวอร์ชันก่อนหน้า
การเผยแพร่ LTS
- การเผยแพร่เวอร์ชันหลัก: คาดว่าจะมีการตัดการเผยแพร่ LTS ใหม่จาก HEAD ทุกๆ 12 เดือน โดยประมาณ เมื่อมีการเผยแพร่ LTS ใหม่แล้ว ระบบจะเข้าสู่ระยะใช้งานอยู่ทันที และการเผยแพร่ LTS ก่อนหน้าจะเข้าสู่ระยะการบำรุงรักษา
- การเผยแพร่เวอร์ชันย่อย: คาดว่าจะมีการเผยแพร่เวอร์ชันย่อยใหม่ในแทร็ก LTS ที่ใช้งานอยู่ทุกๆ 2 เดือน
- การเผยแพร่เวอร์ชันแพตช์: คาดว่าจะมีการเผยแพร่เวอร์ชันแพตช์ใหม่สำหรับการเผยแพร่ LTS ในระยะใช้งานอยู่และ ระยะการบำรุงรักษาตามความต้องการสำหรับการแก้ไขข้อบกพร่องที่สำคัญ
- การเผยแพร่ LTS ของ Bazel จะเข้าสู่ระยะเลิกใช้หลังจากอยู่ในระยะการบำรุงรักษาเป็นเวลา 2 ปี
สำหรับการเผยแพร่ที่วางแผนไว้ โปรดดูปัญหาการเผยแพร่ใน Github
ขั้นตอนและนโยบายการเผยแพร่
สำหรับเวอร์ชันต่อเนื่อง กระบวนการจะตรงไปตรงมา โดยจะมีการสร้างเวอร์ชันใหม่ทุกๆ 2 สัปดาห์โดยประมาณ ซึ่งสอดคล้องกับบรรทัดฐานเดียวกันกับการเผยแพร่ Blaze ภายในของ Google เนื่องจากกำหนดการเผยแพร่อย่างรวดเร็ว เราจึงไม่ย้ายการเปลี่ยนแปลงใดๆ ไปยังเวอร์ชันต่อเนื่อง
สำหรับการเผยแพร่ LTS เราจะทำตามขั้นตอนและนโยบายด้านล่าง
- กำหนดคอมมิตบรรทัดฐานสำหรับการเผยแพร่
- สำหรับการเผยแพร่ LTS เวอร์ชันหลักใหม่ คอมมิตบรรทัดฐานคือ HEAD ของ Branch หลัก
- สำหรับการเผยแพร่เวอร์ชันย่อยหรือแพตช์ คอมมิตบรรทัดฐานคือ HEAD ของเวอร์ชันล่าสุดปัจจุบันของการเผยแพร่ LTS เดียวกัน
- สร้าง Branch การเผยแพร่ในชื่อ
release-<version>จากคอมมิตบรรทัดฐาน - ย้ายการเปลี่ยนแปลงผ่าน PR ไปยัง Branch การเผยแพร่
- ชุมชนสามารถแนะนำคอมมิตบางรายการที่จะย้ายได้โดยตอบกลับ "
@bazel-io flag" ในปัญหาหรือ PR ที่เกี่ยวข้องใน GitHub เพื่อทำเครื่องหมายคอมมิตเหล่านั้นเป็นตัวบล็อกการเผยแพร่ที่อาจเกิดขึ้น ทีม Bazel จะจัดลำดับความสำคัญและตัดสินใจว่าจะย้ายคอมมิตหรือไม่ - เฉพาะคอมมิตที่เข้ากันได้กับเวอร์ชันก่อนหน้าใน Branch หลักเท่านั้นที่จะย้ายได้ และอนุญาตให้มีการเปลี่ยนแปลงเล็กน้อยเพิ่มเติมเพื่อแก้ไขข้อขัดแย้งในการผสาน
- ชุมชนสามารถแนะนำคอมมิตบางรายการที่จะย้ายได้โดยตอบกลับ "
ย้ายการเปลี่ยนแปลงโดยใช้ปัญหาคำขอ Cherry-Pick สำหรับผู้ดูแล Bazel
ผู้ดูแล Bazel สามารถขอเลือกใช้คอมมิตที่เฉพาะเจาะจงไปยัง Branch การเผยแพร่ได้ กระบวนการนี้เริ่มต้นด้วยการสร้างคำขอเลือกใช้ใน GitHub วิธีดำเนินการมีดังนี้
- เปิดคำขอ เลือกใช้
- กรอกรายละเอียดคำขอ
- ชื่อ: ตั้งชื่อคำขอให้กระชับและสื่อความหมาย
- รหัสคอมมิต: ป้อนรหัสของคอมมิตที่ต้องการเลือกใช้ หากมีคอมมิตหลายรายการ ให้คั่นคอมมิตเหล่านั้นด้วยคอมมา
- หมวดหมู่: ระบุหมวดหมู่ของคำขอ
- ผู้ตรวจสอบ: หากมีผู้ตรวจสอบหลายคน ให้คั่นรหัส GitHub ของผู้ตรวจสอบแต่ละคนด้วยคอมมา
- กำหนดเป้าหมาย
- ค้นหาส่วน "เป้าหมาย" แล้วคลิกการตั้งค่า
- เลือกตัวบล็อกการเผยแพร่ X.Y.Z ที่เหมาะสม การดำเนินการนี้จะทริกเกอร์บ็อตเลือกใช้ให้ประมวลผลคำขอของคุณสำหรับ Branch "release-X.Y.Z"
- ส่งปัญหา
- เมื่อกรอกรายละเอียดทั้งหมดและกำหนดเป้าหมายแล้ว ให้ส่งปัญหา
บ็อตเลือกใช้จะประมวลผลคำขอและแจ้งให้ทราบหากคอมมิตมีสิทธิ์เลือกใช้ หากคอมมิต Cherry-Pick ได้ ซึ่งหมายความว่าไม่มีข้อขัดแย้งในการผสานขณะ Cherry-Pick คอมมิต บ็อตจะสร้าง Pull Request ใหม่ เมื่อสมาชิกทีม Bazel อนุมัติคำขอ Pull แล้ว ระบบจะ Cherry-Pick คอมมิตและผสานไปยัง Branch การเผยแพร่ ดูตัวอย่างภาพคำขอเลือกใช้ Cherry-Pick ที่เสร็จสมบูรณ์ได้ที่ ตัวอย่าง นี้ .
ระบุตัวบล็อกการเผยแพร่และแก้ไขปัญหาที่พบใน Branch การเผยแพร่
- ระบบจะทดสอบ Branch การเผยแพร่ด้วยชุดการทดสอบเดียวกันใน postsubmit และ ไปป์ไลน์การทดสอบดาวน์สตรีม ใน Bazel CI ทีม Bazel จะตรวจสอบผลการทดสอบของ Branch การเผยแพร่และแก้ไขการถดถอยที่พบ
สร้างรุ่นที่อาจได้รับการเผยแพร่ใหม่จาก Branch การเผยแพร่เมื่อแก้ไขตัวบล็อกการเผยแพร่ที่ทราบทั้งหมดแล้ว
- เราจะประกาศรุ่นที่อาจได้รับการเผยแพร่ใน bazel-discuss, และทีม Bazel จะตรวจสอบรายงานข้อบกพร่องของชุมชนสำหรับรุ่นที่อาจได้รับการเผยแพร่
- หากพบตัวบล็อกการเผยแพร่ใหม่ ให้กลับไปที่ขั้นตอนสุดท้ายและสร้างรุ่นที่อาจได้รับการเผยแพร่ใหม่หลังจากแก้ไขปัญหาทั้งหมดแล้ว
- ไม่อนุญาตให้เพิ่มฟีเจอร์ใหม่ลงใน Branch การเผยแพร่หลังจากสร้างรุ่นที่อาจได้รับการเผยแพร่รุ่นแรกแล้ว และการ Cherry-Pick จะจำกัดเฉพาะการแก้ไขที่สำคัญเท่านั้น หากจำเป็นต้อง Cherry-Pick ผู้ขอจะต้องตอบคำถามต่อไปนี้ การเปลี่ยนแปลงนี้สำคัญอย่างไร และมีประโยชน์อย่างไร การเปลี่ยนแปลงนี้มีแนวโน้มที่จะทำให้เกิดการถดถอยมากน้อยเพียงใด
เผยแพร่รุ่นที่อาจได้รับการเผยแพร่เป็นเวอร์ชันอย่างเป็นทางการหากไม่พบตัวบล็อกการเผยแพร่เพิ่มเติม
- สำหรับการเผยแพร่แพตช์ ให้เผยแพร่เวอร์ชันอย่างน้อย 2 วันทำการหลังจากเผยแพร่รุ่นที่อาจได้รับการเผยแพร่ล่าสุด
- สำหรับการเผยแพร่เวอร์ชันหลักและเวอร์ชันย่อย ให้เผยแพร่เวอร์ชัน 2 วันทำการหลังจากเผยแพร่รุ่นที่อาจได้รับการเผยแพร่ล่าสุด แต่ไม่เร็วกว่า 1 สัปดาห์หลังจากเผยแพร่รุ่นที่อาจได้รับการเผยแพร่รุ่นแรก
- เราจะเผยแพร่เวอร์ชันในวันที่วันถัดไปเป็นวันทำการเท่านั้น
- เราจะประกาศการเผยแพร่ใน bazel-discuss, และทีม Bazel จะตรวจสอบและแก้ไขรายงานข้อบกพร่องของชุมชนสำหรับการเผยแพร่เวอร์ชันใหม่
รายงานการถดถอย
หากผู้ใช้พบการถดถอยในการเผยแพร่ Bazel เวอร์ชันใหม่ รุ่นที่อาจได้รับการเผยแพร่ หรือแม้แต่ Bazel ที่ HEAD โปรดแจ้งข้อบกพร่องใน GitHub คุณสามารถใช้ Bazelisk เพื่อแบ่งส่วนคอมมิตที่เป็นสาเหตุและใส่ข้อมูลนี้ในรายงานข้อบกพร่อง
ตัวอย่างเช่น หากการสร้างสำเร็จด้วย Bazel 6.1.0 แต่ล้มเหลวด้วยรุ่นที่อาจได้รับการเผยแพร่รุ่นที่ 2 ของ 6.2.0 คุณสามารถแบ่งส่วนผ่าน
bazelisk --bisect=6.1.0..release-6.2.0rc2 build //foo:bar
คุณสามารถตั้งค่าตัวแปรสภาพแวดล้อม BAZELISK_SHUTDOWN หรือ BAZELISK_CLEAN เพื่อเรียกใช้คำสั่ง Bazel ที่เกี่ยวข้องเพื่อรีเซ็ตสถานะการสร้างหากจำเป็นต้องสร้างปัญหาซ้ำ ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบเกี่ยวกับฟีเจอร์การแบ่งส่วนของ Bazelisk
อย่าลืมอัปเกรด Bazelisk เป็นเวอร์ชันล่าสุดเพื่อใช้ฟีเจอร์การแบ่งส่วน
ความเข้ากันได้ของกฎ
หากคุณเป็นผู้เขียนกฎและต้องการรักษาความเข้ากันได้กับ Bazel เวอร์ชันต่างๆ โปรดดูหน้าความเข้ากันได้ของ กฎ