Contents

# The Command Line

* Using the gem

```console
    $ beaker --log-level debug --hosts sample.cfg --tests test.rb
```

* Using latest git

```console
    $ bundle exec beaker --log-level debug --hosts sample.cfg --tests test.rb
```

## Useful options

* `-h, --hosts FILE `, the hosts that you are going to be testing with
* `--log-level debug`, for providing verbose logging and full stacktraces on failure
* `--[no-]provision`, indicates if beaker should provision new boxes upon test execution. If `no` is selected then beaker will attempt to connect to the hosts as defined in `--hosts FILE` without first creating/running them through their hypervisors
* `--preserve-hosts [MODE]`, indicates what should be done with the testing boxes after tests are complete.  If `always` is selected then the boxes will be preserved and left running post-testing.  If `onfail` is selected then the boxes will be preserved only if tests fail, otherwise they will be shut down and destroyed.  If `never` is selected then the boxes will be shut down and destroyed no matter the testing results.
* `--parse-only`, read and parse all command line options, environment options and file options; report the parsed options and exit.

## The Rest

See all options with

* Using the gem

```console
        $ beaker --help
```

* Using latest git

```console
        $ bundle exec beaker --help
```

Version data entries

78 entries across 78 versions & 1 rubygems

Version	Path
beaker-4.40.0	docs/tutorials/the_command_line.md
beaker-5.1.0	docs/tutorials/the_command_line.md
beaker-5.0.0	docs/tutorials/the_command_line.md
beaker-4.39.0	docs/tutorials/the_command_line.md
beaker-4.38.1	docs/tutorials/the_command_line.md
beaker-4.38.0	docs/tutorials/the_command_line.md
beaker-4.37.2	docs/tutorials/the_command_line.md
beaker-4.37.1	docs/tutorials/the_command_line.md
beaker-4.37.0	docs/tutorials/the_command_line.md
beaker-4.36.1	docs/tutorials/the_command_line.md
beaker-4.36.0	docs/tutorials/the_command_line.md
beaker-4.35.0	docs/tutorials/the_command_line.md
beaker-4.34.0	docs/tutorials/the_command_line.md
beaker-4.33.0	docs/tutorials/the_command_line.md
beaker-4.32.0	docs/tutorials/the_command_line.md
beaker-4.31.0	docs/tutorials/the_command_line.md
beaker-4.30.0	docs/tutorials/the_command_line.md
beaker-4.29.1	docs/tutorials/the_command_line.md
beaker-4.29.0	docs/tutorials/the_command_line.md
beaker-4.28.1	docs/tutorials/the_command_line.md