กลุ่มการเรียกใช้ช่วยให้ใช้แพลตฟอร์มการเรียกใช้ได้หลายแพลตฟอร์มภายในเป้าหมายเดียว กลุ่มการดําเนินการแต่ละกลุ่มจะมีชุดเครื่องมือที่ต้องพึ่งพาของตนเอง และแก้ไขชุดเครื่องมือของตนเอง
ข้อมูลเบื้องต้น
กลุ่มการดําเนินการช่วยให้ผู้เขียนกฎกําหนดชุดการดําเนินการแต่ละชุดซึ่งมีแพลตฟอร์มการดําเนินการที่แตกต่างกันได้ แพลตฟอร์มการดำเนินการหลายแพลตฟอร์มอาจทำให้การดำเนินการดำเนินการแตกต่างกันได้ เช่น การคอมไพล์แอป iOS บนผู้ปฏิบัติงานระยะไกล (linux) จากนั้นจึงลิงก์/การรับรองโค้ดกับผู้ปฏิบัติงาน Mac ในเครื่อง
การกำหนดกลุ่มการดำเนินการยังช่วยลดการใช้บันทึกการดำเนินการเป็นพร็อกซีในการระบุการทำงาน ระบบไม่รับประกันว่าคําช่วยจําจะซ้ำกันหรือไม่ และสามารถอ้างอิงการดําเนินการได้เพียงรายการเดียวเท่านั้น ซึ่งจะเป็นประโยชน์อย่างยิ่งในการกำหนดทรัพยากรเพิ่มเติมให้กับหน่วยความจำที่เฉพาะเจาะจงและการดำเนินการที่ต้องใช้การประมวลผลอย่างหนัก เช่น การลิงก์ในบิลด์ C++ โดยไม่ต้องจัดสรรทรัพยากรให้กับงานที่ต้องใช้การประมวลผลน้อยกว่ามากเกินไป
การกำหนดกลุ่มการดำเนินการ
ในระหว่างการกําหนดกฎ ผู้เขียนกฎจะประกาศชุดกลุ่มการดําเนินการได้ ผู้เขียนกฎสามารถระบุข้อมูลทั้งหมดที่จําเป็นในการเลือกแพลตฟอร์มการดําเนินการสําหรับกลุ่มการดําเนินการแต่ละกลุ่มได้ นั่นคือข้อจํากัดผ่าน exec_compatible_with
และประเภทเครื่องมือทางเทคนิคผ่าน 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"))
},
)
ในข้อมูลโค้ดด้านบน คุณจะเห็นว่าการพึ่งพาเครื่องมือยังระบุการเปลี่ยนแปลงสําหรับกลุ่ม exec ได้โดยใช้พารามิเตอร์แอตทริบิวต์ cfg
และข้อบังคับ config
โมดูลจะแสดงฟังก์ชัน exec
ซึ่งใช้พารามิเตอร์สตริงเดียว ซึ่งเป็นชื่อของกลุ่ม exec ที่ควรสร้างข้อกําหนด
เช่นเดียวกับกฎเนทีฟ กลุ่มการดําเนินการ test
จะแสดงอยู่ในกฎทดสอบ Starlark โดยค่าเริ่มต้น
การเข้าถึงกลุ่มการดำเนินการ
ในการใช้งานกฎ คุณสามารถประกาศว่าควรเรียกใช้การดำเนินการบนแพลตฟอร์มการดำเนินการของกลุ่มการดำเนินการ ซึ่งทำได้โดยใช้ exec_group
param ของวิธีการสร้างการดําเนินการ โดยเฉพาะ 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"
จะดูพจนานุกรมพร็อพเพอร์ตี้ exec เป็น {"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
ที่กําหนดในเป้าหมายโดยตรงจะมีความสําคัญเหนือกว่าค่าที่รับค่ามาจากแพลตฟอร์มการเรียกใช้