Provided by: chef_12.3.0-3ubuntu1_all bug

NAME

       knife-cookbook-site - The man page for the knife cookbook site subcommand.

       The  Cookbooks  Site  API  is  used to provide access to the cookbooks community hosted at
       https://supermarket.getchef.com/cookbooks. All of  the  cookbooks  in  the  community  are
       accessible         through         a         RESTful         API         located        at
       https://supermarket.getchef.com/api/v1/cookbooks by using any of the supported  endpoints.
       In  most  cases,  using  knife  and  the  knife  cookbook site sub-command (and any of its
       arguments) is the recommended method of interacting with  these  cookbooks,  but  in  some
       cases, using the Cookbooks Site API directly may make sense.

       The  knife cookbook site subcommand is used to interact with cookbooks that are located at
       https://supermarket.getchef.com/cookbooks. A user account is required  for  any  community
       actions  that  write  data  to  this  site.  The following arguments do not require a user
       account: download, search, install, and list.

COMMON OPTIONS

       The following options may be used with  any  of  the  arguments  available  to  the  knife
       cookbook site subcommand:

       --chef-zero-port PORT
              The port on which chef-zero will listen.

       -c CONFIG_FILE, --config CONFIG_FILE
              The configuration file to use.

       -d, --disable-editing
              Use to prevent the $EDITOR from being opened and to accept data as-is.

       --defaults
              Use to have knife use the default value instead of asking a user to provide one.

       -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.

       --[no-]color
              Use to view colored output.

       --print-after
              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 private key.

       -V, --verbose
              Set for more verbose outputs. Use -VV for maximum verbosity.

       -v, --version
              The version of the chef-client.

       -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 chef-repo.

DOWNLOAD

       The download argument is used to  download  a  cookbook  from  the  community  website.  A
       cookbook  will  be  downloaded  as  a  tar.gz  archive  and  placed in the current working
       directory. If a cookbook (or cookbook version) has been deprecated and the --force  option
       is  not  used,  knife  will  alert  the user that the cookbook is deprecated and then will
       provide the name of the most recent non-deprecated version of that cookbook.

       Syntax

       This argument has the following syntax:

          $ knife cookbook site download COOKBOOK_NAME [COOKBOOK_VERSION] (options)

       Options

       This argument has the following options:

       COOKBOOK_VERSION
              The version of a cookbook to be downloaded. If a cookbook  has  only  one  version,
              this  option does not need to be specified. If a cookbook has more than one version
              and this option is not specified, the most recent version of the cookbook  will  be
              downloaded.

       -f FILE, --file FILE
              The file to which a cookbook download is written.

       --force
              Use to overwrite an existing directory.

       Examples

       To download the cookbook getting-started, enter:

          $ knife cookbook site download getting-started

       to return something like:

          Downloading getting-started from the cookbooks site at version 0.3.0 to
            /Users/sdanna/opscodesupport/getting-started-0.3.0.tar.gz
          Cookbook saved: /Users/sdanna/opscodesupport/getting-started-0.3.0.tar.gz

INSTALL

       The  install  argument  is  used  to  install a cookbook that has been downloaded from the
       community site to a local git repository . This action uses the git version control system
       in   conjunction   with  the  https://supermarket.getchef.com/cookbooks  site  to  install
       community-contributed cookbooks to the local  chef-repo.  Using  this  argument  does  the
       following:

          1. A new "pristine copy" branch is created in git for tracking the upstream.

          2. All existing versions of a cookbook are removed from the branch.

          3. The  cookbook  is  downloaded  from https://supermarket.getchef.com/cookbooks in the
             tar.gz format.

          4. The downloaded cookbook is untarred and its contents are committed to git and a  tag
             is created.

          5. The "pristine copy" branch is merged into the master branch.

       This  process  allows  the  upstream  cookbook  in  the master branch to be modified while
       letting git maintain changes as a separate patch. When an updated upstream version becomes
       available, those changes can be merged while maintaining any local modifications.

       Syntax

       This argument has the following syntax:

          $ knife cookbook site install COOKBOOK_NAME [COOKBOOK_VERSION] (options)

       Options

       This argument has the following options:

       -b, --use-current-branch
              Use to ensure that the current branch is used.

       -B BRANCH, --branch BRANCH
              The name of the default branch. This will default to the master branch.

       COOKBOOK_VERSION
              The  version  of  the  cookbook to be installed. If a version is not specified, the
              most recent version of the cookbook will be installed.

       -D, --skip-dependencies
              Use to ensure that all cookbooks to which the installed cookbook has  a  dependency
              will not be installed.

       -o PATH:PATH, --cookbook-path PATH:PATH
              The directory in which cookbooks are created. This can be a colon-separated path.

       Examples

       To install the cookbook getting-started, enter:

          $ knife cookbook site install getting-started

       to return something like:

          Installing getting-started to /Users/sdanna/opscodesupport/.chef/../cookbooks
          Checking out the master branch.
          Creating pristine copy branch chef-vendor-getting-started
          Downloading getting-started from the cookbooks site at version 0.3.0 to
            /Users/sdanna/opscodesupport/.chef/../cookbooks/getting-started.tar.gz
          Cookbook saved: /Users/sdanna/opscodesupport/.chef/../cookbooks/getting-started.tar.gz
          Removing pre-existing version.
          Uncompressing getting-started version /Users/sdanna/opscodesupport/.chef/../cookbooks.
          removing downloaded tarball
          1 files updated, committing changes
          Creating tag cookbook-site-imported-getting-started-0.3.0
          Checking out the master branch.
          Updating 4d44b5b..b4c32f2
          Fast-forward
           cookbooks/getting-started/README.rdoc              |    4 +++
           cookbooks/getting-started/attributes/default.rb    |    1 +
           cookbooks/getting-started/metadata.json            |   29 ++++++++++++++++++++
           cookbooks/getting-started/metadata.rb              |    6 ++++
           cookbooks/getting-started/recipes/default.rb       |   23 +++++++++++++++
           .../templates/default/chef-getting-started.txt.erb |    5 +++
           6 files changed, 68 insertions(+), 0 deletions(-)
           create mode 100644 cookbooks/getting-started/README.rdoc
           create mode 100644 cookbooks/getting-started/attributes/default.rb
           create mode 100644 cookbooks/getting-started/metadata.json
           create mode 100644 cookbooks/getting-started/metadata.rb
           create mode 100644 cookbooks/getting-started/recipes/default.rb
           create mode 100644 cookbooks/getting-started/templates/default/chef-getting-started.txt.erb
          Cookbook getting-started version 0.3.0 successfully installed

LIST

       The  list  argument  is  used  to view a list of cookbooks that are currently available at
       https://supermarket.getchef.com/cookbooks.

       Syntax

       This argument has the following syntax:

          $ knife cookbook site list

       Options

       This argument has the following options:

       -w, --with-uri
              Use to show the corresponding URIs.

       Examples

       To view a list of cookbooks at https://supermarket.getchef.com/cookbooks server, enter:

          $ knife cookbook site list

       to return:

          1password             homesick              rabbitmq
          7-zip                 hostname              rabbitmq-management
          AmazonEC2Tag          hosts                 rabbitmq_chef
          R                     hosts-awareness       rackspaceknife
          accounts              htop                  radiant
          ack-grep              hudson                rails
          activemq              icinga                rails_enterprise
          ad                    id3lib                redis-package
          ad-likewise           iftop                 redis2
          ant                   iis                   redmine
          [...truncated...]

SEARCH

       The    search    argument    is    used    to     search     for     a     cookbook     at
       https://supermarket.getchef.com/cookbooks.  A  search  query  is  used to return a list of
       cookbooks at https://supermarket.getchef.com/cookbooks and uses the  same  syntax  as  the
       knife search sub-command.

       Syntax

       This argument has the following syntax:

          $ knife cookbook site search SEARCH_QUERY (options)

       Options

       This command does not have any specific options.

       Examples

       To search for all of the cookbooks that can be used with Apache, enter:

          $ knife cookbook site search apache*

       to return something like:

          apache2:
            cookbook:              http://cookbooks.opscode.com/api/v1/cookbooks/apache2
            cookbook_description:  Installs and configures apache2 using Debian symlinks with helper definitions
            cookbook_maintainer:   opscode
            cookbook_name:         apache2
          instiki:
            cookbook:              http://cookbooks.opscode.com/api/v1/cookbooks/instiki
            cookbook_description:  Installs instiki, a Ruby on Rails wiki server under passenger+Apache2.
            cookbook_maintainer:   jtimberman
            cookbook_name:         instiki
          kickstart:
            cookbook:              http://cookbooks.opscode.com/api/v1/cookbooks/kickstart
            cookbook_description:  Creates apache2 vhost and serves a kickstart file.
            cookbook_maintainer:   opscode
            cookbook_name:         kickstart
          [...truncated...]

SHARE

       The share argument is used to add a cookbook to https://supermarket.getchef.com/cookbooks.
       This   action    will    require    a    user    account    and    a    certificate    for
       https://supermarket.getchef.com. By default, knife will use the user name and API key that
       is identified in the configuration file used during the  upload;  otherwise  these  values
       must be specified on the command line or in an alternate configuration file. If a cookbook
       already  exists  on  https://supermarket.getchef.com/cookbooks,  then  only  an  owner  or
       maintainer of that cookbook can make updates.

       Syntax

       This argument has the following syntax:

          $ knife cookbook site share COOKBOOK_NAME CATEGORY (options)

       Options

       This argument has the following options:

       CATEGORY
              The   cookbook   category:   "Databases",   "Web  Servers",  "Process  Management",
              "Monitoring   &   Trending",   "Programming   Languages",   "Package   Management",
              "Applications", "Networking", "Operating Systems & Virtualization", "Utilities", or
              "Other".

       -n, --dry-run
              Use to take no action and only print out results. Default: false.

       -o PATH:PATH, --cookbook-path PATH:PATH
              The directory in which cookbooks are created. This can be a colon-separated path.

       Examples

       To share a cookbook named apache2:

          $ knife cookbook site share "apache2" "Web Servers"

SHOW

       The   show   argument   is   used   to   view   information   about    a    cookbook    on
       https://supermarket.getchef.com/cookbooks.

       Syntax

       This argument has the following syntax:

          $ knife cookbook site show COOKBOOK_NAME [COOKBOOK_VERSION]

       Options

       This argument has the following options:

       COOKBOOK_VERSION
              The  version  of  a  cookbook to be shown. If a cookbook has only one version, this
              option does not need to be specified. If a cookbook has more than one  version  and
              this option is not specified, a list of cookbook versions will be returned.

       Examples

       To show the details for a cookbook named haproxy:

          $ knife cookbook site show haproxy

       to return something like:

          average_rating:
          category:        Networking
          created_at:      2009-10-25T23:51:07Z
          description:     Installs and configures haproxy
          external_url:
          latest_version:  http://cookbooks.opscode.com/api/v1/cookbooks/haproxy/versions/1_0_3
          maintainer:      opscode
          name:            haproxy
          updated_at:      2011-06-30T21:53:25Z
          versions:
             http://cookbooks.opscode.com/api/v1/cookbooks/haproxy/versions/1_0_3
             http://cookbooks.opscode.com/api/v1/cookbooks/haproxy/versions/1_0_2
             http://cookbooks.opscode.com/api/v1/cookbooks/haproxy/versions/1_0_1
             http://cookbooks.opscode.com/api/v1/cookbooks/haproxy/versions/1_0_0
             http://cookbooks.opscode.com/api/v1/cookbooks/haproxy/versions/0_8_1
             http://cookbooks.opscode.com/api/v1/cookbooks/haproxy/versions/0_8_0
             http://cookbooks.opscode.com/api/v1/cookbooks/haproxy/versions/0_7_0

       To  view  information in JSON format, use the -F common option as part of the command like
       this:

          $ knife role show devops -F json

       Other formats available include text, yaml, and pp.

UNSHARE

       The   unshare   argument   is   used   to   stop   the   sharing   of   a   cookbook    at
       https://supermarket.getchef.com/cookbooks.  Only  the maintainer of a cookbook may perform
       this action.

       Syntax

       This argument has the following syntax:

          $ knife cookbook site unshare COOKBOOK_NAME

       Options

       This command does not have any specific options.

       Examples

       To unshare a cookbook named getting-started, enter:

          $ knife cookbook site unshare getting-started

AUTHOR

       Chef

                                            Chef 12.0                      KNIFE-COOKBOOK-SITE(1)