รุ่นที่เผยแพร่

ตามที่ประกาศไว้ใน บล็อกโพสต์ต้นฉบับ Bazel 4.0 ขึ้นไปรองรับเส้นทางการเผยแพร่ 2 เส้นทาง ได้แก่ การเผยแพร่แบบทบเวลาและการเผยแพร่การสนับสนุนระยะยาว (LTS) หน้านี้ครอบคลุมข้อมูลล่าสุดเกี่ยวกับโมเดลการเผยแพร่ของ Bazel

เมทริกซ์การสนับสนุน

คุณดูการเผยแพร่ 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 เราจะทำตามขั้นตอนและนโยบายด้านล่าง

1. กำหนดคอมมิตพื้นฐานสำหรับการเผยแพร่
   • สำหรับการเผยแพร่ LTS เวอร์ชันหลักใหม่ คอมมิตพื้นฐานคือ HEAD ของ Branch หลัก
   • สำหรับการเผยแพร่เวอร์ชันย่อยหรือเวอร์ชันแพตช์ คอมมิตพื้นฐานคือ HEAD ของเวอร์ชันล่าสุดปัจจุบันของการเผยแพร่ LTS เดียวกัน
2. สร้าง Branch การเผยแพร่ในชื่อ release-<version> จากคอมมิตพื้นฐาน
3. ย้ายการเปลี่ยนแปลงผ่าน PR ไปยัง Branch การเผยแพร่
   • ชุมชนสามารถแนะนำคอมมิตบางรายการที่จะย้ายได้โดยตอบกลับ "@bazel-io flag" ในปัญหาหรือ PR ที่เกี่ยวข้องใน GitHub เพื่อทำเครื่องหมายคอมมิตเหล่านั้นเป็นตัวบล็อกการเผยแพร่ที่อาจเกิดขึ้น ทีม Bazel จะจัดลำดับความสำคัญและตัดสินใจว่าจะย้ายคอมมิตหรือไม่
   • เฉพาะคอมมิตที่เข้ากันได้กับเวอร์ชันก่อนหน้าใน Branch หลักเท่านั้นที่จะย้ายได้ และเราอนุญาตให้มีการเปลี่ยนแปลงเล็กน้อยเพิ่มเติมเพื่อแก้ไขข้อขัดแย้งในการผสาน

4. ย้ายการเปลี่ยนแปลงโดยใช้ปัญหาคำขอ Cherry-Pick สำหรับผู้ดูแล Bazel

   • ผู้ดูแล Bazel สามารถขอเลือกใช้คอมมิตที่เฉพาะเจาะจงไปยัง Branch การเผยแพร่ได้ กระบวนการนี้เริ่มต้นด้วยการสร้างคำขอเลือกใช้ใน GitHub วิธีการมีดังนี้

     1. เปิดคำขอ เลือกใช้
     2. กรอกรายละเอียดคำขอ
        • ชื่อ: ตั้งชื่อคำขอให้กระชับและสื่อความหมาย
        • รหัสคอมมิต: ป้อนรหัสของคอมมิตที่ต้องการเลือกใช้ หากมีคอมมิตหลายรายการ ให้คั่นคอมมิตเหล่านั้นด้วยคอมมา
        • หมวดหมู่: ระบุหมวดหมู่ของคำขอ
        • ผู้ตรวจสอบ: หากมีผู้ตรวจสอบหลายคน ให้คั่นรหัส GitHub ของผู้ตรวจสอบแต่ละคนด้วยคอมมา
     3. ตั้งเป้าหมาย
        • ค้นหาส่วน "เป้าหมาย" แล้วคลิกการตั้งค่า
        • เลือกตัวบล็อกการเผยแพร่ X.Y.Z ที่เหมาะสม การดำเนินการนี้จะทริกเกอร์บ็อตเลือกใช้ให้ประมวลผลคำขอของคุณสำหรับ Branch "release-X.Y.Z"
     4. ส่งปัญหา
        • เมื่อกรอกรายละเอียดทั้งหมดและตั้งเป้าหมายแล้ว ให้ส่งปัญหา

   • บ็อตเลือกใช้จะประมวลผลคำขอและแจ้งให้ทราบว่าคอมมิตมีสิทธิ์เลือกใช้หรือไม่ หากคอมมิต Cherry-Pick ได้ ซึ่งหมายความว่าจะไม่มีข้อขัดแย้งในการผสานขณะ Cherry-Pick คอมมิต บ็อตจะสร้าง Pull Request ใหม่ เมื่อสมาชิกทีม Bazel อนุมัติคำขอ Pull แล้ว ระบบจะ Cherry-Pick คอมมิตและผสานคอมมิตเข้ากับ Branch การเผยแพร่ หากต้องการดูตัวอย่างภาพคำขอเลือกใช้ที่เสร็จสมบูรณ์แล้ว โปรดดู ตัวอย่าง นี้

5. ระบุตัวบล็อกการเผยแพร่และแก้ไขปัญหาที่พบใน Branch การเผยแพร่

   • ระบบจะทดสอบ Branch การเผยแพร่ด้วยชุดการทดสอบเดียวกันใน postsubmit และ ไปป์ไลน์การทดสอบดาวน์สตรีม ใน Bazel CI ทีม Bazel จะตรวจสอบผลการทดสอบของ Branch การเผยแพร่และแก้ไขการถดถอยที่พบ

6. สร้างรุ่นที่อาจได้รับการเผยแพร่ใหม่จาก Branch การเผยแพร่เมื่อตัวบล็อกการเผยแพร่ที่ทราบทั้งหมดได้รับการแก้ไขแล้ว

   • เราจะประกาศรุ่นที่อาจได้รับการเผยแพร่ใน bazel-discuss, และทีม Bazel จะตรวจสอบรายงานข้อบกพร่องของชุมชนสำหรับรุ่นที่อาจได้รับการเผยแพร่
   • หากพบตัวบล็อกการเผยแพร่ใหม่ ให้กลับไปที่ขั้นตอนสุดท้ายและสร้างรุ่นที่อาจได้รับการเผยแพร่ใหม่หลังจากแก้ไขปัญหาทั้งหมดแล้ว
   • เราไม่อนุญาตให้เพิ่มฟีเจอร์ใหม่ลงใน Branch การเผยแพร่หลังจากสร้างรุ่นที่อาจได้รับการเผยแพร่รุ่นแรกแล้ว และการ Cherry-Pick จะจำกัดอยู่เฉพาะการแก้ไขที่สำคัญเท่านั้น หากจำเป็นต้องเลือกใช้ ผู้ขอจะต้องตอบคำถามต่อไปนี้ การเปลี่ยนแปลงนี้สำคัญอย่างไร และมีประโยชน์อย่างไร การเปลี่ยนแปลงนี้มีแนวโน้มที่จะทำให้เกิดการถดถอยมากน้อยเพียงใด

7. โปรโมตรุ่นที่อาจได้รับการเผยแพร่ให้เป็นการเผยแพร่เวอร์ชันอย่างเป็นทางการหากไม่พบตัวบล็อกการเผยแพร่เพิ่มเติม

   • สำหรับการเผยแพร่เวอร์ชันแพตช์ ให้โปรโมตการเผยแพร่หลังจากรุ่นที่อาจได้รับการเผยแพร่รุ่นสุดท้ายออกแล้วอย่างน้อย 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 เวอร์ชันต่างๆ โปรดดูหน้า ความเข้ากันได้ของกฎ