microwave 11.400.5 → 11.400.6
Sign up to get free protection for your applications and to get access to all the features.
- data/VERSION +1 -1
- data/lib/chef/daemon.rb +0 -2
- metadata +3 -118
- data/distro/README +0 -2
- data/distro/arch/etc/conf.d/chef-client.conf +0 -5
- data/distro/arch/etc/conf.d/chef-expander.conf +0 -8
- data/distro/arch/etc/conf.d/chef-server-webui.conf +0 -10
- data/distro/arch/etc/conf.d/chef-server.conf +0 -10
- data/distro/arch/etc/conf.d/chef-solr.conf +0 -8
- data/distro/arch/etc/rc.d/chef-client +0 -90
- data/distro/arch/etc/rc.d/chef-expander +0 -78
- data/distro/arch/etc/rc.d/chef-server +0 -78
- data/distro/arch/etc/rc.d/chef-server-webui +0 -78
- data/distro/arch/etc/rc.d/chef-solr +0 -78
- data/distro/common/html/chef-client.8.html +0 -145
- data/distro/common/html/chef-expander.8.html +0 -164
- data/distro/common/html/chef-expanderctl.8.html +0 -146
- data/distro/common/html/chef-server-webui.8.html +0 -185
- data/distro/common/html/chef-server.8.html +0 -182
- data/distro/common/html/chef-shell.1.html +0 -286
- data/distro/common/html/chef-solo.8.html +0 -191
- data/distro/common/html/chef-solr.8.html +0 -165
- data/distro/common/html/knife-bootstrap.1.html +0 -241
- data/distro/common/html/knife-client.1.html +0 -219
- data/distro/common/html/knife-configure.1.html +0 -170
- data/distro/common/html/knife-cookbook-site.1.html +0 -241
- data/distro/common/html/knife-cookbook.1.html +0 -384
- data/distro/common/html/knife-data-bag.1.html +0 -238
- data/distro/common/html/knife-environment.1.html +0 -267
- data/distro/common/html/knife-exec.1.html +0 -134
- data/distro/common/html/knife-index.1.html +0 -125
- data/distro/common/html/knife-node.1.html +0 -250
- data/distro/common/html/knife-role.1.html +0 -200
- data/distro/common/html/knife-search.1.html +0 -288
- data/distro/common/html/knife-ssh.1.html +0 -156
- data/distro/common/html/knife-status.1.html +0 -128
- data/distro/common/html/knife-tag.1.html +0 -137
- data/distro/common/html/knife.1.html +0 -315
- data/distro/common/man/man1/chef-shell.1 +0 -220
- data/distro/common/man/man1/knife-bootstrap.1 +0 -201
- data/distro/common/man/man1/knife-client.1 +0 -99
- data/distro/common/man/man1/knife-configure.1 +0 -88
- data/distro/common/man/man1/knife-cookbook-site.1 +0 -145
- data/distro/common/man/man1/knife-cookbook.1 +0 -345
- data/distro/common/man/man1/knife-data-bag.1 +0 -136
- data/distro/common/man/man1/knife-environment.1 +0 -178
- data/distro/common/man/man1/knife-exec.1 +0 -43
- data/distro/common/man/man1/knife-index.1 +0 -29
- data/distro/common/man/man1/knife-node.1 +0 -134
- data/distro/common/man/man1/knife-role.1 +0 -88
- data/distro/common/man/man1/knife-search.1 +0 -280
- data/distro/common/man/man1/knife-ssh.1 +0 -79
- data/distro/common/man/man1/knife-status.1 +0 -29
- data/distro/common/man/man1/knife-tag.1 +0 -43
- data/distro/common/man/man1/knife.1 +0 -285
- data/distro/common/man/man8/chef-client.8 +0 -104
- data/distro/common/man/man8/chef-expander.8 +0 -97
- data/distro/common/man/man8/chef-expanderctl.8 +0 -62
- data/distro/common/man/man8/chef-server-webui.8 +0 -155
- data/distro/common/man/man8/chef-server.8 +0 -147
- data/distro/common/man/man8/chef-solo.8 +0 -158
- data/distro/common/man/man8/chef-solr.8 +0 -122
- data/distro/common/markdown/README +0 -3
- data/distro/common/markdown/man1/chef-shell.mkd +0 -195
- data/distro/common/markdown/man1/knife-bootstrap.mkd +0 -141
- data/distro/common/markdown/man1/knife-client.mkd +0 -103
- data/distro/common/markdown/man1/knife-configure.mkd +0 -70
- data/distro/common/markdown/man1/knife-cookbook-site.mkd +0 -123
- data/distro/common/markdown/man1/knife-cookbook.mkd +0 -263
- data/distro/common/markdown/man1/knife-data-bag.mkd +0 -121
- data/distro/common/markdown/man1/knife-environment.mkd +0 -151
- data/distro/common/markdown/man1/knife-exec.mkd +0 -42
- data/distro/common/markdown/man1/knife-index.mkd +0 -30
- data/distro/common/markdown/man1/knife-node.mkd +0 -130
- data/distro/common/markdown/man1/knife-role.mkd +0 -85
- data/distro/common/markdown/man1/knife-search.mkd +0 -180
- data/distro/common/markdown/man1/knife-ssh.mkd +0 -69
- data/distro/common/markdown/man1/knife-status.mkd +0 -36
- data/distro/common/markdown/man1/knife-tag.mkd +0 -39
- data/distro/common/markdown/man1/knife.mkd +0 -213
- data/distro/common/markdown/man8/chef-client.mkd +0 -74
- data/distro/common/markdown/man8/chef-expander.mkd +0 -82
- data/distro/common/markdown/man8/chef-expanderctl.mkd +0 -58
- data/distro/common/markdown/man8/chef-server-webui.mkd +0 -121
- data/distro/common/markdown/man8/chef-server.mkd +0 -121
- data/distro/common/markdown/man8/chef-solo.mkd +0 -107
- data/distro/common/markdown/man8/chef-solr.mkd +0 -89
- data/distro/debian/etc/default/chef-client +0 -4
- data/distro/debian/etc/default/chef-expander +0 -8
- data/distro/debian/etc/default/chef-server +0 -9
- data/distro/debian/etc/default/chef-server-webui +0 -9
- data/distro/debian/etc/default/chef-solr +0 -8
- data/distro/debian/etc/init.d/chef-client +0 -210
- data/distro/debian/etc/init.d/chef-expander +0 -176
- data/distro/debian/etc/init.d/chef-server +0 -122
- data/distro/debian/etc/init.d/chef-server-webui +0 -123
- data/distro/debian/etc/init.d/chef-solr +0 -176
- data/distro/debian/etc/init/chef-client.conf +0 -17
- data/distro/debian/etc/init/chef-expander.conf +0 -17
- data/distro/debian/etc/init/chef-server-webui.conf +0 -17
- data/distro/debian/etc/init/chef-server.conf +0 -17
- data/distro/debian/etc/init/chef-solr.conf +0 -17
- data/distro/redhat/etc/init.d/chef-client +0 -121
- data/distro/redhat/etc/init.d/chef-expander +0 -104
- data/distro/redhat/etc/init.d/chef-server +0 -112
- data/distro/redhat/etc/init.d/chef-server-webui +0 -112
- data/distro/redhat/etc/init.d/chef-solr +0 -104
- data/distro/redhat/etc/logrotate.d/chef-client +0 -8
- data/distro/redhat/etc/logrotate.d/chef-expander +0 -8
- data/distro/redhat/etc/logrotate.d/chef-server +0 -8
- data/distro/redhat/etc/logrotate.d/chef-server-webui +0 -8
- data/distro/redhat/etc/logrotate.d/chef-solr +0 -8
- data/distro/redhat/etc/sysconfig/chef-client +0 -15
- data/distro/redhat/etc/sysconfig/chef-expander +0 -7
- data/distro/redhat/etc/sysconfig/chef-server +0 -14
- data/distro/redhat/etc/sysconfig/chef-server-webui +0 -14
- data/distro/redhat/etc/sysconfig/chef-solr +0 -8
- data/distro/windows/service_manager.rb +0 -164
@@ -1,122 +0,0 @@
|
|
1
|
-
.\" generated with Ronn/v0.7.3
|
2
|
-
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
3
|
-
.
|
4
|
-
.TH "CHEF\-SOLR" "8" "February 2013" "Chef 11.2.0" "Chef Manual"
|
5
|
-
.
|
6
|
-
.SH "NAME"
|
7
|
-
\fBchef\-solr\fR \- Runs as Chef\'s search server
|
8
|
-
.
|
9
|
-
.SH "SYNOPSIS"
|
10
|
-
\fBchef\-solr\fR \fI(options)\fR
|
11
|
-
.
|
12
|
-
.TP
|
13
|
-
\fB\-c\fR, \fB\-\-config CONFIG\fR
|
14
|
-
The configuration file to use
|
15
|
-
.
|
16
|
-
.TP
|
17
|
-
\fB\-d\fR, \fB\-\-daemonize\fR
|
18
|
-
Daemonize the process
|
19
|
-
.
|
20
|
-
.TP
|
21
|
-
\fB\-g\fR, \fB\-\-group GROUP\fR
|
22
|
-
Group to set privilege to
|
23
|
-
.
|
24
|
-
.TP
|
25
|
-
\fB\-l\fR, \fB\-\-log_level LEVEL\fR
|
26
|
-
Set the log level (debug, info, warn, error, fatal)
|
27
|
-
.
|
28
|
-
.TP
|
29
|
-
\fB\-L\fR, \fB\-\-logfile LOGLOCATION\fR
|
30
|
-
Set the log file location, defaults to STDOUT \- recommended for daemonizing
|
31
|
-
.
|
32
|
-
.TP
|
33
|
-
\fB\-P\fR, \fB\-\-pid PIDFILE\fR
|
34
|
-
Set the PID file location, defaults to /tmp/chef\-solr\.pid
|
35
|
-
.
|
36
|
-
.TP
|
37
|
-
\fB\-D\fR, \fB\-\-solr\-data\-dir PATH\fR
|
38
|
-
Where the Solr data lives
|
39
|
-
.
|
40
|
-
.TP
|
41
|
-
\fB\-x\fR, \fB\-\-solor\-heap\-size SIZE\fR
|
42
|
-
Set the size of the Java Heap
|
43
|
-
.
|
44
|
-
.TP
|
45
|
-
\fB\-H\fR, \fB\-\-solr\-home\-dir PATH\fR
|
46
|
-
Solr home directory
|
47
|
-
.
|
48
|
-
.TP
|
49
|
-
\fB\-j\fR, \fB\-\-java\-opts OPTS\fR
|
50
|
-
Raw options passed to Java
|
51
|
-
.
|
52
|
-
.TP
|
53
|
-
\fB\-x\fR, \fB\-\-solor\-heap\-size\fR
|
54
|
-
Set the size of the Java Heap
|
55
|
-
.
|
56
|
-
.TP
|
57
|
-
\fB\-W\fR, \fB\-\-solr\-jetty\-dir PATH\fR
|
58
|
-
Where to place the Solr Jetty instance
|
59
|
-
.
|
60
|
-
.TP
|
61
|
-
\fB\-u\fR, \fB\-\-user USER\fR
|
62
|
-
User to set privilege to
|
63
|
-
.
|
64
|
-
.TP
|
65
|
-
\fB\-v\fR, \fB\-\-version\fR
|
66
|
-
Show chef\-solr version
|
67
|
-
.
|
68
|
-
.TP
|
69
|
-
\fB\-h\fR, \fB\-\-help\fR
|
70
|
-
Show this message
|
71
|
-
.
|
72
|
-
.SH "DESCRIPTION"
|
73
|
-
Chef\-solr provides search service for Chef\. You need to have both chef\-solr and chef\-expander\-cluster running in order for search to work\.
|
74
|
-
.
|
75
|
-
.P
|
76
|
-
\fBInstallation\fR
|
77
|
-
.
|
78
|
-
.P
|
79
|
-
Make sure you backed up your data if you are upgrading from a previous version\. Run chef\-solr\-installer to upgrade your Chef Solr installation\. Answer "yes" when prompted for confirmation\. The process should look like this:
|
80
|
-
.
|
81
|
-
.IP "" 4
|
82
|
-
.
|
83
|
-
.nf
|
84
|
-
|
85
|
-
yourshell> chef\-solr\-installer
|
86
|
-
Configuration setting solr_heap_size is unknown and will be ignored
|
87
|
-
|
88
|
-
Chef Solr is already installed in /var/chef/solr
|
89
|
-
Do you want to overwrite the current install? All existing Solr data will be lost\. [y/n] y
|
90
|
-
Removing the existing Chef Solr installation
|
91
|
-
rm \-rf /var/chef/solr
|
92
|
-
rm \-rf /var/chef/solr\-jetty
|
93
|
-
rm \-rf /var/chef/solr/data
|
94
|
-
Creating Solr Home Directory
|
95
|
-
mkdir \-p /var/chef/solr
|
96
|
-
entering /var/chef/solr
|
97
|
-
tar zxvf /Users/ddeleo/opscode/chef/chef\-solr/solr/solr\-home\.tar\.gz
|
98
|
-
Creating Solr Data Directory
|
99
|
-
mkdir \-p /var/chef/solr/data
|
100
|
-
Unpacking Solr Jetty
|
101
|
-
mkdir \-p /var/chef/solr\-jetty
|
102
|
-
entering /var/chef/solr\-jetty
|
103
|
-
tar zxvf /Users/ddeleo/opscode/chef/chef\-solr/solr/solr\-jetty\.tar\.gz
|
104
|
-
|
105
|
-
Successfully installed Chef Solr\.
|
106
|
-
You can restore your search index using `knife index rebuild`
|
107
|
-
.
|
108
|
-
.fi
|
109
|
-
.
|
110
|
-
.IP "" 0
|
111
|
-
.
|
112
|
-
.SH "SEE ALSO"
|
113
|
-
\fBchef\-expander\-cluster\fR(8)
|
114
|
-
.
|
115
|
-
.P
|
116
|
-
Full documentation for Chef and chef\-server is located on the Chef wiki, http://wiki\.opscode\.com/display/chef/Home\.
|
117
|
-
.
|
118
|
-
.SH "AUTHOR"
|
119
|
-
Chef was written by Adam Jacob \fIadam@ospcode\.com\fR of Opscode (http://www\.opscode\.com), with contributions from the community\. This manual page was written by Joshua Timberman \fIjoshua@opscode\.com\fR with help2man\. Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2\.0 License\.
|
120
|
-
.
|
121
|
-
.P
|
122
|
-
On Debian systems, the complete text of the Apache 2\.0 License can be found in /usr/share/common\-licenses/Apache\-2\.0\.
|
@@ -1,195 +0,0 @@
|
|
1
|
-
chef-shell(1) -- Interactive Chef Console
|
2
|
-
=========================================
|
3
|
-
|
4
|
-
## SYNOPSIS
|
5
|
-
|
6
|
-
__chef-shell__ [_named configuration_] _(options)_
|
7
|
-
|
8
|
-
* `-S`, `--server CHEF_SERVER_URL`:
|
9
|
-
The chef server URL
|
10
|
-
* `-z`, `--client`:
|
11
|
-
chef-client mode
|
12
|
-
* `-c`, `--config CONFIG`:
|
13
|
-
The configuration file to use
|
14
|
-
* `-j`, `--json-attributes JSON_ATTRIBS`:
|
15
|
-
Load attributes from a JSON file or URL
|
16
|
-
* `-l`, `--log-level LOG_LEVEL`:
|
17
|
-
Set the logging level
|
18
|
-
* `-s`, `--solo`:
|
19
|
-
chef-solo session
|
20
|
-
* `-a`, `--standalone`:
|
21
|
-
standalone session
|
22
|
-
* `-v`, `--version`:
|
23
|
-
Show chef version
|
24
|
-
* `-h`, `--help`:
|
25
|
-
Show command options
|
26
|
-
|
27
|
-
When no --config option is specified, chef-shell attempts to load a
|
28
|
-
default configuration file:
|
29
|
-
|
30
|
-
* If a _named configuration_ is given, chef-shell will load ~/.chef/_named
|
31
|
-
configuration_/chef_shell.rb
|
32
|
-
* If no _named configuration_ is given chef-shell will load
|
33
|
-
~/.chef/chef_shell.rb if it exists
|
34
|
-
* chef-shell falls back to loading /etc/chef/client.rb or
|
35
|
-
/etc/chef/solo.rb if -z or -s options are given and no chef_shell.rb
|
36
|
-
can be found.
|
37
|
-
* The --config option takes precedence over implicit configuration
|
38
|
-
paths.
|
39
|
-
|
40
|
-
## DESCRIPTION
|
41
|
-
|
42
|
-
`chef-shell` is an irb(1) (interactive ruby) session customized for Chef.
|
43
|
-
`chef-shell` serves two primary functions: it provides a means to
|
44
|
-
interact with a Chef Server interactively using a convenient DSL; it
|
45
|
-
allows you to define and run Chef recipes interactively.
|
46
|
-
|
47
|
-
## SYNTAX
|
48
|
-
|
49
|
-
chef-shell uses irb's subsession feature to provide multiple modes of
|
50
|
-
interaction. In addition to the primary mode which is entered on start,
|
51
|
-
`recipe` and `attributes` modes are available.
|
52
|
-
|
53
|
-
## PRIMARY MODE
|
54
|
-
The following commands are available in the primary
|
55
|
-
session:
|
56
|
-
|
57
|
-
* `help`:
|
58
|
-
Prints a list of available commands
|
59
|
-
* `version`:
|
60
|
-
Prints the Chef version
|
61
|
-
* `recipe`:
|
62
|
-
Switches to `recipe` mode
|
63
|
-
* `attributes`:
|
64
|
-
Switches to `attributes` mode
|
65
|
-
* `run_chef`:
|
66
|
-
Initiates a chef run
|
67
|
-
* `reset`:
|
68
|
-
reinitializes chef-shell session
|
69
|
-
* `echo :on|:off`:
|
70
|
-
Turns irb's echo function on or off. Echo is _on_ by default.
|
71
|
-
* `tracing :on|:off`:
|
72
|
-
Turns irb's function tracing feature on or off. Tracing is extremely
|
73
|
-
verbose and expected to be of interest primarily to developers.
|
74
|
-
* `node`:
|
75
|
-
Returns the _node_ object for the current host. See knife-node(1)
|
76
|
-
for more information about nodes.
|
77
|
-
* `ohai`:
|
78
|
-
Prints the attributes of _node_
|
79
|
-
|
80
|
-
In addition to these commands, chef-shell provides a DSL for accessing
|
81
|
-
data on the Chef Server. When working with remote data in chef-shell, you
|
82
|
-
chain method calls in the form _object type_._operation_, where
|
83
|
-
_object type_ is in plural form. The following object types are
|
84
|
-
available:
|
85
|
-
|
86
|
-
* `nodes`
|
87
|
-
* `roles`
|
88
|
-
* `data_bags`
|
89
|
-
* `clients`
|
90
|
-
* `cookbooks`
|
91
|
-
|
92
|
-
For each _object type_ the following operations are available:
|
93
|
-
|
94
|
-
* _object type_.all(_&block_):
|
95
|
-
Loads all items from the server. If the optional code _block_ is
|
96
|
-
given, each item will be passed to the block and the results
|
97
|
-
returned, similar to ruby's `Enumerable#map` method.
|
98
|
-
* _object type_.show(_object name_):
|
99
|
-
Aliased as _object type_.load
|
100
|
-
|
101
|
-
Loads the singular item identified by _object name_.
|
102
|
-
* _object type_.search(_query_, _&block_):
|
103
|
-
Aliased as _object type_.find
|
104
|
-
|
105
|
-
Runs a search against the server and returns the matching items. If
|
106
|
-
the optional code _block_ is given each item will be passed to the
|
107
|
-
block and the results returned.
|
108
|
-
|
109
|
-
The _query_ may be a Solr/Lucene format query given as a String, or
|
110
|
-
a Hash of conditions. If a Hash is given, the options will be ANDed
|
111
|
-
together. To join conditions with OR, use negative queries, or any
|
112
|
-
advanced search syntax, you must provide give the query in String
|
113
|
-
form.
|
114
|
-
* _object type_.transform(:all|_query_, _&block_):
|
115
|
-
Aliased as _object type_.bulk_edit
|
116
|
-
|
117
|
-
Bulk edit objects by processing them with the (required) code _block_.
|
118
|
-
You can edit all objects of the given type by passing the Symbol
|
119
|
-
`:all` as the argument, or only a subset by passing a _query_ as the
|
120
|
-
argument. The _query_ is evaluated in the same way as with
|
121
|
-
__search__.
|
122
|
-
|
123
|
-
The return value of the code _block_ is used to alter the behavior
|
124
|
-
of `transform`. If the value returned from the block is `nil` or
|
125
|
-
`false`, the object will not be saved. Otherwise, the object is
|
126
|
-
saved after being passed to the block. This behavior can be
|
127
|
-
exploited to create a dry run to test a data transformation.
|
128
|
-
|
129
|
-
## RECIPE MODE
|
130
|
-
Recipe mode implements Chef's recipe DSL. Exhaustively documenting this
|
131
|
-
DSL is outside the scope of this document. See the following pages in
|
132
|
-
the Chef documentation for more information:
|
133
|
-
|
134
|
-
* <http://wiki.opscode.com/display/chef/Resources>
|
135
|
-
* <http://wiki.opscode.com/display/chef/Recipes>
|
136
|
-
|
137
|
-
Once you have defined resources in the recipe, you can trigger a
|
138
|
-
convergence run via `run_chef`
|
139
|
-
|
140
|
-
## EXAMPLES
|
141
|
-
|
142
|
-
* A "Hello World" interactive recipe
|
143
|
-
|
144
|
-
chef > recipe
|
145
|
-
chef:recipe > echo :off
|
146
|
-
chef:recipe > file "/tmp/hello\_world"
|
147
|
-
chef:recipe > run\_chef
|
148
|
-
[Sat, 09 Apr 2011 08:56:56 -0700] INFO: Processing file[/tmp/hello\_world] action create ((irb#1) line 2)
|
149
|
-
[Sat, 09 Apr 2011 08:56:56 -0700] INFO: file[/tmp/hello\_world] created file /tmp/hello\_world
|
150
|
-
chef:recipe > pp ls '/tmp'
|
151
|
-
[".",
|
152
|
-
"..",
|
153
|
-
"hello\_world"]
|
154
|
-
|
155
|
-
* Search for _nodes_ by role, and print their IP addresses
|
156
|
-
|
157
|
-
chef > nodes.find(:roles => 'monitoring-server') {|n| n[:ipaddress] }
|
158
|
-
=> ["10.254.199.5"]
|
159
|
-
|
160
|
-
* Remove the role _obsolete_ from every node in the system
|
161
|
-
|
162
|
-
chef > nodes.transform(:all) {|n| n.run\_list.delete('role[obsolete]') }
|
163
|
-
=> [node[chef098b2.opschef.com], node[ree-woot], node[graphite-dev], node[fluke.localdomain], node[ghost.local], node[kallistec]]
|
164
|
-
|
165
|
-
|
166
|
-
## BUGS
|
167
|
-
|
168
|
-
`chef-shell` often does not perfectly replicate the context in which
|
169
|
-
chef-client(8) configures a host, which may lead to discrepancies in
|
170
|
-
observed behavior.
|
171
|
-
|
172
|
-
`chef-shell` has to duplicate much code from chef-client's internal
|
173
|
-
libraries and may become out of sync with the behavior of those
|
174
|
-
libraries.
|
175
|
-
|
176
|
-
## SEE ALSO
|
177
|
-
|
178
|
-
chef-client(8) knife(1)
|
179
|
-
<http://wiki.opscode.com/display/chef/Chef+Shell>
|
180
|
-
|
181
|
-
## AUTHOR
|
182
|
-
|
183
|
-
Chef was written by Adam Jacob <adam@opscode.com> with many
|
184
|
-
contributions from the community. chef-shell was written by Daniel
|
185
|
-
DeLeo.
|
186
|
-
|
187
|
-
## DOCUMENTATION
|
188
|
-
|
189
|
-
This manual page was written by Daniel DeLeo <dan@opscode.com>.
|
190
|
-
Permission is granted to copy, distribute and / or modify this
|
191
|
-
document under the terms of the Apache 2.0 License.
|
192
|
-
|
193
|
-
## CHEF
|
194
|
-
|
195
|
-
chef-shell is distributed with Chef. <http://wiki.opscode.com/display/chef/Home>
|
@@ -1,141 +0,0 @@
|
|
1
|
-
knife-bootstrap(1) -- Install Chef Client on a remote host
|
2
|
-
========================================
|
3
|
-
|
4
|
-
## SYNOPSIS
|
5
|
-
|
6
|
-
__knife__ __bootstrap__ _(options)_
|
7
|
-
|
8
|
-
* `-i`, `--identity-file IDENTITY_FILE`:
|
9
|
-
The SSH identity file used for authentication
|
10
|
-
* `-N`, `--node-name NAME`:
|
11
|
-
The Chef node name for your new node
|
12
|
-
* `-P`, `--ssh-password PASSWORD`:
|
13
|
-
The ssh password
|
14
|
-
* `-x`, `--ssh-user USERNAME`:
|
15
|
-
The ssh username
|
16
|
-
* `-p`, `--ssh-port PORT`:
|
17
|
-
The ssh port
|
18
|
-
* `--bootstrap-version VERSION`:
|
19
|
-
The version of Chef to install
|
20
|
-
* `--bootstrap-proxy PROXY_URL`:
|
21
|
-
`The proxy server for the node being bootstrapped`
|
22
|
-
* `--prerelease`:
|
23
|
-
Install pre-release Chef gems
|
24
|
-
* `-r`, `--run-list RUN_LIST`:
|
25
|
-
Comma separated list of roles/recipes to apply
|
26
|
-
* `--template-file TEMPLATE`:
|
27
|
-
Full path to location of template to use
|
28
|
-
* `--sudo`:
|
29
|
-
Execute the bootstrap via sudo
|
30
|
-
* `-d`, `--distro DISTRO`:
|
31
|
-
Bootstrap a distro using a template
|
32
|
-
* `--[no-]host-key-verify`:
|
33
|
-
Enable host key verification, which is the default behavior.
|
34
|
-
* `--hint HINT_NAME[=HINT_FILE]`:
|
35
|
-
Provide the name of a hint (with option JSON file) to set for use by
|
36
|
-
Ohai plugins.
|
37
|
-
|
38
|
-
## DESCRIPTION
|
39
|
-
|
40
|
-
Performs a Chef Bootstrap on the target node. The goal of the bootstrap
|
41
|
-
is to get Chef installed on the target system so it can run Chef Client
|
42
|
-
with a Chef Server. The main assumption is a baseline OS installation
|
43
|
-
exists. This sub-command is used internally by some cloud computing
|
44
|
-
plugins.
|
45
|
-
|
46
|
-
The bootstrap sub-command supports supplying a template to perform the
|
47
|
-
bootstrap steps. If the distro is not specified (via `-d` or `--distro`
|
48
|
-
option), an Ubuntu 10.04 host bootstrapped with RubyGems is assumed. The
|
49
|
-
__DISTRO__ value corresponds to the base filename of the template, in
|
50
|
-
other words `DISTRO`.erb. A template file can be specified with the
|
51
|
-
`--template-file` option in which case the __DISTRO__ is not used. The
|
52
|
-
sub-command looks in the following locations for the template to use:
|
53
|
-
|
54
|
-
* `bootstrap` directory in the installed Chef Knife library.
|
55
|
-
* `bootstrap` directory in the `$PWD/.chef`.
|
56
|
-
* `bootstrap` directory in the users `$HOME/.chef`.
|
57
|
-
|
58
|
-
The default bootstrap templates are scripts that get copied to the
|
59
|
-
target node (FQDN). The following distros are supported:
|
60
|
-
|
61
|
-
* centos5-gems
|
62
|
-
* fedora13-gems
|
63
|
-
* ubuntu10.04-gems
|
64
|
-
* ubuntu10.04-apt
|
65
|
-
|
66
|
-
The gems installations will use RubyGems 1.3.6 and Chef installed as a
|
67
|
-
gem. The apt installation will use the Opscode APT repository.
|
68
|
-
|
69
|
-
In addition to handling the software installation, these bootstrap
|
70
|
-
templates do the following:
|
71
|
-
|
72
|
-
- Write the validation.pem per the local knife configuration.
|
73
|
-
- Write a default config file for Chef (`/etc/chef/client.rb`) using values from the `knife.rb`.
|
74
|
-
- Create a JSON attributes file containing the specified run list and run Chef.
|
75
|
-
|
76
|
-
In the case of the RubyGems, the `client.rb` will be written from
|
77
|
-
scratch with a minimal set of values; see __EXAMPLES__. In the case of
|
78
|
-
APT Package installation, `client.rb` will have the
|
79
|
-
`validation_client_name` appended if it is not set to `chef-validator`
|
80
|
-
(default config value), and the `node_name` will be added if
|
81
|
-
`chef_node_name` option is specified.
|
82
|
-
|
83
|
-
When this is complete, the bootstrapped node will have:
|
84
|
-
|
85
|
-
- Latest Chef version installed from RubyGems or APT Packages from Opscode. This may be a later version than the local system.
|
86
|
-
- Be validated with the configured Chef Server.
|
87
|
-
- Have run Chef with its default run list if one is specfied.
|
88
|
-
|
89
|
-
Additional custom bootstrap templates can be created and stored in
|
90
|
-
`.chef/bootstrap/DISTRO.erb`, replacing __DISTRO__ with the value passed
|
91
|
-
with the `-d` or `--distro` option. See __EXAMPLES__ for more
|
92
|
-
information.
|
93
|
-
|
94
|
-
## EXAMPLES
|
95
|
-
Setting up a custom bootstrap is fairly straightforward. Create a
|
96
|
-
`.chef/bootstrap` directory in your Chef Repository or in
|
97
|
-
`$HOME/.chef/bootstrap`. Then create the ERB template file.
|
98
|
-
|
99
|
-
mkdir ~/.chef/bootstrap
|
100
|
-
vi ~/.chef/bootstrap/debian5.0-apt.erb
|
101
|
-
|
102
|
-
For example, to create a new bootstrap template that should be used when
|
103
|
-
setting up a new Debian node. Edit the template to run the commands, set
|
104
|
-
up the validation certificate and the client configuration file, and
|
105
|
-
finally to run chef-client on completion. The bootstrap template can be
|
106
|
-
called with:
|
107
|
-
|
108
|
-
knife bootstrap mynode.example.com --template-file ~/.chef/bootstrap/debian5.0-apt.erb
|
109
|
-
|
110
|
-
Or,
|
111
|
-
|
112
|
-
knife bootstrap mynode.example.com --distro debian5.0-apt
|
113
|
-
|
114
|
-
The `--distro` parameter will automatically look in the
|
115
|
-
`~/.chef/bootstrap` directory for a file named `debian5.0-apt.erb`.
|
116
|
-
|
117
|
-
Templates provided by the Chef installation are located in
|
118
|
-
`BASEDIR/lib/chef/knife/bootstrap/*.erb`, where _BASEDIR_ is the
|
119
|
-
location where the package or Gem installed the Chef client libraries.
|
120
|
-
|
121
|
-
## BUGS
|
122
|
-
`knife bootstrap` is not capable of bootstrapping multiple hosts in
|
123
|
-
parallel.
|
124
|
-
|
125
|
-
The bootstrap script is passed as an argument to sh(1) on the remote
|
126
|
-
system, so sensitive information contained in the script will be visible
|
127
|
-
to other users via the process list using tools such as ps(1).
|
128
|
-
|
129
|
-
## SEE ALSO
|
130
|
-
__knife-ssh__(1)
|
131
|
-
|
132
|
-
## AUTHOR
|
133
|
-
Chef was written by Adam Jacob <adam@opscode.com> with many contributions from the community.
|
134
|
-
|
135
|
-
## DOCUMENTATION
|
136
|
-
This manual page was written by Joshua Timberman <joshua@opscode.com>.
|
137
|
-
Permission is granted to copy, distribute and / or modify this document under the terms of the Apache 2.0 License.
|
138
|
-
|
139
|
-
|
140
|
-
## CHEF
|
141
|
-
Knife is distributed with Chef. <http://wiki.opscode.com/display/chef/Home>
|