runa-chef 0.8.0.1

Sign up to get free protection for your applications and to get access to all the features.
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.