microwave 11.400.3 → 11.400.4
Sign up to get free protection for your applications and to get access to all the features.
- 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 +90 -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 +145 -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-shell.1.html +286 -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 +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 +241 -0
- data/distro/common/html/knife-cookbook.1.html +384 -0
- data/distro/common/html/knife-data-bag.1.html +238 -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-role.1.html +200 -0
- data/distro/common/html/knife-search.1.html +288 -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 +315 -0
- data/distro/common/man/man1/chef-shell.1 +220 -0
- data/distro/common/man/man1/knife-bootstrap.1 +201 -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 +136 -0
- data/distro/common/man/man1/knife-environment.1 +178 -0
- data/distro/common/man/man1/knife-exec.1 +43 -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 +79 -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 +285 -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/chef-shell.mkd +195 -0
- data/distro/common/markdown/man1/knife-bootstrap.mkd +141 -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 +121 -0
- data/distro/common/markdown/man1/knife-environment.mkd +151 -0
- data/distro/common/markdown/man1/knife-exec.mkd +42 -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 +69 -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 +213 -0
- data/distro/common/markdown/man8/chef-client.mkd +74 -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 +210 -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 +121 -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/distro/windows/service_manager.rb +164 -0
- data/lib/chef/api_client.rb +205 -0
- data/lib/chef/api_client/registration.rb +126 -0
- data/lib/chef/application.rb +225 -0
- data/lib/chef/application/agent.rb +18 -0
- data/lib/chef/application/apply.rb +160 -0
- data/lib/chef/application/client.rb +340 -0
- data/lib/chef/application/knife.rb +183 -0
- data/lib/chef/application/solo.rb +263 -0
- data/lib/chef/application/windows_service.rb +230 -0
- data/lib/chef/applications.rb +5 -0
- data/lib/chef/checksum/storage.rb +18 -0
- data/lib/chef/checksum/storage/filesystem.rb +56 -0
- data/lib/chef/chef_fs.rb +11 -0
- data/lib/chef/chef_fs/command_line.rb +232 -0
- data/lib/chef/chef_fs/file_pattern.rb +312 -0
- data/lib/chef/chef_fs/file_system.rb +358 -0
- data/lib/chef/chef_fs/file_system/base_fs_dir.rb +47 -0
- data/lib/chef/chef_fs/file_system/base_fs_object.rb +121 -0
- data/lib/chef/chef_fs/file_system/chef_repository_file_system_entry.rb +109 -0
- data/lib/chef/chef_fs/file_system/chef_repository_file_system_root_dir.rb +31 -0
- data/lib/chef/chef_fs/file_system/chef_server_root_dir.rb +84 -0
- data/lib/chef/chef_fs/file_system/cookbook_dir.rb +188 -0
- data/lib/chef/chef_fs/file_system/cookbook_file.rb +78 -0
- data/lib/chef/chef_fs/file_system/cookbook_subdir.rb +54 -0
- data/lib/chef/chef_fs/file_system/cookbooks_dir.rb +68 -0
- data/lib/chef/chef_fs/file_system/data_bag_dir.rb +78 -0
- data/lib/chef/chef_fs/file_system/data_bag_item.rb +59 -0
- data/lib/chef/chef_fs/file_system/data_bags_dir.rb +66 -0
- data/lib/chef/chef_fs/file_system/file_system_entry.rb +90 -0
- data/lib/chef/chef_fs/file_system/file_system_error.rb +31 -0
- data/lib/chef/chef_fs/file_system/file_system_root_dir.rb +31 -0
- data/lib/chef/chef_fs/file_system/must_delete_recursively_error.rb +31 -0
- data/lib/chef/chef_fs/file_system/nodes_dir.rb +47 -0
- data/lib/chef/chef_fs/file_system/nonexistent_fs_object.rb +40 -0
- data/lib/chef/chef_fs/file_system/not_found_error.rb +31 -0
- data/lib/chef/chef_fs/file_system/rest_list_dir.rb +84 -0
- data/lib/chef/chef_fs/file_system/rest_list_entry.rb +123 -0
- data/lib/chef/chef_fs/knife.rb +77 -0
- data/lib/chef/chef_fs/path_utils.rb +64 -0
- data/lib/chef/client.rb +556 -0
- data/lib/chef/config.rb +354 -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 +171 -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 +627 -0
- data/lib/chef/cookbook/remote_file_vendor.rb +84 -0
- data/lib/chef/cookbook/synchronizer.rb +216 -0
- data/lib/chef/cookbook/syntax_check.rb +183 -0
- data/lib/chef/cookbook_loader.rb +134 -0
- data/lib/chef/cookbook_site_streaming_uploader.rb +244 -0
- data/lib/chef/cookbook_uploader.rb +164 -0
- data/lib/chef/cookbook_version.rb +782 -0
- data/lib/chef/daemon.rb +172 -0
- data/lib/chef/data_bag.rb +145 -0
- data/lib/chef/data_bag_item.rb +214 -0
- data/lib/chef/digester.rb +73 -0
- data/lib/chef/dsl.rb +6 -0
- data/lib/chef/dsl/data_query.rb +71 -0
- data/lib/chef/dsl/include_attribute.rb +63 -0
- data/lib/chef/dsl/include_recipe.rb +45 -0
- data/lib/chef/dsl/platform_introspection.rb +218 -0
- data/lib/chef/dsl/recipe.rb +87 -0
- data/lib/chef/dsl/registry_helper.rb +59 -0
- data/lib/chef/encrypted_data_bag_item.rb +323 -0
- data/lib/chef/environment.rb +287 -0
- data/lib/chef/event_dispatch/base.rb +311 -0
- data/lib/chef/event_dispatch/dispatcher.rb +42 -0
- data/lib/chef/exceptions.rb +275 -0
- data/lib/chef/file_access_control.rb +75 -0
- data/lib/chef/file_access_control/unix.rb +216 -0
- data/lib/chef/file_access_control/windows.rb +310 -0
- data/lib/chef/file_cache.rb +220 -0
- data/lib/chef/formatters/base.rb +250 -0
- data/lib/chef/formatters/doc.rb +236 -0
- data/lib/chef/formatters/error_descriptor.rb +66 -0
- data/lib/chef/formatters/error_inspectors.rb +19 -0
- data/lib/chef/formatters/error_inspectors/api_error_formatting.rb +111 -0
- data/lib/chef/formatters/error_inspectors/compile_error_inspector.rb +106 -0
- data/lib/chef/formatters/error_inspectors/cookbook_resolve_error_inspector.rb +146 -0
- data/lib/chef/formatters/error_inspectors/cookbook_sync_error_inspector.rb +80 -0
- data/lib/chef/formatters/error_inspectors/node_load_error_inspector.rb +125 -0
- data/lib/chef/formatters/error_inspectors/registration_error_inspector.rb +137 -0
- data/lib/chef/formatters/error_inspectors/resource_failure_inspector.rb +117 -0
- data/lib/chef/formatters/error_inspectors/run_list_expansion_error_inspector.rb +118 -0
- data/lib/chef/formatters/error_mapper.rb +85 -0
- data/lib/chef/formatters/minimal.rb +235 -0
- data/lib/chef/handler.rb +235 -0
- data/lib/chef/handler/error_report.rb +33 -0
- data/lib/chef/handler/json_file.rb +65 -0
- data/lib/chef/json_compat.rb +147 -0
- data/lib/chef/knife.rb +589 -0
- data/lib/chef/knife/bootstrap.rb +233 -0
- data/lib/chef/knife/bootstrap/archlinux-gems.erb +62 -0
- data/lib/chef/knife/bootstrap/centos5-gems.erb +62 -0
- data/lib/chef/knife/bootstrap/chef-full.erb +60 -0
- data/lib/chef/knife/bootstrap/fedora13-gems.erb +44 -0
- data/lib/chef/knife/bootstrap/ubuntu10.04-apt.erb +53 -0
- data/lib/chef/knife/bootstrap/ubuntu10.04-gems.erb +48 -0
- data/lib/chef/knife/bootstrap/ubuntu12.04-gems.erb +46 -0
- data/lib/chef/knife/client_bulk_delete.rb +65 -0
- data/lib/chef/knife/client_create.rb +80 -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 +59 -0
- data/lib/chef/knife/client_show.rb +52 -0
- data/lib/chef/knife/configure.rb +170 -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 +447 -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 +108 -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 +109 -0
- data/lib/chef/knife/cookbook_site_install.rb +164 -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 +60 -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 +94 -0
- data/lib/chef/knife/cookbook_upload.rb +295 -0
- data/lib/chef/knife/core/bootstrap_context.rb +106 -0
- data/lib/chef/knife/core/cookbook_scm_repo.rb +160 -0
- data/lib/chef/knife/core/generic_presenter.rb +204 -0
- data/lib/chef/knife/core/node_editor.rb +130 -0
- data/lib/chef/knife/core/node_presenter.rb +137 -0
- data/lib/chef/knife/core/object_loader.rb +112 -0
- data/lib/chef/knife/core/subcommand_loader.rb +112 -0
- data/lib/chef/knife/core/text_formatter.rb +86 -0
- data/lib/chef/knife/core/ui.rb +219 -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 +136 -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/delete.rb +39 -0
- data/lib/chef/knife/diff.rb +46 -0
- data/lib/chef/knife/download.rb +50 -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 +83 -0
- data/lib/chef/knife/environment_list.rb +42 -0
- data/lib/chef/knife/environment_show.rb +53 -0
- data/lib/chef/knife/exec.rb +86 -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 +134 -0
- data/lib/chef/knife/list.rb +109 -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 +75 -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/raw.rb +108 -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 +159 -0
- data/lib/chef/knife/show.rb +32 -0
- data/lib/chef/knife/ssh.rb +463 -0
- data/lib/chef/knife/status.rb +119 -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/knife/upload.rb +50 -0
- data/lib/chef/knife/user_create.rb +93 -0
- data/lib/chef/knife/user_delete.rb +46 -0
- data/lib/chef/knife/user_edit.rb +53 -0
- data/lib/chef/knife/user_list.rb +42 -0
- data/lib/chef/knife/user_reregister.rb +59 -0
- data/lib/chef/knife/user_show.rb +52 -0
- data/lib/chef/log.rb +39 -0
- data/lib/chef/mash.rb +225 -0
- data/lib/chef/mixin/checksum.rb +32 -0
- data/lib/chef/mixin/command.rb +164 -0
- data/lib/chef/mixin/command/unix.rb +220 -0
- data/lib/chef/mixin/command/windows.rb +76 -0
- data/lib/chef/mixin/convert_to_class_name.rb +65 -0
- data/lib/chef/mixin/create_path.rb +57 -0
- data/lib/chef/mixin/deep_merge.rb +168 -0
- data/lib/chef/mixin/deprecation.rb +100 -0
- data/lib/chef/mixin/enforce_ownership_and_permissions.rb +39 -0
- data/lib/chef/mixin/file_class.rb +46 -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 +48 -0
- data/lib/chef/mixin/language_include_attribute.rb +35 -0
- data/lib/chef/mixin/language_include_recipe.rb +32 -0
- data/lib/chef/mixin/params_validate.rb +225 -0
- data/lib/chef/mixin/path_sanity.rb +67 -0
- data/lib/chef/mixin/recipe_definition_dsl_core.rb +35 -0
- data/lib/chef/mixin/securable.rb +205 -0
- data/lib/chef/mixin/shell_out.rb +69 -0
- data/lib/chef/mixin/template.rb +140 -0
- data/lib/chef/mixin/why_run.rb +332 -0
- data/lib/chef/mixin/xml_escape.rb +140 -0
- data/lib/chef/mixins.rb +14 -0
- data/lib/chef/monkey_patches/dir.rb +36 -0
- data/lib/chef/monkey_patches/fileutils.rb +65 -0
- data/lib/chef/monkey_patches/net_http.rb +22 -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 +509 -0
- data/lib/chef/node/attribute.rb +398 -0
- data/lib/chef/node/attribute_collections.rb +206 -0
- data/lib/chef/node/immutable_collections.rb +186 -0
- data/lib/chef/platform.rb +519 -0
- data/lib/chef/provider.rb +176 -0
- data/lib/chef/provider/breakpoint.rb +36 -0
- data/lib/chef/provider/cookbook_file.rb +113 -0
- data/lib/chef/provider/cron.rb +214 -0
- data/lib/chef/provider/cron/solaris.rb +56 -0
- data/lib/chef/provider/deploy.rb +475 -0
- data/lib/chef/provider/deploy/revision.rb +80 -0
- data/lib/chef/provider/deploy/timestamped.rb +32 -0
- data/lib/chef/provider/directory.rb +131 -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 +106 -0
- data/lib/chef/provider/execute.rb +68 -0
- data/lib/chef/provider/file.rb +328 -0
- data/lib/chef/provider/git.rb +260 -0
- data/lib/chef/provider/group.rb +158 -0
- data/lib/chef/provider/group/aix.rb +70 -0
- data/lib/chef/provider/group/dscl.rb +129 -0
- data/lib/chef/provider/group/gpasswd.rb +65 -0
- data/lib/chef/provider/group/groupadd.rb +96 -0
- data/lib/chef/provider/group/groupmod.rb +120 -0
- data/lib/chef/provider/group/pw.rb +93 -0
- data/lib/chef/provider/group/suse.rb +60 -0
- data/lib/chef/provider/group/usermod.rb +68 -0
- data/lib/chef/provider/group/windows.rb +79 -0
- data/lib/chef/provider/http_request.rb +119 -0
- data/lib/chef/provider/ifconfig.rb +214 -0
- data/lib/chef/provider/link.rb +132 -0
- data/lib/chef/provider/log.rb +54 -0
- data/lib/chef/provider/lwrp_base.rb +150 -0
- data/lib/chef/provider/mdadm.rb +92 -0
- data/lib/chef/provider/mount.rb +128 -0
- data/lib/chef/provider/mount/mount.rb +252 -0
- data/lib/chef/provider/mount/windows.rb +81 -0
- data/lib/chef/provider/ohai.rb +47 -0
- data/lib/chef/provider/package.rb +229 -0
- data/lib/chef/provider/package/apt.rb +147 -0
- data/lib/chef/provider/package/dpkg.rb +128 -0
- data/lib/chef/provider/package/easy_install.rb +136 -0
- data/lib/chef/provider/package/freebsd.rb +149 -0
- data/lib/chef/provider/package/ips.rb +101 -0
- data/lib/chef/provider/package/macports.rb +105 -0
- data/lib/chef/provider/package/pacman.rb +111 -0
- data/lib/chef/provider/package/portage.rb +138 -0
- data/lib/chef/provider/package/rpm.rb +121 -0
- data/lib/chef/provider/package/rubygems.rb +548 -0
- data/lib/chef/provider/package/smartos.rb +84 -0
- data/lib/chef/provider/package/solaris.rb +139 -0
- data/lib/chef/provider/package/yum-dump.py +307 -0
- data/lib/chef/provider/package/yum.rb +1255 -0
- data/lib/chef/provider/package/zypper.rb +144 -0
- data/lib/chef/provider/registry_key.rb +156 -0
- data/lib/chef/provider/remote_directory.rb +180 -0
- data/lib/chef/provider/remote_file.rb +141 -0
- data/lib/chef/provider/resource_update.rb +55 -0
- data/lib/chef/provider/route.rb +223 -0
- data/lib/chef/provider/ruby_block.rb +42 -0
- data/lib/chef/provider/script.rb +57 -0
- data/lib/chef/provider/service.rb +173 -0
- data/lib/chef/provider/service/arch.rb +113 -0
- data/lib/chef/provider/service/debian.rb +152 -0
- data/lib/chef/provider/service/freebsd.rb +175 -0
- data/lib/chef/provider/service/gentoo.rb +67 -0
- data/lib/chef/provider/service/init.rb +89 -0
- data/lib/chef/provider/service/insserv.rb +52 -0
- data/lib/chef/provider/service/invokercd.rb +35 -0
- data/lib/chef/provider/service/macosx.rb +144 -0
- data/lib/chef/provider/service/redhat.rb +77 -0
- data/lib/chef/provider/service/simple.rb +172 -0
- data/lib/chef/provider/service/solaris.rb +86 -0
- data/lib/chef/provider/service/systemd.rb +115 -0
- data/lib/chef/provider/service/upstart.rb +232 -0
- data/lib/chef/provider/service/windows.rb +163 -0
- data/lib/chef/provider/subversion.rb +214 -0
- data/lib/chef/provider/template.rb +120 -0
- data/lib/chef/provider/template_finder.rb +61 -0
- data/lib/chef/provider/user.rb +206 -0
- data/lib/chef/provider/user/dscl.rb +288 -0
- data/lib/chef/provider/user/pw.rb +113 -0
- data/lib/chef/provider/user/useradd.rb +144 -0
- data/lib/chef/provider/user/windows.rb +124 -0
- data/lib/chef/providers.rb +103 -0
- data/lib/chef/recipe.rb +135 -0
- data/lib/chef/reserved_names.rb +9 -0
- data/lib/chef/resource.rb +794 -0
- data/lib/chef/resource/apt_package.rb +43 -0
- data/lib/chef/resource/bash.rb +33 -0
- data/lib/chef/resource/breakpoint.rb +35 -0
- data/lib/chef/resource/chef_gem.rb +53 -0
- data/lib/chef/resource/conditional.rb +101 -0
- data/lib/chef/resource/cookbook_file.rb +52 -0
- data/lib/chef/resource/cron.rb +202 -0
- data/lib/chef/resource/csh.rb +33 -0
- data/lib/chef/resource/deploy.rb +403 -0
- data/lib/chef/resource/deploy_revision.rb +40 -0
- data/lib/chef/resource/directory.rb +65 -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 +63 -0
- data/lib/chef/resource/erl_call.rb +86 -0
- data/lib/chef/resource/execute.rb +132 -0
- data/lib/chef/resource/file.rb +96 -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 +83 -0
- data/lib/chef/resource/http_request.rb +65 -0
- data/lib/chef/resource/ifconfig.rb +149 -0
- data/lib/chef/resource/ips_package.rb +42 -0
- data/lib/chef/resource/link.rb +92 -0
- data/lib/chef/resource/log.rb +74 -0
- data/lib/chef/resource/lwrp_base.rb +127 -0
- data/lib/chef/resource/macports_package.rb +29 -0
- data/lib/chef/resource/mdadm.rb +105 -0
- data/lib/chef/resource/mount.rb +139 -0
- data/lib/chef/resource/ohai.rb +54 -0
- data/lib/chef/resource/package.rb +84 -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/registry_key.rb +86 -0
- data/lib/chef/resource/remote_directory.rb +126 -0
- data/lib/chef/resource/remote_file.rb +81 -0
- data/lib/chef/resource/route.rb +140 -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 +51 -0
- data/lib/chef/resource/scm.rb +151 -0
- data/lib/chef/resource/script.rb +63 -0
- data/lib/chef/resource/service.rb +178 -0
- data/lib/chef/resource/smartos_package.rb +36 -0
- data/lib/chef/resource/solaris_package.rb +36 -0
- data/lib/chef/resource/subversion.rb +37 -0
- data/lib/chef/resource/template.rb +76 -0
- data/lib/chef/resource/timestamped_deploy.rb +31 -0
- data/lib/chef/resource/user.rb +134 -0
- data/lib/chef/resource/yum_package.rb +63 -0
- data/lib/chef/resource_collection.rb +221 -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/resource_platform_map.rb +151 -0
- data/lib/chef/resource_reporter.rb +281 -0
- data/lib/chef/resources.rb +69 -0
- data/lib/chef/rest.rb +438 -0
- data/lib/chef/rest/auth_credentials.rb +57 -0
- data/lib/chef/rest/cookie_jar.rb +31 -0
- data/lib/chef/rest/rest_request.rb +229 -0
- data/lib/chef/role.rb +253 -0
- data/lib/chef/run_context.rb +214 -0
- data/lib/chef/run_context/cookbook_compiler.rb +280 -0
- data/lib/chef/run_list.rb +163 -0
- data/lib/chef/run_list/run_list_expansion.rb +191 -0
- data/lib/chef/run_list/run_list_item.rb +99 -0
- data/lib/chef/run_list/versioned_recipe_list.rb +68 -0
- data/lib/chef/run_lock.rb +90 -0
- data/lib/chef/run_status.rb +124 -0
- data/lib/chef/runner.rb +118 -0
- data/lib/chef/sandbox.rb +20 -0
- data/lib/chef/scan_access_control.rb +133 -0
- data/lib/chef/search/query.rb +65 -0
- data/lib/chef/shef/ext.rb +19 -0
- data/lib/chef/shell.rb +329 -0
- data/lib/chef/shell/ext.rb +593 -0
- data/lib/chef/shell/model_wrapper.rb +120 -0
- data/lib/chef/shell/shell_rest.rb +28 -0
- data/lib/chef/shell/shell_session.rb +298 -0
- data/lib/chef/shell_out.rb +13 -0
- data/lib/chef/streaming_cookbook_uploader.rb +201 -0
- data/lib/chef/tasks/chef_repo.rake +334 -0
- data/lib/chef/user.rb +182 -0
- data/lib/chef/util/file_edit.rb +132 -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/win32/api.rb +364 -0
- data/lib/chef/win32/api/error.rb +921 -0
- data/lib/chef/win32/api/file.rb +535 -0
- data/lib/chef/win32/api/memory.rb +105 -0
- data/lib/chef/win32/api/process.rb +41 -0
- data/lib/chef/win32/api/psapi.rb +51 -0
- data/lib/chef/win32/api/security.rb +385 -0
- data/lib/chef/win32/api/system.rb +192 -0
- data/lib/chef/win32/api/unicode.rb +178 -0
- data/lib/chef/win32/error.rb +73 -0
- data/lib/chef/win32/file.rb +167 -0
- data/lib/chef/win32/file/info.rb +100 -0
- data/lib/chef/win32/handle.rb +55 -0
- data/lib/chef/win32/memory.rb +101 -0
- data/lib/chef/win32/process.rb +84 -0
- data/lib/chef/win32/registry.rb +382 -0
- data/lib/chef/win32/security.rb +508 -0
- data/lib/chef/win32/security/ace.rb +125 -0
- data/lib/chef/win32/security/acl.rb +101 -0
- data/lib/chef/win32/security/securable_object.rb +109 -0
- data/lib/chef/win32/security/security_descriptor.rb +93 -0
- data/lib/chef/win32/security/sid.rb +199 -0
- data/lib/chef/win32/security/token.rb +64 -0
- data/lib/chef/win32/unicode.rb +43 -0
- data/lib/chef/win32/version.rb +119 -0
- metadata +553 -3
@@ -0,0 +1,103 @@
|
|
1
|
+
knife-client(1) -- Manage Chef API Clients
|
2
|
+
========================================
|
3
|
+
|
4
|
+
## SYNOPSIS
|
5
|
+
|
6
|
+
__knife__ __client__ _sub-command_ _(options)_
|
7
|
+
|
8
|
+
## SUB-COMMANDS
|
9
|
+
Client subcommands follow a basic create, read, update, delete (CRUD)
|
10
|
+
pattern. The Following subcommands are available:
|
11
|
+
|
12
|
+
## BULK DELETE
|
13
|
+
__knife client bulk delete__ _regex_ _(options)_
|
14
|
+
|
15
|
+
Delete clients where the client name matches the regular expression
|
16
|
+
_regex_ on the Chef Server. The regular expression should be given as a
|
17
|
+
quoted string, and not surrounded by forward slashes.
|
18
|
+
|
19
|
+
## CREATE
|
20
|
+
__knife client create__ _client name_ _(options)_
|
21
|
+
|
22
|
+
* `-a`, `--admin `:
|
23
|
+
Create the client as an admin
|
24
|
+
* `-f`, `--file FILE`:
|
25
|
+
Write the key to a file
|
26
|
+
|
27
|
+
Create a new client. This generates an RSA keypair. The private key will
|
28
|
+
be displayed on _STDOUT_ or written to the named file. The public half
|
29
|
+
will be stored on the Server. For _chef-client_ systems, the private key
|
30
|
+
should be copied to the system as `/etc/chef/client.pem`.
|
31
|
+
|
32
|
+
Admin clients should be created for users that will use _knife_ to
|
33
|
+
access the API as an administrator. The private key will generally be
|
34
|
+
copied to `~/.chef/client\_name.pem` and referenced in the `knife.rb`
|
35
|
+
configuration file.
|
36
|
+
|
37
|
+
## DELETE
|
38
|
+
__knife client delete__ _client name_ _(options)_
|
39
|
+
|
40
|
+
Deletes a registered client.
|
41
|
+
|
42
|
+
## EDIT
|
43
|
+
__client edit__ _client name_ _(options)_
|
44
|
+
|
45
|
+
Edit a registered client.
|
46
|
+
|
47
|
+
## LIST
|
48
|
+
__client list__ _(options)_
|
49
|
+
|
50
|
+
* `-w`, `--with-uri`:
|
51
|
+
Show corresponding URIs
|
52
|
+
|
53
|
+
List all registered clients.
|
54
|
+
|
55
|
+
## REREGISTER
|
56
|
+
__client reregister__ _client name_ _(options)_
|
57
|
+
|
58
|
+
* `-f`, `--file FILE`:
|
59
|
+
Write the key to a file
|
60
|
+
|
61
|
+
Regenerate the RSA keypair for a client. The public half will be stored
|
62
|
+
on the server and the private key displayed on _STDOUT_ or written to
|
63
|
+
the named file. This operation will invalidate the previous keypair used
|
64
|
+
by the client, preventing it from authenticating with the Chef Server.
|
65
|
+
Use care when reregistering the validator client.
|
66
|
+
|
67
|
+
## SHOW
|
68
|
+
__client show__ _client name_ _(options)_
|
69
|
+
|
70
|
+
* `-a`, `--attribute ATTR`:
|
71
|
+
Show only one attribute
|
72
|
+
|
73
|
+
Show a client. Output format is determined by the --format option.
|
74
|
+
|
75
|
+
## DESCRIPTION
|
76
|
+
Clients are identities used for communication with the Chef Server API,
|
77
|
+
roughly equivalent to user accounts on the Chef Server, except that
|
78
|
+
clients only communicate with the Chef Server API and are authenticated
|
79
|
+
via request signatures.
|
80
|
+
|
81
|
+
In the typical case, there will be one client object on the server for
|
82
|
+
each node, and the corresponding client and node will have identical
|
83
|
+
names.
|
84
|
+
|
85
|
+
In the Chef authorization model, there is one special client, the
|
86
|
+
"validator", which is authorized to create new non-administrative
|
87
|
+
clients but has minimal privileges otherwise. This identity is used as a
|
88
|
+
sort of "guest account" to create a client identity when initially
|
89
|
+
setting up a host for management with Chef.
|
90
|
+
|
91
|
+
## SEE ALSO
|
92
|
+
__knife-node__(1)
|
93
|
+
|
94
|
+
## AUTHOR
|
95
|
+
Chef was written by Adam Jacob <adam@opscode.com> with many contributions from the community.
|
96
|
+
|
97
|
+
## DOCUMENTATION
|
98
|
+
This manual page was written by Joshua Timberman <joshua@opscode.com>.
|
99
|
+
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
|
100
|
+
|
101
|
+
## CHEF
|
102
|
+
Knife is distributed with Chef. <http://wiki.opscode.com/display/chef/Home>
|
103
|
+
|
@@ -0,0 +1,70 @@
|
|
1
|
+
knife-configure(1) -- Generate configuration files for knife or Chef Client
|
2
|
+
========================================
|
3
|
+
|
4
|
+
## SYNOPSIS
|
5
|
+
|
6
|
+
__knife__ __configure__ [client] _(options)_
|
7
|
+
|
8
|
+
## DESCRIPTION
|
9
|
+
Generates a knife.rb configuration file interactively. When given the
|
10
|
+
--initial option, also creates a new administrative user.
|
11
|
+
|
12
|
+
## CONFIGURE SUBCOMMANDS ##
|
13
|
+
|
14
|
+
__knife configure__ _(options)_
|
15
|
+
|
16
|
+
* `-i`, `--initial`:
|
17
|
+
Create an initial API Client
|
18
|
+
* `-r`, `--repository REPO`:
|
19
|
+
The path to your chef-repo
|
20
|
+
|
21
|
+
Create a configuration file for knife. This will prompt for values to
|
22
|
+
enter into the file. Default values are listed in square brackets if no
|
23
|
+
other entry is typed. See __knife__(1) for a description of
|
24
|
+
configuration options.
|
25
|
+
|
26
|
+
__knife configure client__ _directory_
|
27
|
+
|
28
|
+
Read the _knife.rb_ config file and generate a config file suitable for
|
29
|
+
use in _/etc/chef/client.rb_ and copy the validation certificate into
|
30
|
+
the specified _directory_.
|
31
|
+
|
32
|
+
## EXAMPLES
|
33
|
+
* On a freshly installed Chef Server, use _knife configure -i_ to
|
34
|
+
create an administrator and knife configuration file. Leave the
|
35
|
+
field blank to accept the default value. On most systems, the
|
36
|
+
default values are acceptable.
|
37
|
+
|
38
|
+
user@host$ knife configure -i
|
39
|
+
Please enter the chef server URL: [http://localhost:4000]
|
40
|
+
Please enter a clientname for the new client: [username]
|
41
|
+
Please enter the existing admin clientname: [chef-webui]
|
42
|
+
Please enter the location of the existing admin client's private key: [/etc/chef/webui.pem]
|
43
|
+
Please enter the validation clientname: [chef-validator]
|
44
|
+
Please enter the location of the validation key: [/etc/chef/validation.pem]
|
45
|
+
Please enter the path to a chef repository (or leave blank):
|
46
|
+
Creating initial API user...
|
47
|
+
Created (or updated) client[username]
|
48
|
+
Configuration file written to /home/username/.chef/knife.rb
|
49
|
+
|
50
|
+
This creates a new administrator client named _username_, writes
|
51
|
+
a configuration file to _/home/username/.chef/knife.rb_, and the
|
52
|
+
private key to _/home/username/.chef/username.pem_. The
|
53
|
+
configuration file and private key may be copied to another system
|
54
|
+
to facilitate administration of the Chef Server from a remote
|
55
|
+
system. Depending on the value given for the Chef Server URL, you
|
56
|
+
may need to modify that setting after copying to a remote host.
|
57
|
+
|
58
|
+
## SEE ALSO
|
59
|
+
__knife__(1) __knife-client__(1)
|
60
|
+
|
61
|
+
## AUTHOR
|
62
|
+
Chef was written by Adam Jacob <adam@opscode.com> with many contributions from the community.
|
63
|
+
|
64
|
+
## DOCUMENTATION
|
65
|
+
This manual page was written by Joshua Timberman <joshua@opscode.com>.
|
66
|
+
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
|
67
|
+
|
68
|
+
## CHEF
|
69
|
+
Knife is distributed with Chef. <http://wiki.opscode.com/display/chef/Home>
|
70
|
+
|
@@ -0,0 +1,123 @@
|
|
1
|
+
knife-cookbook-site(1) -- Install and update open source cookbooks
|
2
|
+
========================================
|
3
|
+
|
4
|
+
## SYNOPSIS
|
5
|
+
|
6
|
+
__knife__ __cookbook site__ _sub-command_ _(options)_
|
7
|
+
|
8
|
+
## COOKBOOK SITE SUB-COMMANDS
|
9
|
+
`knife cookbook site` provides the following subcommands:
|
10
|
+
|
11
|
+
## INSTALL
|
12
|
+
__cookbook site install COOKBOOK [VERSION]__ _(options)_
|
13
|
+
|
14
|
+
* `-D`, `--skip-dependencies `:
|
15
|
+
Skip automatic installation of dependencies.
|
16
|
+
* `-o`, `--cookbook-path PATH`:
|
17
|
+
Install cookbooks to PATH
|
18
|
+
* `-B`, `--branch BRANCH`:
|
19
|
+
Default branch to work with [defaults to master]
|
20
|
+
|
21
|
+
Uses git(1) version control in conjunction with the cookbook site to
|
22
|
+
install community contributed cookbooks to your local cookbook
|
23
|
+
repository. Running `knife cookbook site install` does the following:
|
24
|
+
|
25
|
+
1. A new "pristine copy" branch is created in git for tracking the
|
26
|
+
upstream;
|
27
|
+
2. All existing cookbooks are removed from the branch;
|
28
|
+
3. The cookbook is downloaded from the cookbook site in tarball form;
|
29
|
+
4. The downloaded cookbook is untarred, and its contents commited via git;
|
30
|
+
5. The pristine copy branch is merged into the master branch.
|
31
|
+
|
32
|
+
By installing cookbook with this process, you can locally modify the
|
33
|
+
upstream cookbook in your master branch and let git maintain your
|
34
|
+
changes as a separate patch. When an updated upstream version becomes
|
35
|
+
available, you will be able to merge the upstream changes while
|
36
|
+
maintaining your local modifications.
|
37
|
+
|
38
|
+
Unless _--skip-dependencies_ is specified, the process is applied recursively to all the
|
39
|
+
cookbooks _COOKBOOK_ depends on (via metadata _dependencies_).
|
40
|
+
|
41
|
+
## DOWNLOAD
|
42
|
+
__knife cookbook site download COOKBOOK [VERSION]__ _(options)_
|
43
|
+
|
44
|
+
* `-f`, `--file FILE`:
|
45
|
+
The filename to write to
|
46
|
+
* `--force`:
|
47
|
+
Force download deprecated cookbook
|
48
|
+
|
49
|
+
Downloads a specific cookbook from the Community site, optionally
|
50
|
+
specifying a certain version.
|
51
|
+
|
52
|
+
## LIST
|
53
|
+
__knife cookbook site list__ _(options)_
|
54
|
+
|
55
|
+
* `-w`, `--with-uri`:
|
56
|
+
Show corresponding URIs
|
57
|
+
|
58
|
+
Lists available cookbooks from the Community site.
|
59
|
+
|
60
|
+
## SEARCH
|
61
|
+
__knife cookbook site search QUERY__ _(options)_
|
62
|
+
|
63
|
+
Searches for available cookbooks matching the specified query.
|
64
|
+
|
65
|
+
## SHARE
|
66
|
+
__knife cookbook site share COOKBOOK CATEGORY__ _(options)_
|
67
|
+
|
68
|
+
* `-k`, `--key KEY`:
|
69
|
+
API Client Key
|
70
|
+
* `-u`, `--user USER`:
|
71
|
+
API Client Username
|
72
|
+
* `-o`, `--cookbook-path PATH:PATH`:
|
73
|
+
A colon-separated path to look for cookbooks in
|
74
|
+
|
75
|
+
Uploads the specified cookbook using the given category to the Opscode
|
76
|
+
cookbooks site. Requires a login user and certificate for the Opscode
|
77
|
+
Cookbooks site. By default, knife will use the username and API key
|
78
|
+
you've configured in your configuration file; otherwise you must
|
79
|
+
explicitly set these values on the command line or use an alternate
|
80
|
+
configuration file.
|
81
|
+
|
82
|
+
## UNSHARE
|
83
|
+
__knife cookbook site unshare COOKBOOK__
|
84
|
+
|
85
|
+
Stops sharing the specified cookbook on the Opscode cookbooks site.
|
86
|
+
|
87
|
+
## SHOW
|
88
|
+
__knife cookbook site show COOKBOOK [VERSION]__ _(options)_
|
89
|
+
|
90
|
+
Shows information from the site about a particular cookbook.
|
91
|
+
|
92
|
+
## DESCRIPTION
|
93
|
+
The cookbook site, <http://community.opscode.com/>, is a cookbook
|
94
|
+
distribution service operated by Opscode. This service provides users
|
95
|
+
with a central location to publish cookbooks for sharing with other
|
96
|
+
community members.
|
97
|
+
|
98
|
+
`knife cookbook site` commands provide an interface to the cookbook
|
99
|
+
site's HTTP API. For commands that read data from the API, no account is
|
100
|
+
required. In order to upload cookbooks using the `knife cookbook site
|
101
|
+
share` command, you must create an account on the cookbook site and
|
102
|
+
configure your credentials via command line option or in your knife
|
103
|
+
configuration file.
|
104
|
+
|
105
|
+
## EXAMPLES
|
106
|
+
Uploading cookbooks to the Opscode cookbooks site:
|
107
|
+
|
108
|
+
knife cookbook site share example Other -k ~/.chef/USERNAME.pem -u USERNAME
|
109
|
+
|
110
|
+
## SEE ALSO
|
111
|
+
__knife-cookbook(1)__
|
112
|
+
<http://community.opscode.com/cookbooks>
|
113
|
+
|
114
|
+
## AUTHOR
|
115
|
+
Chef was written by Adam Jacob <adam@opscode.com> with many contributions from the community.
|
116
|
+
|
117
|
+
## DOCUMENTATION
|
118
|
+
This manual page was written by Joshua Timberman <joshua@opscode.com>.
|
119
|
+
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
|
120
|
+
|
121
|
+
## CHEF
|
122
|
+
Knife is distributed with Chef. <http://wiki.opscode.com/display/chef/Home>
|
123
|
+
|
@@ -0,0 +1,263 @@
|
|
1
|
+
knife-cookbook(1) -- upload and manage chef cookbooks
|
2
|
+
========================================
|
3
|
+
|
4
|
+
## SYNOPSIS
|
5
|
+
|
6
|
+
__knife__ __cookbook__ _sub-command_ _(options)_
|
7
|
+
|
8
|
+
## SUB-COMMANDS
|
9
|
+
`knife cookbook` supports the following sub commands:
|
10
|
+
|
11
|
+
## LIST
|
12
|
+
__knife cookbook list__ _(options)_
|
13
|
+
|
14
|
+
* `-a`, `--all`:
|
15
|
+
show all versions of a cookbook instead of just the most recent
|
16
|
+
* `-w`, `--with-uri`:
|
17
|
+
show corresponding uris
|
18
|
+
|
19
|
+
Lists the cookbooks available on the Chef server.
|
20
|
+
|
21
|
+
## SHOW
|
22
|
+
__knife cookbook show cookbook [version] [part] [filename]__ _(options)_
|
23
|
+
|
24
|
+
* `-f`, `--fqdn fqdn `:
|
25
|
+
the fqdn of the host to see the file for
|
26
|
+
* `-p`, `--platform platform `:
|
27
|
+
the platform to see the file for
|
28
|
+
* `-v`, `--platform-version version`:
|
29
|
+
the platform version to see the file for
|
30
|
+
* `-w`, `--with-uri`:
|
31
|
+
Show corresponding URIs
|
32
|
+
|
33
|
+
show a particular part of a _cookbook_ for the specified _version_. _part_ can be one of:
|
34
|
+
|
35
|
+
* _attributes_
|
36
|
+
* _definitions_
|
37
|
+
* _files_
|
38
|
+
* _libraries_
|
39
|
+
* _providers_
|
40
|
+
* _recipes_
|
41
|
+
* _resources_
|
42
|
+
* _templates_
|
43
|
+
|
44
|
+
## UPLOAD
|
45
|
+
__knife cookbook upload [cookbooks...]__ _(options)_
|
46
|
+
|
47
|
+
* `-a`, `--all`:
|
48
|
+
upload all cookbooks, rather than just a single cookbook
|
49
|
+
* `-o`, `--cookbook-path path:path`:
|
50
|
+
a colon-separated path to look for cookbooks in
|
51
|
+
* `-d`, `--upload-dependencies`:
|
52
|
+
Uploads additional cookbooks that this cookbook lists in as
|
53
|
+
dependencies in its metadata.
|
54
|
+
* `-E`, `--environment ENVIRONMENT`:
|
55
|
+
An _ENVIRONMENT_ to apply the uploaded cookbooks to. Specifying this
|
56
|
+
option will cause knife to edit the _ENVIRONMENT_ to place a strict
|
57
|
+
version constraint on the cookbook version(s) uploaded.
|
58
|
+
* `--freeze`:
|
59
|
+
Sets the frozen flag on the uploaded cookbook(s) Any future attempt
|
60
|
+
to modify the cookbook without changing the version number will
|
61
|
+
return an error unless --force is specified.
|
62
|
+
* `--force`:
|
63
|
+
Overrides the frozen flag on a cookbook, allowing you to overwrite a
|
64
|
+
cookbook version that has previously been uploaded with the --freeze
|
65
|
+
option.
|
66
|
+
|
67
|
+
Uploads one or more cookbooks from your local cookbook repository(ies)
|
68
|
+
to the Chef Server. Only files that don't yet exist on the server will
|
69
|
+
be uploaded.
|
70
|
+
|
71
|
+
As the command parses the name args as 1..n cookbook names:
|
72
|
+
`knife cookbook upload COOKBOOK COOKBOOK ...`
|
73
|
+
works for one to many cookbooks.
|
74
|
+
|
75
|
+
## DOWNLOAD
|
76
|
+
__knife cookbook download cookbook [version]__ _(options)_
|
77
|
+
|
78
|
+
* `-d`, `--dir download_directory`:
|
79
|
+
the directory to download the cookbook into
|
80
|
+
* `-f`, `--force`:
|
81
|
+
overwrite an existing directory with the download
|
82
|
+
* `-n`, `--latest`:
|
83
|
+
download the latest version of the cookbook
|
84
|
+
|
85
|
+
download a cookbook from the chef server. if no version is specified and
|
86
|
+
only one version exists on the server, that version will be downloaded.
|
87
|
+
if no version is specified and multiple versions are available on the
|
88
|
+
server, you will be prompted for a version to download.
|
89
|
+
|
90
|
+
## DELETE
|
91
|
+
__knife cookbook delete cookbook [version]__ _(options)_
|
92
|
+
|
93
|
+
* `-a`, `--all`:
|
94
|
+
delete all versions
|
95
|
+
* `-p`, `--purge`:
|
96
|
+
purge files from backing store. this will disable any cookbook that contains any of the same files as the cookbook being purged.
|
97
|
+
|
98
|
+
delete the specified _version_ of the named _cookbook_. if no version is
|
99
|
+
specified, and only one version exists on the server, that version will
|
100
|
+
be deleted. if multiple versions are available on the server, you will
|
101
|
+
be prompted for a version to delete.
|
102
|
+
|
103
|
+
## BULK DELETE
|
104
|
+
__knife cookbook bulk delete regex__ _(options)_
|
105
|
+
|
106
|
+
* `-p`, `--purge`:
|
107
|
+
purge files from backing store. this will disable any cookbook that
|
108
|
+
contains any of the same files as the cookbook being purged.
|
109
|
+
|
110
|
+
delete cookbooks on the chef server based on a regular expression. the
|
111
|
+
regular expression (_regex_) should be in quotes, not in //'s.
|
112
|
+
|
113
|
+
## COOKBOOK CREATE
|
114
|
+
__knife cookbook create cookbook__ _(options)_
|
115
|
+
|
116
|
+
* `-o`, `--cookbook-path path`:
|
117
|
+
the directory where the cookbook will be created
|
118
|
+
* `-r`, `--readme-format format`:
|
119
|
+
format of the readme file md, mkd, txt, rdoc
|
120
|
+
* `-c`, `--copyright copyright`:
|
121
|
+
name of copyright holder
|
122
|
+
* `-i`, `--license license`:
|
123
|
+
license for cookbook, apachev2 or none
|
124
|
+
* `-e`, `--email email`:
|
125
|
+
email address of cookbook maintainer
|
126
|
+
|
127
|
+
this is a helper command that creates a new cookbook directory in the
|
128
|
+
`cookbook_path`. the following directories and files are created for the
|
129
|
+
named cookbook.
|
130
|
+
|
131
|
+
* cookbook/attributes
|
132
|
+
* cookbook/definitions
|
133
|
+
* cookbook/files/default
|
134
|
+
* cookbook/libraries
|
135
|
+
* cookbook/metadata.rb
|
136
|
+
* cookbook/providers
|
137
|
+
* cookbook/readme.md
|
138
|
+
* cookbook/recipes/default.rb
|
139
|
+
* cookbook/resources
|
140
|
+
* cookbook/templates/default
|
141
|
+
|
142
|
+
supported readme formats are 'md' (default), 'mkd', 'txt', 'rdoc'. the
|
143
|
+
readme file will be written with the specified extension and a set of
|
144
|
+
helpful starting headers.
|
145
|
+
|
146
|
+
specify `-c` or `--copyright` with the name of the copyright holder as
|
147
|
+
your name or your company/organization name in a quoted string. if this
|
148
|
+
value is not specified an all-caps string `your_company_name` is used
|
149
|
+
which can be easily changed with find/replace.
|
150
|
+
|
151
|
+
specify `-i` or `--license` with the license that the cookbook is
|
152
|
+
distributed under for sharing with other people or posting to the
|
153
|
+
opscode cookbooks site. be aware of the licenses of files you put inside
|
154
|
+
the cookbook and follow any restrictions they describe. when using
|
155
|
+
`none` (default) or `apachev2`, comment header text and metadata file
|
156
|
+
are pre-filled. the `none` license will be treated as
|
157
|
+
non-redistributable.
|
158
|
+
|
159
|
+
specify `-e` or `--email` with the email address of the cookbook's
|
160
|
+
maintainer. if this value is not specified, an all-caps string
|
161
|
+
`your_email` is used which can easily be changed with find/replace.
|
162
|
+
|
163
|
+
the cookbook copyright, license, email and readme_format settings can be filled in the
|
164
|
+
`knife.rb`, for example with default values:
|
165
|
+
|
166
|
+
cookbook_copyright "your_company_name"
|
167
|
+
cookbook_license "none"
|
168
|
+
cookbook_email "your_email"
|
169
|
+
readme_format "md"
|
170
|
+
|
171
|
+
|
172
|
+
## METADATA
|
173
|
+
__knife cookbook metadata cookbook__ _(options)_
|
174
|
+
|
175
|
+
* `-a`, `--all`:
|
176
|
+
generate metadata for all cookbooks, rather than just a single cookbook
|
177
|
+
* `-o`, `--cookbook-path path:path`:
|
178
|
+
a colon-separated path to look for cookbooks in
|
179
|
+
|
180
|
+
generate cookbook metadata for the named _cookbook_. the _path_ used here specifies where the cookbooks directory is located and corresponds to the `cookbook_path` configuration option.
|
181
|
+
|
182
|
+
## METADATA FROM FILE
|
183
|
+
__knife cookbook metadata from file__ _(options)_
|
184
|
+
|
185
|
+
load the cookbook metadata from a specified file.
|
186
|
+
|
187
|
+
## TEST
|
188
|
+
__knife cookbook test [cookbooks...]__ _(options)_
|
189
|
+
|
190
|
+
* `-a`, `--all`:
|
191
|
+
test all cookbooks, rather than just a single cookbook
|
192
|
+
* `-o`, `--cookbook-path path:path`:
|
193
|
+
a colon-separated path to look for cookbooks in
|
194
|
+
|
195
|
+
test the specified cookbooks for syntax errors. this uses the built-in
|
196
|
+
ruby syntax checking option for files in the cookbook ending in `.rb`,
|
197
|
+
and the erb syntax check for files ending in `.erb` (templates).
|
198
|
+
|
199
|
+
## RECIPE LIST
|
200
|
+
__knife recipe list [PATTERN]__
|
201
|
+
|
202
|
+
List available recipes from the server. Specify _PATTERN_ as a regular
|
203
|
+
expression to limit the results.
|
204
|
+
|
205
|
+
## DESCRIPTION
|
206
|
+
Cookbooks are the fundamental unit of distribution in Chef. They
|
207
|
+
encapsulate all recipes of resources and assets used to configure a
|
208
|
+
particular aspect of the infrastructure. The following sub-commands can
|
209
|
+
be used to manipulate the cookbooks stored on the Chef Server.
|
210
|
+
|
211
|
+
On disk, cookbooks are directories with a defined structure. The
|
212
|
+
following directories may appear within a cookbook:
|
213
|
+
|
214
|
+
* COOKBOOK/attributes/:
|
215
|
+
Ruby files that define default parameters to be used in recipes
|
216
|
+
* COOKBOOK/definitions/:
|
217
|
+
Ruby files that contain _resource definitions_
|
218
|
+
* COOKBOOK/files/SPECIFICITY:
|
219
|
+
Files of arbitrary type. These files may be downloaded by
|
220
|
+
chef-client(8) when configuring a host.
|
221
|
+
* COOKBOOK/libraries/:
|
222
|
+
Ruby files that contain library code needed for recipes
|
223
|
+
* COOKBOOK/providers/:
|
224
|
+
Ruby files that contain Lightweight Provider definitions
|
225
|
+
* COOKBOOK/recipes/:
|
226
|
+
Ruby files that use Chef's recipe DSL to describe the desired
|
227
|
+
configuration of a system
|
228
|
+
* COOKBOOK/resources/:
|
229
|
+
Ruby files that contain Lightweight Resource definitions
|
230
|
+
* COOKBOOK/templates/SPECIFICITY:
|
231
|
+
ERuby (ERb) template files. These are referenced by _recipes_ and
|
232
|
+
evaluated to dynamically generate configuration files.
|
233
|
+
|
234
|
+
__SPECIFICITY__ is a feature of _files_ and _templates_ that allow you
|
235
|
+
to specify alternate files to be used on a specific OS platform or host.
|
236
|
+
The default specificity setting is _default_, that is files in
|
237
|
+
`COOKBOOK/files/default` will be used when a more specific copy is not
|
238
|
+
available. Further documentation for this feature is available on the
|
239
|
+
Chef wiki: <http://wiki.opscode.com/display/chef/File+Distribution#FileDistribution-FileSpecificity>
|
240
|
+
|
241
|
+
Cookbooks also contain a metadata file that defines various properties
|
242
|
+
of the cookbook. The most important of these are the _version_ and the
|
243
|
+
_dependencies_. The _version_ is used in combination with environments
|
244
|
+
to select which copy of a given cookbook is distributed to a node. The
|
245
|
+
_dependencies_ are used by the server to determine which additional
|
246
|
+
cookbooks must be distributed to a given host when it requires a
|
247
|
+
cookbook.
|
248
|
+
|
249
|
+
## SEE ALSO
|
250
|
+
__knife-environment(1)__ __knife-cookbook-site(1)__
|
251
|
+
<http://wiki.opscode.com/display/chef/Cookbooks>
|
252
|
+
<http://wiki.opscode.com/display/chef/Metadata>
|
253
|
+
|
254
|
+
## AUTHOR
|
255
|
+
Chef was written by Adam Jacob <adam@opscode.com> with many contributions from the community.
|
256
|
+
|
257
|
+
## DOCUMENTATION
|
258
|
+
This manual page was written by Joshua Timberman <joshua@opscode.com>.
|
259
|
+
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
|
260
|
+
|
261
|
+
|
262
|
+
## CHEF
|
263
|
+
Knife is distributed with Chef. <http://wiki.opscode.com/display/chef/Home>
|