Yürütme grupları, tek bir hedef içinde birden çok yürütme platformuna izin verir. Her yürütme grubu kendi araç zinciri bağımlılıklarına sahiptir ve kendi araç zinciri çözünürlüğünü gerçekleştirir.
Arka plan
Yürütme grupları, kural yazarının her biri potansiyel olarak farklı bir yürütme platformuna sahip olan işlem grupları tanımlamasına olanak tanır. Birden fazla yürütme platformu, işlemlerin farklı şekilde yürütülmesine izin verebilir. Örneğin, bir iOS uygulamasını uzaktan (linux) çalışanda derleme ve ardından yerel bir mac çalışanı üzerinde bağlantı/kod imzalama gibi işlemleri yapabilir.
İşlem gruplarını tanımlayabilmek, eylemleri belirtmek için bir aracı olarak işlem anımsatıcılarının kullanımını azaltmaya da yardımcı olur. Anımsatıcıların benzersiz olacağı garanti edilmez ve yalnızca tek bir işleme referans verilebilir. Bu, özellikle belirli belleğe ek kaynak ayırma ve daha az çaba gerektiren görevlere fazla ayırmadan C++ derlemelerinde bağlantı oluşturma gibi yoğun işlemlerin işlenmesi açısından faydalıdır.
Yürütme gruplarını tanımlama
Kural tanımı sırasında, kural yazarları bir dizi yürütme grubu bildirebilir. Kural yazarı, her yürütme grubunda o yürütme grubu için bir yürütme platformu seçmek üzere gereken her şeyi, yani exec_compatible_with üzerinden gerçekleşen kısıtlamaları ve toolchain aracılığıyla araç zinciri türlerini belirtebilir.
# 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"))
},
)
Yukarıdaki kod snippet'inde, cfg özellik parametresini ve config modülünü kullanarak araç bağımlılıklarının bir yönetici grubu için geçişi de belirtebildiğini görebilirsiniz. Modül, bağımlılığın derlenmesi gereken yönetici grubunun adı olan tek bir dize parametresini alan bir exec işlevi sunar.
Yerel kurallarda olduğu gibi test yürütme grubu da Starlark test kurallarında varsayılan olarak mevcuttur.
Yürütme gruplarına erişme
Kural uygulamasında, işlemlerin bir yürütme grubunun yürütme platformunda çalıştırılması gerektiğini belirtebilirsiniz. Bunu, işlem oluşturma yöntemlerinin exec_group parametresini, özellikle de ctx.actions.run ve ctx.actions.run_shell kullanarak yapabilirsiniz.
# foo.bzl
def _impl(ctx):
ctx.actions.run(
inputs = [ctx.attr._some_tool, ctx.srcs[0]]
exec_group = "compile",
# ...
)
Kural yazarları, bir hedefin çözümlenmiş araç zincirine erişebileceğiniz gibi, yürütme gruplarının çözülmüş araç zincirlerine de erişebilir:
# 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",
# ...
)
Yürütme özelliklerini ayarlamak için yürütme gruplarını kullanma
Yürütme grupları, her kuralda bulunan exec_properties özelliğiyle entegre edilir ve hedef yazıcının, daha sonra yürütme makinesine iletilen özelliklerin dize listesini belirtmesine olanak tanır. Örneğin, hedef için bellek gibi bir özellik ayarlamak ve belirli işlemlere daha yüksek bir bellek tahsisi sağlamak istiyorsanız yürütme grubu ile artırılmış bir anahtar içeren bir exec_properties girişi yazarsınız. Örneğin:
# BUILD
my_rule(
name = 'my_target',
exec_properties = {
'mem': '12g',
'link.mem': '16g'
}
…
)
exec_group = "link" içeren tüm işlemler, yönetici özellikleri sözlüğünü {"mem": "16g"} olarak görür. Burada gördüğünüz gibi, yürütme grubu düzeyindeki ayarlar hedef düzeyindeki ayarları geçersiz kılar.
Yerel kurallar için yürütme grupları
Aşağıdaki yürütme grupları, yerel kurallarla tanımlanan işlemler için kullanılabilir:
test: Test koşucusu işlemleri.cpp_link: C++ bağlantı işlemleri.
Yürütme grupları ve platform yürütme özellikleri
Platform hedeflerindeki rastgele yürütme grupları için exec_properties tanımlamak mümkündür (bilinmeyen yürütme gruplarının özelliklerinin reddedildiği bir hedefte doğrudan ayarlanan exec_properties'ın aksine). Daha sonra hedefler, varsayılan yürütme grubunu ve diğer ilgili yürütme gruplarını etkileyen yürütme platformunun exec_properties ayarını devralır.
Örneğin, bir C++ testi çalıştırmak için bazı kaynakların kullanılabilir olması gerektiğini ancak derleme ve bağlantı oluşturma için gerekli olmadığını varsayalım. Bu, aşağıdaki gibi modellenebilir:
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"],
)
Doğrudan hedeflerde tanımlanan exec_properties, yürütme platformundan devralınanlardan önceliklidir.