tylerrick-chef 0.10.8
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 +146 -0
- data/distro/common/html/chef-expander.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 +165 -0
- data/distro/common/html/knife-bootstrap.1.html +243 -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 +241 -0
- data/distro/common/html/knife-cookbook.1.html +384 -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 +250 -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 +288 -0
- data/distro/common/html/knife-ssh.1.html +157 -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 +321 -0
- data/distro/common/html/shef.1.html +283 -0
- data/distro/common/man/man1/knife-bootstrap.1 +197 -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 +145 -0
- data/distro/common/man/man1/knife-cookbook.1 +345 -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 +134 -0
- data/distro/common/man/man1/knife-role.1 +88 -0
- data/distro/common/man/man1/knife-search.1 +280 -0
- data/distro/common/man/man1/knife-ssh.1 +83 -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 +292 -0
- data/distro/common/man/man1/shef.1 +256 -0
- data/distro/common/man/man8/chef-client.8 +104 -0
- data/distro/common/man/man8/chef-expander.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 +122 -0
- data/distro/common/markdown/README +3 -0
- data/distro/common/markdown/man1/knife-bootstrap.mkd +142 -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 +123 -0
- data/distro/common/markdown/man1/knife-cookbook.mkd +263 -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 +130 -0
- data/distro/common/markdown/man1/knife-role.mkd +85 -0
- data/distro/common/markdown/man1/knife-search.mkd +180 -0
- data/distro/common/markdown/man1/knife-ssh.mkd +72 -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 +220 -0
- data/distro/common/markdown/man1/shef.mkd +189 -0
- data/distro/common/markdown/man8/chef-client.mkd +75 -0
- data/distro/common/markdown/man8/chef-expander.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 +89 -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 +185 -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 +110 -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 +41 -0
- data/lib/chef/api_client.rb +271 -0
- data/lib/chef/application.rb +152 -0
- data/lib/chef/application/agent.rb +18 -0
- data/lib/chef/application/client.rb +285 -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 +167 -0
- data/lib/chef/checksum/storage.rb +18 -0
- data/lib/chef/checksum/storage/filesystem.rb +56 -0
- data/lib/chef/checksum_cache.rb +189 -0
- data/lib/chef/client.rb +366 -0
- data/lib/chef/config.rb +248 -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 +88 -0
- data/lib/chef/cookbook/syntax_check.rb +136 -0
- data/lib/chef/cookbook_loader.rb +121 -0
- data/lib/chef/cookbook_site_streaming_uploader.rb +244 -0
- data/lib/chef/cookbook_uploader.rb +154 -0
- data/lib/chef/cookbook_version.rb +1096 -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 +235 -0
- data/lib/chef/data_bag_item.rb +273 -0
- data/lib/chef/encrypted_data_bag_item.rb +139 -0
- data/lib/chef/environment.rb +455 -0
- data/lib/chef/exceptions.rb +154 -0
- data/lib/chef/file_access_control.rb +144 -0
- data/lib/chef/file_cache.rb +218 -0
- data/lib/chef/handler.rb +227 -0
- data/lib/chef/handler/error_report.rb +33 -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 +520 -0
- data/lib/chef/knife/bootstrap.rb +207 -0
- data/lib/chef/knife/bootstrap/archlinux-gems.erb +60 -0
- data/lib/chef/knife/bootstrap/centos5-gems.erb +56 -0
- data/lib/chef/knife/bootstrap/fedora13-gems.erb +43 -0
- data/lib/chef/knife/bootstrap/ubuntu10.04-apt.erb +49 -0
- data/lib/chef/knife/bootstrap/ubuntu10.04-gems.erb +50 -0
- data/lib/chef/knife/client_bulk_delete.rb +65 -0
- data/lib/chef/knife/client_create.rb +79 -0
- data/lib/chef/knife/client_delete.rb +46 -0
- data/lib/chef/knife/client_edit.rb +45 -0
- data/lib/chef/knife/client_list.rb +42 -0
- data/lib/chef/knife/client_reregister.rb +58 -0
- data/lib/chef/knife/client_show.rb +52 -0
- data/lib/chef/knife/configure.rb +149 -0
- data/lib/chef/knife/configure_client.rb +50 -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 +151 -0
- data/lib/chef/knife/cookbook_download.rb +137 -0
- data/lib/chef/knife/cookbook_list.rb +47 -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 +62 -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 +240 -0
- data/lib/chef/knife/core/bootstrap_context.rb +100 -0
- data/lib/chef/knife/core/cookbook_scm_repo.rb +148 -0
- data/lib/chef/knife/core/generic_presenter.rb +191 -0
- data/lib/chef/knife/core/node_editor.rb +127 -0
- data/lib/chef/knife/core/node_presenter.rb +136 -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 +216 -0
- data/lib/chef/knife/data_bag_create.rb +93 -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 +87 -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 +103 -0
- data/lib/chef/knife/help_topics.rb +4 -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 +73 -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 +56 -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 +141 -0
- data/lib/chef/knife/ssh.rb +367 -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 +163 -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 +57 -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/get_source_from_package.rb +42 -0
- data/lib/chef/mixin/language.rb +163 -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 +15 -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 +49 -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 +434 -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 +418 -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 +226 -0
- data/lib/chef/provider/git.rb +243 -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 +91 -0
- data/lib/chef/provider/group/pw.rb +84 -0
- data/lib/chef/provider/group/suse.rb +53 -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 +195 -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 +240 -0
- data/lib/chef/provider/mount/windows.rb +81 -0
- data/lib/chef/provider/ohai.rb +42 -0
- data/lib/chef/provider/package.rb +200 -0
- data/lib/chef/provider/package/apt.rb +145 -0
- data/lib/chef/provider/package/dpkg.rb +115 -0
- data/lib/chef/provider/package/easy_install.rb +136 -0
- data/lib/chef/provider/package/freebsd.rb +125 -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 +104 -0
- data/lib/chef/provider/package/rubygems.rb +465 -0
- data/lib/chef/provider/package/solaris.rb +130 -0
- data/lib/chef/provider/package/yum-dump.py +286 -0
- data/lib/chef/provider/package/yum.rb +1173 -0
- data/lib/chef/provider/package/zypper.rb +144 -0
- data/lib/chef/provider/remote_directory.rb +137 -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 +116 -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/invokercd.rb +35 -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/systemd.rb +102 -0
- data/lib/chef/provider/service/upstart.rb +198 -0
- data/lib/chef/provider/service/windows.rb +155 -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 +95 -0
- data/lib/chef/recipe.rb +129 -0
- data/lib/chef/resource.rb +609 -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/conditional.rb +90 -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 +389 -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 +46 -0
- data/lib/chef/resource/group.rb +78 -0
- data/lib/chef/resource/http_request.rb +61 -0
- data/lib/chef/resource/ifconfig.rb +144 -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 +134 -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 +151 -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 +63 -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 +400 -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 +343 -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 +105 -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 +285 -0
- data/lib/chef/shell_out.rb +249 -0
- data/lib/chef/shell_out/unix.rb +223 -0
- data/lib/chef/shell_out/windows.rb +588 -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 +132 -0
- data/lib/chef/streaming_cookbook_uploader.rb +201 -0
- data/lib/chef/tasks/chef_repo.rake +334 -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 +764 -0
@@ -0,0 +1,85 @@
|
|
1
|
+
knife-role(1) -- Group common configuration settings
|
2
|
+
========================================
|
3
|
+
|
4
|
+
## SYNOPSIS
|
5
|
+
|
6
|
+
__knife__ __role__ _sub-command_ _(options)_
|
7
|
+
|
8
|
+
## ROLE SUB-COMMANDS
|
9
|
+
The following `role` subcommands are available:
|
10
|
+
|
11
|
+
## LIST
|
12
|
+
__knife role list__ _(options)_
|
13
|
+
|
14
|
+
* `-w`, `--with-uri`:
|
15
|
+
Show corresponding URIs
|
16
|
+
|
17
|
+
List roles.
|
18
|
+
|
19
|
+
## SHOW
|
20
|
+
__knife role show ROLE__ _(options)_
|
21
|
+
|
22
|
+
* `-a`, `--attribute ATTR`:
|
23
|
+
Show only one attribute
|
24
|
+
|
25
|
+
Show a specific role.
|
26
|
+
|
27
|
+
## CREATE
|
28
|
+
__knife role create ROLE__ _(options)_
|
29
|
+
|
30
|
+
* `-d`, `--description`:
|
31
|
+
The role description
|
32
|
+
|
33
|
+
Create a new role.
|
34
|
+
|
35
|
+
## EDIT
|
36
|
+
__knife role edit ROLE__ _(options)_
|
37
|
+
|
38
|
+
Edit a role.
|
39
|
+
|
40
|
+
## FROM FILE
|
41
|
+
__knife role from file FILE__ _(options)_
|
42
|
+
|
43
|
+
Create or update a role from a role Ruby DSL (`.rb`) or JSON file.
|
44
|
+
|
45
|
+
## DELETE
|
46
|
+
__knife role delete ROLE__ _(options)_
|
47
|
+
|
48
|
+
Delete a role.
|
49
|
+
|
50
|
+
## BULK DELETE
|
51
|
+
__knife role bulk delete REGEX__ _(options)_
|
52
|
+
|
53
|
+
Delete roles on the Chef Server based on a regular expression. The regular expression (_REGEX_) should be in quotes, not in //'s.
|
54
|
+
|
55
|
+
## DESCRIPTION
|
56
|
+
Roles provide a mechanism to group repeated configuration settings.
|
57
|
+
Roles are data structures that contain __default\_attributes__, and
|
58
|
+
__override_attributes__, which are nested hashes of configuration
|
59
|
+
settings, and a __run_list__, which is an ordered list of recipes and
|
60
|
+
roles that should be applied to a host by chef-client.
|
61
|
+
|
62
|
+
__default_attributes__ will be overridden if they conflict with a value
|
63
|
+
on a node that includes the role. Conversely, __override_attributes__
|
64
|
+
will override any values set on nodes that apply them.
|
65
|
+
|
66
|
+
When __chef-client__(8) configures a host, it will "expand" the
|
67
|
+
__run_list__ included in that host's node data. The expansion process
|
68
|
+
will recursively replace any roles in the run\_list with that role's
|
69
|
+
run\_list.
|
70
|
+
|
71
|
+
## SEE ALSO
|
72
|
+
__knife-node(1)__ __knife-environment(1)__
|
73
|
+
<http://wiki.opscode.com/display/chef/Roles>
|
74
|
+
<http://wiki.opscode.com/display/chef/Attributes>
|
75
|
+
|
76
|
+
## AUTHOR
|
77
|
+
Chef was written by Adam Jacob <adam@opscode.com> with many contributions from the community.
|
78
|
+
|
79
|
+
## DOCUMENTATION
|
80
|
+
This manual page was written by Joshua Timberman <joshua@opscode.com>.
|
81
|
+
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
|
82
|
+
|
83
|
+
## CHEF
|
84
|
+
Knife is distributed with Chef. <http://wiki.opscode.com/display/chef/Home>
|
85
|
+
|
@@ -0,0 +1,180 @@
|
|
1
|
+
knife-search(1) -- Find objects on a Chef Server by query
|
2
|
+
========================================
|
3
|
+
|
4
|
+
## SYNOPSIS
|
5
|
+
|
6
|
+
__knife__ __search INDEX QUERY__ _(options)_
|
7
|
+
|
8
|
+
* `-a`, `--attribute ATTR`:
|
9
|
+
Show only one attribute
|
10
|
+
* `-i`, `--id-only`:
|
11
|
+
Show only the ID of matching objects
|
12
|
+
* `-q`, `--query QUERY`:
|
13
|
+
The search query; useful to protect queries starting with -
|
14
|
+
* `-R`, `--rows INT`:
|
15
|
+
The number of rows to return
|
16
|
+
* `-r`, `--run-list`:
|
17
|
+
Show only the run list
|
18
|
+
* `-o`, `--sort SORT`:
|
19
|
+
The order to sort the results in
|
20
|
+
* `-b`, `--start ROW`:
|
21
|
+
The row to start returning results at
|
22
|
+
* `-m`, `--medium`:
|
23
|
+
Display medium sized output when searching nodes using the default
|
24
|
+
summary format
|
25
|
+
* `-l`, `--long`:
|
26
|
+
Display long output when searching nodes using the default summary
|
27
|
+
format
|
28
|
+
|
29
|
+
## DESCRIPTION
|
30
|
+
|
31
|
+
Search is a feature of the Chef Server that allows you to use a
|
32
|
+
full-text search engine to query information about your infrastructure
|
33
|
+
and applications. You can utilize this service via search calls in a
|
34
|
+
recipe or the knife search command. The search syntax is based on
|
35
|
+
Lucene.
|
36
|
+
|
37
|
+
|
38
|
+
## INDEXES
|
39
|
+
|
40
|
+
Search indexes are a feature of the Chef Server and the search
|
41
|
+
sub-command allows querying any of the available indexes using SOLR
|
42
|
+
query syntax. The following data types are indexed for search:
|
43
|
+
|
44
|
+
* _node_
|
45
|
+
* _role_
|
46
|
+
* _environment_
|
47
|
+
* _clients_
|
48
|
+
* _data bag_
|
49
|
+
|
50
|
+
Data bags are indexed by the data bag's name. For example, to search a
|
51
|
+
data bag named "admins":
|
52
|
+
|
53
|
+
knife search admins "field:search_pattern"
|
54
|
+
|
55
|
+
## QUERY SYNTAX
|
56
|
+
|
57
|
+
Queries have the form `field:search_pattern` where `field` is a key in
|
58
|
+
the JSON description of the relevant objects (nodes, roles,
|
59
|
+
environments, or data bags). Both `field` and `search_pattern` are
|
60
|
+
case-sensitive. `search_pattern` can be an exact, wildcard,
|
61
|
+
range, or fuzzy match (see below). The `field` supports exact
|
62
|
+
matching and limited wildcard matching.
|
63
|
+
|
64
|
+
Searches will return the relevant objects (nodes, roles, environments,
|
65
|
+
or data bags) where the `search_pattern` matches the object's value of
|
66
|
+
`field`.
|
67
|
+
|
68
|
+
### FIELD NAMES
|
69
|
+
|
70
|
+
Field names are the keys within the JSON description of the object
|
71
|
+
being searched. Nested Keys can be searched by placing an underscore
|
72
|
+
("_") between key names.
|
73
|
+
|
74
|
+
### WILDCARD MATCHING FOR FIELD NAMES
|
75
|
+
|
76
|
+
The field name also has limited support for wildcard matching. Both
|
77
|
+
the "*" and "?" wildcards (see below) can be used within a field name;
|
78
|
+
however, they cannot be the first character of the field name.
|
79
|
+
|
80
|
+
### EXACT MATCHES
|
81
|
+
Without any search modifiers, a search returns those fields for which
|
82
|
+
the `search_pattern` exactly matches the value of `field` in the JSON
|
83
|
+
description of the object.
|
84
|
+
|
85
|
+
### WILDCARD MATCHES
|
86
|
+
|
87
|
+
Search support both single- and multi-character wildcard searches
|
88
|
+
within a search pattern.
|
89
|
+
|
90
|
+
'?' matches exactly one character.
|
91
|
+
|
92
|
+
'*' matches zero or more characters.
|
93
|
+
|
94
|
+
### RANGE MATCHES
|
95
|
+
Range searches allows one to match values between two given values. To
|
96
|
+
match values between X and Y, inclusively, use square brackets:
|
97
|
+
|
98
|
+
knife search INDEX 'field:[X TO Y]
|
99
|
+
|
100
|
+
To match values between X and Y, exclusively, use curly brackets:
|
101
|
+
|
102
|
+
knife search INDEX 'field:{X TO Y}'
|
103
|
+
|
104
|
+
Values are sorted in lexicographic order.
|
105
|
+
|
106
|
+
### FUZZY MATCHES
|
107
|
+
|
108
|
+
Fuzzy searches allows one to match values based on the Levenshtein
|
109
|
+
Distance algorithm. To perform a fuzzy match, append a tilda (~) to
|
110
|
+
the search term:
|
111
|
+
|
112
|
+
knife search INDEX 'field:term~'
|
113
|
+
|
114
|
+
This search would return nodes whose `field` was 'perm' or 'germ'.
|
115
|
+
|
116
|
+
### BOOLEAN OPERATORS
|
117
|
+
|
118
|
+
The boolean operators NOT, AND, and OR are supported. To find values
|
119
|
+
of `field` that are not X:
|
120
|
+
|
121
|
+
knife search INDEX 'field:(NOT X)'
|
122
|
+
|
123
|
+
To find records where `field1` is X and `field2` is Y:
|
124
|
+
|
125
|
+
knife search INDEX 'field1:X AND field2:Y'
|
126
|
+
|
127
|
+
To find records where `field` is X or Y:
|
128
|
+
|
129
|
+
knife search INDEX 'field:X OR field:Y'
|
130
|
+
|
131
|
+
### QUOTING AND SPECIAL CHARACTERS
|
132
|
+
|
133
|
+
In order to avoid having special characters and escape sequences
|
134
|
+
within your search term interpreted by either Ruby or the shell,
|
135
|
+
enclose them in single quotes.
|
136
|
+
|
137
|
+
Search terms that include spaces should be enclosed in double-quotes:
|
138
|
+
|
139
|
+
knife search INDEX 'field:"term with spaces"'
|
140
|
+
|
141
|
+
The following characters must be escaped:
|
142
|
+
|
143
|
+
+ - && || ! ( ) { } [ ] ^ " ~ * ? : \
|
144
|
+
|
145
|
+
## EXAMPLES
|
146
|
+
|
147
|
+
Find the nodes with the fully-qualified domain name (FQDN)
|
148
|
+
www.example.com:
|
149
|
+
|
150
|
+
knife search node 'fqdn:www.example.com'
|
151
|
+
|
152
|
+
Find the nodes running a version of Ubuntu:
|
153
|
+
|
154
|
+
knife search node 'platform:ubuntu*'
|
155
|
+
|
156
|
+
Find all nodes running CentOS in the production environment:
|
157
|
+
|
158
|
+
knife search node 'chef_environment:production AND platform:centos'
|
159
|
+
|
160
|
+
## KNOWN BUGS
|
161
|
+
|
162
|
+
* Searches against the client index return no results in most cases. (CHEF-2477)
|
163
|
+
* Searches using the fuzzy match operator (~) produce an error. (CHEF-2478)
|
164
|
+
|
165
|
+
## SEE ALSO
|
166
|
+
__knife-ssh__(1)
|
167
|
+
<http://wiki.opscode.com/display/chef/Attributes>
|
168
|
+
[Lucene Query Parser Syntax](http://lucene.apache.org/java/2_3_2/queryparsersyntax.html)
|
169
|
+
|
170
|
+
## AUTHOR
|
171
|
+
Chef was written by Adam Jacob <adam@opscode.com> with many contributions from the community.
|
172
|
+
|
173
|
+
## DOCUMENTATION
|
174
|
+
This manual page was written by Joshua Timberman <joshua@opscode.com>.
|
175
|
+
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
|
176
|
+
|
177
|
+
## CHEF
|
178
|
+
Knife is distributed with Chef. <http://wiki.opscode.com/display/chef/Home>
|
179
|
+
|
180
|
+
|
@@ -0,0 +1,72 @@
|
|
1
|
+
knife-ssh(1) -- Run a command or interactive session on multiple remote hosts
|
2
|
+
========================================
|
3
|
+
|
4
|
+
## SYNOPSIS
|
5
|
+
|
6
|
+
__knife__ __ssh QUERY COMMAND__ _(options)_
|
7
|
+
|
8
|
+
* `-a`, `--attribute ATTR `:
|
9
|
+
The attribute to use for opening the connection - default is fqdn
|
10
|
+
* `-C`, `--concurrency NUM `:
|
11
|
+
The number of concurrent connections
|
12
|
+
* `-m`, `--manual-list `:
|
13
|
+
QUERY is a space separated list of servers
|
14
|
+
* `-P`, `--ssh-password PASSWORD`:
|
15
|
+
The ssh password
|
16
|
+
* `-x`, `--ssh-user USERNAME `:
|
17
|
+
The ssh username
|
18
|
+
* `-i`, `--identity-file IDENTITY_FILE`:
|
19
|
+
The SSH identity file used for authentication
|
20
|
+
* `-p`, `--ssh-port PORT`:
|
21
|
+
The ssh port
|
22
|
+
* `-i`, `--identity-file IDENTITY_FILE`:
|
23
|
+
The SSH identity file used for authentication
|
24
|
+
* `--no-host-key-verify`:
|
25
|
+
Disable host key verification
|
26
|
+
|
27
|
+
|
28
|
+
## DESCRIPTION
|
29
|
+
|
30
|
+
The _ssh_ sub-command opens an ssh session to each of the nodes in the
|
31
|
+
search results of the _QUERY_. This sub-command requires that the
|
32
|
+
net-ssh-multi and highline Ruby libraries are installed. On Debian
|
33
|
+
systems, these are the libnet-ssh-multi-ruby and libhighline-ruby
|
34
|
+
packages. They can also be installed as RubyGems (net-ssh-multi and
|
35
|
+
highline, respectively).
|
36
|
+
|
37
|
+
## TERMINAL MULTIPLEXING AND TERMINAL TAB SUPPORT
|
38
|
+
`knife ssh` integrates with several terminal multiplexer programs to
|
39
|
+
provide a more convenient means of managing multiple ssh sessions. When
|
40
|
+
the _COMMAND_ option matches one of these, `knife ssh` will create
|
41
|
+
multiple interactive ssh sessions running locally in the terminal
|
42
|
+
multiplexer instead of invoking the command on the remote host.
|
43
|
+
|
44
|
+
The available multiplexers are:
|
45
|
+
|
46
|
+
* `interactive`:
|
47
|
+
A built-in multiplexer. `interactive` supports running commands on a
|
48
|
+
subset of the connected hosts in parallel
|
49
|
+
* __screen__(1):
|
50
|
+
Runs ssh interactively inside `screen`. ~/.screenrc will be sourced
|
51
|
+
if it exists.
|
52
|
+
* __tmux__(1):
|
53
|
+
Runs ssh interactively inside tmux.
|
54
|
+
* `macterm` (Mac OS X only):
|
55
|
+
Opens a Terminal.app window and creates a tab for each ssh session.
|
56
|
+
You must install the rb-appscript gem before you can use this
|
57
|
+
option.
|
58
|
+
|
59
|
+
## SEE ALSO
|
60
|
+
__knife-search__(1)
|
61
|
+
|
62
|
+
## AUTHOR
|
63
|
+
Chef was written by Adam Jacob <adam@opscode.com> with many contributions from the community.
|
64
|
+
|
65
|
+
## DOCUMENTATION
|
66
|
+
This manual page was written by Joshua Timberman <joshua@opscode.com>.
|
67
|
+
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
|
68
|
+
|
69
|
+
## CHEF
|
70
|
+
Knife is distributed with Chef. <http://wiki.opscode.com/display/chef/Home>
|
71
|
+
|
72
|
+
|
@@ -0,0 +1,36 @@
|
|
1
|
+
knife-status(1) -- Display status information for the nodes in your infrastructure
|
2
|
+
========================================
|
3
|
+
|
4
|
+
## SYNOPSIS
|
5
|
+
|
6
|
+
__knife__ __status__ _(options)_
|
7
|
+
|
8
|
+
* `-r`, `--run-list RUN_LIST`:
|
9
|
+
Show the run list
|
10
|
+
|
11
|
+
## DESCRIPTION
|
12
|
+
|
13
|
+
The _status_ sub-command searches the Chef Server for all nodes and
|
14
|
+
displays information about the last time the node checked into the
|
15
|
+
server and executed a `node.save`. The fields displayed are the relative
|
16
|
+
checkin time, the node name, it's operating system platform and version,
|
17
|
+
the fully-qualified domain name and the default IP address. If the `-r`
|
18
|
+
option is given, the node's run list will also be displayed. Note that
|
19
|
+
depending on the configuration of the nodes, the FQDN and IP displayed
|
20
|
+
may not be publicly reachable.
|
21
|
+
|
22
|
+
|
23
|
+
## SEE ALSO
|
24
|
+
__knife-search__(1)
|
25
|
+
|
26
|
+
## AUTHOR
|
27
|
+
Chef was written by Adam Jacob <adam@opscode.com> with many contributions from the community.
|
28
|
+
|
29
|
+
## DOCUMENTATION
|
30
|
+
This manual page was written by Joshua Timberman <joshua@opscode.com>.
|
31
|
+
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
|
32
|
+
|
33
|
+
## CHEF
|
34
|
+
Knife is distributed with Chef. <http://wiki.opscode.com/display/chef/Home>
|
35
|
+
|
36
|
+
|
@@ -0,0 +1,39 @@
|
|
1
|
+
knife-tag(1) -- Apply tags to nodes on a Chef Server
|
2
|
+
========================================
|
3
|
+
|
4
|
+
## SYNOPSIS
|
5
|
+
|
6
|
+
__knife__ __tag__ _subcommand_ _(options)_
|
7
|
+
|
8
|
+
## TAG SUBCOMMANDS
|
9
|
+
The following `tag` subcommands are available:
|
10
|
+
|
11
|
+
## CREATE
|
12
|
+
__knife tag create__ _node_ _tag_ [_..._]
|
13
|
+
|
14
|
+
Adds one or more tags to _node_
|
15
|
+
|
16
|
+
## DELETE
|
17
|
+
__knife tag delete__ _node_ _tag_ [_..._]
|
18
|
+
|
19
|
+
Removes one or more tags from _node_
|
20
|
+
|
21
|
+
## LIST
|
22
|
+
__knife tag list__ _node_
|
23
|
+
|
24
|
+
Lists the tags applied to _node_
|
25
|
+
|
26
|
+
|
27
|
+
## SEE ALSO
|
28
|
+
__knife-node(1)__
|
29
|
+
|
30
|
+
## AUTHOR
|
31
|
+
Chef was written by Adam Jacob <adam@opscode.com> with many contributions from the community.
|
32
|
+
|
33
|
+
## DOCUMENTATION
|
34
|
+
This manual page was written by Daniel DeLeo <dan@opscode.com>.
|
35
|
+
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
|
36
|
+
|
37
|
+
## CHEF
|
38
|
+
Knife is distributed with Chef. <http://wiki.opscode.com/display/chef/Home>
|
39
|
+
|
@@ -0,0 +1,220 @@
|
|
1
|
+
knife(1) -- Chef Server API client utility
|
2
|
+
========================================
|
3
|
+
|
4
|
+
## SYNOPSIS
|
5
|
+
|
6
|
+
__knife__ _sub-command_ [_argument_...] _(options)_
|
7
|
+
|
8
|
+
## DESCRIPTION
|
9
|
+
|
10
|
+
Knife is a command-line utility used to manage data on a Chef server
|
11
|
+
through the HTTP(S) API. Knife is organized into groups of subcommands
|
12
|
+
centered around the various object types in Chef. Each category of
|
13
|
+
subcommand is documented in its own manual page. Available topics are:
|
14
|
+
|
15
|
+
* bootstrap
|
16
|
+
* client
|
17
|
+
* configure
|
18
|
+
* cookbook-site
|
19
|
+
* cookbook
|
20
|
+
* data-bag
|
21
|
+
* environment
|
22
|
+
* exec
|
23
|
+
* index
|
24
|
+
* node
|
25
|
+
* recipe
|
26
|
+
* role
|
27
|
+
* search
|
28
|
+
* ssh
|
29
|
+
* status
|
30
|
+
* tag
|
31
|
+
|
32
|
+
If the knife manuals are in your `MANPATH`, you can access help for the
|
33
|
+
above topics using `man knife-TOPIC`; otherwise, you can view the
|
34
|
+
documentation using `knife help TOPIC`.
|
35
|
+
|
36
|
+
## OPTIONS
|
37
|
+
* `-s`, `--server-url` URL:
|
38
|
+
Chef Server URL, corresponds to `Chef::Config` `chef_server_url`.
|
39
|
+
* `-k`, `--key` KEY:
|
40
|
+
API Client Key, corresponds to `Chef::Config` `client_key`.
|
41
|
+
* `-c`, `--config` CONFIG:
|
42
|
+
The configuration file to use
|
43
|
+
* `-E`, `--environment ENVIRONMENT`:
|
44
|
+
Set the Chef environment
|
45
|
+
* `-e`, `--editor` EDITOR:
|
46
|
+
Set the editor to use for interactive commands
|
47
|
+
* `-F`, `--format` FORMAT:
|
48
|
+
Which format to use for output. See FORMATS for details.
|
49
|
+
* `-V`, `--verbose`:
|
50
|
+
More verbose output. Use twice for max verbosity
|
51
|
+
* `-n`, `--no-editor`:
|
52
|
+
Do not open EDITOR, just accept the data as is
|
53
|
+
* `-u`, `--user` USER:
|
54
|
+
API Client Username, corresponds to `Chef::Config` `node_name`.
|
55
|
+
* `-p`, `--print-after`:
|
56
|
+
Show the data after a destructive operation
|
57
|
+
* `-v`, `--version`:
|
58
|
+
Show chef version
|
59
|
+
* `-y`, `--yes`:
|
60
|
+
Say yes to all prompts for confirmation
|
61
|
+
* `--defaults`:
|
62
|
+
Accept default values for all questions
|
63
|
+
* `--color`:
|
64
|
+
Use colored output
|
65
|
+
* `--no-color`:
|
66
|
+
Don't use colors in the output
|
67
|
+
* `-h`, `--help`:
|
68
|
+
Show the available options for a command.
|
69
|
+
|
70
|
+
## SUB-COMMANDS
|
71
|
+
|
72
|
+
Sub-commands that operate on the basic Chef data types are structured as
|
73
|
+
_NOUN verb NOUN (options)_. For all data types, the following commands
|
74
|
+
are available:
|
75
|
+
|
76
|
+
* create (create)
|
77
|
+
* list and show (read)
|
78
|
+
* edit (update)
|
79
|
+
* delete (destroy)
|
80
|
+
|
81
|
+
Knife also includes commands that take actions other than displaying or
|
82
|
+
modifying data on the Chef Server, such as __knife-ssh(1)__.
|
83
|
+
|
84
|
+
## CONFIGURATION
|
85
|
+
|
86
|
+
The knife configuration file is a Ruby DSL to set configuration
|
87
|
+
parameters for Knife's __GENERAL OPTIONS__. The default location for the
|
88
|
+
config file is `~/.chef/knife.rb`. If managing multiple Chef
|
89
|
+
repositories, per-repository config files can be created. The file must
|
90
|
+
be `.chef/knife.rb` in the current directory of the repository.
|
91
|
+
|
92
|
+
If the config file exists, knife uses these settings for __GENERAL OPTIONS__ defaults.
|
93
|
+
|
94
|
+
* `node_name`:
|
95
|
+
User or client identity (i.e., _name_) to use for authenticating
|
96
|
+
requests to the Chef Server.
|
97
|
+
* `client_key`:
|
98
|
+
Private key file to authenticate to the Chef server. Corresponds to the
|
99
|
+
`-k` or `--key` option.
|
100
|
+
* `chef_server_url`:
|
101
|
+
URL of the Chef server. Corresponds to the `-s` or `--server-url`
|
102
|
+
option. This is requested from the user when running this sub-command.
|
103
|
+
* `cache_type`:
|
104
|
+
The type of cache to use. Default is BasicFile. This can be any type of
|
105
|
+
Cache that moneta supports: BasicFile, Berkeley, Couch, DataMapper,
|
106
|
+
File, LMC, Memcache, Memory, MongoDB, Redis, Rufus, S3, SDBM, Tyrant,
|
107
|
+
Xattr, YAML.
|
108
|
+
* `cache_options`:
|
109
|
+
Specifies various options to use for caching. These options are
|
110
|
+
dependent on the `cache_type`.
|
111
|
+
* `validation_client_name`:
|
112
|
+
Specifies the name of the client used to validate new clients.
|
113
|
+
* `validation_key`:
|
114
|
+
Specifies the private key file to use when bootstrapping new hosts.
|
115
|
+
See knife-client(1) for more information about the validation
|
116
|
+
client.
|
117
|
+
* `cookbook_copyright`, `cookbook_email`, `cookbook_license`, `readme_format`
|
118
|
+
Used by `knife cookbook create` sub-command to specify the copyright
|
119
|
+
holder, maintainer email, license and readme format (respectively) for new cookbooks.
|
120
|
+
The copyright holder is listed as the maintainer in the cookbook's
|
121
|
+
metadata and as the Copyright in the comments of the default recipe. The
|
122
|
+
maintainer email is used in the cookbook metadata. The license
|
123
|
+
determines what preamble to put in the comment of the default recipe,
|
124
|
+
and is listed as the license in the cookbook metadata. Currently
|
125
|
+
supported licenses are "apachev2" and "none". Any other values will
|
126
|
+
result in an empty license in the metadata (needs to be filled in by the
|
127
|
+
author), and no comment preamble in the default recipe. Currently supported
|
128
|
+
readme formats are "md", "mkd", "txt", and "rdoc". Any other value will
|
129
|
+
result in an unformatted README.
|
130
|
+
|
131
|
+
## FILES
|
132
|
+
|
133
|
+
_~/.chef/knife.rb_
|
134
|
+
|
135
|
+
Ruby DSL configuration file for knife. See __CONFIGURATION__.
|
136
|
+
|
137
|
+
## FORMATS
|
138
|
+
|
139
|
+
The amount of content displayed and the output format are
|
140
|
+
modified by the `--format` option. If no alternate format is selected,
|
141
|
+
the default is summary.
|
142
|
+
|
143
|
+
Valid formats are:
|
144
|
+
|
145
|
+
* `summary`:
|
146
|
+
displays the node in a custom, summarized format (default)
|
147
|
+
* `text`:
|
148
|
+
displays the node data in its entirety using the colorized tree display
|
149
|
+
* `json`:
|
150
|
+
displays the node in JSON format
|
151
|
+
* `yaml`:
|
152
|
+
displays the node in YAML format
|
153
|
+
* `pp`:
|
154
|
+
displays the node using Ruby's pretty printer.
|
155
|
+
|
156
|
+
For brevity, only the first character of the format is required, for
|
157
|
+
example, -Fj will produce JSON format output.
|
158
|
+
|
159
|
+
## CHEF WORKFLOW
|
160
|
+
|
161
|
+
When working with Chef and Knife in the local repository, the recommended workflow outline looks like:
|
162
|
+
|
163
|
+
* Create repository. A skeleton sample is provided at _http://github.com/opscode/chef-repo/_.
|
164
|
+
* Configure knife, see __CONFIGURATION__.
|
165
|
+
* Download cookbooks from the Opscode cookbooks site, see __COOKBOOK SITE SUB-COMMANDS__.
|
166
|
+
* Or, create new cookbooks, see `cookbook create` sub-command.
|
167
|
+
* Commit changes to the version control system. See your tool's documentation.
|
168
|
+
* Upload cookbooks to the Chef Server, see __COOKBOOK SUB-COMMANDS__.
|
169
|
+
* Launch instances in the Cloud, OR provision new hosts; see __CLOUD COMPUTING SUB-COMMANDS__ and __BOOTSTRAP SUB-COMMANDS__.
|
170
|
+
* Watch Chef configure systems!
|
171
|
+
|
172
|
+
A note about git: Opscode and many folks in the Chef community use git,
|
173
|
+
but it is not required, except in the case of the `cookbook site vendor`
|
174
|
+
sub-command, as it uses git directly. Version control is strongly
|
175
|
+
recommended though, and git fits with a lot of the workflow paradigms.
|
176
|
+
|
177
|
+
|
178
|
+
## EXAMPLES
|
179
|
+
|
180
|
+
|
181
|
+
## ENVIRONMENT
|
182
|
+
* `EDITOR`:
|
183
|
+
The text editor to use for editing data. The --editor option takes
|
184
|
+
precedence over this value, and the --no-editor option supresses
|
185
|
+
data editing entirely.
|
186
|
+
|
187
|
+
## SEE ALSO
|
188
|
+
__chef-client(8)__ __chef-server(8)__ __shef(1)__
|
189
|
+
|
190
|
+
__knife-bootstrap(1)__ __knife-client(1)__ __knife-configure(1)__
|
191
|
+
__knife-cookbook-site(1)__ __knife-cookbook(1)__ __knife-data-bag(1)__
|
192
|
+
__knife-environment(1)__ __knife-exec(1)__ __knife-index(1)__
|
193
|
+
__knife-node(1)__ __knife-recipe(1)__ __knife-role(1)__
|
194
|
+
__knife-search(1)__ __knife-ssh(1)__ __knife-tag(1)__
|
195
|
+
|
196
|
+
Complete Chef documentation is available online: <http://wiki.opscode.com/display/chef/Home/>
|
197
|
+
|
198
|
+
JSON is JavaScript Object Notation <http://json.org/>
|
199
|
+
|
200
|
+
SOLR is an open source search engine. <http://lucene.apache.org/solr/>
|
201
|
+
|
202
|
+
__git(1)__ is a version control system <http://git-scm.com/>
|
203
|
+
|
204
|
+
This manual page was generated from Markdown with __ronn(1)__ <http://rtomayko.github.com/ronn/ronn.1.html>
|
205
|
+
|
206
|
+
## AUTHOR
|
207
|
+
Chef was written by Adam Jacob <adam@opscode.com> of Opscode
|
208
|
+
(<http://www.opscode.com>), with contributions from the community.
|
209
|
+
|
210
|
+
## DOCUMENTATION
|
211
|
+
This manual page was written by Joshua Timberman <joshua@opscode.com>.
|
212
|
+
|
213
|
+
## LICENSE
|
214
|
+
Both Chef and this documentation are released under the terms of the
|
215
|
+
Apache 2.0 License. You may view the license online: <http://www.apache.org/licenses/LICENSE-2.0.html>
|
216
|
+
On some systems, the complete text of the Apache 2.0 License may be found in `/usr/share/common-licenses/Apache-2.0`.
|
217
|
+
|
218
|
+
## CHEF
|
219
|
+
Knife is distributed with Chef. <http://wiki.opscode.com/display/chef/Home>
|
220
|
+
|