Run tasks
Run ad hoc tasks on target nodes to upgrade packages, restart services, execute shell commands, or perform any other type of single-action executions on your nodes.
Tasks are similar to scripts, but they are kept in modules and can have metadata. For more information, see Bolt tasks.
When selecting to run a task from either a details or listing page, some of the selected nodes might not be eligible to run the task on. An eligible node must be accessible using the SSH or WinRM credentials you added, or if running the install Puppet agent task, an eligible node doesn't have the agent installed.
Running shell commands
Execute an arbitrary shell command on discovered nodes without installing an agent.
/etc/sudoers
file and configured to not require a tty
. For
example:Defaults:myuser !requiretty
Parameter | Description |
---|---|
command
|
The command to execute on the target
nodes.
example:
example:
To execute commands, tasks use the command prompt. To run commands, you must invoke . For example:
|
failonfail
|
By default, the task fails when the command returns a non-zero. To disable this default setting, select the checkbox. |
interleave
|
By default, content from stdout
and stderr is interleaved. To disable this default
setting, select the checkbox. |
Managing packages
Install, upgrade, or uninstall packages on discovered nodes without installing an agent.
To run the manage package task on target hosts, the following package management systems are required:
-
APT or YUM for hosts.
-
Chocolatey for hosts.
Parameter | Description |
---|---|
action |
The action to be applied to the
package:
|
name |
The name of the package. |
provider |
The name of the provider to use for managing or inspecting the package. |
version |
The version, and if applicable, the
release value of the package. A version number range or a semver
pattern are not permitted. For example, to install the bash-4.1.2-29.el6.x86_64.rpm package, enter
4.1.2-29.el6.
Tip: To install or upgrade to the latest
version of a package, leave the
version
parameter blank. |
Managing system services
Execute an arbitrary shell command on discovered hosts without installing an agent.
Parameter | Description |
---|---|
action |
The action to be applied to the
service:
|
name |
The name of the service. |
provider |
The name of the provider to use for managing or inspecting the service. |