กลุ่มการดำเนินการทำให้มีแพลตฟอร์มการดำเนินการที่หลากหลายภายในเป้าหมายเดียว กลุ่มการดำเนินการแต่ละกลุ่มมีทรัพยากร Dependency ของ 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 ซึ่งใช้สตริงเดียว
พารามิเตอร์ ซึ่งเป็นชื่อกลุ่มปฏิบัติการที่ควรจะเป็น
สร้าง
ตามกฎแบบเนทีฟ กลุ่มการดำเนินการ 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",
# ...
)
ผู้เขียนกฎยังเข้าถึงToolchain ที่แก้ไขแล้วได้ด้วย กลุ่มการดำเนินการ ซึ่งคล้ายกับวิธีที่คุณ เข้าถึง Toolchain ที่ได้รับการแก้ไขของเป้าหมายได้
# 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 ที่กำหนดไว้โดยตรงในเป้าหมายมีความสำคัญเหนือกว่า
จะรับค่ามาจากแพลตฟอร์มการดำเนินการ