Skip to main content

knife configure

[edit on GitHub]

Use the knife configure subcommand to create the client.rb and config.rb files so that they can be distributed to workstations and nodes.

Syntax

This subcommand has the following syntax when creating a config.rb file:

knife configure (options)

and the following syntax when creating a client.rb file:

knife configure client DIRECTORY

Options

Note

Review the list of common options available to this (and all) knife subcommands and plugins.

This subcommand has the following options for use when configuring a config.rb file:

--admin-client-name NAME

The name of the client, typically the name of the admin client.

--admin-client-key PATH

The path to the private key used by the client, typically a file named admin.pem.

-i, --initial

Create a API client, typically an administrator client on a freshly-installed Chef Infra Server.

-r REPO, --repository REPO

The path to the chef-repo.

--validation-client-name NAME

The name of the validation client, typically a client named chef-validator.

--validation-key PATH

The path to the validation key used by the client, typically a file named chef-validator.pem.

Note

See config.rb for more information about how to add certain knife options as settings in the config.rb file.

Examples

The following examples show how to use this knife subcommand:

Configure config.rb

knife configure

Configure client.rb

knife configure client '/directory'