runa-chef 0.8.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (216) hide show
  1. data/LICENSE +201 -0
  2. data/README.rdoc +136 -0
  3. data/bin/chef-client +26 -0
  4. data/bin/chef-solo +26 -0
  5. data/bin/knife +27 -0
  6. data/bin/shef +45 -0
  7. data/distro/README +2 -0
  8. data/distro/common/man/man1/chef-indexer.1 +42 -0
  9. data/distro/common/man/man1/chef-server.1 +108 -0
  10. data/distro/common/man/man8/chef-client.8 +61 -0
  11. data/distro/common/man/man8/chef-solo.8 +58 -0
  12. data/distro/common/man/man8/knife.8 +359 -0
  13. data/distro/debian/etc/init.d/chef-client +175 -0
  14. data/distro/debian/etc/init.d/chef-indexer +175 -0
  15. data/distro/debian/etc/init.d/chef-server +120 -0
  16. data/distro/redhat/etc/init.d/chef-client +78 -0
  17. data/distro/redhat/etc/init.d/chef-indexer +76 -0
  18. data/distro/redhat/etc/init.d/chef-server +78 -0
  19. data/distro/redhat/etc/sysconfig/chef-client +10 -0
  20. data/distro/redhat/etc/sysconfig/chef-indexer +8 -0
  21. data/distro/redhat/etc/sysconfig/chef-server +10 -0
  22. data/distro/suse/etc/init.d/chef-client +121 -0
  23. data/lib/chef.rb +49 -0
  24. data/lib/chef/api_client.rb +269 -0
  25. data/lib/chef/application.rb +98 -0
  26. data/lib/chef/application/agent.rb +18 -0
  27. data/lib/chef/application/client.rb +214 -0
  28. data/lib/chef/application/knife.rb +138 -0
  29. data/lib/chef/application/server.rb +19 -0
  30. data/lib/chef/application/solo.rb +214 -0
  31. data/lib/chef/cache.rb +61 -0
  32. data/lib/chef/cache/checksum.rb +70 -0
  33. data/lib/chef/certificate.rb +154 -0
  34. data/lib/chef/client.rb +323 -0
  35. data/lib/chef/compile.rb +158 -0
  36. data/lib/chef/config.rb +195 -0
  37. data/lib/chef/cookbook.rb +198 -0
  38. data/lib/chef/cookbook/metadata.rb +487 -0
  39. data/lib/chef/cookbook/metadata/version.rb +87 -0
  40. data/lib/chef/cookbook_loader.rb +180 -0
  41. data/lib/chef/couchdb.rb +273 -0
  42. data/lib/chef/daemon.rb +170 -0
  43. data/lib/chef/data_bag.rb +216 -0
  44. data/lib/chef/data_bag_item.rb +227 -0
  45. data/lib/chef/exceptions.rb +39 -0
  46. data/lib/chef/file_cache.rb +205 -0
  47. data/lib/chef/knife.rb +300 -0
  48. data/lib/chef/knife/client_bulk_delete.rb +41 -0
  49. data/lib/chef/knife/client_create.rb +55 -0
  50. data/lib/chef/knife/client_delete.rb +37 -0
  51. data/lib/chef/knife/client_edit.rb +37 -0
  52. data/lib/chef/knife/client_list.rb +40 -0
  53. data/lib/chef/knife/client_reregister.rb +48 -0
  54. data/lib/chef/knife/client_show.rb +42 -0
  55. data/lib/chef/knife/configure.rb +84 -0
  56. data/lib/chef/knife/cookbook_bulk_delete.rb +47 -0
  57. data/lib/chef/knife/cookbook_delete.rb +41 -0
  58. data/lib/chef/knife/cookbook_download.rb +57 -0
  59. data/lib/chef/knife/cookbook_list.rb +41 -0
  60. data/lib/chef/knife/cookbook_metadata.rb +87 -0
  61. data/lib/chef/knife/cookbook_show.rb +75 -0
  62. data/lib/chef/knife/cookbook_upload.rb +173 -0
  63. data/lib/chef/knife/data_bag_create.rb +43 -0
  64. data/lib/chef/knife/data_bag_delete.rb +43 -0
  65. data/lib/chef/knife/data_bag_edit.rb +49 -0
  66. data/lib/chef/knife/data_bag_list.rb +42 -0
  67. data/lib/chef/knife/data_bag_show.rb +40 -0
  68. data/lib/chef/knife/ec2_instance_data.rb +46 -0
  69. data/lib/chef/knife/node_bulk_delete.rb +44 -0
  70. data/lib/chef/knife/node_create.rb +39 -0
  71. data/lib/chef/knife/node_delete.rb +36 -0
  72. data/lib/chef/knife/node_edit.rb +36 -0
  73. data/lib/chef/knife/node_from_file.rb +42 -0
  74. data/lib/chef/knife/node_list.rb +41 -0
  75. data/lib/chef/knife/node_run_list_add.rb +64 -0
  76. data/lib/chef/knife/node_run_list_remove.rb +45 -0
  77. data/lib/chef/knife/node_show.rb +46 -0
  78. data/lib/chef/knife/role_bulk_delete.rb +45 -0
  79. data/lib/chef/knife/role_create.rb +44 -0
  80. data/lib/chef/knife/role_delete.rb +36 -0
  81. data/lib/chef/knife/role_edit.rb +37 -0
  82. data/lib/chef/knife/role_from_file.rb +46 -0
  83. data/lib/chef/knife/role_list.rb +40 -0
  84. data/lib/chef/knife/role_show.rb +43 -0
  85. data/lib/chef/knife/search.rb +94 -0
  86. data/lib/chef/log.rb +39 -0
  87. data/lib/chef/mixin/check_helper.rb +31 -0
  88. data/lib/chef/mixin/checksum.rb +32 -0
  89. data/lib/chef/mixin/command.rb +390 -0
  90. data/lib/chef/mixin/convert_to_class_name.rb +57 -0
  91. data/lib/chef/mixin/create_path.rb +56 -0
  92. data/lib/chef/mixin/deep_merge.rb +33 -0
  93. data/lib/chef/mixin/find_preferred_file.rb +92 -0
  94. data/lib/chef/mixin/from_file.rb +50 -0
  95. data/lib/chef/mixin/generate_url.rb +58 -0
  96. data/lib/chef/mixin/language.rb +107 -0
  97. data/lib/chef/mixin/language_include_attribute.rb +56 -0
  98. data/lib/chef/mixin/language_include_recipe.rb +53 -0
  99. data/lib/chef/mixin/params_validate.rb +197 -0
  100. data/lib/chef/mixin/recipe_definition_dsl_core.rb +79 -0
  101. data/lib/chef/mixin/template.rb +94 -0
  102. data/lib/chef/nanite.rb +100 -0
  103. data/lib/chef/node.rb +463 -0
  104. data/lib/chef/node/attribute.rb +412 -0
  105. data/lib/chef/openid_registration.rb +181 -0
  106. data/lib/chef/platform.rb +268 -0
  107. data/lib/chef/provider.rb +101 -0
  108. data/lib/chef/provider/breakpoint.rb +36 -0
  109. data/lib/chef/provider/cron.rb +184 -0
  110. data/lib/chef/provider/deploy.rb +314 -0
  111. data/lib/chef/provider/deploy/revision.rb +70 -0
  112. data/lib/chef/provider/deploy/timestamped.rb +33 -0
  113. data/lib/chef/provider/directory.rb +72 -0
  114. data/lib/chef/provider/erl_call.rb +72 -0
  115. data/lib/chef/provider/execute.rb +58 -0
  116. data/lib/chef/provider/file.rb +195 -0
  117. data/lib/chef/provider/git.rb +203 -0
  118. data/lib/chef/provider/group.rb +120 -0
  119. data/lib/chef/provider/group/dscl.rb +128 -0
  120. data/lib/chef/provider/group/gpasswd.rb +50 -0
  121. data/lib/chef/provider/group/groupadd.rb +78 -0
  122. data/lib/chef/provider/group/pw.rb +88 -0
  123. data/lib/chef/provider/group/usermod.rb +57 -0
  124. data/lib/chef/provider/http_request.rb +106 -0
  125. data/lib/chef/provider/ifconfig.rb +131 -0
  126. data/lib/chef/provider/link.rb +157 -0
  127. data/lib/chef/provider/mdadm.rb +88 -0
  128. data/lib/chef/provider/mount.rb +117 -0
  129. data/lib/chef/provider/mount/mount.rb +208 -0
  130. data/lib/chef/provider/package.rb +160 -0
  131. data/lib/chef/provider/package/apt.rb +110 -0
  132. data/lib/chef/provider/package/dpkg.rb +109 -0
  133. data/lib/chef/provider/package/easy_install.rb +106 -0
  134. data/lib/chef/provider/package/freebsd.rb +153 -0
  135. data/lib/chef/provider/package/macports.rb +105 -0
  136. data/lib/chef/provider/package/portage.rb +124 -0
  137. data/lib/chef/provider/package/rpm.rb +99 -0
  138. data/lib/chef/provider/package/rubygems.rb +136 -0
  139. data/lib/chef/provider/package/yum-dump.py +125 -0
  140. data/lib/chef/provider/package/yum.rb +175 -0
  141. data/lib/chef/provider/package/zypper.rb +132 -0
  142. data/lib/chef/provider/remote_directory.rb +126 -0
  143. data/lib/chef/provider/remote_file.rb +141 -0
  144. data/lib/chef/provider/route.rb +118 -0
  145. data/lib/chef/provider/ruby_block.rb +33 -0
  146. data/lib/chef/provider/script.rb +42 -0
  147. data/lib/chef/provider/service.rb +135 -0
  148. data/lib/chef/provider/service/debian.rb +64 -0
  149. data/lib/chef/provider/service/freebsd.rb +156 -0
  150. data/lib/chef/provider/service/gentoo.rb +54 -0
  151. data/lib/chef/provider/service/init.rb +71 -0
  152. data/lib/chef/provider/service/redhat.rb +62 -0
  153. data/lib/chef/provider/service/simple.rb +114 -0
  154. data/lib/chef/provider/subversion.rb +156 -0
  155. data/lib/chef/provider/template.rb +175 -0
  156. data/lib/chef/provider/user.rb +170 -0
  157. data/lib/chef/provider/user/dscl.rb +280 -0
  158. data/lib/chef/provider/user/pw.rb +113 -0
  159. data/lib/chef/provider/user/useradd.rb +108 -0
  160. data/lib/chef/recipe.rb +105 -0
  161. data/lib/chef/resource.rb +380 -0
  162. data/lib/chef/resource/apt_package.rb +34 -0
  163. data/lib/chef/resource/bash.rb +33 -0
  164. data/lib/chef/resource/breakpoint.rb +35 -0
  165. data/lib/chef/resource/cron.rb +179 -0
  166. data/lib/chef/resource/csh.rb +33 -0
  167. data/lib/chef/resource/deploy.rb +359 -0
  168. data/lib/chef/resource/deploy_revision.rb +35 -0
  169. data/lib/chef/resource/directory.rb +76 -0
  170. data/lib/chef/resource/dpkg_package.rb +34 -0
  171. data/lib/chef/resource/easy_install_package.rb +41 -0
  172. data/lib/chef/resource/erl_call.rb +83 -0
  173. data/lib/chef/resource/execute.rb +127 -0
  174. data/lib/chef/resource/file.rb +84 -0
  175. data/lib/chef/resource/gem_package.rb +41 -0
  176. data/lib/chef/resource/git.rb +36 -0
  177. data/lib/chef/resource/group.rb +70 -0
  178. data/lib/chef/resource/http_request.rb +52 -0
  179. data/lib/chef/resource/ifconfig.rb +134 -0
  180. data/lib/chef/resource/link.rb +78 -0
  181. data/lib/chef/resource/macports_package.rb +29 -0
  182. data/lib/chef/resource/mdadm.rb +82 -0
  183. data/lib/chef/resource/mount.rb +135 -0
  184. data/lib/chef/resource/package.rb +80 -0
  185. data/lib/chef/resource/perl.rb +33 -0
  186. data/lib/chef/resource/portage_package.rb +33 -0
  187. data/lib/chef/resource/python.rb +33 -0
  188. data/lib/chef/resource/remote_directory.rb +91 -0
  189. data/lib/chef/resource/remote_file.rb +60 -0
  190. data/lib/chef/resource/route.rb +135 -0
  191. data/lib/chef/resource/ruby.rb +33 -0
  192. data/lib/chef/resource/ruby_block.rb +39 -0
  193. data/lib/chef/resource/scm.rb +137 -0
  194. data/lib/chef/resource/script.rb +51 -0
  195. data/lib/chef/resource/service.rb +134 -0
  196. data/lib/chef/resource/subversion.rb +34 -0
  197. data/lib/chef/resource/template.rb +60 -0
  198. data/lib/chef/resource/timestamped_deploy.rb +31 -0
  199. data/lib/chef/resource/user.rb +101 -0
  200. data/lib/chef/resource_collection.rb +212 -0
  201. data/lib/chef/resource_collection/stepable_iterator.rb +124 -0
  202. data/lib/chef/resource_definition.rb +67 -0
  203. data/lib/chef/rest.rb +298 -0
  204. data/lib/chef/role.rb +301 -0
  205. data/lib/chef/run_list.rb +164 -0
  206. data/lib/chef/runner.rb +130 -0
  207. data/lib/chef/search/query.rb +71 -0
  208. data/lib/chef/shef.rb +220 -0
  209. data/lib/chef/shef/ext.rb +297 -0
  210. data/lib/chef/shef/shef_session.rb +175 -0
  211. data/lib/chef/streaming_cookbook_uploader.rb +185 -0
  212. data/lib/chef/tasks/chef_repo.rake +245 -0
  213. data/lib/chef/util/file_edit.rb +125 -0
  214. data/lib/chef/util/fileedit.rb +121 -0
  215. data/lib/chef/webui_user.rb +231 -0
  216. metadata +398 -0
@@ -0,0 +1,2 @@
1
+ Init scripts meant to be used with a gem installation via the bootstrap
2
+ cookbook.
@@ -0,0 +1,42 @@
1
+ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36.
2
+ .TH CHEF-INDEXER: "1" "August 2009" "chef-indexer 0.7.8" "User Commands"
3
+ .SH NAME
4
+ chef-indexer: \- Runs the search index process.
5
+ .SH SYNOPSIS
6
+ .B chef-indexer
7
+ \fI(options)\fR
8
+ .SH DESCRIPTION
9
+ .TP
10
+ chef-indexer requires that the stompserver be started but at this time the stompserver package does not install a startup script, let alone start the daemon. I am working with the package maintainer for stompserver to include a startup script.
11
+ \fB\-c\fR, \fB\-\-config\fR CONFIG
12
+ The configuration file to use
13
+ .TP
14
+ \fB\-d\fR, \fB\-\-daemonize\fR
15
+ Daemonize the process
16
+ .TP
17
+ \fB\-g\fR, \fB\-\-group\fR GROUP
18
+ Group to change gid to before daemonizing
19
+ .TP
20
+ \fB\-l\fR, \fB\-\-log_level\fR LEVEL
21
+ Set the log level (debug, info, warn, error, fatal)
22
+ .TP
23
+ \fB\-L\fR, \fB\-\-logfile\fR LOGLOCATION
24
+ Set the log file location, defaults to STDOUT \- recommended for daemonizing
25
+ .TP
26
+ \fB\-u\fR, \fB\-\-user\fR USER
27
+ User to change uid to before daemonizing
28
+ .TP
29
+ \fB\-v\fR, \fB\-\-version\fR
30
+ Show chef version
31
+ .TP
32
+ \fB\-h\fR, \fB\-\-help\fR
33
+ Show this message
34
+ .SH "SEE ALSO"
35
+ Full documentation for Chef and chef-indexer is located on the Chef wiki, http://wiki.opscode.com/display/chef/Home.
36
+ .SH AUTHOR
37
+ Chef was written by Adam Jacob <adam@ospcode.com> of Opscode (http://www.opscode.com), with contributions from the community.
38
+ This manual page was written by Joshua Timberman <joshua@opscode.com> with help2man. Permission is granted
39
+ to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
40
+
41
+ On Debian systems, the complete text of the Apache 2.0 License can be found in
42
+ /usr/share/common-licenses/Apache-2.0.
@@ -0,0 +1,108 @@
1
+ .\" DO NOT MODIFY THIS FILE! It was generated by help2man.
2
+ .TH CHEF-SERVER "1" "August 2009" "chef-server" "User Commands"
3
+ .SH NAME
4
+ chef-server \- Start the Chef Server merb application slice.
5
+ .SH SYNOPSIS
6
+ .B chef-server
7
+ [\fIuGdcIpPhmailLerkKX\fR] [\fIargument\fR]
8
+ .SH DESCRIPTION
9
+ The Chef Server is a Merb application slice. Both chef-server and chef-server-slice packages should be installed. This man page was generated for merb and generated for chef-server.
10
+ The default listen port is 4000. At a minimum, chef-server should be started with \-c2 so one process starts for the webui (4000) and one process starts for openid (4001).
11
+ .TP
12
+ \fB\-u\fR, \fB\-\-user\fR USER
13
+ This flag is for having chef-server run as a user other than the one currently logged in. Note: if you set this you must also provide a \fB\-\-group\fR option for it to take effect.
14
+ .TP
15
+ \fB\-G\fR, \fB\-\-group\fR GROUP
16
+ This flag is for having chef-server run as a group other than the one currently logged in. Note: if you set this you must also provide a \fB\-\-user\fR option for it to take effect.
17
+ .TP
18
+ \fB\-d\fR, \fB\-\-daemonize\fR
19
+ This will run a single chef-server in the background.
20
+ .TP
21
+ \fB\-N\fR, \fB\-\-no\-daemonize\fR
22
+ This will allow you to run a cluster in console mode
23
+ .TP
24
+ \fB\-c\fR, \fB\-\-cluster\-nodes\fR NUM_MERBS
25
+ Number of merb daemons to run for chef-server. At least 2 are required to run, the second is for openid (runs on port 4001).
26
+ .TP
27
+ \fB\-I\fR, \fB\-\-init\-file\fR FILE
28
+ File to use for initialization on load, defaults to config/init.rb
29
+ .TP
30
+ \fB\-p\fR, \fB\-\-port\fR PORTNUM
31
+ Port to run chef-server on, defaults to 4000. Additional nodes (\-c) listen on incrementing port numbers.
32
+ .TP
33
+ \fB\-o\fR, \fB\-\-socket\-file\fR FILE
34
+ Socket file to run chef-server on, defaults to [Merb.root]/log/merb.sock. This is for web servers, like thin, that use sockets.Specify this *only* if you *must*.
35
+ .TP
36
+ \fB\-s\fR, \fB\-\-socket\fR SOCKNUM
37
+ Socket number to run chef-server on, defaults to 0.
38
+ .TP
39
+ \fB\-n\fR, \fB\-\-name\fR NAME
40
+ Set the name of the application. This is used in the process title and log file names.
41
+ .TP
42
+ \fB\-P\fR, \fB\-\-pid\fR PIDFILE
43
+ PID file, defaults to [Merb.root]/log/merb.main.pid for the master process and[Merb.root]/log/merb.[port number].pid for worker processes. For clusters, use %s to specify where in the file chef-server should place the port number. For instance: \fB\-P\fR myapp.%s.pid
44
+ .TP
45
+ \fB\-h\fR, \fB\-\-host\fR HOSTNAME
46
+ Host to bind to (default is 0.0.0.0).
47
+ .HP
48
+ \fB\-m\fR, \fB\-\-merb\-root\fR /path/to/approot The path to the Merb.root for the app you want to run (default is current working directory).
49
+ .TP
50
+ \fB\-a\fR, \fB\-\-adapter\fR ADAPTER
51
+ The rack adapter to use to run chef-server (default is mongrel)[mongrel, emongrel, thin, ebb, fastcgi, webrick]
52
+ .TP
53
+ \fB\-R\fR, \fB\-\-rackup\fR FILE
54
+ Load an alternate Rack config file (default is config/rack.rb)
55
+ .TP
56
+ \fB\-i\fR, \fB\-\-irb\-console\fR
57
+ This flag will start chef-server in irb console mode. All your models and other classes will be available for you in an irb session.
58
+ .TP
59
+ \fB\-S\fR, \fB\-\-sandbox\fR
60
+ This flag will enable a sandboxed irb console. If your ORM supports transactions, all edits will be rolled back on exit.
61
+ .TP
62
+ \fB\-l\fR, \fB\-\-log\-level\fR LEVEL
63
+ Log levels can be set to any of these options: debug < info < warn < error < fatal (default is info)
64
+ .TP
65
+ \fB\-L\fR, \fB\-\-log\fR LOGFILE
66
+ A string representing the logfile to use. Defaults to [Merb.root]/log/merb.[main].log for the master process and [Merb.root]/log/merb[port number].logfor worker processes
67
+ .TP
68
+ \fB\-e\fR, \fB\-\-environment\fR STRING
69
+ Environment to run Merb under [development, production, testing] (default is development)
70
+ .HP
71
+ \fB\-r\fR ['RUBY CODE'| FULL_SCRIPT_PATH]
72
+ .TP
73
+ \fB\-\-script\-runner\fR
74
+ Command\-line option to run scripts and/or code in the chef-server app.
75
+ .TP
76
+ \fB\-K\fR, \fB\-\-graceful\fR PORT or all
77
+ Gracefully kill chef-server proceses by port number. Use chef-server \fB\-K\fR all to gracefully kill all merbs.
78
+ .TP
79
+ \fB\-k\fR, \fB\-\-kill\fR PORT
80
+ Force kill one merb worker by port number. This will cause the worker tobe respawned.
81
+ .TP
82
+ \fB\-\-fast\-deploy\fR
83
+ Reload the code, but not yourinit.rb or gems
84
+ .TP
85
+ \fB\-X\fR, \fB\-\-mutex\fR on/off
86
+ This flag is for turning the mutex lock on and off.
87
+ .TP
88
+ \fB\-D\fR, \fB\-\-debugger\fR
89
+ Run chef-server using rDebug.
90
+ .TP
91
+ \fB\-V\fR, \fB\-\-verbose\fR
92
+ Print extra information
93
+ .TP
94
+ \fB\-C\fR, \fB\-\-console\-trap\fR
95
+ Enter an irb console on ^C
96
+ .TP
97
+ \-?, \fB\-H\fR, \fB\-\-help\fR
98
+ Show this help message
99
+ .SH "SEE ALSO"
100
+ Full documentation for Chef and chef-server is located on the Chef wiki, http://wiki.opscode.com/display/chef/Home.
101
+ .SH AUTHOR
102
+ Chef was written by Adam Jacob <adam@ospcode.com> of Opscode (http://www.opscode.com), with contributions from the community.
103
+ This manual page was written by Joshua Timberman <joshua@opscode.com> with help2man
104
+ for the Debian project (but may be used by others).. Permission is granted
105
+ to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
106
+
107
+ On Debian systems, the complete text of the Apache 2.0 License can be found in
108
+ /usr/share/common-licenses/Apache-2.0.
@@ -0,0 +1,61 @@
1
+ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36.
2
+ .TH CHEF-CLIENT: "8" "August 2009" "chef-client 0.7.8" "System Administration Utilities"
3
+ .SH NAME
4
+ chef-client: \- Runs a client node connecting to a chef-server.
5
+ .SH SYNOPSIS
6
+ .B chef-client
7
+ \fI(options)\fR
8
+ .SH DESCRIPTION
9
+ .TP
10
+ \fB\-S\fR, \fB\-\-server\fR CHEFSERVERURL
11
+ The chef server URL
12
+ .TP
13
+ \fB\-c\fR, \fB\-\-config\fR CONFIG
14
+ The configuration file to use
15
+ .TP
16
+ \fB\-d\fR, \fB\-\-daemonize\fR
17
+ Daemonize the process
18
+ .TP
19
+ \fB\-g\fR, \fB\-\-group\fR GROUP
20
+ Group to set privilege to
21
+ .TP
22
+ \fB\-i\fR, \fB\-\-interval\fR SECONDS
23
+ Run chef\-client periodically, in seconds
24
+ .TP
25
+ \fB\-j\fR JSON_ATTRIBS
26
+ Load attributes from a JSON file or URL
27
+ .HP
28
+ \fB\-\-json\-attributes\fR
29
+ .TP
30
+ \fB\-l\fR, \fB\-\-log_level\fR LEVEL
31
+ Set the log level (debug, info, warn, error, fatal)
32
+ .TP
33
+ \fB\-L\fR, \fB\-\-logfile\fR LOGLOCATION
34
+ Set the log file location, defaults to STDOUT \- recommended for daemonizing
35
+ .TP
36
+ \fB\-N\fR, \fB\-\-node\-name\fR NODE_NAME
37
+ The node name for this client
38
+ .TP
39
+ \fB\-s\fR, \fB\-\-splay\fR SECONDS
40
+ The splay time for running at intervals, in seconds
41
+ .TP
42
+ \fB\-u\fR, \fB\-\-user\fR USER
43
+ User to set privilege to
44
+ .TP
45
+ \fB\-t\fR, \fB\-\-token\fR TOKEN
46
+ Set the openid validation token
47
+ .TP
48
+ \fB\-v\fR, \fB\-\-version\fR
49
+ Show chef version
50
+ .TP
51
+ \fB\-h\fR, \fB\-\-help\fR
52
+ Show this message
53
+ .SH "SEE ALSO"
54
+ Full documentation for Chef and chef-client is located on the Chef wiki, http://wiki.opscode.com/display/chef/Home.
55
+ .SH AUTHOR
56
+ Chef was written by Adam Jacob <adam@ospcode.com> of Opscode (http://www.opscode.com), with contributions from the community.
57
+ This manual page was written by Joshua Timberman <joshua@opscode.com> with help2man. Permission is granted
58
+ to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
59
+
60
+ On Debian systems, the complete text of the Apache 2.0 License can be found in
61
+ /usr/share/common-licenses/Apache-2.0.
@@ -0,0 +1,58 @@
1
+ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.36.
2
+ .TH CHEF-SOLO: "8" "August 2009" "chef-solo 0.7.8" "System Administration Utilities"
3
+ .SH NAME
4
+ chef-solo: \- Runs chef in solo mode against a specified cookbook location.
5
+ .SH SYNOPSIS
6
+ .B chef-solo
7
+ \fI(options)\fR
8
+ .SH DESCRIPTION
9
+ .TP
10
+ \fB\-c\fR, \fB\-\-config\fR CONFIG
11
+ The configuration file to use
12
+ .TP
13
+ \fB\-d\fR, \fB\-\-daemonize\fR
14
+ Daemonize the process
15
+ .TP
16
+ \fB\-g\fR, \fB\-\-group\fR GROUP
17
+ Group to set privilege to
18
+ .TP
19
+ \fB\-i\fR, \fB\-\-interval\fR SECONDS
20
+ Run chef\-client periodically, in seconds
21
+ .TP
22
+ \fB\-j\fR JSON_ATTRIBS
23
+ Load attributes from a JSON file or URL
24
+ .HP
25
+ \fB\-\-json\-attributes\fR
26
+ .TP
27
+ \fB\-l\fR, \fB\-\-log_level\fR LEVEL
28
+ Set the log level (debug, info, warn, error, fatal)
29
+ .TP
30
+ \fB\-L\fR, \fB\-\-logfile\fR LOGLOCATION
31
+ Set the log file location, defaults to STDOUT
32
+ .TP
33
+ \fB\-N\fR, \fB\-\-node\-name\fR NODE_NAME
34
+ The node name for this client
35
+ .TP
36
+ \fB\-r\fR, \fB\-\-recipe\-url\fR RECIPE_URL
37
+ Pull down a remote gzipped tarball of recipes and untar it to the cookbook cache.
38
+ .TP
39
+ \fB\-s\fR, \fB\-\-splay\fR SECONDS
40
+ The splay time for running at intervals, in seconds
41
+ .TP
42
+ \fB\-u\fR, \fB\-\-user\fR USER
43
+ User to set privilege to
44
+ .TP
45
+ \fB\-v\fR, \fB\-\-version\fR
46
+ Show chef version
47
+ .TP
48
+ \fB\-h\fR, \fB\-\-help\fR
49
+ Show this message
50
+ .SH "SEE ALSO"
51
+ Full documentation for Chef and chef-solo is located on the Chef wiki, http://wiki.opscode.com/display/chef/Home.
52
+ .SH AUTHOR
53
+ Chef was written by Adam Jacob <adam@ospcode.com> of Opscode (http://www.opscode.com), with contributions from the community.
54
+ This manual page was written by Joshua Timberman <joshua@opscode.com> with help2man. Permission is granted
55
+ to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
56
+
57
+ On Debian systems, the complete text of the Apache 2.0 License can be found in
58
+ /usr/share/common-licenses/Apache-2.0.
@@ -0,0 +1,359 @@
1
+ .TH CHEF: "1" "December 2009" "knife: 0.8.0" "System Administration Utilities"
2
+ .SH NAME
3
+ knife: \- Chef server REST API utility
4
+ .SH SYNOPSIS
5
+ .B knife
6
+ \fIsub-command (options)\fR
7
+ .SH DESCRIPTION
8
+ .TP
9
+ This manual page documents knife, a command-line utility used to interact with a Chef server directly through the RESTful API. Knife uses sub-commands to take various actions on different types of Chef objects. Some sub-commands take additional options. General options follow sub-commands and their options. A configuration file can be created for common defaults.
10
+ .TP
11
+ Unless otherwise specified, output is in JSON format, and input files are also JSON format.
12
+ .SH GENERAL OPTIONS
13
+ .TP
14
+ \fB\-s\fR, \fB\-\-server\-url\fR URL
15
+ Chef Server URL
16
+ .TP
17
+ \fB\-k\fR, \fB\-\-key\fR KEY
18
+ API Client Key
19
+ .TP
20
+ \fB\-c\fR, \fB\-\-config\fR CONFIG
21
+ The configuration file to use
22
+ .TP
23
+ \fB\-e\fR, \fB\-\-editor\fR EDITOR
24
+ Set the editor to use for interactive commands
25
+ .TP
26
+ \fB\-l\fR, \fB\-\-log_level\fR LEVEL
27
+ Set the log level (debug, info, warn, error, fatal)
28
+ .TP
29
+ \fB\-L\fR, \fB\-\-logfile\fR LOGLOCATION
30
+ Set the log file location, defaults to STDOUT
31
+ .TP
32
+ \fB\-u\fR, \fB\-\-user\fR USER
33
+ API Client Username
34
+ .TP
35
+ \fB\-p\fR, \fB\-\-print\-after\fR
36
+ Show the data after a destructive operation
37
+ .TP
38
+ \fB\-v\fR, \fB\-\-version\fR
39
+ Show chef version
40
+ .TP
41
+ \fB\-y\fR, \fB\-\-yes\fR
42
+ Say yes to all prompts for confirmation
43
+ .TP
44
+ \fB\-h\fR, \fB\-\-help\fR
45
+ Show usage information.
46
+ .SH SUB-COMMANDS
47
+ Knife sub-commands are structured as "NOUN verb NOUN (options)". The sub-commands are meant to be intuitively named.
48
+ .SH CLIENT SUB-COMMANDS
49
+ .TP
50
+ Sub-commands related to working with clients, which are registered entities that access the Chef server.
51
+ .TP
52
+ .B client bulk delete \fI(options)\fR
53
+ .TP
54
+ \fB\-r\fR, \fB\-\-regex\fR [REGEX]
55
+ Narrow the operation via regular expression
56
+ .PP
57
+ Delete all the clients on the Chef server, or only certain clients based on a regular expression.
58
+ .PP
59
+ .B client create CLIENT (options)
60
+ .TP
61
+ \fB\-f\fR, \fB\-\-file\fR FILE
62
+ Write the key to a file
63
+ .PP
64
+ Create a new client.
65
+ .PP
66
+ .B client delete CLIENT (options)
67
+ .PP
68
+ Deletes a registered client.
69
+ .PP
70
+ .B client edit CLIENT (options)
71
+ .PP
72
+ Edit a registered client.
73
+ .PP
74
+ .B client list (options)
75
+ .TP
76
+ \fB\-w\fR, \fB\-\-with\-uri\fR
77
+ Show corresponding URIs
78
+ .PP
79
+ List all registered clients.
80
+ .PP
81
+ .B client reregister CLIENT (options)
82
+ .TP
83
+ \fB\-f\fR, \fB\-\-file\fR FILE
84
+ Write the key to a file
85
+ .PP
86
+ Regenerate the private key for a client.
87
+ .PP
88
+ .B client show CLIENT (options)
89
+ .TP
90
+ \fB\-a\fR, \fB\-\-attribute\fR [ATTR]
91
+ Show only one attribute
92
+ .PP
93
+ Show a client.
94
+ .SH COOKBOOK SUB-COMMANDS
95
+ .TP
96
+ Cookbooks are the fundamental unit of distribution in Chef. They encapsulate all the recipes of resources and the assets used to configure a particular aspect of the infrastructure.
97
+ .PP
98
+ .B cookbook bulk delete COOKBOOK (options)
99
+ .TP
100
+ \fB\-r\fR, \fB\-\-regex\fR [REGEX]
101
+ Narrow the operation via regular expression
102
+ .PP
103
+ Delete all the cookbooks on the Chef server, or use a regular expression to only delete certain cookbooks.
104
+ .PP
105
+ .B cookbook delete COOKBOOK (options)
106
+ .PP
107
+ Delete a single named COOKBOOK.
108
+ .PP
109
+ .B cookbook download COOKBOOK (options)
110
+ .TP
111
+ \fB\-f\fR, \fB\-\-file\fR FILE
112
+ The filename to write to
113
+ .PP
114
+ Download a cookbook from the server as a gzip(1)'ed, tar(1) archive.
115
+ .PP
116
+ .B cookbook list (options)
117
+ .TP
118
+ \fB\-w\fR, \fB\-\-with\-uri\fR
119
+ Show corresponding URIs
120
+ .PP
121
+ List all cookbooks.
122
+ .PP
123
+ .B cookbook metadata COOKBOOK (options)
124
+ .TP
125
+ \fB\-a\fR, \fB\-\-all\fR
126
+ Generate metadata for all cookbooks, rather than just a single cookbook
127
+ .PP
128
+ Generate cookbook metadata for the named COOKBOOK.
129
+ .TP
130
+ \fB\-o\fR, \fB\-\-cookbook\-path\fR PATH:PATH
131
+ A colon\-separated path to look for cookbooks in
132
+ .PP
133
+ .B cookbook show COOKBOOK [PART] [FILENAME] (options)
134
+ .TP
135
+ \fB\-f\fR, \fB\-\-fqdn\fR FQDN
136
+ The FQDN of the host to see the file for
137
+ .TP
138
+ \fB\-p\fR, \fB\-\-platform\fR PLATFORM
139
+ The platform to see the file for
140
+ .TP
141
+ \fB\-V\fR, \fB\-\-platform\-version\fR VERSION
142
+ The platform version to see the file for
143
+ .PP
144
+ Show the particular part of a COOKBOOK. PART can be one of:
145
+ .TP
146
+ \fIattribute definition file provider recipe resource template\fR
147
+ .PP
148
+ .B cookbook upload COOKBOOK (options)
149
+ .TP
150
+ \fB\-a\fR, \fB\-\-all\fR
151
+ Upload all cookbooks, rather than just a single cookbook
152
+ .TP
153
+ \fB\-o\fR, \fB\-\-cookbook\-path\fR PATH:PATH
154
+ A colon\-separated path to look for cookbooks in
155
+ .PP
156
+ Upload a cookbook to the server.
157
+ .SH DATA BAG SUB-COMMANDS
158
+ .PP
159
+ Data bags are stores of JSON blobs. These blobs are called items. They are free form and indexed by the search mechanism on the Chef server.
160
+ .PP
161
+ .B data bag create BAG [ITEM] (options)
162
+ .PP
163
+ Create a new data bag, or item in a data bag.
164
+ .PP
165
+ .B data bag delete BAG [ITEM] (options)
166
+ .PP
167
+ Delete a data bag, or item from a data bag.
168
+ .PP
169
+ .B data bag edit BAG ITEM (options)
170
+ .PP
171
+ Edit an item in a data bag.
172
+ .PP
173
+ .B data bag list (options)
174
+ .TP
175
+ \fB\-w\fR, \fB\-\-with\-uri\fR
176
+ Show corresponding URIs
177
+ .PP
178
+ List the available data bags.
179
+ .PP
180
+ .B data bag show BAG [ITEM] (options)
181
+ .PP
182
+ Show a specific data bag or an item in a data bag.
183
+ .SH NODE SUB-COMMANDS
184
+ .PP
185
+ Nodes are the entities which are configured with Chef, typically servers or workstations. Nodes are registered as a client, typcially of the same name, but a single client might represent one or more nodes.
186
+ .PP
187
+ .B node bulk delete (options)
188
+ .TP
189
+ \fB\-r\fR, \fB\-\-regex\fR [REGEX]
190
+ Narrow the operation via regular expression
191
+ .PP
192
+ Delete all nodes, or only certain nodes based on a regular expression.
193
+ .PP
194
+ .B node create NODE (options)
195
+ .PP
196
+ Create a new node.
197
+ .PP
198
+ .B node delete NODE (options)
199
+ .PP
200
+ Delete a single node.
201
+ .PP
202
+ .B node edit NODE (options)
203
+ .PP
204
+ Edit a node.
205
+ .PP
206
+ .B node from file FILE (options)
207
+ .PP
208
+ Create a node from a JSON file.
209
+ .PP
210
+ .B node list (options)
211
+ .TP
212
+ \fB\-w\fR, \fB\-\-with\-uri\fR
213
+ Show corresponding URIs
214
+ .PP
215
+ List all nodes.
216
+ .PP
217
+ .B node run_list add [NODE] [ENTRY] (options)
218
+ .TP
219
+ \fB\-a\fR, \fB\-\-after\fR [ITEM]
220
+ Place the ENTRY in the run list after ITEM
221
+ .PP
222
+ Add a recipe or role to the node's run_list.
223
+ .PP
224
+ .B node run_list remove [NODE] [ENTRY] (options)
225
+ .PP
226
+ Remove a recipe or role from the node's run_list.
227
+ .PP
228
+ .B node show NODE (options)
229
+ .TP
230
+ \fB\-a\fR, \fB\-\-attribute\fR [ATTR]
231
+ Show only one attribute
232
+ .TP
233
+ \fB\-r\fR, \fB\-\-run\-list\fR
234
+ Show only the run list
235
+ .PP
236
+ Show a node.
237
+ .SH ROLE SUB-COMMANDS
238
+ .PP
239
+ Roles provide a mechanism to apply a set of recipes and attributes to nodes. For example, the 'webserver' role might instruct Chef to add a recipe for Apache, and specify a default domain to use.
240
+ .PP
241
+ .B role bulk delete (options)
242
+ .TP
243
+ \fB\-r\fR, \fB\-\-regex\fR [REGEX]
244
+ Narrow the operation via regular expression
245
+ .PP
246
+ Delete all roles, or only certain roles based on a regular expression.
247
+ .PP
248
+ .B role create ROLE (options)
249
+ .TP
250
+ \fB\-d\fR, \fB\-\-description\fR
251
+ The role description
252
+ .PP
253
+ Create a new role.
254
+ .PP
255
+ .B role delete ROLE (options)
256
+ .PP
257
+ Delete a role.
258
+ .PP
259
+ .B role edit ROLE (options)
260
+ Edit a role.
261
+ .PP
262
+ .B role from file FILE (options)
263
+ .PP
264
+ Update a role from a file.
265
+ .PP
266
+ .B role list (options)
267
+ .TP
268
+ \fB\-w\fR, \fB\-\-with\-uri\fR
269
+ Show corresponding URIs
270
+ .PP
271
+ List roles.
272
+ .PP
273
+ .B role show ROLE (options)
274
+ .TP
275
+ \fB\-a\fR, \fB\-\-attribute\fR [ATTR]
276
+ Show only one attribute
277
+ .PP
278
+ Show a specific role.
279
+ .SH GENERAL SUB-COMMANDS
280
+ .PP
281
+ The following are general sub-commands that do not fit within the other object types used in Chef.
282
+ .PP
283
+ .B configure (options)
284
+ .TP
285
+ \fB\-r\fR, \fB\-\-repository\fR REPO
286
+ The path to your chef\-repo
287
+ .PP
288
+ Create a configuration file for knife. This will prompt for values to enter into the file. See "\fBCONFIGURATION\fR" below for available options.
289
+ .PP
290
+ .B ec2 instance data [RUN LIST...] (options)
291
+ .TP
292
+ \fB\-e\fR, \fB\-\-edit\fR
293
+ Edit the instance data
294
+ .PP
295
+ Chef is commonly used with Amazon AWS EC2 nodes. This command will generate instance metadata that can be used to automatically configure an EC2 instance with Chef.
296
+ .PP
297
+ .B search INDEX QUERY (options)
298
+ .TP
299
+ \fB\-a\fR, \fB\-\-attribute\fR [ATTR]
300
+ Show only one attribute
301
+ .TP
302
+ \fB\-i\fR, \fB\-\-id\-only\fR
303
+ Show only the ID of matching objects
304
+ .TP
305
+ \fB\-R\fR, \fB\-\-rows\fR INT
306
+ The number of rows to return
307
+ .TP
308
+ \fB\-r\fR, \fB\-\-run\-list\fR
309
+ Show only the run list
310
+ .TP
311
+ \fB\-o\fR, \fB\-\-sort\fR SORT
312
+ The order to sort the results in
313
+ .TP
314
+ \fB\-b\fR, \fB\-\-start\fR ROW
315
+ The row to start returning results at
316
+ .PP
317
+ Search indexes are a powerful feature of the Chef server and the search subcommand allows searching any of the available indexes using the SOLR query syntax.
318
+ .SH CONFIGURATION
319
+ The knife configuration file is a Ruby DSL. If it exists, knife uses the settings for \fBGENERAL OPTIONS\fR defaults.
320
+ .TP
321
+ .B log_level
322
+ A Ruby symbol specifying the log level. Corresponds to the \-l or \-\-log_level option. Default is :info.
323
+ .TP
324
+ .B log_location
325
+ Corresponds to the \-L or \-\-logfile option. Default is STDOUT.
326
+ .TP
327
+ .B node_name
328
+ User to authenticate to the Chef server. Corresponds to the \-u or \-\-user option. This is requested from the user when running this sub-command.
329
+ .TP
330
+ .B client_key
331
+ Private key file to authenticate to the Chef server. Corresponds to the \-k or \-\-key option. This is requested from the user when running this sub-command.
332
+ .TP
333
+ .B chef_server_url
334
+ URL of the Chef server. Corresponds to the \-s or \-\-server\-url option. This is requested from the user when running this sub-command.
335
+ .TP
336
+ .B cache_type
337
+ The type of cache to use. Default is \fIBasicFile\fR. This can be any type of Cache that moneta supports: BasicFile, Berkeley, Couch, DataMapper, File, LMC, Memcache, Memory, MongoDB, Redis, Rufus, S3, SDBM, Tyrant, Xattr, YAML.
338
+ .TP
339
+ .B cache_options
340
+ Specifies various options to use for caching. Default reads the Chef client configuration (/etc/chef/checksums).
341
+ .SH FILES
342
+ .PP
343
+ \fI~/.chef/knife.rb\fR
344
+ .TP
345
+ Ruby DSL configuration file for Knife. See "\fBCONFIGURATION\fR".
346
+ .SH SEE ALSO
347
+ .PP
348
+ Full documentation for Chef and Knife is located on the Chef wiki, http://wiki.opscode.com/display/chef/Home.
349
+ .PP
350
+ JSON is JavaScript Object Notation and more information can be found at http://json.org/.
351
+ .PP
352
+ SOLR is an open source search engine. The Chef Server includes a SOLR installation. More information about SOLR, including search query syntax, can be found at http://lucene.apache.org/solr/.
353
+ .SH AUTHOR
354
+ Chef was written by Adam Jacob <adam@ospcode.com> of Opscode (http://www.opscode.com), with contributions from the community.
355
+ This manual page was written by Joshua Timberman <joshua@opscode.com> with help2man. Permission is granted
356
+ to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
357
+ .PP
358
+ On Debian systems, the complete text of the Apache 2.0 License can be found in
359
+ /usr/share/common-licenses/Apache-2.0.