Comment on page

Variants

All Comtrya actions support the concept of variants. Variants allow you to modify how the action will be executed based on the contexts available.
Let's assume you want to run a command that is different on macOS, Linux, and Windows.
actions:
# This action has a "default" execution for when the variants don't overlay,
# as it does not provide its own "where"
- action: command.run
command: echo
args:
- hello, world!
variants:
- where: os.name == "linux"
command: reboot
- where: os.name == "macos"
command: echo
args: ["Hello", "macOS"]
- where: user.username == "rawkode"
command: echo
args: ["Hello", "rawkode!"]
We even allow you to target the OS family or specific distribution:
actions:
- action: command.run
command: echo
args:
- hello, vanilla Linux!
variants:
- where: os.family == "unix"
command: echo Hi, Unix
- where: os.distribution == "Ubuntu"
command: echo Hi, Ubuntu
- where: os.bitness == "64-bit"
command: echo Hi, 64 bit!
Lastly, the where clause can be used to selectively skip or run tasks:
actions:
- action: command.run
where: os.name == "linux"
command: echo
args:
- Hello Linux