Beaker commands are executed through an ssh connection to each individual SUT. Various options are supported during command execution that control how the commands themselves are executed, what output is generated and how results are interpreted.
Provide either a single or an array of acceptable/passing exit codes for the provided command. Defaults to the single exit code 0.
on host, puppet( 'agent -t' ), :acceptable_exit_codes => [0,1,2]
Consider any exit codes returned by the command to be acceptable/passing. Defaults to nil/false.
on host, puppet( 'agent -t' ), :accept_all_exit_codes => true
Assume that this command will cause a connection failure. Used for host.reboot so that Beaker can handle the broken ssh connection.
on host, "reboot", {:expect_connection_failure => true}
Do not actually execute this command on the SUT. Defaults to false.
on host, "don't do this crazy thing", {:dry_run => true}
Should this command be executed in a pseudoterminal? Defaults to false.
on host, "sudo su -c \"service ssh restart\"", {:pty => true})
Do not output any logging for this command. Defaults to false.
on host, "echo hello", {:silent => true}
Specifies standard input to be provided to the command post execution. Defaults to nil.
on host, "this command takes input", {:stdin => "hiya"}
Execute the command against all hosts in parallel
on hosts, puppet( 'agent -t' ), :run_in_parallel => true