ตามที่ได้ประกาศไว้ในบล็อกโพสต์ต้นฉบับ เวอร์ชัน 4.0 และสูงกว่าของ Bazel จะรองรับแทร็กการเผยแพร่ 2 แบบ ได้แก่ การเปิดตัวแบบต่อเนื่องและการสนับสนุนระยะยาว (LTS) หน้านี้จะพูดถึงข้อมูลล่าสุด เกี่ยวกับโมเดลการเปิดตัวของ Bazel
การกำหนดเวอร์ชันรุ่น
Bazel ใช้รูปแบบ major.minor.patch การกำหนดเวอร์ชันความหมาย
- รุ่นหลักมีฟีเจอร์ที่เข้ากันไม่ได้กับรุ่นก่อนหน้า เวอร์ชันหลักแต่ละเวอร์ชันของ 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 ไม่ได้ให้การสนับสนุนสำหรับเวอร์ชันหลักนี้อีกต่อไป ผู้ใช้ทุกคนควรย้ายข้อมูลไปยัง Bazel LTS รุ่นที่ใหม่กว่า
ช่วงเวลาการเปิดตัว
Bazel เผยแพร่รุ่นสำหรับแทร็กการเผยแพร่ 2 แทร็กเป็นประจำ
การเปิดตัวทีละน้อย
- การเปิดตัวทีละขั้นเป็นการประสานงานกับการเปิดตัว Google Blaze และจะเปิดตัวจาก HEAD ทุกๆ 2 สัปดาห์ นี่คือพรีวิวของ Bazel LTS รุ่นถัดไป
- การเปิดตัวแบบค่อยเป็นค่อยไปสามารถจัดส่งการเปลี่ยนแปลงที่เข้ากันไม่ได้ เราขอแนะนำให้ใช้แฟล็กที่ใช้ร่วมกันไม่ได้สำหรับการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบที่สำคัญ การเปิดตัวการเปลี่ยนแปลงที่เข้ากันไม่ได้ควรเป็นไปตามนโยบายความเข้ากันได้แบบย้อนหลัง
รุ่น LTS
- รุ่นหลัก: คาดว่าจะตัดรุ่น LTS ใหม่ออกจาก HEAD ทุกๆ 12 เดือนโดยประมาณ เมื่อ LTS รุ่นใหม่เปิดตัวแล้ว ก็จะเข้าสู่ระยะ "ใช้งานอยู่" ทันที และ LTS รุ่นก่อนหน้าจะเข้าสู่ขั้นตอนการบำรุงรักษา
- การเปิดตัวย่อย: คาดว่าเวอร์ชันย่อยใหม่ๆ ในแทร็ก LTS ที่ใช้งานอยู่จะเผยแพร่ 1 ครั้งต่อทุก 2 เดือน
- การเผยแพร่แพตช์: แพตช์เวอร์ชันใหม่สำหรับรุ่น LTS ในขั้นตอนใช้งานอยู่และการบำรุงรักษาคาดว่าจะเผยแพร่ได้ตามความต้องการสำหรับการแก้ไขข้อบกพร่องที่สำคัญ
- รุ่น Bazel LTS เข้าสู่ระยะเลิกใช้งานหลังจากอยู่ในขั้นตอนการบำรุงรักษาเป็นเวลา 2 ปี
สำหรับการเผยแพร่ที่วางแผนไว้ โปรดตรวจสอบปัญหาเกี่ยวกับ การเผยแพร่บน GitHub
เมทริกซ์การสนับสนุน
| รุ่น LTS | ระยะการสนับสนุน | เวอร์ชันล่าสุด | สิ้นสุดการสนับสนุน |
|---|---|---|---|
| บาเซล 7 | ทบเวลา | ตรวจสอบหน้าการเผยแพร่ใน GitHub | ไม่มีข้อมูล |
| บาเซล 6 | ใช้งานอยู่ | 6.4.0 | ธ.ค. 2025 |
| บาเซล 5 | การบำรุงรักษา | 5.4.1 | ม.ค. 2025 |
| บาเซล 4 | การบำรุงรักษา | 4.2.4 | Jan 2024 |
ดู Bazel ทั้งหมดได้ในหน้าการเผยแพร่ใน GitHub
กระบวนการและนโยบายของการเผยแพร่
สำหรับการเปิดตัวแบบต่อเนื่อง ขั้นตอนนี้ไม่ซับซ้อน กล่าวคือทุกๆ 2 สัปดาห์ระบบจะสร้างรุ่นใหม่ซึ่งสอดคล้องกับเกณฑ์พื้นฐานเดียวกันกับการเปิดตัว Blaze ภายในของ Google เนื่องจากกำหนดการเผยแพร่ที่รวดเร็ว เราจึงไม่ได้ย่อการเปลี่ยนแปลงใดๆ ไปยังการเปิดตัวแบบต่อเนื่อง
สำหรับรุ่น LTS ให้ทำตามขั้นตอนและนโยบายด้านล่างนี้
- กำหนดสัญญาผูกมัดพื้นฐานสำหรับการเผยแพร่
- สำหรับรุ่น LTS รุ่นหลักรายการใหม่ คอมมิตพื้นฐานคือ HEAD ของ Branch หลัก
- สำหรับรุ่นย่อยหรือเวอร์ชันแพตช์ คอมมิตพื้นฐานคือส่วน HEAD ของรุ่น LTS เดียวกันรุ่นล่าสุดในปัจจุบัน
- สร้าง Branch ของรุ่นในชื่อ
release-<version>จากสัญญาผูกมัดพื้นฐาน - การเปลี่ยนแปลง Backport ผ่าน PR ไปยัง Branch ของรุ่น
- ชุมชนสามารถแนะนำสัญญาผูกมัดบางรายการให้มีการส่งกลับมาได้ด้วยการตอบกลับ "
@bazel-io flag" ในปัญหาหรือ PR ที่เกี่ยวข้องเพื่อทำเครื่องหมายเป็นอุปสรรคในการปล่อยที่อาจเกิดขึ้น ทีม Bazel จะตรวจสอบและตัดสินใจว่าจะย้ายคอมมิตหรือไม่ - เฉพาะคอมมิตที่เข้ากันได้แบบย้อนหลังใน Branch หลักเท่านั้นที่สามารถโอนย้อนหลังได้ สามารถยอมรับการเปลี่ยนแปลงเล็กน้อยเพิ่มเติมเพื่อแก้ไขความขัดแย้งในการรวมได้
- ชุมชนสามารถแนะนำสัญญาผูกมัดบางรายการให้มีการส่งกลับมาได้ด้วยการตอบกลับ "
- ระบุตัวบล็อกการเผยแพร่และแก้ไขปัญหาที่พบใน Branch ของรุ่น
- มีการทดสอบ Branch ของรุ่นด้วยชุดทดสอบเดียวกันในหลังส่งและไปป์ไลน์การทดสอบดาวน์สตรีมใน Bazel CI ทีม Bazel ติดตามผลการทดสอบของ Branch และแก้ไขการถดถอยที่พบ
- สร้างตัวเลือกการเผยแพร่ใหม่จาก Branch ของรุ่นเมื่อแก้ไขตัวบล็อกรุ่นที่ทราบทั้งหมดแล้ว
- จะมีการประกาศรายชื่อผู้ได้รับการเสนอชื่อในการพูดคุยเกี่ยวกับ Bazel และทีม Bazel ยังคอยตรวจสอบรายงานข้อบกพร่องของชุมชนสำหรับผู้สมัครดังกล่าว
- หากตรวจพบตัวบล็อกการเผยแพร่ใหม่ ให้กลับไปที่ขั้นตอนสุดท้ายและสร้างผู้สมัครรุ่นใหม่หลังจากแก้ไขปัญหาทั้งหมดแล้ว
- ระบบไม่อนุญาตให้เพิ่มฟีเจอร์ใหม่ใน Branch ของรุ่นหลังจากสร้างผู้สมัครรุ่นแรกแล้ว
- พุชผู้สมัครที่จะเผยแพร่เป็นรุ่นอย่างเป็นทางการหากไม่พบตัวบล็อกการเผยแพร่เพิ่มเติม
- สำหรับการเผยแพร่แพตช์ ให้พุชรุ่นดังกล่าวอย่างน้อย 2 วันทำการหลังจากการเปิดตัวแพตช์ครั้งล่าสุดออกมา
- สำหรับรุ่นหลักและรุ่นย่อย ให้พุชรุ่นในอีก 2 วันทำการหลังจากรุ่นที่เผยแพร่ล่าสุดเปิดตัว แต่ต้องไม่เร็วกว่า 1 สัปดาห์หลังจากการเปิดตัวรุ่นแรกเปิดตัว
- การเผยแพร่จะพุชในวันที่วันถัดไปเป็นวันทำการเท่านั้น
- มีการประกาศข่าวการเปิดตัวใน bazel-discuss และทีมงาน Bazel ติดตามและแก้ไขรายงานข้อบกพร่องของชุมชนสำหรับรุ่นใหม่
รายงานการเกิดปัญหาซ้ำ
หากผู้ใช้พบการถดถอยใน Bazel รุ่นใหม่ ผู้สมัครรับเลือกตั้ง หรือแม้กระทั่ง Bazel ที่ HEAD โปรดรายงานข้อบกพร่องใน GitHub คุณสามารถใช้ Bazelisk เพื่อแบ่งตัวผู้ก่อเหตุและรวมข้อมูลนี้ในรายงานข้อบกพร่อง
ตัวอย่างเช่น หากบิลด์ของคุณสำเร็จด้วย Bazel 6.1.0 แต่ทำไม่สำเร็จด้วยเวอร์ชัน 6.2.0 ซึ่งเป็นรุ่นที่ 2 ที่เป็นเวอร์ชัน 6.2 คุณจะแยกเวอร์ชันได้ผ่านทาง
bazelisk --bisect=6.1.0..release-6.2.0rc2 build //foo:bar
คุณสามารถตั้งค่าตัวแปรสภาพแวดล้อม BAZELISK_SHUTDOWN หรือ BAZELISK_CLEAN ให้เรียกใช้คำสั่ง bazel ที่เกี่ยวข้องเพื่อรีเซ็ตสถานะของบิลด์ หากจําเป็นต่อการทําให้ปัญหาเกิดซ้ำ ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบเกี่ยวกับฟีเจอร์ของ Bisect ของ Bazelisk
อย่าลืมอัปเกรด Bazelisk เป็นเวอร์ชันล่าสุดเพื่อใช้ฟีเจอร์ Bisect
ความเข้ากันได้ของกฎ
หากคุณเป็นผู้เขียนกฎและต้องการคงความสามารถในการใช้งานร่วมกันกับ Banzel เวอร์ชันต่างๆ กัน โปรดดูหน้าความเข้ากันได้ของกฎ