rmm-chef 0.10.0.rc.0
Sign up to get free protection for your applications and to get access to all the features.
- data/LICENSE +201 -0
- data/README.rdoc +171 -0
- data/bin/chef-client +26 -0
- data/bin/chef-solo +25 -0
- data/bin/knife +26 -0
- data/bin/shef +34 -0
- data/distro/README +2 -0
- data/distro/arch/etc/conf.d/chef-client.conf +5 -0
- data/distro/arch/etc/conf.d/chef-expander.conf +8 -0
- data/distro/arch/etc/conf.d/chef-server-webui.conf +10 -0
- data/distro/arch/etc/conf.d/chef-server.conf +10 -0
- data/distro/arch/etc/conf.d/chef-solr.conf +8 -0
- data/distro/arch/etc/rc.d/chef-client +76 -0
- data/distro/arch/etc/rc.d/chef-expander +78 -0
- data/distro/arch/etc/rc.d/chef-server +78 -0
- data/distro/arch/etc/rc.d/chef-server-webui +78 -0
- data/distro/arch/etc/rc.d/chef-solr +78 -0
- data/distro/common/html/chef-client.8.html +141 -0
- data/distro/common/html/chef-expander-cluster.8.html +164 -0
- data/distro/common/html/chef-expanderctl.8.html +146 -0
- data/distro/common/html/chef-server-webui.8.html +185 -0
- data/distro/common/html/chef-server.8.html +182 -0
- data/distro/common/html/chef-solo.8.html +191 -0
- data/distro/common/html/chef-solr.8.html +163 -0
- data/distro/common/html/knife-bootstrap.1.html +241 -0
- data/distro/common/html/knife-client.1.html +219 -0
- data/distro/common/html/knife-configure.1.html +170 -0
- data/distro/common/html/knife-cookbook-site.1.html +239 -0
- data/distro/common/html/knife-cookbook.1.html +373 -0
- data/distro/common/html/knife-data-bag.1.html +234 -0
- data/distro/common/html/knife-environment.1.html +267 -0
- data/distro/common/html/knife-exec.1.html +134 -0
- data/distro/common/html/knife-index.1.html +125 -0
- data/distro/common/html/knife-node.1.html +270 -0
- data/distro/common/html/knife-recipe.1.html +92 -0
- data/distro/common/html/knife-role.1.html +200 -0
- data/distro/common/html/knife-search.1.html +143 -0
- data/distro/common/html/knife-ssh.1.html +156 -0
- data/distro/common/html/knife-status.1.html +128 -0
- data/distro/common/html/knife-tag.1.html +137 -0
- data/distro/common/html/knife.1.html +295 -0
- data/distro/common/html/shef.1.html +283 -0
- data/distro/common/man/man1/knife-bootstrap.1 +189 -0
- data/distro/common/man/man1/knife-client.1 +99 -0
- data/distro/common/man/man1/knife-configure.1 +88 -0
- data/distro/common/man/man1/knife-cookbook-site.1 +137 -0
- data/distro/common/man/man1/knife-cookbook.1 +320 -0
- data/distro/common/man/man1/knife-data-bag.1 +130 -0
- data/distro/common/man/man1/knife-environment.1 +178 -0
- data/distro/common/man/man1/knife-exec.1 +46 -0
- data/distro/common/man/man1/knife-index.1 +29 -0
- data/distro/common/man/man1/knife-node.1 +154 -0
- data/distro/common/man/man1/knife-role.1 +88 -0
- data/distro/common/man/man1/knife-search.1 +61 -0
- data/distro/common/man/man1/knife-ssh.1 +74 -0
- data/distro/common/man/man1/knife-status.1 +29 -0
- data/distro/common/man/man1/knife-tag.1 +43 -0
- data/distro/common/man/man1/knife.1 +251 -0
- data/distro/common/man/man1/shef.1 +256 -0
- data/distro/common/man/man8/chef-client.8 +84 -0
- data/distro/common/man/man8/chef-expander-cluster.8 +97 -0
- data/distro/common/man/man8/chef-expanderctl.8 +62 -0
- data/distro/common/man/man8/chef-server-webui.8 +155 -0
- data/distro/common/man/man8/chef-server.8 +147 -0
- data/distro/common/man/man8/chef-solo.8 +158 -0
- data/distro/common/man/man8/chef-solr.8 +114 -0
- data/distro/common/markdown/README +3 -0
- data/distro/common/markdown/man1/knife-bootstrap.mkd +138 -0
- data/distro/common/markdown/man1/knife-client.mkd +103 -0
- data/distro/common/markdown/man1/knife-configure.mkd +70 -0
- data/distro/common/markdown/man1/knife-cookbook-site.mkd +119 -0
- data/distro/common/markdown/man1/knife-cookbook.mkd +253 -0
- data/distro/common/markdown/man1/knife-data-bag.mkd +117 -0
- data/distro/common/markdown/man1/knife-environment.mkd +151 -0
- data/distro/common/markdown/man1/knife-exec.mkd +37 -0
- data/distro/common/markdown/man1/knife-index.mkd +30 -0
- data/distro/common/markdown/man1/knife-node.mkd +147 -0
- data/distro/common/markdown/man1/knife-role.mkd +85 -0
- data/distro/common/markdown/man1/knife-search.mkd +55 -0
- data/distro/common/markdown/man1/knife-ssh.mkd +62 -0
- data/distro/common/markdown/man1/knife-status.mkd +36 -0
- data/distro/common/markdown/man1/knife-tag.mkd +39 -0
- data/distro/common/markdown/man1/knife.mkd +189 -0
- data/distro/common/markdown/man1/shef.mkd +189 -0
- data/distro/common/markdown/man8/chef-client.mkd +65 -0
- data/distro/common/markdown/man8/chef-expander-cluster.mkd +82 -0
- data/distro/common/markdown/man8/chef-expanderctl.mkd +58 -0
- data/distro/common/markdown/man8/chef-server-webui.mkd +121 -0
- data/distro/common/markdown/man8/chef-server.mkd +121 -0
- data/distro/common/markdown/man8/chef-solo.mkd +107 -0
- data/distro/common/markdown/man8/chef-solr.mkd +85 -0
- data/distro/debian/etc/default/chef-client +4 -0
- data/distro/debian/etc/default/chef-expander +8 -0
- data/distro/debian/etc/default/chef-server +9 -0
- data/distro/debian/etc/default/chef-server-webui +9 -0
- data/distro/debian/etc/default/chef-solr +8 -0
- data/distro/debian/etc/init.d/chef-client +175 -0
- data/distro/debian/etc/init.d/chef-expander +176 -0
- data/distro/debian/etc/init.d/chef-server +122 -0
- data/distro/debian/etc/init.d/chef-server-webui +123 -0
- data/distro/debian/etc/init.d/chef-solr +176 -0
- data/distro/debian/etc/init/chef-client.conf +17 -0
- data/distro/debian/etc/init/chef-expander.conf +17 -0
- data/distro/debian/etc/init/chef-server-webui.conf +17 -0
- data/distro/debian/etc/init/chef-server.conf +17 -0
- data/distro/debian/etc/init/chef-solr.conf +17 -0
- data/distro/redhat/etc/init.d/chef-client +106 -0
- data/distro/redhat/etc/init.d/chef-expander +104 -0
- data/distro/redhat/etc/init.d/chef-server +112 -0
- data/distro/redhat/etc/init.d/chef-server-webui +112 -0
- data/distro/redhat/etc/init.d/chef-solr +104 -0
- data/distro/redhat/etc/logrotate.d/chef-client +8 -0
- data/distro/redhat/etc/logrotate.d/chef-expander +8 -0
- data/distro/redhat/etc/logrotate.d/chef-server +8 -0
- data/distro/redhat/etc/logrotate.d/chef-server-webui +8 -0
- data/distro/redhat/etc/logrotate.d/chef-solr +8 -0
- data/distro/redhat/etc/sysconfig/chef-client +15 -0
- data/distro/redhat/etc/sysconfig/chef-expander +7 -0
- data/distro/redhat/etc/sysconfig/chef-server +14 -0
- data/distro/redhat/etc/sysconfig/chef-server-webui +14 -0
- data/distro/redhat/etc/sysconfig/chef-solr +8 -0
- data/lib/chef.rb +40 -0
- data/lib/chef/api_client.rb +265 -0
- data/lib/chef/application.rb +152 -0
- data/lib/chef/application/agent.rb +18 -0
- data/lib/chef/application/client.rb +280 -0
- data/lib/chef/application/knife.rb +188 -0
- data/lib/chef/application/solo.rb +218 -0
- data/lib/chef/applications.rb +4 -0
- data/lib/chef/certificate.rb +194 -0
- data/lib/chef/checksum.rb +182 -0
- data/lib/chef/checksum_cache.rb +189 -0
- data/lib/chef/client.rb +366 -0
- data/lib/chef/config.rb +244 -0
- data/lib/chef/cookbook/chefignore.rb +66 -0
- data/lib/chef/cookbook/cookbook_collection.rb +45 -0
- data/lib/chef/cookbook/cookbook_version_loader.rb +173 -0
- data/lib/chef/cookbook/file_system_file_vendor.rb +56 -0
- data/lib/chef/cookbook/file_vendor.rb +48 -0
- data/lib/chef/cookbook/metadata.rb +629 -0
- data/lib/chef/cookbook/remote_file_vendor.rb +87 -0
- data/lib/chef/cookbook/syntax_check.rb +136 -0
- data/lib/chef/cookbook_loader.rb +103 -0
- data/lib/chef/cookbook_site_streaming_uploader.rb +244 -0
- data/lib/chef/cookbook_uploader.rb +151 -0
- data/lib/chef/cookbook_version.rb +1071 -0
- data/lib/chef/cookbook_version_selector.rb +168 -0
- data/lib/chef/couchdb.rb +246 -0
- data/lib/chef/daemon.rb +172 -0
- data/lib/chef/data_bag.rb +223 -0
- data/lib/chef/data_bag_item.rb +267 -0
- data/lib/chef/encrypted_data_bag_item.rb +126 -0
- data/lib/chef/environment.rb +449 -0
- data/lib/chef/exceptions.rb +153 -0
- data/lib/chef/file_access_control.rb +144 -0
- data/lib/chef/file_cache.rb +218 -0
- data/lib/chef/handler.rb +206 -0
- data/lib/chef/handler/error_report.rb +40 -0
- data/lib/chef/handler/json_file.rb +58 -0
- data/lib/chef/index_queue.rb +29 -0
- data/lib/chef/index_queue/amqp_client.rb +116 -0
- data/lib/chef/index_queue/consumer.rb +76 -0
- data/lib/chef/index_queue/indexable.rb +109 -0
- data/lib/chef/json_compat.rb +52 -0
- data/lib/chef/knife.rb +548 -0
- data/lib/chef/knife/bootstrap.rb +228 -0
- data/lib/chef/knife/bootstrap/archlinux-gems.erb +48 -0
- data/lib/chef/knife/bootstrap/centos5-gems.erb +50 -0
- data/lib/chef/knife/bootstrap/fedora13-gems.erb +39 -0
- data/lib/chef/knife/bootstrap/ubuntu10.04-apt.erb +32 -0
- data/lib/chef/knife/bootstrap/ubuntu10.04-gems.erb +48 -0
- data/lib/chef/knife/client_bulk_delete.rb +43 -0
- data/lib/chef/knife/client_create.rb +73 -0
- data/lib/chef/knife/client_delete.rb +48 -0
- data/lib/chef/knife/client_edit.rb +48 -0
- data/lib/chef/knife/client_list.rb +43 -0
- data/lib/chef/knife/client_reregister.rb +59 -0
- data/lib/chef/knife/client_show.rb +53 -0
- data/lib/chef/knife/configure.rb +149 -0
- data/lib/chef/knife/configure_client.rb +52 -0
- data/lib/chef/knife/cookbook_bulk_delete.rb +72 -0
- data/lib/chef/knife/cookbook_create.rb +274 -0
- data/lib/chef/knife/cookbook_delete.rb +149 -0
- data/lib/chef/knife/cookbook_download.rb +134 -0
- data/lib/chef/knife/cookbook_list.rb +53 -0
- data/lib/chef/knife/cookbook_metadata.rb +107 -0
- data/lib/chef/knife/cookbook_metadata_from_file.rb +44 -0
- data/lib/chef/knife/cookbook_show.rb +102 -0
- data/lib/chef/knife/cookbook_site_download.rb +70 -0
- data/lib/chef/knife/cookbook_site_install.rb +148 -0
- data/lib/chef/knife/cookbook_site_list.rb +60 -0
- data/lib/chef/knife/cookbook_site_search.rb +51 -0
- data/lib/chef/knife/cookbook_site_share.rb +114 -0
- data/lib/chef/knife/cookbook_site_show.rb +57 -0
- data/lib/chef/knife/cookbook_site_unshare.rb +56 -0
- data/lib/chef/knife/cookbook_site_vendor.rb +46 -0
- data/lib/chef/knife/cookbook_test.rb +93 -0
- data/lib/chef/knife/cookbook_upload.rb +169 -0
- data/lib/chef/knife/core/cookbook_scm_repo.rb +149 -0
- data/lib/chef/knife/core/generic_presenter.rb +184 -0
- data/lib/chef/knife/core/node_editor.rb +127 -0
- data/lib/chef/knife/core/node_presenter.rb +103 -0
- data/lib/chef/knife/core/object_loader.rb +75 -0
- data/lib/chef/knife/core/subcommand_loader.rb +112 -0
- data/lib/chef/knife/core/text_formatter.rb +100 -0
- data/lib/chef/knife/core/ui.rb +211 -0
- data/lib/chef/knife/data_bag_create.rb +95 -0
- data/lib/chef/knife/data_bag_delete.rb +51 -0
- data/lib/chef/knife/data_bag_edit.rb +94 -0
- data/lib/chef/knife/data_bag_from_file.rb +91 -0
- data/lib/chef/knife/data_bag_list.rb +46 -0
- data/lib/chef/knife/data_bag_show.rb +81 -0
- data/lib/chef/knife/environment_create.rb +53 -0
- data/lib/chef/knife/environment_delete.rb +45 -0
- data/lib/chef/knife/environment_edit.rb +45 -0
- data/lib/chef/knife/environment_from_file.rb +50 -0
- data/lib/chef/knife/environment_list.rb +42 -0
- data/lib/chef/knife/environment_show.rb +46 -0
- data/lib/chef/knife/exec.rb +51 -0
- data/lib/chef/knife/help.rb +102 -0
- data/lib/chef/knife/index_rebuild.rb +50 -0
- data/lib/chef/knife/node_bulk_delete.rb +80 -0
- data/lib/chef/knife/node_create.rb +50 -0
- data/lib/chef/knife/node_delete.rb +47 -0
- data/lib/chef/knife/node_edit.rb +72 -0
- data/lib/chef/knife/node_from_file.rb +50 -0
- data/lib/chef/knife/node_list.rb +46 -0
- data/lib/chef/knife/node_run_list_add.rb +67 -0
- data/lib/chef/knife/node_run_list_remove.rb +48 -0
- data/lib/chef/knife/node_show.rb +68 -0
- data/lib/chef/knife/recipe_list.rb +32 -0
- data/lib/chef/knife/role_bulk_delete.rb +70 -0
- data/lib/chef/knife/role_create.rb +55 -0
- data/lib/chef/knife/role_delete.rb +47 -0
- data/lib/chef/knife/role_edit.rb +48 -0
- data/lib/chef/knife/role_from_file.rb +54 -0
- data/lib/chef/knife/role_list.rb +43 -0
- data/lib/chef/knife/role_show.rb +54 -0
- data/lib/chef/knife/search.rb +138 -0
- data/lib/chef/knife/ssh.rb +329 -0
- data/lib/chef/knife/status.rb +104 -0
- data/lib/chef/knife/tag_create.rb +52 -0
- data/lib/chef/knife/tag_delete.rb +60 -0
- data/lib/chef/knife/tag_list.rb +47 -0
- data/lib/chef/log.rb +39 -0
- data/lib/chef/mash.rb +211 -0
- data/lib/chef/mixin/check_helper.rb +31 -0
- data/lib/chef/mixin/checksum.rb +32 -0
- data/lib/chef/mixin/command.rb +221 -0
- data/lib/chef/mixin/command/unix.rb +215 -0
- data/lib/chef/mixin/command/windows.rb +76 -0
- data/lib/chef/mixin/convert_to_class_name.rb +63 -0
- data/lib/chef/mixin/create_path.rb +56 -0
- data/lib/chef/mixin/deep_merge.rb +225 -0
- data/lib/chef/mixin/deprecation.rb +65 -0
- data/lib/chef/mixin/from_file.rb +50 -0
- data/lib/chef/mixin/language.rb +165 -0
- data/lib/chef/mixin/language_include_attribute.rb +61 -0
- data/lib/chef/mixin/language_include_recipe.rb +52 -0
- data/lib/chef/mixin/params_validate.rb +225 -0
- data/lib/chef/mixin/recipe_definition_dsl_core.rb +78 -0
- data/lib/chef/mixin/shell_out.rb +41 -0
- data/lib/chef/mixin/template.rb +95 -0
- data/lib/chef/mixin/xml_escape.rb +140 -0
- data/lib/chef/mixins.rb +15 -0
- data/lib/chef/monkey_patches/dir.rb +36 -0
- data/lib/chef/monkey_patches/numeric.rb +7 -0
- data/lib/chef/monkey_patches/object.rb +9 -0
- data/lib/chef/monkey_patches/regexp.rb +34 -0
- data/lib/chef/monkey_patches/string.rb +28 -0
- data/lib/chef/monkey_patches/tempfile.rb +64 -0
- data/lib/chef/nil_argument.rb +3 -0
- data/lib/chef/node.rb +677 -0
- data/lib/chef/node/attribute.rb +487 -0
- data/lib/chef/openid_registration.rb +187 -0
- data/lib/chef/platform.rb +409 -0
- data/lib/chef/provider.rb +124 -0
- data/lib/chef/provider/breakpoint.rb +36 -0
- data/lib/chef/provider/cookbook_file.rb +100 -0
- data/lib/chef/provider/cron.rb +186 -0
- data/lib/chef/provider/cron/solaris.rb +195 -0
- data/lib/chef/provider/deploy.rb +343 -0
- data/lib/chef/provider/deploy/revision.rb +80 -0
- data/lib/chef/provider/deploy/timestamped.rb +33 -0
- data/lib/chef/provider/directory.rb +72 -0
- data/lib/chef/provider/env.rb +152 -0
- data/lib/chef/provider/env/windows.rb +75 -0
- data/lib/chef/provider/erl_call.rb +101 -0
- data/lib/chef/provider/execute.rb +65 -0
- data/lib/chef/provider/file.rb +222 -0
- data/lib/chef/provider/git.rb +230 -0
- data/lib/chef/provider/group.rb +133 -0
- data/lib/chef/provider/group/aix.rb +70 -0
- data/lib/chef/provider/group/dscl.rb +121 -0
- data/lib/chef/provider/group/gpasswd.rb +53 -0
- data/lib/chef/provider/group/groupadd.rb +81 -0
- data/lib/chef/provider/group/pw.rb +84 -0
- data/lib/chef/provider/group/usermod.rb +57 -0
- data/lib/chef/provider/group/windows.rb +79 -0
- data/lib/chef/provider/http_request.rb +122 -0
- data/lib/chef/provider/ifconfig.rb +134 -0
- data/lib/chef/provider/link.rb +164 -0
- data/lib/chef/provider/log.rb +54 -0
- data/lib/chef/provider/mdadm.rb +91 -0
- data/lib/chef/provider/mount.rb +114 -0
- data/lib/chef/provider/mount/mount.rb +232 -0
- data/lib/chef/provider/mount/windows.rb +81 -0
- data/lib/chef/provider/ohai.rb +42 -0
- data/lib/chef/provider/package.rb +164 -0
- data/lib/chef/provider/package/apt.rb +110 -0
- data/lib/chef/provider/package/dpkg.rb +112 -0
- data/lib/chef/provider/package/easy_install.rb +136 -0
- data/lib/chef/provider/package/freebsd.rb +122 -0
- data/lib/chef/provider/package/macports.rb +105 -0
- data/lib/chef/provider/package/pacman.rb +101 -0
- data/lib/chef/provider/package/portage.rb +135 -0
- data/lib/chef/provider/package/rpm.rb +101 -0
- data/lib/chef/provider/package/rubygems.rb +462 -0
- data/lib/chef/provider/package/solaris.rb +127 -0
- data/lib/chef/provider/package/yum-dump.py +128 -0
- data/lib/chef/provider/package/yum.rb +261 -0
- data/lib/chef/provider/package/zypper.rb +127 -0
- data/lib/chef/provider/remote_directory.rb +139 -0
- data/lib/chef/provider/remote_file.rb +118 -0
- data/lib/chef/provider/route.rb +193 -0
- data/lib/chef/provider/ruby_block.rb +34 -0
- data/lib/chef/provider/script.rb +55 -0
- data/lib/chef/provider/service.rb +122 -0
- data/lib/chef/provider/service/arch.rb +109 -0
- data/lib/chef/provider/service/debian.rb +130 -0
- data/lib/chef/provider/service/freebsd.rb +154 -0
- data/lib/chef/provider/service/gentoo.rb +53 -0
- data/lib/chef/provider/service/init.rb +71 -0
- data/lib/chef/provider/service/insserv.rb +52 -0
- data/lib/chef/provider/service/redhat.rb +60 -0
- data/lib/chef/provider/service/simple.rb +120 -0
- data/lib/chef/provider/service/solaris.rb +85 -0
- data/lib/chef/provider/service/upstart.rb +192 -0
- data/lib/chef/provider/service/windows.rb +146 -0
- data/lib/chef/provider/subversion.rb +197 -0
- data/lib/chef/provider/template.rb +104 -0
- data/lib/chef/provider/user.rb +186 -0
- data/lib/chef/provider/user/dscl.rb +280 -0
- data/lib/chef/provider/user/pw.rb +113 -0
- data/lib/chef/provider/user/useradd.rb +137 -0
- data/lib/chef/provider/user/windows.rb +124 -0
- data/lib/chef/providers.rb +93 -0
- data/lib/chef/recipe.rb +128 -0
- data/lib/chef/resource.rb +554 -0
- data/lib/chef/resource/apt_package.rb +34 -0
- data/lib/chef/resource/bash.rb +33 -0
- data/lib/chef/resource/breakpoint.rb +35 -0
- data/lib/chef/resource/cookbook_file.rb +45 -0
- data/lib/chef/resource/cron.rb +188 -0
- data/lib/chef/resource/csh.rb +33 -0
- data/lib/chef/resource/deploy.rb +371 -0
- data/lib/chef/resource/deploy_revision.rb +40 -0
- data/lib/chef/resource/directory.rb +76 -0
- data/lib/chef/resource/dpkg_package.rb +34 -0
- data/lib/chef/resource/easy_install_package.rb +57 -0
- data/lib/chef/resource/env.rb +58 -0
- data/lib/chef/resource/erl_call.rb +83 -0
- data/lib/chef/resource/execute.rb +127 -0
- data/lib/chef/resource/file.rb +99 -0
- data/lib/chef/resource/freebsd_package.rb +35 -0
- data/lib/chef/resource/gem_package.rb +53 -0
- data/lib/chef/resource/git.rb +37 -0
- data/lib/chef/resource/group.rb +70 -0
- data/lib/chef/resource/http_request.rb +61 -0
- data/lib/chef/resource/ifconfig.rb +134 -0
- data/lib/chef/resource/link.rb +78 -0
- data/lib/chef/resource/log.rb +62 -0
- data/lib/chef/resource/macports_package.rb +29 -0
- data/lib/chef/resource/mdadm.rb +82 -0
- data/lib/chef/resource/mount.rb +135 -0
- data/lib/chef/resource/ohai.rb +40 -0
- data/lib/chef/resource/package.rb +80 -0
- data/lib/chef/resource/pacman_package.rb +33 -0
- data/lib/chef/resource/perl.rb +33 -0
- data/lib/chef/resource/portage_package.rb +33 -0
- data/lib/chef/resource/python.rb +33 -0
- data/lib/chef/resource/remote_directory.rb +109 -0
- data/lib/chef/resource/remote_file.rb +83 -0
- data/lib/chef/resource/route.rb +135 -0
- data/lib/chef/resource/rpm_package.rb +34 -0
- data/lib/chef/resource/ruby.rb +33 -0
- data/lib/chef/resource/ruby_block.rb +40 -0
- data/lib/chef/resource/scm.rb +147 -0
- data/lib/chef/resource/script.rb +60 -0
- data/lib/chef/resource/service.rb +160 -0
- data/lib/chef/resource/solaris_package.rb +36 -0
- data/lib/chef/resource/subversion.rb +36 -0
- data/lib/chef/resource/template.rb +69 -0
- data/lib/chef/resource/timestamped_deploy.rb +31 -0
- data/lib/chef/resource/user.rb +130 -0
- data/lib/chef/resource/yum_package.rb +43 -0
- data/lib/chef/resource_collection.rb +217 -0
- data/lib/chef/resource_collection/stepable_iterator.rb +124 -0
- data/lib/chef/resource_definition.rb +67 -0
- data/lib/chef/resource_definition_list.rb +38 -0
- data/lib/chef/resources.rb +64 -0
- data/lib/chef/rest.rb +392 -0
- data/lib/chef/rest/auth_credentials.rb +71 -0
- data/lib/chef/rest/cookie_jar.rb +31 -0
- data/lib/chef/rest/rest_request.rb +213 -0
- data/lib/chef/role.rb +342 -0
- data/lib/chef/run_context.rb +126 -0
- data/lib/chef/run_list.rb +165 -0
- data/lib/chef/run_list/run_list_expansion.rb +193 -0
- data/lib/chef/run_list/run_list_item.rb +92 -0
- data/lib/chef/run_list/versioned_recipe_list.rb +68 -0
- data/lib/chef/run_status.rb +121 -0
- data/lib/chef/runner.rb +92 -0
- data/lib/chef/sandbox.rb +153 -0
- data/lib/chef/search/query.rb +65 -0
- data/lib/chef/shef.rb +327 -0
- data/lib/chef/shef/ext.rb +569 -0
- data/lib/chef/shef/model_wrapper.rb +120 -0
- data/lib/chef/shef/shef_rest.rb +28 -0
- data/lib/chef/shef/shef_session.rb +284 -0
- data/lib/chef/shell_out.rb +250 -0
- data/lib/chef/shell_out/unix.rb +223 -0
- data/lib/chef/shell_out/windows.rb +98 -0
- data/lib/chef/solr_query.rb +187 -0
- data/lib/chef/solr_query/lucene.treetop +150 -0
- data/lib/chef/solr_query/lucene_nodes.rb +285 -0
- data/lib/chef/solr_query/query_transform.rb +65 -0
- data/lib/chef/solr_query/solr_http_request.rb +118 -0
- data/lib/chef/streaming_cookbook_uploader.rb +201 -0
- data/lib/chef/tasks/chef_repo.rake +330 -0
- data/lib/chef/util/file_edit.rb +122 -0
- data/lib/chef/util/windows.rb +56 -0
- data/lib/chef/util/windows/net_group.rb +101 -0
- data/lib/chef/util/windows/net_use.rb +121 -0
- data/lib/chef/util/windows/net_user.rb +198 -0
- data/lib/chef/util/windows/volume.rb +59 -0
- data/lib/chef/version.rb +23 -0
- data/lib/chef/version_class.rb +70 -0
- data/lib/chef/version_constraint.rb +116 -0
- data/lib/chef/webui_user.rb +231 -0
- metadata +759 -0
@@ -0,0 +1,170 @@
|
|
1
|
+
<!DOCTYPE html>
|
2
|
+
<html>
|
3
|
+
<head>
|
4
|
+
<meta http-equiv='content-type' value='text/html;charset=utf8'>
|
5
|
+
<meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
|
6
|
+
<title>knife-configure(1) - Generate configuration files for knife or Chef Client</title>
|
7
|
+
<style type='text/css' media='all'>
|
8
|
+
/* style: man */
|
9
|
+
body#manpage {margin:0}
|
10
|
+
.mp {max-width:100ex;padding:0 9ex 1ex 4ex}
|
11
|
+
.mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
|
12
|
+
.mp h2 {margin:10px 0 0 0}
|
13
|
+
.mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
|
14
|
+
.mp h3 {margin:0 0 0 4ex}
|
15
|
+
.mp dt {margin:0;clear:left}
|
16
|
+
.mp dt.flush {float:left;width:8ex}
|
17
|
+
.mp dd {margin:0 0 0 9ex}
|
18
|
+
.mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
|
19
|
+
.mp pre {margin-bottom:20px}
|
20
|
+
.mp pre+h2,.mp pre+h3 {margin-top:22px}
|
21
|
+
.mp h2+pre,.mp h3+pre {margin-top:5px}
|
22
|
+
.mp img {display:block;margin:auto}
|
23
|
+
.mp h1.man-title {display:none}
|
24
|
+
.mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
|
25
|
+
.mp h2 {font-size:16px;line-height:1.25}
|
26
|
+
.mp h1 {font-size:20px;line-height:2}
|
27
|
+
.mp {text-align:justify;background:#fff}
|
28
|
+
.mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
|
29
|
+
.mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
|
30
|
+
.mp u {text-decoration:underline}
|
31
|
+
.mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
|
32
|
+
.mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
|
33
|
+
.mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
|
34
|
+
.mp b.man-ref {font-weight:normal;color:#434241}
|
35
|
+
.mp pre {padding:0 4ex}
|
36
|
+
.mp pre code {font-weight:normal;color:#434241}
|
37
|
+
.mp h2+pre,h3+pre {padding-left:0}
|
38
|
+
ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
|
39
|
+
ol.man-decor {width:100%}
|
40
|
+
ol.man-decor li.tl {text-align:left}
|
41
|
+
ol.man-decor li.tc {text-align:center;letter-spacing:4px}
|
42
|
+
ol.man-decor li.tr {text-align:right;float:right}
|
43
|
+
</style>
|
44
|
+
<style type='text/css' media='all'>
|
45
|
+
/* style: toc */
|
46
|
+
.man-navigation {display:block !important;position:fixed;top:0;left:113ex;height:100%;width:100%;padding:48px 0 0 0;border-left:1px solid #dbdbdb;background:#eee}
|
47
|
+
.man-navigation a,.man-navigation a:hover,.man-navigation a:link,.man-navigation a:visited {display:block;margin:0;padding:5px 2px 5px 30px;color:#999;text-decoration:none}
|
48
|
+
.man-navigation a:hover {color:#111;text-decoration:underline}
|
49
|
+
</style>
|
50
|
+
</head>
|
51
|
+
<!--
|
52
|
+
The following styles are deprecated and will be removed at some point:
|
53
|
+
div#man, div#man ol.man, div#man ol.head, div#man ol.man.
|
54
|
+
|
55
|
+
The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
|
56
|
+
.man-navigation should be used instead.
|
57
|
+
-->
|
58
|
+
<body id='manpage'>
|
59
|
+
<div class='mp' id='man'>
|
60
|
+
|
61
|
+
<div class='man-navigation' style='display:none'>
|
62
|
+
<a href="#NAME">NAME</a>
|
63
|
+
<a href="#SYNOPSIS">SYNOPSIS</a>
|
64
|
+
<a href="#DESCRIPTION">DESCRIPTION</a>
|
65
|
+
<a href="#CONFIGURE-SUBCOMMANDS">CONFIGURE SUBCOMMANDS</a>
|
66
|
+
<a href="#EXAMPLES">EXAMPLES</a>
|
67
|
+
<a href="#SEE-ALSO">SEE ALSO</a>
|
68
|
+
<a href="#AUTHOR">AUTHOR</a>
|
69
|
+
<a href="#DOCUMENTATION">DOCUMENTATION</a>
|
70
|
+
<a href="#CHEF">CHEF</a>
|
71
|
+
</div>
|
72
|
+
|
73
|
+
<ol class='man-decor man-head man head'>
|
74
|
+
<li class='tl'>knife-configure(1)</li>
|
75
|
+
<li class='tc'>Chef Manual</li>
|
76
|
+
<li class='tr'>knife-configure(1)</li>
|
77
|
+
</ol>
|
78
|
+
|
79
|
+
<h2 id="NAME">NAME</h2>
|
80
|
+
<p class="man-name">
|
81
|
+
<code>knife-configure</code> - <span class="man-whatis">Generate configuration files for knife or Chef Client</span>
|
82
|
+
</p>
|
83
|
+
|
84
|
+
<h2 id="SYNOPSIS">SYNOPSIS</h2>
|
85
|
+
|
86
|
+
<p><strong>knife</strong> <strong>configure</strong> [client] <em>(options)</em></p>
|
87
|
+
|
88
|
+
<h2 id="DESCRIPTION">DESCRIPTION</h2>
|
89
|
+
|
90
|
+
<p>Generates a knife.rb configuration file interactively. When given the
|
91
|
+
--initial option, also creates a new administrative user.</p>
|
92
|
+
|
93
|
+
<h2 id="CONFIGURE-SUBCOMMANDS">CONFIGURE SUBCOMMANDS</h2>
|
94
|
+
|
95
|
+
<p><strong>knife configure</strong> <em>(options)</em></p>
|
96
|
+
|
97
|
+
<dl>
|
98
|
+
<dt><code>-i</code>, <code>--initial</code></dt><dd>Create an initial API Client</dd>
|
99
|
+
<dt><code>-r</code>, <code>--repository REPO</code></dt><dd>The path to your chef-repo</dd>
|
100
|
+
</dl>
|
101
|
+
|
102
|
+
|
103
|
+
<p>Create a configuration file for knife. This will prompt for values to
|
104
|
+
enter into the file. Default values are listed in square brackets if no
|
105
|
+
other entry is typed. See <strong>knife</strong>(1) for a description of
|
106
|
+
configuration options.</p>
|
107
|
+
|
108
|
+
<p><strong>knife configure client</strong> <em>directory</em></p>
|
109
|
+
|
110
|
+
<p>Read the <em>knife.rb</em> config file and generate a config file suitable for
|
111
|
+
use in <em>/etc/chef/client.rb</em> and copy the validation certificate into
|
112
|
+
the specified <em>directory</em>.</p>
|
113
|
+
|
114
|
+
<h2 id="EXAMPLES">EXAMPLES</h2>
|
115
|
+
|
116
|
+
<ul>
|
117
|
+
<li><p>On a freshly installed Chef Server, use <em>knife configure -i</em> to
|
118
|
+
create an administrator and knife configuration file. Leave the
|
119
|
+
field blank to accept the default value. On most systems, the
|
120
|
+
default values are acceptable.</p>
|
121
|
+
|
122
|
+
<p>user@host$ knife configure -i<br />
|
123
|
+
Please enter the chef server URL: [http://localhost:4000]<br />
|
124
|
+
Please enter a clientname for the new client: [username]<br />
|
125
|
+
Please enter the existing admin clientname: [chef-webui]<br />
|
126
|
+
Please enter the location of the existing admin client's private key: [/etc/chef/webui.pem]<br />
|
127
|
+
Please enter the validation clientname: [chef-validator]<br />
|
128
|
+
Please enter the location of the validation key: [/etc/chef/validation.pem]<br />
|
129
|
+
Please enter the path to a chef repository (or leave blank):<br />
|
130
|
+
Creating initial API user...<br />
|
131
|
+
Created (or updated) client[username]<br />
|
132
|
+
Configuration file written to /home/username/.chef/knife.rb</p>
|
133
|
+
|
134
|
+
<p>This creates a new administrator client named <em>username</em>, writes
|
135
|
+
a configuration file to <em>/home/username/.chef/knife.rb</em>, and the
|
136
|
+
private key to <em>/home/username/.chef/username.pem</em>. The
|
137
|
+
configuration file and private key may be copied to another system
|
138
|
+
to facilitate administration of the Chef Server from a remote
|
139
|
+
system. Depending on the value given for the Chef Server URL, you
|
140
|
+
may need to modify that setting after copying to a remote host.</p></li>
|
141
|
+
</ul>
|
142
|
+
|
143
|
+
|
144
|
+
<h2 id="SEE-ALSO">SEE ALSO</h2>
|
145
|
+
|
146
|
+
<p> <strong>knife</strong>(1) <strong>knife-client</strong>(1)</p>
|
147
|
+
|
148
|
+
<h2 id="AUTHOR">AUTHOR</h2>
|
149
|
+
|
150
|
+
<p> Chef was written by Adam Jacob <a href="mailto:adam@opscode.com" data-bare-link="true">adam@opscode.com</a> with many contributions from the community.</p>
|
151
|
+
|
152
|
+
<h2 id="DOCUMENTATION">DOCUMENTATION</h2>
|
153
|
+
|
154
|
+
<p> This manual page was written by Joshua Timberman <a href="mailto:joshua@opscode.com" data-bare-link="true">joshua@opscode.com</a>.
|
155
|
+
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
|
156
|
+
|
157
|
+
<h2 id="CHEF">CHEF</h2>
|
158
|
+
|
159
|
+
<p> Knife is distributed with Chef. <a href="http://wiki.opscode.com/display/chef/Home" data-bare-link="true">http://wiki.opscode.com/display/chef/Home</a></p>
|
160
|
+
|
161
|
+
|
162
|
+
<ol class='man-decor man-foot man foot'>
|
163
|
+
<li class='tl'>Chef 0.10.0.rc.0</li>
|
164
|
+
<li class='tc'>April 2011</li>
|
165
|
+
<li class='tr'>knife-configure(1)</li>
|
166
|
+
</ol>
|
167
|
+
|
168
|
+
</div>
|
169
|
+
</body>
|
170
|
+
</html>
|
@@ -0,0 +1,239 @@
|
|
1
|
+
<!DOCTYPE html>
|
2
|
+
<html>
|
3
|
+
<head>
|
4
|
+
<meta http-equiv='content-type' value='text/html;charset=utf8'>
|
5
|
+
<meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
|
6
|
+
<title>knife-cookbook-site(1) - Install and update open source cookbooks</title>
|
7
|
+
<style type='text/css' media='all'>
|
8
|
+
/* style: man */
|
9
|
+
body#manpage {margin:0}
|
10
|
+
.mp {max-width:100ex;padding:0 9ex 1ex 4ex}
|
11
|
+
.mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
|
12
|
+
.mp h2 {margin:10px 0 0 0}
|
13
|
+
.mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
|
14
|
+
.mp h3 {margin:0 0 0 4ex}
|
15
|
+
.mp dt {margin:0;clear:left}
|
16
|
+
.mp dt.flush {float:left;width:8ex}
|
17
|
+
.mp dd {margin:0 0 0 9ex}
|
18
|
+
.mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
|
19
|
+
.mp pre {margin-bottom:20px}
|
20
|
+
.mp pre+h2,.mp pre+h3 {margin-top:22px}
|
21
|
+
.mp h2+pre,.mp h3+pre {margin-top:5px}
|
22
|
+
.mp img {display:block;margin:auto}
|
23
|
+
.mp h1.man-title {display:none}
|
24
|
+
.mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
|
25
|
+
.mp h2 {font-size:16px;line-height:1.25}
|
26
|
+
.mp h1 {font-size:20px;line-height:2}
|
27
|
+
.mp {text-align:justify;background:#fff}
|
28
|
+
.mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
|
29
|
+
.mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
|
30
|
+
.mp u {text-decoration:underline}
|
31
|
+
.mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
|
32
|
+
.mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
|
33
|
+
.mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
|
34
|
+
.mp b.man-ref {font-weight:normal;color:#434241}
|
35
|
+
.mp pre {padding:0 4ex}
|
36
|
+
.mp pre code {font-weight:normal;color:#434241}
|
37
|
+
.mp h2+pre,h3+pre {padding-left:0}
|
38
|
+
ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
|
39
|
+
ol.man-decor {width:100%}
|
40
|
+
ol.man-decor li.tl {text-align:left}
|
41
|
+
ol.man-decor li.tc {text-align:center;letter-spacing:4px}
|
42
|
+
ol.man-decor li.tr {text-align:right;float:right}
|
43
|
+
</style>
|
44
|
+
<style type='text/css' media='all'>
|
45
|
+
/* style: toc */
|
46
|
+
.man-navigation {display:block !important;position:fixed;top:0;left:113ex;height:100%;width:100%;padding:48px 0 0 0;border-left:1px solid #dbdbdb;background:#eee}
|
47
|
+
.man-navigation a,.man-navigation a:hover,.man-navigation a:link,.man-navigation a:visited {display:block;margin:0;padding:5px 2px 5px 30px;color:#999;text-decoration:none}
|
48
|
+
.man-navigation a:hover {color:#111;text-decoration:underline}
|
49
|
+
</style>
|
50
|
+
</head>
|
51
|
+
<!--
|
52
|
+
The following styles are deprecated and will be removed at some point:
|
53
|
+
div#man, div#man ol.man, div#man ol.head, div#man ol.man.
|
54
|
+
|
55
|
+
The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
|
56
|
+
.man-navigation should be used instead.
|
57
|
+
-->
|
58
|
+
<body id='manpage'>
|
59
|
+
<div class='mp' id='man'>
|
60
|
+
|
61
|
+
<div class='man-navigation' style='display:none'>
|
62
|
+
<a href="#NAME">NAME</a>
|
63
|
+
<a href="#SYNOPSIS">SYNOPSIS</a>
|
64
|
+
<a href="#COOKBOOK-SITE-SUB-COMMANDS">COOKBOOK SITE SUB-COMMANDS</a>
|
65
|
+
<a href="#INSTALL">INSTALL</a>
|
66
|
+
<a href="#DOWNLOAD">DOWNLOAD</a>
|
67
|
+
<a href="#LIST">LIST</a>
|
68
|
+
<a href="#SEARCH">SEARCH</a>
|
69
|
+
<a href="#SHARE">SHARE</a>
|
70
|
+
<a href="#UNSHARE">UNSHARE</a>
|
71
|
+
<a href="#SHOW">SHOW</a>
|
72
|
+
<a href="#DESCRIPTION">DESCRIPTION</a>
|
73
|
+
<a href="#EXAMPLES">EXAMPLES</a>
|
74
|
+
<a href="#SEE-ALSO">SEE ALSO</a>
|
75
|
+
<a href="#AUTHOR">AUTHOR</a>
|
76
|
+
<a href="#DOCUMENTATION">DOCUMENTATION</a>
|
77
|
+
<a href="#CHEF">CHEF</a>
|
78
|
+
</div>
|
79
|
+
|
80
|
+
<ol class='man-decor man-head man head'>
|
81
|
+
<li class='tl'>knife-cookbook-site(1)</li>
|
82
|
+
<li class='tc'>Chef Manual</li>
|
83
|
+
<li class='tr'>knife-cookbook-site(1)</li>
|
84
|
+
</ol>
|
85
|
+
|
86
|
+
<h2 id="NAME">NAME</h2>
|
87
|
+
<p class="man-name">
|
88
|
+
<code>knife-cookbook-site</code> - <span class="man-whatis">Install and update open source cookbooks</span>
|
89
|
+
</p>
|
90
|
+
|
91
|
+
<h2 id="SYNOPSIS">SYNOPSIS</h2>
|
92
|
+
|
93
|
+
<p><strong>knife</strong> <strong>cookbook site</strong> <em>sub-command</em> <em>(options)</em></p>
|
94
|
+
|
95
|
+
<h2 id="COOKBOOK-SITE-SUB-COMMANDS">COOKBOOK SITE SUB-COMMANDS</h2>
|
96
|
+
|
97
|
+
<p><code>knife cookbook site</code> provides the following subcommands:</p>
|
98
|
+
|
99
|
+
<h2 id="INSTALL">INSTALL</h2>
|
100
|
+
|
101
|
+
<p><strong>cookbook site install COOKBOOK [VERSION]</strong> <em>(options)</em></p>
|
102
|
+
|
103
|
+
<dl>
|
104
|
+
<dt><code>-d</code>, <code>--dependencies</code></dt><dd>Grab dependencies automatically</dd>
|
105
|
+
</dl>
|
106
|
+
|
107
|
+
|
108
|
+
<p>Uses <span class="man-ref">git<span class="s">(1)</span></span> version control in conjunction with the cookbook site to
|
109
|
+
install community contributed cookbooks to your local cookbook
|
110
|
+
repository. Running <code>knife cookbook site install</code> does the following:</p>
|
111
|
+
|
112
|
+
<ol>
|
113
|
+
<li>A new "pristine copy" branch is created in git for tracking the
|
114
|
+
upstream;</li>
|
115
|
+
<li>All existing cookbooks are removed from the branch;</li>
|
116
|
+
<li>The cookbook is downloaded from the cookbook site in tarball form;</li>
|
117
|
+
<li>The downloaded cookbook is untarred, and its contents commited via git;</li>
|
118
|
+
<li>The pristine copy branch is merged into the master branch.</li>
|
119
|
+
</ol>
|
120
|
+
|
121
|
+
|
122
|
+
<p>By installing cookbook with this process, you can locally modify the
|
123
|
+
upstream cookbook in your master branch ant let git maintain your
|
124
|
+
changes as a separate patch. When an updated upstream version becomes
|
125
|
+
available, you will be able to merge the upstream changes while
|
126
|
+
maintaining your local modifications.</p>
|
127
|
+
|
128
|
+
<p>If <em>-d</em> is specified, the process is applied recursively to all the
|
129
|
+
cookbooks <em>COOKBOOK</em> depends on (via metadata <em>dependencies</em>).</p>
|
130
|
+
|
131
|
+
<h2 id="DOWNLOAD">DOWNLOAD</h2>
|
132
|
+
|
133
|
+
<p><strong>knife cookbook site download COOKBOOK [VERSION]</strong> <em>(options)</em></p>
|
134
|
+
|
135
|
+
<dl>
|
136
|
+
<dt><code>-f</code>, <code>--file FILE</code></dt><dd>The filename to write to</dd>
|
137
|
+
<dt class="flush"><code>--force</code></dt><dd>Force download deprecated cookbook</dd>
|
138
|
+
</dl>
|
139
|
+
|
140
|
+
|
141
|
+
<p>Downloads a specific cookbook from the Community site, optionally
|
142
|
+
specifying a certain version.</p>
|
143
|
+
|
144
|
+
<h2 id="LIST">LIST</h2>
|
145
|
+
|
146
|
+
<p><strong>knife cookbook site list</strong> <em>(options)</em></p>
|
147
|
+
|
148
|
+
<dl>
|
149
|
+
<dt><code>-w</code>, <code>--with-uri</code></dt><dd>Show corresponding URIs</dd>
|
150
|
+
</dl>
|
151
|
+
|
152
|
+
|
153
|
+
<p>Lists available cookbooks from the Community site.</p>
|
154
|
+
|
155
|
+
<h2 id="SEARCH">SEARCH</h2>
|
156
|
+
|
157
|
+
<p><strong>knife cookbook site search QUERY</strong> <em>(options)</em></p>
|
158
|
+
|
159
|
+
<p>Searches for available cookbooks matching the specified query.</p>
|
160
|
+
|
161
|
+
<h2 id="SHARE">SHARE</h2>
|
162
|
+
|
163
|
+
<p><strong>knife cookbook site share COOKBOOK CATEGORY</strong> <em>(options)</em></p>
|
164
|
+
|
165
|
+
<dl>
|
166
|
+
<dt><code>-k</code>, <code>--key KEY</code></dt><dd>API Client Key</dd>
|
167
|
+
<dt><code>-u</code>, <code>--user USER</code></dt><dd>API Client Username</dd>
|
168
|
+
<dt><code>-o</code>, <code>--cookbook-path PATH:PATH</code></dt><dd>A colon-separated path to look for cookbooks in</dd>
|
169
|
+
</dl>
|
170
|
+
|
171
|
+
|
172
|
+
<p>Uploads the specified cookbook using the given category to the Opscode
|
173
|
+
cookbooks site. Requires a login user and certificate for the Opscode
|
174
|
+
Cookbooks site. By default, knife will use the username and API key
|
175
|
+
you've configured in your configuration file; otherwise you must
|
176
|
+
explicitly set these values on the command line or use an alternate
|
177
|
+
configuration file.</p>
|
178
|
+
|
179
|
+
<h2 id="UNSHARE">UNSHARE</h2>
|
180
|
+
|
181
|
+
<p><strong>knife cookbook site unshare COOKBOOK</strong></p>
|
182
|
+
|
183
|
+
<p>Stops sharing the specified cookbook on the Opscode cookbooks site.</p>
|
184
|
+
|
185
|
+
<h2 id="SHOW">SHOW</h2>
|
186
|
+
|
187
|
+
<p><strong>knife cookbook site show COOKBOOK [VERSION]</strong> <em>(options)</em></p>
|
188
|
+
|
189
|
+
<p>Shows information from the site about a particular cookbook.</p>
|
190
|
+
|
191
|
+
<h2 id="DESCRIPTION">DESCRIPTION</h2>
|
192
|
+
|
193
|
+
<p>The cookbook site, <a href="http://community.opscode.com/" data-bare-link="true">http://community.opscode.com/</a>, is a cookbook
|
194
|
+
distribution service operated by Opscode. This service provides users
|
195
|
+
with a central location to publish cookbooks for sharing with other
|
196
|
+
community members.</p>
|
197
|
+
|
198
|
+
<p><code>knife cookbook site</code> commands provide an interface to the cookbook
|
199
|
+
site's HTTP API. For commands that read data from the API, no account is
|
200
|
+
required. In order to upload cookbooks using the <code>knife cookbook site
|
201
|
+
share</code> command, you must create an account on the cookbook site and
|
202
|
+
configure your credentials via command line option or in your knife
|
203
|
+
configuration file.</p>
|
204
|
+
|
205
|
+
<h2 id="EXAMPLES">EXAMPLES</h2>
|
206
|
+
|
207
|
+
<p>Uploading cookbooks to the Opscode cookbooks site:</p>
|
208
|
+
|
209
|
+
<pre><code>knife cookbook site share example Other -k ~/.chef/USERNAME.pem -u USERNAME
|
210
|
+
</code></pre>
|
211
|
+
|
212
|
+
<h2 id="SEE-ALSO">SEE ALSO</h2>
|
213
|
+
|
214
|
+
<p> <strong><span class="man-ref">knife-cookbook<span class="s">(1)</span></span></strong>
|
215
|
+
<a href="http://community.opscode.com/cookbooks" data-bare-link="true">http://community.opscode.com/cookbooks</a></p>
|
216
|
+
|
217
|
+
<h2 id="AUTHOR">AUTHOR</h2>
|
218
|
+
|
219
|
+
<p> Chef was written by Adam Jacob <a href="mailto:adam@opscode.com" data-bare-link="true">adam@opscode.com</a> with many contributions from the community.</p>
|
220
|
+
|
221
|
+
<h2 id="DOCUMENTATION">DOCUMENTATION</h2>
|
222
|
+
|
223
|
+
<p> This manual page was written by Joshua Timberman <a href="mailto:joshua@opscode.com" data-bare-link="true">joshua@opscode.com</a>.
|
224
|
+
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
|
225
|
+
|
226
|
+
<h2 id="CHEF">CHEF</h2>
|
227
|
+
|
228
|
+
<p> Knife is distributed with Chef. <a href="http://wiki.opscode.com/display/chef/Home" data-bare-link="true">http://wiki.opscode.com/display/chef/Home</a></p>
|
229
|
+
|
230
|
+
|
231
|
+
<ol class='man-decor man-foot man foot'>
|
232
|
+
<li class='tl'>Chef 0.10.0.rc.0</li>
|
233
|
+
<li class='tc'>April 2011</li>
|
234
|
+
<li class='tr'>knife-cookbook-site(1)</li>
|
235
|
+
</ol>
|
236
|
+
|
237
|
+
</div>
|
238
|
+
</body>
|
239
|
+
</html>
|
@@ -0,0 +1,373 @@
|
|
1
|
+
<!DOCTYPE html>
|
2
|
+
<html>
|
3
|
+
<head>
|
4
|
+
<meta http-equiv='content-type' value='text/html;charset=utf8'>
|
5
|
+
<meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
|
6
|
+
<title>knife-cookbook(1) - upload and manage chef cookbooks</title>
|
7
|
+
<style type='text/css' media='all'>
|
8
|
+
/* style: man */
|
9
|
+
body#manpage {margin:0}
|
10
|
+
.mp {max-width:100ex;padding:0 9ex 1ex 4ex}
|
11
|
+
.mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
|
12
|
+
.mp h2 {margin:10px 0 0 0}
|
13
|
+
.mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
|
14
|
+
.mp h3 {margin:0 0 0 4ex}
|
15
|
+
.mp dt {margin:0;clear:left}
|
16
|
+
.mp dt.flush {float:left;width:8ex}
|
17
|
+
.mp dd {margin:0 0 0 9ex}
|
18
|
+
.mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
|
19
|
+
.mp pre {margin-bottom:20px}
|
20
|
+
.mp pre+h2,.mp pre+h3 {margin-top:22px}
|
21
|
+
.mp h2+pre,.mp h3+pre {margin-top:5px}
|
22
|
+
.mp img {display:block;margin:auto}
|
23
|
+
.mp h1.man-title {display:none}
|
24
|
+
.mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
|
25
|
+
.mp h2 {font-size:16px;line-height:1.25}
|
26
|
+
.mp h1 {font-size:20px;line-height:2}
|
27
|
+
.mp {text-align:justify;background:#fff}
|
28
|
+
.mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
|
29
|
+
.mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
|
30
|
+
.mp u {text-decoration:underline}
|
31
|
+
.mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
|
32
|
+
.mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
|
33
|
+
.mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
|
34
|
+
.mp b.man-ref {font-weight:normal;color:#434241}
|
35
|
+
.mp pre {padding:0 4ex}
|
36
|
+
.mp pre code {font-weight:normal;color:#434241}
|
37
|
+
.mp h2+pre,h3+pre {padding-left:0}
|
38
|
+
ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
|
39
|
+
ol.man-decor {width:100%}
|
40
|
+
ol.man-decor li.tl {text-align:left}
|
41
|
+
ol.man-decor li.tc {text-align:center;letter-spacing:4px}
|
42
|
+
ol.man-decor li.tr {text-align:right;float:right}
|
43
|
+
</style>
|
44
|
+
<style type='text/css' media='all'>
|
45
|
+
/* style: toc */
|
46
|
+
.man-navigation {display:block !important;position:fixed;top:0;left:113ex;height:100%;width:100%;padding:48px 0 0 0;border-left:1px solid #dbdbdb;background:#eee}
|
47
|
+
.man-navigation a,.man-navigation a:hover,.man-navigation a:link,.man-navigation a:visited {display:block;margin:0;padding:5px 2px 5px 30px;color:#999;text-decoration:none}
|
48
|
+
.man-navigation a:hover {color:#111;text-decoration:underline}
|
49
|
+
</style>
|
50
|
+
</head>
|
51
|
+
<!--
|
52
|
+
The following styles are deprecated and will be removed at some point:
|
53
|
+
div#man, div#man ol.man, div#man ol.head, div#man ol.man.
|
54
|
+
|
55
|
+
The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
|
56
|
+
.man-navigation should be used instead.
|
57
|
+
-->
|
58
|
+
<body id='manpage'>
|
59
|
+
<div class='mp' id='man'>
|
60
|
+
|
61
|
+
<div class='man-navigation' style='display:none'>
|
62
|
+
<a href="#NAME">NAME</a>
|
63
|
+
<a href="#SYNOPSIS">SYNOPSIS</a>
|
64
|
+
<a href="#SUB-COMMANDS">SUB-COMMANDS</a>
|
65
|
+
<a href="#LIST">LIST</a>
|
66
|
+
<a href="#SHOW">SHOW</a>
|
67
|
+
<a href="#UPLOAD">UPLOAD</a>
|
68
|
+
<a href="#DOWNLOAD">DOWNLOAD</a>
|
69
|
+
<a href="#DELETE">DELETE</a>
|
70
|
+
<a href="#BULK-DELETE">BULK DELETE</a>
|
71
|
+
<a href="#COOKBOOK-CREATE">COOKBOOK CREATE</a>
|
72
|
+
<a href="#METADATA">METADATA</a>
|
73
|
+
<a href="#METADATA-FROM-FILE">METADATA FROM FILE</a>
|
74
|
+
<a href="#TEST">TEST</a>
|
75
|
+
<a href="#RECIPE-LIST">RECIPE LIST</a>
|
76
|
+
<a href="#DESCRIPTION">DESCRIPTION</a>
|
77
|
+
<a href="#SEE-ALSO">SEE ALSO</a>
|
78
|
+
<a href="#AUTHOR">AUTHOR</a>
|
79
|
+
<a href="#DOCUMENTATION">DOCUMENTATION</a>
|
80
|
+
<a href="#CHEF">CHEF</a>
|
81
|
+
</div>
|
82
|
+
|
83
|
+
<ol class='man-decor man-head man head'>
|
84
|
+
<li class='tl'>knife-cookbook(1)</li>
|
85
|
+
<li class='tc'>Chef Manual</li>
|
86
|
+
<li class='tr'>knife-cookbook(1)</li>
|
87
|
+
</ol>
|
88
|
+
|
89
|
+
<h2 id="NAME">NAME</h2>
|
90
|
+
<p class="man-name">
|
91
|
+
<code>knife-cookbook</code> - <span class="man-whatis">upload and manage chef cookbooks</span>
|
92
|
+
</p>
|
93
|
+
|
94
|
+
<h2 id="SYNOPSIS">SYNOPSIS</h2>
|
95
|
+
|
96
|
+
<p><strong>knife</strong> <strong>cookbook</strong> <em>sub-command</em> <em>(options)</em></p>
|
97
|
+
|
98
|
+
<h2 id="SUB-COMMANDS">SUB-COMMANDS</h2>
|
99
|
+
|
100
|
+
<p><code>knife cookbook</code> supports the following sub commands:</p>
|
101
|
+
|
102
|
+
<h2 id="LIST">LIST</h2>
|
103
|
+
|
104
|
+
<p><strong>knife cookbook list</strong> <em>(options)</em></p>
|
105
|
+
|
106
|
+
<dl>
|
107
|
+
<dt><code>-a</code>, <code>--all</code></dt><dd>show all versions of a cookbook instead of just the most recent</dd>
|
108
|
+
<dt><code>-w</code>, <code>--with-uri</code></dt><dd>show corresponding uris</dd>
|
109
|
+
</dl>
|
110
|
+
|
111
|
+
|
112
|
+
<p>Lists the cookbooks available on the Chef server.</p>
|
113
|
+
|
114
|
+
<h2 id="SHOW">SHOW</h2>
|
115
|
+
|
116
|
+
<p><strong>knife cookbook show cookbook [version] [part] [filename]</strong> <em>(options)</em></p>
|
117
|
+
|
118
|
+
<dl>
|
119
|
+
<dt><code>-f</code>, <code>--fqdn fqdn </code></dt><dd>the fqdn of the host to see the file for</dd>
|
120
|
+
<dt><code>-p</code>, <code>--platform platform </code></dt><dd>the platform to see the file for</dd>
|
121
|
+
<dt><code>-v</code>, <code>--platform-version version</code></dt><dd>the platform version to see the file for</dd>
|
122
|
+
</dl>
|
123
|
+
|
124
|
+
|
125
|
+
<p>show a particular part of a <em>cookbook</em> for the specified <em>version</em>. <em>part</em> can be one of:</p>
|
126
|
+
|
127
|
+
<ul>
|
128
|
+
<li><em>attributes</em></li>
|
129
|
+
<li><em>definitions</em></li>
|
130
|
+
<li><em>files</em></li>
|
131
|
+
<li><em>libraries</em></li>
|
132
|
+
<li><em>providers</em></li>
|
133
|
+
<li><em>recipes</em></li>
|
134
|
+
<li><em>resources</em></li>
|
135
|
+
<li><em>templates</em></li>
|
136
|
+
</ul>
|
137
|
+
|
138
|
+
|
139
|
+
<h2 id="UPLOAD">UPLOAD</h2>
|
140
|
+
|
141
|
+
<p><strong>knife cookbook upload [cookbooks...]</strong> <em>(options)</em></p>
|
142
|
+
|
143
|
+
<dl>
|
144
|
+
<dt><code>-a</code>, <code>--all</code></dt><dd>upload all cookbooks, rather than just a single cookbook</dd>
|
145
|
+
<dt><code>-o</code>, <code>--cookbook-path path:path</code></dt><dd>a colon-separated path to look for cookbooks in</dd>
|
146
|
+
<dt><code>-E</code>, <code>--environment ENVIRONMENT</code></dt><dd>An <em>ENVIRONMENT</em> to apply the uploaded cookbooks to. Specifying this
|
147
|
+
option will cause knife to edit the <em>ENVIRONMENT</em> to place a strict
|
148
|
+
version constraint on the cookbook version(s) uploaded.</dd>
|
149
|
+
<dt><code>--freeze</code></dt><dd>Sets the frozen flag on the uploaded cookbook(s) Any future attempt
|
150
|
+
to modify the cookbook without changing the version number will
|
151
|
+
return an error unless --force is specified.</dd>
|
152
|
+
<dt class="flush"><code>--force</code></dt><dd>Overrides the frozen flag on a cookbook, allowing you to overwrite a
|
153
|
+
cookbook version that has previously been uploaded with the --freeze
|
154
|
+
option.</dd>
|
155
|
+
</dl>
|
156
|
+
|
157
|
+
|
158
|
+
<p>Uploads one or more cookbooks from your local cookbook repository(ies)
|
159
|
+
to the Chef Server. Only files that don't yet exist on the server will
|
160
|
+
be uploaded.</p>
|
161
|
+
|
162
|
+
<h2 id="DOWNLOAD">DOWNLOAD</h2>
|
163
|
+
|
164
|
+
<p><strong>knife cookbook download cookbook [version]</strong> <em>(options)</em></p>
|
165
|
+
|
166
|
+
<dl>
|
167
|
+
<dt><code>-d</code>, <code>--dir download_directory</code></dt><dd>the directory to download the cookbook into</dd>
|
168
|
+
<dt><code>-f</code>, <code>--force</code></dt><dd>overwrite an existing directory with the download</dd>
|
169
|
+
<dt><code>-n</code>, <code>--latest</code></dt><dd>download the latest version of the cookbook</dd>
|
170
|
+
</dl>
|
171
|
+
|
172
|
+
|
173
|
+
<p>download a cookbook from the chef server. if no version is specified and
|
174
|
+
only one version exists on the server, that version will be downloaded.
|
175
|
+
if no version is specified and multiple versions are available on the
|
176
|
+
server, you will be prompted for a version to download.</p>
|
177
|
+
|
178
|
+
<h2 id="DELETE">DELETE</h2>
|
179
|
+
|
180
|
+
<p><strong>knife cookbook delete cookbook [version]</strong> <em>(options)</em></p>
|
181
|
+
|
182
|
+
<dl>
|
183
|
+
<dt><code>-a</code>, <code>--all</code></dt><dd>delete all versions</dd>
|
184
|
+
<dt><code>-p</code>, <code>--purge</code></dt><dd>purge files from backing store. this will disable any cookbook that contains any of the same files as the cookbook being purged.</dd>
|
185
|
+
</dl>
|
186
|
+
|
187
|
+
|
188
|
+
<p>delete the specified <em>version</em> of the named <em>cookbook</em>. if no version is
|
189
|
+
specified, and only one version exists on the server, that version will
|
190
|
+
be deleted. if multiple versions are available on the server, you will
|
191
|
+
be prompted for a version to delete.</p>
|
192
|
+
|
193
|
+
<h2 id="BULK-DELETE">BULK DELETE</h2>
|
194
|
+
|
195
|
+
<p><strong>knife cookbook bulk delete regex</strong> <em>(options)</em></p>
|
196
|
+
|
197
|
+
<dl>
|
198
|
+
<dt><code>-p</code>, <code>--purge</code></dt><dd>purge files from backing store. this will disable any cookbook that
|
199
|
+
contains any of the same files as the cookbook being purged.</dd>
|
200
|
+
</dl>
|
201
|
+
|
202
|
+
|
203
|
+
<p>delete cookbooks on the chef server based on a regular expression. the
|
204
|
+
regular expression (<em>regex</em>) should be in quotes, not in //'s.</p>
|
205
|
+
|
206
|
+
<h2 id="COOKBOOK-CREATE">COOKBOOK CREATE</h2>
|
207
|
+
|
208
|
+
<p><strong>knife cookbook create cookbook</strong> <em>(options)</em></p>
|
209
|
+
|
210
|
+
<dl>
|
211
|
+
<dt><code>-o</code>, <code>--cookbook-path path</code></dt><dd>the directory where the cookbook will be created</dd>
|
212
|
+
<dt><code>-r</code>, <code>--readme-format format</code></dt><dd>format of the readme file</dd>
|
213
|
+
<dt><code>-c</code>, <code>--copyright copyright</code></dt><dd>name of copyright holder</dd>
|
214
|
+
<dt><code>-i</code>, <code>--license license</code></dt><dd>license for cookbook, apachev2 or none</dd>
|
215
|
+
<dt><code>-e</code>, <code>--email email</code></dt><dd>email address of cookbook maintainer</dd>
|
216
|
+
</dl>
|
217
|
+
|
218
|
+
|
219
|
+
<p>this is a helper command that creates a new cookbook directory in the
|
220
|
+
<code>cookbook_path</code>. the following directories and files are created for the
|
221
|
+
named cookbook.</p>
|
222
|
+
|
223
|
+
<ul>
|
224
|
+
<li>cookbook/attributes</li>
|
225
|
+
<li>cookbook/definitions</li>
|
226
|
+
<li>cookbook/files/default</li>
|
227
|
+
<li>cookbook/libraries</li>
|
228
|
+
<li>cookbook/metadata.rb</li>
|
229
|
+
<li>cookbook/providers</li>
|
230
|
+
<li>cookbook/readme.rdoc</li>
|
231
|
+
<li>cookbook/recipes/default.rb</li>
|
232
|
+
<li>cookbook/resources</li>
|
233
|
+
<li>cookbook/templates/default</li>
|
234
|
+
</ul>
|
235
|
+
|
236
|
+
|
237
|
+
<p>supported readme formats are 'rdoc' (default), 'md', 'mkd', 'txt'. the
|
238
|
+
readme file will be written with the specified extension and a set of
|
239
|
+
helpful starting headers.</p>
|
240
|
+
|
241
|
+
<p>specify <code>-c</code> or <code>--copyright</code> with the name of the copyright holder as
|
242
|
+
your name or your company/organization name in a quoted string. if this
|
243
|
+
value is not specified an all-caps string <code>your_company_name</code> is used
|
244
|
+
which can be easily changed with find/replace.</p>
|
245
|
+
|
246
|
+
<p>specify <code>-i</code> or <code>--license</code> with the license that the cookbook is
|
247
|
+
distributed under for sharing with other people or posting to the
|
248
|
+
opscode cookbooks site. be aware of the licenses of files you put inside
|
249
|
+
the cookbook and follow any restrictions they describe. when using
|
250
|
+
<code>none</code> (default) or <code>apachev2</code>, comment header text and metadata file
|
251
|
+
are pre-filled. the <code>none</code> license will be treated as
|
252
|
+
non-redistributable.</p>
|
253
|
+
|
254
|
+
<p>specify <code>-e</code> or <code>--email</code> with the email address of the cookbook's
|
255
|
+
maintainer. if this value is not specified, an all-caps string
|
256
|
+
<code>your_email</code> is used which can easily be changed with find/replace.</p>
|
257
|
+
|
258
|
+
<p>the cookbook copyright, license and email settings can be filled in the
|
259
|
+
<code>knife.rb</code>, for example with default values:</p>
|
260
|
+
|
261
|
+
<pre><code>cookbook_copyright "your_company_name"
|
262
|
+
cookbook_license "none"
|
263
|
+
cookbook_email "your_email"
|
264
|
+
</code></pre>
|
265
|
+
|
266
|
+
<h2 id="METADATA">METADATA</h2>
|
267
|
+
|
268
|
+
<p><strong>knife cookbook metadata cookbook</strong> <em>(options)</em></p>
|
269
|
+
|
270
|
+
<dl>
|
271
|
+
<dt><code>-a</code>, <code>--all</code></dt><dd>generate metadata for all cookbooks, rather than just a single cookbook</dd>
|
272
|
+
<dt><code>-o</code>, <code>--cookbook-path path:path</code></dt><dd>a colon-separated path to look for cookbooks in</dd>
|
273
|
+
</dl>
|
274
|
+
|
275
|
+
|
276
|
+
<p>generate cookbook metadata for the named <em>cookbook</em>. the <em>path</em> used here specifies where the cookbooks directory is located and corresponds to the <code>cookbook_path</code> configuration option.</p>
|
277
|
+
|
278
|
+
<h2 id="METADATA-FROM-FILE">METADATA FROM FILE</h2>
|
279
|
+
|
280
|
+
<p><strong>knife cookbook metadata from file</strong> <em>(options)</em></p>
|
281
|
+
|
282
|
+
<p>load the cookbook metadata from a specified file.</p>
|
283
|
+
|
284
|
+
<h2 id="TEST">TEST</h2>
|
285
|
+
|
286
|
+
<p><strong>knife cookbook test [cookbooks...]</strong> <em>(options)</em></p>
|
287
|
+
|
288
|
+
<dl>
|
289
|
+
<dt><code>-a</code>, <code>--all</code></dt><dd>test all cookbooks, rather than just a single cookbook</dd>
|
290
|
+
<dt><code>-o</code>, <code>--cookbook-path path:path</code></dt><dd>a colon-separated path to look for cookbooks in</dd>
|
291
|
+
</dl>
|
292
|
+
|
293
|
+
|
294
|
+
<p>test the specified cookbooks for syntax errors. this uses the built-in
|
295
|
+
ruby syntax checking option for files in the cookbook ending in <code>.rb</code>,
|
296
|
+
and the erb syntax check for files ending in <code>.erb</code> (templates).</p>
|
297
|
+
|
298
|
+
<h2 id="RECIPE-LIST">RECIPE LIST</h2>
|
299
|
+
|
300
|
+
<p><strong>knife recipe list [PATTERN]</strong></p>
|
301
|
+
|
302
|
+
<p>List available recipes from the server. Specify <em>PATTERN</em> as a regular
|
303
|
+
expression to limit the results.</p>
|
304
|
+
|
305
|
+
<h2 id="DESCRIPTION">DESCRIPTION</h2>
|
306
|
+
|
307
|
+
<p>Cookbooks are the fundamental unit of distribution in Chef. They
|
308
|
+
encapsulate all recipes of resources and assets used to configure a
|
309
|
+
particular aspect of the infrastructure. The following sub-commands can
|
310
|
+
be used to manipulate the cookbooks stored on the Chef Server.</p>
|
311
|
+
|
312
|
+
<p>On disk, cookbooks are directories with a defined structure. The
|
313
|
+
following directories may appear within a cookbook:</p>
|
314
|
+
|
315
|
+
<dl>
|
316
|
+
<dt>COOKBOOK/attributes/</dt><dd>Ruby files that define default parameters to be used in recipes</dd>
|
317
|
+
<dt>COOKBOOK/definitions/</dt><dd>Ruby files that contain <em>resource definitions</em></dd>
|
318
|
+
<dt>COOKBOOK/files/SPECIFICITY</dt><dd>Files of arbitrary type. These files may be downloaded by
|
319
|
+
<span class="man-ref">chef-client<span class="s">(8)</span></span> when configuring a host.</dd>
|
320
|
+
<dt>COOKBOOK/libraries/</dt><dd>Ruby files that contain library code needed for recipes</dd>
|
321
|
+
<dt>COOKBOOK/providers/</dt><dd>Ruby files that contain Lightweight Provider definitions</dd>
|
322
|
+
<dt>COOKBOOK/recipes/</dt><dd>Ruby files that use Chef's recipe DSL to describe the desired
|
323
|
+
configuration of a system</dd>
|
324
|
+
<dt>COOKBOOK/resources/</dt><dd>Ruby files that contain Lightweight Resource definitions</dd>
|
325
|
+
<dt>COOKBOOK/templates/SPECIFICITY</dt><dd>ERuby (ERb) template files. These are referenced by <em>recipes</em> and
|
326
|
+
evaluated to dynamically generate configuration files.</dd>
|
327
|
+
</dl>
|
328
|
+
|
329
|
+
|
330
|
+
<p><strong>SPECIFICITY</strong> is a feature of <em>files</em> and <em>templates</em> that allow you
|
331
|
+
to specify alternate files to be used on a specific OS platform or host.
|
332
|
+
The default specificity setting is <em>default</em>, that is files in
|
333
|
+
<code>COOKBOOK/files/default</code> will be used when a more specific copy is not
|
334
|
+
available. Further documentation for this feature is available on the
|
335
|
+
Chef wiki: <a href="http://wiki.opscode.com/display/chef/File+Distribution#FileDistribution-FileSpecificity" data-bare-link="true">http://wiki.opscode.com/display/chef/File+Distribution#FileDistribution-FileSpecificity</a></p>
|
336
|
+
|
337
|
+
<p>Cookbooks also contain a metadata file that defines various properties
|
338
|
+
of the cookbook. The most important of these are the <em>version</em> and the
|
339
|
+
<em>dependencies</em>. The <em>version</em> is used in combination with environments
|
340
|
+
to select which copy of a given cookbook is distributed to a node. The
|
341
|
+
<em>dependencies</em> are used by the server to determine which additional
|
342
|
+
cookbooks must be distributed to a given host when it requires a
|
343
|
+
cookbook.</p>
|
344
|
+
|
345
|
+
<h2 id="SEE-ALSO">SEE ALSO</h2>
|
346
|
+
|
347
|
+
<p> <strong><span class="man-ref">knife-environment<span class="s">(1)</span></span></strong> <strong><span class="man-ref">knife-cookbook-site<span class="s">(1)</span></span></strong>
|
348
|
+
<a href="http://wiki.opscode.com/display/chef/Cookbooks" data-bare-link="true">http://wiki.opscode.com/display/chef/Cookbooks</a>
|
349
|
+
<a href="http://wiki.opscode.com/display/chef/Metadata" data-bare-link="true">http://wiki.opscode.com/display/chef/Metadata</a></p>
|
350
|
+
|
351
|
+
<h2 id="AUTHOR">AUTHOR</h2>
|
352
|
+
|
353
|
+
<p> Chef was written by Adam Jacob <a href="mailto:adam@opscode.com" data-bare-link="true">adam@opscode.com</a> with many contributions from the community.</p>
|
354
|
+
|
355
|
+
<h2 id="DOCUMENTATION">DOCUMENTATION</h2>
|
356
|
+
|
357
|
+
<p> This manual page was written by Joshua Timberman <a href="mailto:joshua@opscode.com" data-bare-link="true">joshua@opscode.com</a>.
|
358
|
+
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.</p>
|
359
|
+
|
360
|
+
<h2 id="CHEF">CHEF</h2>
|
361
|
+
|
362
|
+
<p> Knife is distributed with Chef. <a href="http://wiki.opscode.com/display/chef/Home" data-bare-link="true">http://wiki.opscode.com/display/chef/Home</a></p>
|
363
|
+
|
364
|
+
|
365
|
+
<ol class='man-decor man-foot man foot'>
|
366
|
+
<li class='tl'>Chef 0.10.0.rc.0</li>
|
367
|
+
<li class='tc'>April 2011</li>
|
368
|
+
<li class='tr'>knife-cookbook(1)</li>
|
369
|
+
</ol>
|
370
|
+
|
371
|
+
</div>
|
372
|
+
</body>
|
373
|
+
</html>
|