knife-serve - The man page for the knife serve subcommand.
The knife serve
subcommand is used to run a persistent chef-zero against
the local chef-repo. (chef-zero is a lightweight Chef server that runs
in-memory on the local machine.) This is the same as running the chef-client
executable with the --local-mode
option. The chef_repo_path
located automatically and the Chef server will bind to the first available
port between 8889
. knife serve
will print the
URL for the local Chef server, so that it may be added to the knife.rb file.
This subcommand has the following syntax:
This subcommand has the following options:
- -c CONFIG_FILE, --config CONFIG_FILE
- The configuration file to use.
- --chef-zero-port PORT
- The port on which chef-zero will listen.
- -d, --disable-editing
- Use to prevent the $EDITOR from being opened and to accept data
- Use to have knife use the default value instead of asking a user to
- -e EDITOR, --editor EDITOR
- The $EDITOR that is used for all interactive commands.
- -E ENVIRONMENT, --environment ENVIRONMENT
- The name of the environment. When this option is added to a command, the
command will run only against the named environment.
- -F FORMAT, --format FORMAT
- The output format: summary (default), text, json,
yaml, and pp.
- -h, --help
- Shows help for the command.
- -k KEY, --key KEY
- The private key that knife will use to sign requests made by the API
client to the Chef server.
- Use to view colored output.
- Use to show data after a destructive operation.
- -s URL, --server-url URL
- The URL for the Chef server.
- -u USER, --user USER
- The user name used by knife to sign requests made by the API client to the
Chef server. Authentication will fail if the user name does not match the
- -v, --version
- The version of the chef-client.
- -V, --verbose
- Set for more verbose outputs. Use -VV for maximum verbosity.
- -y, --yes
- Use to respond to all confirmation prompts with "Yes". knife
will not ask for confirmation.
- -z, --local-mode
- Use to run the chef-client in local mode. This allows all commands that
work against the Chef server to also work against the local