chef 0.9.8 → 0.9.10.rc.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (98) hide show
  1. data/README.rdoc +1 -1
  2. data/distro/common/man/man8/knife.8 +89 -79
  3. data/distro/common/markdown/knife.mkd +7 -0
  4. data/distro/debian/etc/default/chef-server +3 -0
  5. data/distro/debian/etc/default/chef-server-webui +3 -0
  6. data/distro/debian/etc/default/chef-solr +3 -0
  7. data/distro/debian/etc/default/chef-solr-indexer +3 -0
  8. data/distro/debian/etc/init.d/chef-server +3 -1
  9. data/distro/debian/etc/init.d/chef-server-webui +3 -1
  10. data/distro/redhat/etc/init.d/chef-client +1 -1
  11. data/lib/chef/application.rb +2 -0
  12. data/lib/chef/application/client.rb +5 -3
  13. data/lib/chef/application/knife.rb +16 -5
  14. data/lib/chef/application/solo.rb +0 -1
  15. data/lib/chef/checksum.rb +65 -1
  16. data/lib/chef/checksum_cache.rb +173 -0
  17. data/lib/chef/client.rb +84 -121
  18. data/lib/chef/cookbook/remote_file_vendor.rb +10 -3
  19. data/lib/chef/cookbook/syntax_check.rb +2 -2
  20. data/lib/chef/cookbook_loader.rb +2 -0
  21. data/lib/chef/cookbook_site_streaming_uploader.rb +29 -0
  22. data/lib/chef/cookbook_uploader.rb +8 -7
  23. data/lib/chef/cookbook_version.rb +155 -114
  24. data/lib/chef/exceptions.rb +5 -0
  25. data/lib/chef/handler.rb +43 -0
  26. data/lib/chef/index_queue/consumer.rb +1 -1
  27. data/lib/chef/index_queue/indexable.rb +1 -1
  28. data/lib/chef/knife.rb +18 -5
  29. data/lib/chef/knife/bootstrap.rb +2 -2
  30. data/lib/chef/knife/bootstrap/archlinux-gems.erb +44 -0
  31. data/lib/chef/knife/bootstrap/client-install.vbs +80 -0
  32. data/lib/chef/knife/bootstrap/ubuntu10.04-apt.erb +2 -2
  33. data/lib/chef/knife/bootstrap/ubuntu10.04-gems.erb +6 -7
  34. data/lib/chef/knife/bootstrap/windows-gems.erb +34 -0
  35. data/lib/chef/knife/configure_client.rb +4 -2
  36. data/lib/chef/knife/cookbook_metadata.rb +1 -1
  37. data/lib/chef/knife/cookbook_site_share.rb +2 -1
  38. data/lib/chef/knife/cookbook_site_vendor.rb +6 -0
  39. data/lib/chef/knife/cookbook_test.rb +1 -1
  40. data/lib/chef/knife/ec2_server_create.rb +51 -26
  41. data/lib/chef/knife/exec.rb +52 -0
  42. data/lib/chef/knife/ssh.rb +27 -15
  43. data/lib/chef/knife/status.rb +27 -10
  44. data/lib/chef/knife/windows_bootstrap.rb +154 -0
  45. data/lib/chef/mixin/checksum.rb +2 -2
  46. data/lib/chef/mixin/xml_escape.rb +75 -49
  47. data/lib/chef/node.rb +54 -58
  48. data/lib/chef/node/attribute.rb +61 -53
  49. data/lib/chef/platform.rb +19 -2
  50. data/lib/chef/provider/breakpoint.rb +1 -1
  51. data/lib/chef/provider/cookbook_file.rb +3 -3
  52. data/lib/chef/provider/cron.rb +3 -3
  53. data/lib/chef/provider/cron/solaris.rb +195 -0
  54. data/lib/chef/provider/deploy.rb +3 -3
  55. data/lib/chef/provider/directory.rb +2 -2
  56. data/lib/chef/provider/env.rb +5 -5
  57. data/lib/chef/provider/execute.rb +1 -1
  58. data/lib/chef/provider/file.rb +10 -9
  59. data/lib/chef/provider/git.rb +12 -4
  60. data/lib/chef/provider/group.rb +5 -5
  61. data/lib/chef/provider/http_request.rb +25 -9
  62. data/lib/chef/provider/ifconfig.rb +2 -2
  63. data/lib/chef/provider/link.rb +11 -6
  64. data/lib/chef/provider/log.rb +1 -0
  65. data/lib/chef/provider/mdadm.rb +3 -3
  66. data/lib/chef/provider/mount.rb +5 -5
  67. data/lib/chef/provider/mount/mount.rb +1 -1
  68. data/lib/chef/provider/ohai.rb +41 -0
  69. data/lib/chef/provider/package.rb +5 -5
  70. data/lib/chef/provider/package/yum-dump.py +5 -2
  71. data/lib/chef/provider/remote_directory.rb +11 -5
  72. data/lib/chef/provider/remote_file.rb +2 -2
  73. data/lib/chef/provider/route.rb +154 -133
  74. data/lib/chef/provider/ruby_block.rb +1 -1
  75. data/lib/chef/provider/service.rb +6 -6
  76. data/lib/chef/provider/subversion.rb +12 -9
  77. data/lib/chef/provider/template.rb +2 -2
  78. data/lib/chef/provider/user.rb +7 -7
  79. data/lib/chef/provider/user/useradd.rb +15 -1
  80. data/lib/chef/providers.rb +2 -0
  81. data/lib/chef/resource.rb +164 -58
  82. data/lib/chef/resource/http_request.rb +9 -0
  83. data/lib/chef/resource/ohai.rb +40 -0
  84. data/lib/chef/resource/remote_directory.rb +10 -1
  85. data/lib/chef/resource/rpm_package.rb +34 -0
  86. data/lib/chef/resource_collection.rb +3 -2
  87. data/lib/chef/resources.rb +2 -0
  88. data/lib/chef/rest.rb +13 -7
  89. data/lib/chef/rest/auth_credentials.rb +1 -1
  90. data/lib/chef/rest/rest_request.rb +3 -1
  91. data/lib/chef/runner.rb +31 -55
  92. data/lib/chef/shef/shef_session.rb +1 -1
  93. data/lib/chef/util/windows/net_use.rb +1 -1
  94. data/lib/chef/version.rb +1 -1
  95. data/lib/chef/webui_user.rb +0 -1
  96. metadata +38 -19
  97. data/lib/chef/cache.rb +0 -61
  98. data/lib/chef/cache/checksum.rb +0 -91
@@ -47,7 +47,7 @@ Install these via your platform's preferred method; for example apt, yum, ports,
47
47
  * erubis
48
48
  * extlib
49
49
  * highline
50
- * json (1.4.2)
50
+ * json (1.4.4 - 1.4.6)
51
51
  * mixlib-authentication
52
52
  * mixlib-cli
53
53
  * mixlib-config
@@ -1,13 +1,13 @@
1
- .\" generated with Ronn/v0.6.0
2
- .\" http://github.com/rtomayko/ronn/
1
+ .\" generated with Ronn/v0.7.3
2
+ .\" http://github.com/rtomayko/ronn/tree/0.7.3
3
3
  .
4
- .TH "KNIFE" "8" "July 2010" "" ""
4
+ .TH "KNIFE" "8" "September 2010" "" ""
5
5
  .
6
6
  .SH "NAME"
7
7
  \fBknife\fR \- Chef Server REST API utility
8
8
  .
9
9
  .SH "SYNOPSIS"
10
- \fBknife\fR\fIsub\-command\fR\fI(options)\fR
10
+ \fBknife\fR \fIsub\-command\fR \fI(options)\fR
11
11
  .
12
12
  .SH "DESCRIPTION"
13
13
  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\.
@@ -22,11 +22,11 @@ The Chef class \fBChef::Config\fR that configures the behavior of how knife runs
22
22
  .
23
23
  .TP
24
24
  \fB\-s\fR, \fB\-\-server\-url\fR URL
25
- Chef Server URL, corresponds to \fBChef::Config\fR\fBchef_server_url\fR\.
25
+ Chef Server URL, corresponds to \fBChef::Config\fR \fBchef_server_url\fR\.
26
26
  .
27
27
  .TP
28
28
  \fB\-k\fR, \fB\-\-key\fR KEY
29
- API Client Key, corresponds to \fBChef::Config\fR\fBclient_key\fR\.
29
+ API Client Key, corresponds to \fBChef::Config\fR \fBclient_key\fR\.
30
30
  .
31
31
  .TP
32
32
  \fB\-c\fR, \fB\-\-config\fR CONFIG
@@ -42,11 +42,11 @@ Which format to use for output
42
42
  .
43
43
  .TP
44
44
  \fB\-l\fR, \fB\-\-log_level\fR LEVEL
45
- Set the log level (debug, info, warn, error, fatal), corresponds to \fBChef::Config\fR\fBlog_level\fR\.
45
+ Set the log level (debug, info, warn, error, fatal), corresponds to \fBChef::Config\fR \fBlog_level\fR\.
46
46
  .
47
47
  .TP
48
48
  \fB\-L\fR, \fB\-\-logfile\fR LOGLOCATION
49
- Set the log file location, defaults to STDOUT, corresponds to \fBChef::Config\fR\fBlog_location\fR\.
49
+ Set the log file location, defaults to STDOUT, corresponds to \fBChef::Config\fR \fBlog_location\fR\.
50
50
  .
51
51
  .TP
52
52
  \fB\-n\fR, \fB\-\-no\-editor\fR
@@ -54,7 +54,7 @@ Do not open EDITOR, just accept the data as is
54
54
  .
55
55
  .TP
56
56
  \fB\-u\fR, \fB\-\-user\fR USER
57
- API Client Username, corresponds to \fBChef::Config\fR\fBnode_name\fR\.
57
+ API Client Username, corresponds to \fBChef::Config\fR \fBnode_name\fR\.
58
58
  .
59
59
  .TP
60
60
  \fB\-p\fR, \fB\-\-print\-after\fR
@@ -99,7 +99,7 @@ Objects stored on the server support these, as described below\.
99
99
  The following are general sub\-commands that do not fit within the other object types utilized in the Chef Server API\.
100
100
  .
101
101
  .P
102
- \fBconfigure\fR\fI(options)\fR
102
+ \fBconfigure\fR \fI(options)\fR
103
103
  .
104
104
  .TP
105
105
  \fB\-i\fR, \fB\-\-initial\fR
@@ -119,7 +119,7 @@ Create a configuration file for knife\. This will prompt for values to enter int
119
119
  Read the \fBknife\.rb\fR config file and generate a config file suitable for use in \fB/etc/chef/client\.rb\fR and copy the validation certificate into the specified \fIDIRECTORY\fR\.
120
120
  .
121
121
  .P
122
- \fBindex rebuild\fR\fI(options)\fR
122
+ \fBindex rebuild\fR \fI(options)\fR
123
123
  .
124
124
  .TP
125
125
  \fB\-y\fR, \fB\-\-yes\fR
@@ -135,7 +135,7 @@ Rebuilds all the search indexes on the server\.
135
135
  List available recipes from the server\. Specify \fIPATTERN\fR as a regular expression to limit the results\.
136
136
  .
137
137
  .P
138
- \fBsearch INDEX QUERY\fR\fI(options)\fR
138
+ \fBsearch INDEX QUERY\fR \fI(options)\fR
139
139
  .
140
140
  .TP
141
141
  \fB\-a\fR, \fB\-\-attribute ATTR\fR
@@ -165,7 +165,7 @@ The row to start returning results at
165
165
  Search indexes are a feature of the Chef Server and the search sub\-command allows querying any of the available indexes using SOLR query syntax\. The following data types are indexed for search: \fInode\fR, \fIrole\fR, \fIclient\fR, \fIdata bag\fR\.
166
166
  .
167
167
  .P
168
- \fBssh QUERY COMMAND\fR\fI(options)\fR
168
+ \fBssh QUERY COMMAND\fR \fI(options)\fR
169
169
  .
170
170
  .TP
171
171
  \fB\-a\fR, \fB\-\-attribute ATTR\fR
@@ -190,8 +190,18 @@ The ssh username
190
190
  .P
191
191
  The \fIssh\fR sub\-command opens an ssh session to each of the nodes in the search results of the \fIQUERY\fR\. This sub\-command requires that the net\-ssh\-multi and highline Ruby libraries are installed\. On Debian systems, these are the libnet\-ssh\-multi\-ruby and libhighline\-ruby packages\. They can also be installed as RubyGems (net\-ssh\-multi and highline, respectively)\.
192
192
  .
193
+ .P
194
+ \fBstatus\fR \fI(options)\fR
195
+ .
196
+ .TP
197
+ \fB\-r\fR, \fB\-\-run\-list RUN_LIST\fR
198
+ Show the run list
199
+ .
200
+ .P
201
+ The \fIstatus\fR sub\-command searches the Chef Server for all nodes and displays information about the last time the node checked into the server and executed a \fBnode\.save\fR\. The fields displayed are the relative checkin time, the node name, it\'s operating system platform and version, the fully\-qualified domain name and the default IP address\. If the \fB\-r\fR option is given, the node\'s run list will also be displayed\. Note that depending on the configuration of the nodes, the FQDN and IP displayed may not be publicly reachable\.
202
+ .
193
203
  .SH "BOOTSTRAP SUB\-COMMANDS"
194
- \fBbootstrap FQDN\fR\fI(options)\fR
204
+ \fBbootstrap FQDN\fR \fI(options)\fR
195
205
  .
196
206
  .TP
197
207
  \fB\-i\fR, \fB\-\-identity\-file IDENTITY_FILE\fR
@@ -312,13 +322,13 @@ Additional custom bootstrap templates can be created and stored in \fB\.chef/boo
312
322
  Clients are entities that communicate with the Chef Server API\.
313
323
  .
314
324
  .P
315
- \fBclient bulk delete REGEX\fR\fI(options)\fR
325
+ \fBclient bulk delete REGEX\fR \fI(options)\fR
316
326
  .
317
327
  .P
318
328
  Delete clients on the Chef Server based on a regular expression\. The regular expression (\fIREGEX\fR) should be in quotes, not in //\'s\.
319
329
  .
320
330
  .P
321
- \fBclient create CLIENT\fR\fI(options)\fR
331
+ \fBclient create CLIENT\fR \fI(options)\fR
322
332
  .
323
333
  .TP
324
334
  \fB\-a\fR, \fB\-\-admin\fR
@@ -335,19 +345,19 @@ Create a new client\. This generates an RSA keypair\. The private key will be di
335
345
  Admin clients should be created for users that will use \fIknife\fR to access the API as an administrator\. The private key will generally be copied to \fB~/\.chef/CLIENT\.pem\fR and referenced in the \fBknife\.rb\fR configuration file\.
336
346
  .
337
347
  .P
338
- \fBclient delete CLIENT\fR\fI(options)\fR
348
+ \fBclient delete CLIENT\fR \fI(options)\fR
339
349
  .
340
350
  .P
341
351
  Deletes a registered client\.
342
352
  .
343
353
  .P
344
- \fBclient edit CLIENT\fR\fI(options)\fR
354
+ \fBclient edit CLIENT\fR \fI(options)\fR
345
355
  .
346
356
  .P
347
357
  Edit a registered client\.
348
358
  .
349
359
  .P
350
- \fBclient list\fR\fI(options)\fR
360
+ \fBclient list\fR \fI(options)\fR
351
361
  .
352
362
  .TP
353
363
  \fB\-w\fR, \fB\-\-with\-uri\fR
@@ -357,7 +367,7 @@ Show corresponding URIs
357
367
  List all registered clients\.
358
368
  .
359
369
  .P
360
- \fBclient reregister CLIENT\fR\fI(options)\fR
370
+ \fBclient reregister CLIENT\fR \fI(options)\fR
361
371
  .
362
372
  .TP
363
373
  \fB\-f\fR, \fB\-\-file FILE\fR
@@ -367,7 +377,7 @@ Write the key to a file
367
377
  Regenerate the RSA keypair for a client\. The public half will be stored on the server and the private key displayed on \fISTDOUT\fR or written to the named file\.
368
378
  .
369
379
  .P
370
- \fBclient show CLIENT\fR\fI(options)\fR
380
+ \fBclient show CLIENT\fR \fI(options)\fR
371
381
  .
372
382
  .TP
373
383
  \fB\-a\fR, \fB\-\-attribute ATTR\fR
@@ -380,7 +390,7 @@ Show a client\.
380
390
  Cookbooks are the fundamental unit of distribution in Chef\. They encapsulate all recipes of resources and assets used to configure a particular aspect of the infrastructure\. The following sub\-commands can be used to manipulate the cookbooks stored on the Chef Server\.
381
391
  .
382
392
  .P
383
- \fBcookbook bulk delete REGEX\fR\fI(options)\fR
393
+ \fBcookbook bulk delete REGEX\fR \fI(options)\fR
384
394
  .
385
395
  .TP
386
396
  \fB\-p\fR, \fB\-\-purge\fR
@@ -390,7 +400,7 @@ Purge files from backing store\. This will disable any cookbook that contains an
390
400
  Delete cookbooks on the Chef Server based on a regular expression\. The regular expression (\fIREGEX\fR) should be in quotes, not in //\'s\.
391
401
  .
392
402
  .P
393
- \fBcookbook create COOKBOOK\fR\fI(options)\fR
403
+ \fBcookbook create COOKBOOK\fR \fI(options)\fR
394
404
  .
395
405
  .TP
396
406
  \fB\-o\fR, \fB\-\-cookbook\-path PATH\fR
@@ -466,16 +476,16 @@ The cookbook copyright, license and email settings can be filled in the \fBknife
466
476
  .
467
477
  .nf
468
478
 
469
- cookbook_copyright \"YOUR_COMPANY_NAME\"
470
- cookbook_license \"none\"
471
- cookbook_email \"YOUR_EMAIL\"
479
+ cookbook_copyright "YOUR_COMPANY_NAME"
480
+ cookbook_license "none"
481
+ cookbook_email "YOUR_EMAIL"
472
482
  .
473
483
  .fi
474
484
  .
475
485
  .IP "" 0
476
486
  .
477
487
  .P
478
- \fBcookbook delete COOKBOOK [VERSION]\fR\fI(options)\fR
488
+ \fBcookbook delete COOKBOOK [VERSION]\fR \fI(options)\fR
479
489
  .
480
490
  .TP
481
491
  \fB\-a\fR, \fB\-\-all\fR
@@ -489,7 +499,7 @@ Purge files from backing store\. This will disable any cookbook that contains an
489
499
  Delete the specified \fIVERSION\fR of the named \fICOOKBOOK\fR\. If no version is specified, and only one version exists on the server, that version will be deleted\. If multiple versions are available on the server, you will be prompted for a version to delete\.
490
500
  .
491
501
  .P
492
- \fBcookbook download COOKBOOK [VERSION]\fR\fI(options)\fR
502
+ \fBcookbook download COOKBOOK [VERSION]\fR \fI(options)\fR
493
503
  .
494
504
  .TP
495
505
  \fB\-d\fR, \fB\-\-dir DOWNLOAD_DIRECTORY\fR
@@ -507,7 +517,7 @@ Download the latest version of the cookbook
507
517
  Download a cookbook from the Chef Server\. If no version is specified and only one version exists on the server, that version will be downloaded\. If no version is specified and multiple versions are available on the server, you will be prompted for a version to download\.
508
518
  .
509
519
  .P
510
- \fBcookbook list\fR\fI(options)\fR
520
+ \fBcookbook list\fR \fI(options)\fR
511
521
  .
512
522
  .TP
513
523
  \fB\-w\fR, \fB\-\-with\-uri\fR
@@ -517,7 +527,7 @@ Show corresponding URIs
517
527
  List all the cookbooks\.
518
528
  .
519
529
  .P
520
- \fBcookbook metadata COOKBOOK\fR\fI(options)\fR
530
+ \fBcookbook metadata COOKBOOK\fR \fI(options)\fR
521
531
  .
522
532
  .TP
523
533
  \fB\-a\fR, \fB\-\-all\fR
@@ -531,13 +541,13 @@ A colon\-separated path to look for cookbooks in
531
541
  Generate cookbook metadata for the named \fICOOKBOOK\fR\. The \fIPATH\fR used here specifies where the cookbooks directory is located and corresponds to the \fBcookbook_path\fR configuration option\.
532
542
  .
533
543
  .P
534
- \fBcookbook metadata from FILE\fR\fI(options)\fR
544
+ \fBcookbook metadata from FILE\fR \fI(options)\fR
535
545
  .
536
546
  .P
537
547
  Load the cookbook metadata from a specified file\.
538
548
  .
539
549
  .P
540
- \fBcookbook show COOKBOOK [VERSION] [PART] [FILENAME]\fR\fI(options)\fR
550
+ \fBcookbook show COOKBOOK [VERSION] [PART] [FILENAME]\fR \fI(options)\fR
541
551
  .
542
552
  .TP
543
553
  \fB\-f\fR, \fB\-\-fqdn FQDN\fR
@@ -581,7 +591,7 @@ Show a particular part of a \fICOOKBOOK\fR for the specified \fIVERSION\fR\. \fI
581
591
  .IP "" 0
582
592
  .
583
593
  .P
584
- \fBcookbook test [COOKBOOKS\.\.\.]\fR\fI(options)\fR
594
+ \fBcookbook test [COOKBOOKS\.\.\.]\fR \fI(options)\fR
585
595
  .
586
596
  .TP
587
597
  \fB\-a\fR, \fB\-\-all\fR
@@ -595,7 +605,7 @@ A colon\-separated path to look for cookbooks in
595
605
  Test the specified cookbooks for syntax errors\. This uses the built\-in Ruby syntax checking option for files in the cookbook ending in \fB\.rb\fR, and the ERB syntax check for files ending in \fB\.erb\fR (templates)\.
596
606
  .
597
607
  .P
598
- \fBcookbook upload [COOKBOOKS\.\.\.]\fR\fI(options)\fR
608
+ \fBcookbook upload [COOKBOOKS\.\.\.]\fR \fI(options)\fR
599
609
  .
600
610
  .TP
601
611
  \fB\-a\fR, \fB\-\-all\fR
@@ -612,7 +622,7 @@ Uploads the specified cookbooks to the Chef Server\. The actual upload executes
612
622
  The following sub\-commands are still in the context of cookbooks, but they make use of Opscode\'s Cookbook Community site, \fIhttp://cookbooks\.opscode\.com/\fR\. That site has an API, and these sub\-commands utilize that API, rather than the Chef Server API\.
613
623
  .
614
624
  .P
615
- \fBcookbook site download COOKBOOK [VERSION]\fR\fI(options)\fR
625
+ \fBcookbook site download COOKBOOK [VERSION]\fR \fI(options)\fR
616
626
  .
617
627
  .TP
618
628
  \fB\-f\fR, \fB\-\-file FILE\fR
@@ -622,7 +632,7 @@ The filename to write to
622
632
  Downloads a specific cookbook from the Community site, optionally specifying a certain version\.
623
633
  .
624
634
  .P
625
- \fBcookbook site list\fR\fI(options)\fR
635
+ \fBcookbook site list\fR \fI(options)\fR
626
636
  .
627
637
  .TP
628
638
  \fB\-w\fR, \fB\-\-with\-uri\fR
@@ -632,13 +642,13 @@ Show corresponding URIs
632
642
  Lists available cookbooks from the Community site\.
633
643
  .
634
644
  .P
635
- \fBcookbook site search QUERY\fR\fI(options)\fR
645
+ \fBcookbook site search QUERY\fR \fI(options)\fR
636
646
  .
637
647
  .P
638
648
  Searches the Community site with the specified query\.
639
649
  .
640
650
  .P
641
- \fBcookbook site share COOKBOOK CATEGORY\fR\fI(options)\fR
651
+ \fBcookbook site share COOKBOOK CATEGORY\fR \fI(options)\fR
642
652
  .
643
653
  .TP
644
654
  \fB\-k\fR, \fB\-\-key KEY\fR
@@ -662,13 +672,13 @@ Uploads the specified cookbook using the given category to the Opscode cookbooks
662
672
  Stops sharing the specified cookbook on the Opscode cookbooks site\.
663
673
  .
664
674
  .P
665
- \fBcookbook site show COOKBOOK [VERSION]\fR\fI(options)\fR
675
+ \fBcookbook site show COOKBOOK [VERSION]\fR \fI(options)\fR
666
676
  .
667
677
  .P
668
678
  Shows information from the site about a particular cookbook\.
669
679
  .
670
680
  .P
671
- \fBcookbook site vendor COOKBOOK [VERSION]\fR\fI(options)\fR
681
+ \fBcookbook site vendor COOKBOOK [VERSION]\fR \fI(options)\fR
672
682
  .
673
683
  .TP
674
684
  \fB\-d\fR, \fB\-\-dependencies\fR
@@ -681,31 +691,31 @@ Uses \fBgit\fR version control in conjunction with the cookbook site to download
681
691
  Data bags are stores of JSON blobs\. These blobs are called items\. They are free form JSON and indexed by the Chef Server\.
682
692
  .
683
693
  .P
684
- \fBdata bag create BAG [ITEM]\fR\fI(options)\fR
694
+ \fBdata bag create BAG [ITEM]\fR \fI(options)\fR
685
695
  .
686
696
  .P
687
697
  Create a new data bag, or an item in a data bag\.
688
698
  .
689
699
  .P
690
- \fBdata bag delete BAG [ITEM]\fR\fI(options)\fR
700
+ \fBdata bag delete BAG [ITEM]\fR \fI(options)\fR
691
701
  .
692
702
  .P
693
703
  Delete a data bag, or an item from a data bag\.
694
704
  .
695
705
  .P
696
- \fBdata bag edit BAG ITEM\fR\fI(options)\fR
706
+ \fBdata bag edit BAG ITEM\fR \fI(options)\fR
697
707
  .
698
708
  .P
699
709
  Edit an item in a data bag\.
700
710
  .
701
711
  .P
702
- \fBdata bag from file BAG FILE\fR\fI(options)\fR
712
+ \fBdata bag from file BAG FILE\fR \fI(options)\fR
703
713
  .
704
714
  .P
705
715
  Load a data bag item from a JSON file\. Looks in the directory \fBdata_bags/BAG/ITEM\.json\fR unless a relative path is specified\.
706
716
  .
707
717
  .P
708
- \fBdata bag list\fR\fI(options)\fR
718
+ \fBdata bag list\fR \fI(options)\fR
709
719
  .
710
720
  .TP
711
721
  \fB\-w\fR, \fB\-\-with\-uri\fR
@@ -715,7 +725,7 @@ Show corresponding URIs
715
725
  List the available data bags\.
716
726
  .
717
727
  .P
718
- \fBdata bag show BAG [ITEM]\fR\fI(options)\fR
728
+ \fBdata bag show BAG [ITEM]\fR \fI(options)\fR
719
729
  .
720
730
  .P
721
731
  Show a specific data bag or an item in a data bag\.
@@ -724,37 +734,37 @@ Show a specific data bag or an item in a data bag\.
724
734
  Nodes are the entities which are configured with Chef\. Typically these are servers or workstations\. Nodes are registered as a client, by default by the fully qualified domain name (fqdn)\. A single client may configure more than one node\.
725
735
  .
726
736
  .P
727
- \fBnode bulk delete REGEX\fR\fI(options)\fR
737
+ \fBnode bulk delete REGEX\fR \fI(options)\fR
728
738
  .
729
739
  .P
730
740
  Delete nodes on the Chef Server based on a regular expression\. The regular expression (\fIREGEX\fR) should be in quotes, not in //\'s\.
731
741
  .
732
742
  .P
733
- \fBnode create NODE\fR\fI(options)\fR
743
+ \fBnode create NODE\fR \fI(options)\fR
734
744
  .
735
745
  .P
736
746
  Create a new node\.
737
747
  .
738
748
  .P
739
- \fBnode delete NODE\fR\fI(options)\fR
749
+ \fBnode delete NODE\fR \fI(options)\fR
740
750
  .
741
751
  .P
742
752
  Delete a single node\.
743
753
  .
744
754
  .P
745
- \fBnode edit NODE\fR\fI(options)\fR
755
+ \fBnode edit NODE\fR \fI(options)\fR
746
756
  .
747
757
  .P
748
758
  Edit a node\.
749
759
  .
750
760
  .P
751
- \fBnode from file FILE\fR\fI(options)\fR
761
+ \fBnode from file FILE\fR \fI(options)\fR
752
762
  .
753
763
  .P
754
764
  Create a node from a JSON file\.
755
765
  .
756
766
  .P
757
- \fBnode list\fR\fI(options)\fR
767
+ \fBnode list\fR \fI(options)\fR
758
768
  .
759
769
  .TP
760
770
  \fB\-w\fR, \fB\-\-with\-uri\fR
@@ -764,7 +774,7 @@ Show corresponding URIs
764
774
  List all nodes\.
765
775
  .
766
776
  .P
767
- \fBnode run_list add [NODE] [ENTRY]\fR\fI(options)\fR
777
+ \fBnode run_list add [NODE] [ENTRY]\fR \fI(options)\fR
768
778
  .
769
779
  .TP
770
780
  \fB\-a\fR, \fB\-\-after ITEM\fR
@@ -774,13 +784,13 @@ Place the ENTRY in the run list after ITEM
774
784
  Add a recipe or role to the node\'s \fBrun_list\fR\.
775
785
  .
776
786
  .P
777
- \fBnode run_list remove [NODE] [ENTRY]\fR\fI(options)\fR
787
+ \fBnode run_list remove [NODE] [ENTRY]\fR \fI(options)\fR
778
788
  .
779
789
  .P
780
790
  Remove a recipe or role from the node\'s \fBrun_list\fR\.
781
791
  .
782
792
  .P
783
- \fBnode show NODE\fR\fI(options)\fR
793
+ \fBnode show NODE\fR \fI(options)\fR
784
794
  .
785
795
  .TP
786
796
  \fB\-a\fR, \fB\-\-attribute [ATTR]\fR
@@ -800,13 +810,13 @@ Show a node\.
800
810
  List the recipes available on the server\. The results shown can be limited with the optional PATTERN, which is a regular expression\. PATTERN should be given in quotes, without slashes\.
801
811
  .
802
812
  .SH "ROLE SUB\-COMMANDS"
803
- \fBrole bulk delete REGEX\fR\fI(options)\fR
813
+ \fBrole bulk delete REGEX\fR \fI(options)\fR
804
814
  .
805
815
  .P
806
816
  Delete roles on the Chef Server based on a regular expression\. The regular expression (\fIREGEX\fR) should be in quotes, not in //\'s\.
807
817
  .
808
818
  .P
809
- \fBrole create ROLE\fR\fI(options)\fR
819
+ \fBrole create ROLE\fR \fI(options)\fR
810
820
  .
811
821
  .TP
812
822
  \fB\-d\fR, \fB\-\-description\fR
@@ -816,25 +826,25 @@ The role description
816
826
  Create a new role\.
817
827
  .
818
828
  .P
819
- \fBrole delete ROLE\fR\fI(options)\fR
829
+ \fBrole delete ROLE\fR \fI(options)\fR
820
830
  .
821
831
  .P
822
832
  Delete a role\.
823
833
  .
824
834
  .P
825
- \fBrole edit ROLE\fR\fI(options)\fR
835
+ \fBrole edit ROLE\fR \fI(options)\fR
826
836
  .
827
837
  .P
828
838
  Edit a role\.
829
839
  .
830
840
  .P
831
- \fBrole from file FILE\fR\fI(options)\fR
841
+ \fBrole from file FILE\fR \fI(options)\fR
832
842
  .
833
843
  .P
834
844
  Create or update a role from a role Ruby DSL (\fB\.rb\fR) or JSON file\.
835
845
  .
836
846
  .P
837
- \fBrole list\fR\fI(options)\fR
847
+ \fBrole list\fR \fI(options)\fR
838
848
  .
839
849
  .TP
840
850
  \fB\-w\fR, \fB\-\-with\-uri\fR
@@ -844,7 +854,7 @@ Show corresponding URIs
844
854
  List roles\.
845
855
  .
846
856
  .P
847
- \fBrole show ROLE\fR\fI(options)\fR
857
+ \fBrole show ROLE\fR \fI(options)\fR
848
858
  .
849
859
  .TP
850
860
  \fB\-a\fR, \fB\-\-attribute ATTR\fR
@@ -866,7 +876,7 @@ In order to use knife with the various \fBCLOUD COMPUTING SUB\-COMMANDS\fR, cred
866
876
  Chef is commonly used with Amazon AWS EC2 nodes\. This sub\-command will generate instance metadata that can be used to automatically configure an EC2 instance with Chef\. This requires an AMI that has Chef preinstalled with a configuration file that can parse the metadata at run\-time\. At this time this is the only sub\-command for EC2, but more may be added later similar to \fBRACKSPACE\fR and \fBTERREMARK\fR below\.
867
877
  .
868
878
  .P
869
- \fBec2 instance data [RUN LIST\.\.\.]\fR\fI(options)\fR
879
+ \fBec2 instance data [RUN LIST\.\.\.]\fR \fI(options)\fR
870
880
  .
871
881
  .TP
872
882
  \fB\-e\fR, \fB\-\-edit\fR
@@ -876,7 +886,7 @@ Edit the instance data
876
886
  The \fIRUN LIST\fR should be specified as a space separated list of roles or recipes that will be used by the instance to configure the server\.
877
887
  .
878
888
  .P
879
- \fBec2 server create [RUN LIST\.\.\.]\fR\fI(options)\fR
889
+ \fBec2 server create [RUN LIST\.\.\.]\fR \fI(options)\fR
880
890
  .
881
891
  .TP
882
892
  \fB\-Z\fR, \fB\-\-availability\-zone ZONE\fR
@@ -938,7 +948,7 @@ Bootstrap a distro using a template, passed to \fBbootstrap\fR\.
938
948
  Creates a new Amazon AWS EC2 instance and bootstraps it by calling the \fBbootstrap\fR sub\-command\. The \fB[RUN LIST\.\.\.]\fR items are passed to the bootstrap\'s \fBrun_list\fR config parameter/option\. See the \fBBOOTSTRAP SUB\-COMMANDS\fR section above for more information\.
939
949
  .
940
950
  .P
941
- \fBec2 server delete SERVER [SERVER]\fR\fI(options)\fR
951
+ \fBec2 server delete SERVER [SERVER]\fR \fI(options)\fR
942
952
  .
943
953
  .TP
944
954
  \fB\-A\fR, \fB\-\-aws\-access\-key\-id KEY\fR
@@ -952,7 +962,7 @@ Your AWS API Secret Access Key
952
962
  Terminates a running Amazon AWS EC2 instance\.
953
963
  .
954
964
  .P
955
- \fBec2 server list [RUN LIST\.\.\.]\fR\fI(options)\fR
965
+ \fBec2 server list [RUN LIST\.\.\.]\fR \fI(options)\fR
956
966
  .
957
967
  .TP
958
968
  \fB\-A\fR, \fB\-\-aws\-access\-key\-id KEY\fR
@@ -969,7 +979,7 @@ List running Amazon AWS EC2 instances\.
969
979
  In addition to EC2 nodes, Chef can be used on Rackspace Cloud nodes\. The following sub\-commands allow manipulating Rackspace Cloud nodes via the \fBfog\fR library\.
970
980
  .
971
981
  .P
972
- \fBrackspace server create [RUN LIST\.\.\.]\fR\fI(options)\fR
982
+ \fBrackspace server create [RUN LIST\.\.\.]\fR \fI(options)\fR
973
983
  .
974
984
  .TP
975
985
  \fB\-K\fR, \fB\-\-rackspace\-api\-key KEY\fR
@@ -995,13 +1005,13 @@ The server name
995
1005
  Creates a new Rackspace Cloud server\.
996
1006
  .
997
1007
  .P
998
- \fBrackspace server delete SERVER\fR\fI(options)\fR
1008
+ \fBrackspace server delete SERVER\fR \fI(options)\fR
999
1009
  .
1000
1010
  .P
1001
1011
  Deletes a running Rackspace Cloud server\.
1002
1012
  .
1003
1013
  .P
1004
- \fBrackspace server list\fR\fI(options)\fR
1014
+ \fBrackspace server list\fR \fI(options)\fR
1005
1015
  .
1006
1016
  .P
1007
1017
  Lists running Rackspace Cloud servers\.
@@ -1010,7 +1020,7 @@ Lists running Rackspace Cloud servers\.
1010
1020
  As above, Chef can also be used on Slicehost nodes\. The following sub\-commands allow manipulating Slicehost nodes via the \fBfog\fR library\.
1011
1021
  .
1012
1022
  .P
1013
- \fBslicehost server create [RUN LIST\.\.\.]\fR\fI(options)\fR * \fB\-f\fR, \fB\-\-flavor FLAVOR\fR:
1023
+ \fBslicehost server create [RUN LIST\.\.\.]\fR \fI(options)\fR * \fB\-f\fR, \fB\-\-flavor FLAVOR\fR:
1014
1024
  .
1015
1025
  .IP "" 4
1016
1026
  .
@@ -1038,7 +1048,7 @@ Your slicehost API password
1038
1048
  Creates a new slicehost server\.
1039
1049
  .
1040
1050
  .P
1041
- \fBslicehost server list\fR\fI(options)\fR
1051
+ \fBslicehost server list\fR \fI(options)\fR
1042
1052
  .
1043
1053
  .P
1044
1054
  Lists running Slicehost servers\.
@@ -1059,7 +1069,7 @@ Lists the available Slicehost server images to boot\.
1059
1069
  As above, Chef can also be used on Terremark vCloud nodes\. The following sub\-commands allow manipulating Terremark vCloud nodes via the \fBfog\fR library\.
1060
1070
  .
1061
1071
  .P
1062
- \fBterremark server create NAME [RUN LIST\.\.\.]\fR\fI(options)\fR
1072
+ \fBterremark server create NAME [RUN LIST\.\.\.]\fR \fI(options)\fR
1063
1073
  .
1064
1074
  .TP
1065
1075
  \fB\-K PASSWORD\fR, \fB\-\-terremark\-password\fR
@@ -1077,13 +1087,13 @@ Your terremark username
1077
1087
  Creates a new Terremark vCloud server\.
1078
1088
  .
1079
1089
  .P
1080
- \fBterremark server delete SERVER\fR\fI(options)\fR
1090
+ \fBterremark server delete SERVER\fR \fI(options)\fR
1081
1091
  .
1082
1092
  .P
1083
1093
  Deletes a running Terremark vCloud server\.
1084
1094
  .
1085
1095
  .P
1086
- \fBterremark server list\fR\fI(options)\fR
1096
+ \fBterremark server list\fR \fI(options)\fR
1087
1097
  .
1088
1098
  .TP
1089
1099
  \fB\-K PASSWORD\fR, \fB\-\-terremark\-password\fR
@@ -1175,25 +1185,25 @@ Specifies the name of the client used to validate new clients\. This is requeste
1175
1185
  Specifies the private key file to use for generating ec2 instance data for validating new clients\. This is implied from the \fBvalidation_client_name\fR\.
1176
1186
  .
1177
1187
  .P
1178
- \fBcookbook_copyright\fR\fBcookbook_email\fR\fBcookbook_license\fR
1188
+ \fBcookbook_copyright\fR \fBcookbook_email\fR \fBcookbook_license\fR
1179
1189
  .
1180
1190
  .P
1181
- Used by \fBknife cookbook create\fR sub\-command to specify the copyright holder, maintainer email and license (respectively) for new cookbooks\. The copyright holder is listed as the maintainer in the cookbook\'s metadata and as the Copyright in the comments of the default recipe\. The maintainer email is used in the cookbook metadata\. The license determines what preamble to put in the comment of the default recipe, and is listed as the license in the cookbook metadata\. Currently supported licenses are \"apachev2\" and \"none\"\. Any other values will result in an empty license in the metadata (needs to be filled in by the author), and no comment preamble in the default recipe\.
1191
+ Used by \fBknife cookbook create\fR sub\-command to specify the copyright holder, maintainer email and license (respectively) for new cookbooks\. The copyright holder is listed as the maintainer in the cookbook\'s metadata and as the Copyright in the comments of the default recipe\. The maintainer email is used in the cookbook metadata\. The license determines what preamble to put in the comment of the default recipe, and is listed as the license in the cookbook metadata\. Currently supported licenses are "apachev2" and "none"\. Any other values will result in an empty license in the metadata (needs to be filled in by the author), and no comment preamble in the default recipe\.
1182
1192
  .
1183
1193
  .P
1184
- \fBknife[:aws_access_key_id]\fR\fBknife[:aws_secret_access_key]\fR
1194
+ \fBknife[:aws_access_key_id]\fR \fBknife[:aws_secret_access_key]\fR
1185
1195
  .
1186
1196
  .P
1187
1197
  Specifies the Amazon AWS EC2 credentials to use when running the ec2 sub\-commands\.
1188
1198
  .
1189
1199
  .P
1190
- \fBknife[:rackspace_api_username]\fR\fBknife[:rackspace_api_key]\fR
1200
+ \fBknife[:rackspace_api_username]\fR \fBknife[:rackspace_api_key]\fR
1191
1201
  .
1192
1202
  .P
1193
1203
  Specifies the Rackspace Cloud credentials to use when running the rackspace sub\-commands\.
1194
1204
  .
1195
1205
  .P
1196
- \fBknife[:terremark_username]\fR\fBknife[:terremark_password]\fR\fBknife[:terremark_service]\fR
1206
+ \fBknife[:terremark_username]\fR \fBknife[:terremark_password]\fR \fBknife[:terremark_service]\fR
1197
1207
  .
1198
1208
  .P
1199
1209
  Specifies the Terremark vCloud credentials to use when running the terremark sub\-commands\.