knife upload
Use the knife upload
subcommand to upload data to the Chef Infra
Server from the current working directory in the chef-repo. The
following types of data may be uploaded with this subcommand:
- Cookbooks
- Data bags
- Roles stored as JSON data
- Environments stored as JSON data
(Roles and environments stored as Ruby data will not be uploaded.) This
subcommand is often used in conjunction with knife diff
, which can be
used to see exactly what changes will be uploaded, and then
knife download
, which does the opposite of knife upload
.
Syntax
This subcommand has the following syntax:
knife upload [PATTERN...] (options)
Options
Note
This subcommand has the following options:
--chef-repo-path PATH
The path to the chef-repo. This setting will override the default path to the chef-repo. Default: same value as specified by
chef_repo_path
in client.rb.--concurrency
The number of allowed concurrent connections. Default:
10
.--[no-]diff
Upload only new and modified files. Set to
false
to upload all files. Default:true
.--[no-]force
Use
--force
to upload roles, cookbooks, etc. even if the file in the directory is identical (by default, noPOST
orPUT
is performed unless an actual change would be made). Default:--no-force
.--[no-]freeze
Require changes to a cookbook be included as a new version. Only the
--force
option can override this setting. Default:false
.-n
,--dry-run
Take no action and only print out results. Default:
false
.--[no-]purge
Use
--purge
to delete roles, cookbooks, etc. from the Chef Infra Server if their corresponding files do not exist in the chef-repo. By default, such objects are left alone and NOT purged. Default:--no-purge
.--[no-]recurse
Use
--no-recurse
to disable uploading a directory recursively. Default:--recurse
.--repo-mode MODE
The layout of the local chef-repo. Possible values:
static
,everything
, orhosted_everything
. Usestatic
for just roles, environments, cookbooks, and data bags. By default,everything
andhosted_everything
are dynamically selected depending on the server type. Default:everything
/hosted_everything
.
Note
Examples
The following examples show how to use this knife subcommand:
Upload the entire chef-repo
Browse to the top level of the chef-repo and enter:
knife upload .
or from anywhere in the chef-repo, enter:
knife upload /
to upload all cookbooks and data bags, plus all roles and environments that are stored as JSON data. (Roles and environments stored as Ruby data will not be uploaded.)
Upload the /cookbooks directory
Browse to the top level of the chef-repo and enter:
knife upload cookbooks
or from anywhere in the chef-repo, enter:
knife upload /cookbooks
Upload the /environments directory
Browse to the top level of the chef-repo and enter:
knife upload environments
or from anywhere in the chef-repo, enter:
knife upload /environments
to upload all environments that are stored as JSON data. (Environments stored as Ruby data will not be uploaded.)
Upload a single environment
Browse to the top level of the chef-repo and enter:
knife upload environments/production.json
or from the environments/
directory, enter:
knife upload production.json
Upload the /roles directory
Browse to the top level of the chef-repo and enter:
knife upload roles
or from anywhere in the chef-repo, enter:
knife upload /roles
to upload all roles that are stored as JSON data. (Roles stored as Ruby data will not be uploaded.)
Upload cookbooks and roles
Browse to the top level of the chef-repo and enter:
knife upload cookbooks/apache\* roles/webserver.json
Use output of knife deps to pass command to knife upload
knife upload `knife deps nodes/*.json`