กลุ่มการดำเนินการช่วยให้มีแพลตฟอร์มการดำเนินการได้หลายแพลตฟอร์มภายในเป้าหมายเดียว กลุ่มการดำเนินการแต่ละกลุ่มมีทรัพยากร Dependency toolchain เป็นของตัวเองและแก้ปัญหา Toolchain ของตนเอง
ที่มา
กลุ่มการดำเนินการช่วยให้ผู้เขียนกฎกำหนดชุดการดำเนินการได้ โดยแต่ละกลุ่มอาจมีแพลตฟอร์มการดำเนินการที่แตกต่างกัน แพลตฟอร์มการดำเนินการหลายแพลตฟอร์มอาจอนุญาตให้มีการดำเนินการที่แตกต่างกัน เช่น การคอมไพล์แอป iOS บนผู้ปฏิบัติงานระยะไกล (linux) แล้วลิงก์/ลงนามโค้ดบนผู้ปฏิบัติงาน Mac ในเครื่อง
การกำหนดกลุ่มการดำเนินการยังช่วยลดการใช้งานความทรงจำของการดำเนินการเป็นพร็อกซีสำหรับการระบุการดำเนินการได้ด้วย การช่วยจำไม่จำเป็นต้องไม่ซ้ำกัน และจะกล่าวถึงได้เพียงครั้งเดียวเท่านั้น ซึ่งมีประโยชน์อย่างยิ่งในการจัดสรรทรัพยากรเพิ่มเติมให้กับหน่วยความจำที่ต้องการและประมวลผลการดำเนินการที่เข้มข้น เช่น การลิงก์ในบิลด์ C++ โดยไม่ต้องจัดสรรงานที่ไม่จำเป็นมากเกินไป
การกำหนดกลุ่มการดำเนินการ
ระหว่างคำจำกัดความของกฎ ผู้เขียนกฎจะประกาศชุดกลุ่มการดำเนินการได้ ในกลุ่มการดำเนินการแต่ละกลุ่ม ผู้เขียนกฎสามารถระบุทุกสิ่งที่จำเป็นในการเลือกแพลตฟอร์มการดำเนินการสำหรับกลุ่มการดำเนินการนั้นๆ ได้ ซึ่งได้แก่ ข้อจำกัดผ่าน exec_compatible_with
และประเภท Toolchain ผ่าน toolchain
# foo.bzl
my_rule = rule(
_impl,
exec_groups = {
“link”: exec_group(
exec_compatible_with = [ "@platforms//os:linux" ]
toolchains = ["//foo:toolchain_type"],
),
“test”: exec_group(
toolchains = ["//foo_tools:toolchain_type"],
),
},
attrs = {
"_compiler": attr.label(cfg = config.exec("link"))
},
)
ในข้อมูลโค้ดด้านบน คุณจะเห็นว่าทรัพยากร Dependency ของเครื่องมือระบุการเปลี่ยนสำหรับกลุ่มผู้บริหารได้โดยใช้พารามิเตอร์แอตทริบิวต์ cfg
และโมดูล config
โมดูลจะแสดงฟังก์ชัน exec
ซึ่งใช้พารามิเตอร์สตริงเดียวซึ่งเป็นชื่อกลุ่มการดำเนินการที่ควรสร้าง Dependency
ตามกฎแบบเนทีฟ กลุ่มการดำเนินการ test
จะปรากฏโดยค่าเริ่มต้นในกฎการทดสอบ Starlark
การเข้าถึงกลุ่มการดำเนินการ
ในการใช้งานกฎ คุณจะประกาศได้ว่าการดำเนินการต่างๆ ควรเรียกใช้บนแพลตฟอร์มการดำเนินการของกลุ่มการดำเนินการ ซึ่งทำได้โดยใช้พารามิเตอร์ exec_group
ของเมธอดสร้างการดำเนินการ โดยเฉพาะ ctx.actions.run
และ ctx.actions.run_shell
# foo.bzl
def _impl(ctx):
ctx.actions.run(
inputs = [ctx.attr._some_tool, ctx.srcs[0]]
exec_group = "compile",
# ...
)
ผู้เขียนกฎจะเข้าถึงเชนเครื่องมือที่แก้ไขแล้วของกลุ่มการดำเนินการได้ ซึ่งคล้ายกับวิธีที่คุณจะเข้าถึงเชนเครื่องมือที่แก้ไขแล้วของเป้าหมายได้
# foo.bzl
def _impl(ctx):
foo_info = ctx.exec_groups["link"].toolchains["//foo:toolchain_type"].fooinfo
ctx.actions.run(
inputs = [foo_info, ctx.srcs[0]]
exec_group = "link",
# ...
)
การใช้กลุ่มการดำเนินการเพื่อตั้งค่าพร็อพเพอร์ตี้การดำเนินการ
กลุ่มการดำเนินการจะผสานรวมกับแอตทริบิวต์ exec_properties
ที่มีอยู่ในกฎทุกกฎ และช่วยให้ผู้เขียนเป้าหมายระบุเพนต์สตริงของพร็อพเพอร์ตี้ที่ส่งไปยังเครื่องปฏิบัติการได้ ตัวอย่างเช่น หากคุณต้องการตั้งค่าพร็อพเพอร์ตี้บางอย่าง เช่น หน่วยความจำสำหรับเป้าหมาย และให้การจัดสรรหน่วยความจำที่สูงขึ้นสำหรับการดำเนินการบางอย่าง คุณจะต้องเขียนรายการ exec_properties
ที่มีคีย์ที่เพิ่มกลุ่มการดำเนินการ เช่น
# BUILD
my_rule(
name = 'my_target',
exec_properties = {
'mem': '12g',
'link.mem': '16g'
}
…
)
การดำเนินการทั้งหมดที่มี exec_group = "link"
จะเห็นพจนานุกรมพร็อพเพอร์ตี้ผู้บริหารเป็น {"mem": "16g"}
อย่างที่เห็นที่นี่ การตั้งค่าระดับกลุ่มการดำเนินการจะลบล้างการตั้งค่าระดับเป้าหมาย
กลุ่มการดำเนินการสำหรับกฎเนทีฟ
กลุ่มการดำเนินการต่อไปนี้ใช้ได้กับการดำเนินการที่กำหนดโดยกฎเนทีฟ
test
: การดำเนินการของตัวดำเนินการทดสอบcpp_link
: การลิงก์ C++
กลุ่มการดำเนินการและพร็อพเพอร์ตี้การดำเนินการของแพลตฟอร์ม
คุณกำหนด exec_properties
สำหรับกลุ่มการดำเนินการที่กำหนดเองในเป้าหมายแพลตฟอร์มได้ (ต่างจาก exec_properties
ที่ตั้งค่าโดยตรงในเป้าหมาย ซึ่งระบบจะปฏิเสธพร็อพเพอร์ตี้สำหรับกลุ่มการดำเนินการที่ไม่รู้จัก) จากนั้นเป้าหมายจะรับค่า exec_properties
ของแพลตฟอร์มการดำเนินการที่มีผลต่อกลุ่มการดำเนินการเริ่มต้นและกลุ่มการดำเนินการอื่นๆ ที่เกี่ยวข้อง
ตัวอย่างเช่น สมมติว่าการเรียกใช้การทดสอบ C++ จำเป็นต้องมีทรัพยากรบางอย่างเพื่อให้ใช้งานได้ แต่ไม่จำเป็นสำหรับการคอมไพล์และลิงก์ การจำลองนี้อาจมีลักษณะดังนี้
constraint_setting(name = "resource")
constraint_value(name = "has_resource", constraint_setting = ":resource")
platform(
name = "platform_with_resource",
constraint_values = [":has_resource"],
exec_properties = {
"test.resource": "...",
},
)
cc_test(
name = "my_test",
srcs = ["my_test.cc"],
exec_compatible_with = [":has_resource"],
)
exec_properties
กำหนดไว้โดยตรงในเป้าหมายจะมีความสำคัญมากกว่าสิ่งที่ได้รับจากแพลตฟอร์มการดำเนินการ