Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

knife-role(1) [debian man page]

KNIFE-ROLE(1)							    Chef Manual 						     KNIFE-ROLE(1)

NAME
knife-role - Group common configuration settings SYNOPSIS
knife role sub-command (options) ROLE SUB-COMMANDS The following role subcommands are available: LIST
knife role list (options) -w, --with-uri Show corresponding URIs List roles. SHOW
knife role show ROLE (options) -a, --attribute ATTR Show only one attribute Show a specific role. CREATE
knife role create ROLE (options) -d, --description The role description Create a new role. EDIT
knife role edit ROLE (options) Edit a role. FROM FILE
knife role from file FILE (options) Create or update a role from a role Ruby DSL (.rb) or JSON file. DELETE
knife role delete ROLE (options) Delete a role. BULK DELETE
knife role bulk delete REGEX (options) Delete roles on the Chef Server based on a regular expression. The regular expression (REGEX) should be in quotes, not in //'s. DESCRIPTION
Roles provide a mechanism to group repeated configuration settings. Roles are data structures that contain default_attributes, and over- ride_attributes, which are nested hashes of configuration settings, and a run_list, which is an ordered list of recipes and roles that should be applied to a host by chef-client. default_attributes will be overridden if they conflict with a value on a node that includes the role. Conversely, override_attributes will override any values set on nodes that apply them. When chef-client(8) configures a host, it will "expand" the run_list included in that host's node data. The expansion process will recur- sively replace any roles in the run_list with that role's run_list. SEE ALSO
knife-node(1) knife-environment(1) http://wiki.opscode.com/display/chef/Roles http://wiki.opscode.com/display/chef/Attributes AUTHOR
Chef was written by Adam Jacob adam@opscode.com with many contributions from the community. DOCUMENTATION
This manual page was written by Joshua Timberman joshua@opscode.com. Permission is granted to copy, distribute and / or modify this docu- ment under the terms of the Apache 2.0 License. CHEF
Knife is distributed with Chef. http://wiki.opscode.com/display/chef/Home Chef 10.12.0 June 2012 KNIFE-ROLE(1)

Check Out this Related Man Page

KNIFE-COOKBOOK-SITE(1)						    Chef Manual 					    KNIFE-COOKBOOK-SITE(1)

NAME
knife-cookbook-site - Install and update open source cookbooks SYNOPSIS
knife cookbook site sub-command (options) COOKBOOK SITE SUB-COMMANDS knife cookbook site provides the following subcommands: INSTALL
cookbook site install COOKBOOK [VERSION] (options) -D, --skip-dependencies Skip automatic installation of dependencies. -o, --cookbook-path PATH Install cookbooks to PATH -B, --branch BRANCH Default branch to work with [defaults to master] Uses git(1) version control in conjunction with the cookbook site to install community contributed cookbooks to your local cookbook reposi- tory. Running knife cookbook site install does the following: 1. A new "pristine copy" branch is created in git for tracking the upstream; 2. All existing cookbooks are removed from the branch; 3. The cookbook is downloaded from the cookbook site in tarball form; 4. The downloaded cookbook is untarred, and its contents commited via git; 5. The pristine copy branch is merged into the master branch. By installing cookbook with this process, you can locally modify the upstream cookbook in your master branch and let git maintain your changes as a separate patch. When an updated upstream version becomes available, you will be able to merge the upstream changes while main- taining your local modifications. Unless --skip-dependencies is specified, the process is applied recursively to all the cookbooks COOKBOOK depends on (via metadata depen- dencies). DOWNLOAD
knife cookbook site download COOKBOOK [VERSION] (options) -f, --file FILE The filename to write to --force Force download deprecated cookbook Downloads a specific cookbook from the Community site, optionally specifying a certain version. LIST
knife cookbook site list (options) -w, --with-uri Show corresponding URIs Lists available cookbooks from the Community site. SEARCH
knife cookbook site search QUERY (options) Searches for available cookbooks matching the specified query. SHARE
knife cookbook site share COOKBOOK CATEGORY (options) -k, --key KEY API Client Key -u, --user USER API Client Username -o, --cookbook-path PATH:PATH A colon-separated path to look for cookbooks in Uploads the specified cookbook using the given category to the Opscode cookbooks site. Requires a login user and certificate for the Opscode Cookbooks site. By default, knife will use the username and API key you've configured in your configuration file; otherwise you must explicitly set these values on the command line or use an alternate configuration file. UNSHARE
knife cookbook site unshare COOKBOOK Stops sharing the specified cookbook on the Opscode cookbooks site. SHOW
knife cookbook site show COOKBOOK [VERSION] (options) Shows information from the site about a particular cookbook. DESCRIPTION
The cookbook site, http://community.opscode.com/, is a cookbook distribution service operated by Opscode. This service provides users with a central location to publish cookbooks for sharing with other community members. knife cookbook site commands provide an interface to the cookbook site's HTTP API. For commands that read data from the API, no account is required. In order to upload cookbooks using the knife cookbook site share command, you must create an account on the cookbook site and configure your credentials via command line option or in your knife configuration file. EXAMPLES
Uploading cookbooks to the Opscode cookbooks site: knife cookbook site share example Other -k ~/.chef/USERNAME.pem -u USERNAME SEE ALSO
knife-cookbook(1) http://community.opscode.com/cookbooks AUTHOR
Chef was written by Adam Jacob adam@opscode.com with many contributions from the community. DOCUMENTATION
This manual page was written by Joshua Timberman joshua@opscode.com. Permission is granted to copy, distribute and / or modify this docu- ment under the terms of the Apache 2.0 License. CHEF
Knife is distributed with Chef. http://wiki.opscode.com/display/chef/Home Chef 10.12.0 June 2012 KNIFE-COOKBOOK-SITE(1)
Man Page

Featured Tech Videos