คุณสามารถเรียกใช้ Bazel จากสคริปต์เพื่อสร้าง เรียกใช้การทดสอบ หรือค้นหา กราฟทรัพยากร Dependency Bazel ได้รับการออกแบบมาเพื่อใช้สคริปต์ที่มีประสิทธิภาพ แต่ ส่วนนี้แสดงรายละเอียดบางอย่างที่ควรคำนึงถึงเพื่อให้สคริปต์มี แข็งแกร่ง
การเลือกฐานเอาต์พุต
ตัวเลือก --output_base
จะควบคุมตำแหน่งที่กระบวนการ Bazel ควรเขียน
เอาต์พุตของบิลด์ไปยัง ตลอดจนไฟล์งานต่างๆ ที่ใช้ภายในโดย
Bazel หนึ่งในนั้นเป็นล็อกที่ป้องกันการกลายพันธุ์ของ
ตามกระบวนการของ Bazel ที่หลากหลาย
การเลือกไดเรกทอรีฐานเอาต์พุตที่ถูกต้องสำหรับสคริปต์ขึ้นอยู่กับ
ปัจจัย หากคุณต้องใส่เอาต์พุตของบิลด์ในตำแหน่งเฉพาะ การดำเนินการนี้จะ
ให้เขียนถึงฐานเอาต์พุตที่ต้องการใช้ หากคุณกำลังสร้างสถานะ "อ่านอย่างเดียว" โทรหา
Bazel (เช่น bazel query
) ปัจจัยในการล็อกจะมีความสำคัญมากกว่า ใน
โดยเฉพาะ หากคุณต้องการเรียกใช้สคริปต์หลายอินสแตนซ์พร้อมกัน
คุณจะต้องให้ฐานเอาต์พุตที่แตกต่างกัน (หรือแบบสุ่ม) ให้กับแต่ละแบบ
หากคุณใช้ค่าฐานเอาต์พุตเริ่มต้น คุณจะต้องแข่งขันกันเพื่อ ล็อกที่ใช้โดยคำสั่ง Bazel แบบอินเทอร์แอกทีฟของผู้ใช้ หากผู้ใช้พบปัญหา คำสั่งที่ทำงานมานาน เช่น บิลด์ สคริปต์จะต้องรอคำสั่งเหล่านั้น ที่คุณต้องดำเนินการให้เสร็จก่อนที่จะดำเนินการต่อ
หมายเหตุเกี่ยวกับโหมดเซิร์ฟเวอร์
โดยค่าเริ่มต้น Bazel ใช้กระบวนการของเซิร์ฟเวอร์ที่ใช้เวลานานเป็น
การเพิ่มประสิทธิภาพ เมื่อเรียกใช้ Bazel ในสคริปต์ อย่าลืมโทรหา shutdown
เมื่อคุณดำเนินการกับเซิร์ฟเวอร์เสร็จแล้ว หรือระบุ --max_idle_secs=5
เพื่อให้
เซิร์ฟเวอร์ที่ไม่มีการใช้งานจะปิดตัวลงทันที
ฉันจะได้รับรหัสทางออกใด
Bazel พยายามจะแยกความแตกต่างของความล้มเหลวเนื่องจากซอร์สโค้ดภายใต้ การพิจารณาจากข้อผิดพลาดภายนอกที่ทำให้ Bazel ทำงานอย่างไม่ถูกต้อง การดำเนินการของ Bazel อาจทำให้เกิดรหัสออกต่อไปนี้
ออกจากโค้ดที่ใช้กันโดยทั่วไปในคำสั่งทั้งหมด:
0
- สำเร็จ2
- ปัญหาบรรทัดคำสั่ง ค่าสถานะหรือชุดคำสั่งที่ไม่ถูกต้องหรือไม่ถูกต้อง หรือ ตัวแปรสภาพแวดล้อมไม่ถูกต้อง คุณต้องแก้ไขบรรทัดคำสั่ง8
- บิลด์ขัดข้อง แต่เราได้สิ้นสุดการหยุดให้บริการอย่างเป็นขั้นตอน9
- การล็อกเซิร์ฟเวอร์ถูกระงับและผ่าน--noblock_for_lock
32
- สภาพแวดล้อมภายนอกไม่ทำงานในเครื่องนี้33
- Bazel หน่วยความจำเต็มและเกิดข้อขัดข้อง คุณต้องแก้ไขบรรทัดคำสั่ง34
- สงวนไว้สำหรับการใช้งานภายใน Google35
- สงวนไว้สำหรับการใช้งานภายใน Google36
- ปัญหาสิ่งแวดล้อมในท้องถิ่น อาจเป็นไปได้ว่าคงอยู่ถาวร37
- ข้อยกเว้นที่ไม่มีการจัดการ / ข้อผิดพลาดภายใน Bazel38
- สงวนไว้สำหรับการใช้งานภายใน Google41-44
- สงวนไว้สำหรับการใช้งานภายใน Google45
- เกิดข้อผิดพลาดขณะเผยแพร่ผลลัพธ์ไปยังบริการ Build Event47
- สงวนไว้สำหรับการใช้งานภายใน Google
รหัสการคืนสินค้าสำหรับคำสั่ง bazel build
, bazel test
:
1
- การสร้างล้มเหลว3
- บิลด์ใช้ได้ แต่การทดสอบบางรายการล้มเหลวหรือหมดเวลา4
- สร้างสำเร็จ แต่ไม่พบการทดสอบแม้ว่าจะมีการทดสอบ ที่ขอ
สำหรับ bazel run
:
1
- การสร้างล้มเหลว- หากบิลด์สำเร็จ แต่กระบวนการย่อยที่ดำเนินการอยู่แสดงผลการออกที่ไม่ใช่ 0 โค้ดนี้จะเป็นโค้ดสำหรับออกของคำสั่งด้วย
สำหรับ bazel query
:
3
- สำเร็จบางส่วน แต่คำค้นหาพบข้อผิดพลาดอย่างน้อย 1 รายการใน อินพุตของชุดไฟล์ BUILD ดังนั้นผลลัพธ์ของการดำเนินการจึงไม่ใช่ 100% เชื่อถือได้ ปัญหานี้อาจเกิดจากตัวเลือก--keep_going
ในบรรทัดคำสั่ง7
- คำสั่งล้มเหลว
เวอร์ชัน Bazel ในอนาคตอาจเพิ่มโค้ดสำหรับออกเพิ่มเติม แทนที่ความล้มเหลวทั่วไป
ออกจากโค้ด 1
ที่มีค่าอื่นๆ ที่ไม่ใช่ 0 ซึ่งมีความหมายเฉพาะ
อย่างไรก็ตาม ค่าที่ออกทั้งหมดที่ไม่ใช่ 0 จะกลายเป็นข้อผิดพลาดเสมอ
กำลังอ่านไฟล์ .bazelrc
โดยค่าเริ่มต้น Bazel จะอ่านไฟล์ .bazelrc
จากฐาน
Workspace หรือไดเรกทอรีหลักของผู้ใช้ ใช่หรือไม่
des คือทางเลือกสำหรับสคริปต์ของคุณ หากสคริปต์ของคุณจะต้อง
สมบูรณ์แบบ
มากมาย (เช่น เมื่อสร้างรุ่น) คุณควรปิดใช้การอ่าน
ไฟล์ .bazelrc โดยใช้ตัวเลือก --bazelrc=/dev/null
หากคุณต้องการดำเนินการ
บิลด์โดยใช้การตั้งค่าที่ผู้ใช้ต้องการ ลักษณะการทำงานเริ่มต้นจะดีกว่า
บันทึกคำสั่ง
นอกจากนี้ เอาต์พุต Bazel ยังพร้อมใช้งานในไฟล์บันทึกคำสั่งที่ใช้ค้นหาได้ด้วย คำสั่งต่อไปนี้
bazel info command_log
ไฟล์บันทึกคำสั่งมีสตรีม stdout และ stderr ที่มีการแทรกสลับของคำสั่ง
คำสั่ง Bazel ล่าสุด โปรดทราบว่าการเรียกใช้ bazel info
จะเขียนทับ
เนื้อหาของไฟล์นี้ จะกลายเป็นคำสั่ง Bazel ล่าสุด
แต่ตำแหน่งของไฟล์บันทึกคำสั่งจะไม่เปลี่ยนแปลงจนกว่าคุณจะเปลี่ยน
การตั้งค่าของตัวเลือก --output_base
หรือ --output_user_root
กำลังแยกวิเคราะห์เอาต์พุต
เอาต์พุต Bazel ค่อนข้างง่ายในการแยกวิเคราะห์เพื่อวัตถุประสงค์หลายอย่าง มี 2 ตัวเลือกที่อาจ
ที่เป็นประโยชน์สำหรับสคริปต์ของคุณคือ --noshow_progress
ซึ่งยับยั้งความคืบหน้า
และ --show_result n
ซึ่งควบคุมว่า
ไม่ใช่ "บิลด์ที่ทันสมัย" มีการพิมพ์ข้อความ ข้อความเหล่านี้อาจถูกแยกวิเคราะห์เป็น
ดูว่าเป้าหมายใดสร้างได้สำเร็จ และตำแหน่งของผลลัพธ์
ที่ผู้ใช้สร้างไว้ อย่าลืมระบุค่า n จำนวนมากหากคุณใช้
ข้อความเหล่านี้
การแก้ปัญหาประสิทธิภาพตามการทำโปรไฟล์
ดูส่วนการทำโปรไฟล์ประสิทธิภาพ