website/docs: Add documentation for the Chef Zero provisioner
This commit is contained in:
parent
dec5dcdda3
commit
2d78f1a816
|
@ -5,11 +5,11 @@ sidebar_current: "provisioning-chefcommon"
|
||||||
|
|
||||||
# Shared Chef Options
|
# Shared Chef Options
|
||||||
|
|
||||||
This page documents the list of available options that are available in
|
This page documents the list of available options that are available in the
|
||||||
both the
|
[Chef Solo](/v2/provisioning/chef_solo.html),
|
||||||
[Chef solo](/v2/provisioning/chef_solo.html)
|
[Chef Zero](/v2/provisioning/chef_zero.html)
|
||||||
and
|
and
|
||||||
[Chef client](/v2/provisioning/chef_client.html)
|
[Chef Client](/v2/provisioning/chef_client.html)
|
||||||
provisioners.
|
provisioners.
|
||||||
|
|
||||||
* `arguments` (string) - A list of additional arguments to pass on the
|
* `arguments` (string) - A list of additional arguments to pass on the
|
||||||
|
|
|
@ -34,7 +34,7 @@ available below this section.
|
||||||
|
|
||||||
Note that only the Chef-solo specific options are shown below. There is
|
Note that only the Chef-solo specific options are shown below. There is
|
||||||
also a large set of [common options](/v2/provisioning/chef_common.html)
|
also a large set of [common options](/v2/provisioning/chef_common.html)
|
||||||
that are available with both the Chef Solo and Chef client provisioners.
|
that are available with all Chef provisioners.
|
||||||
|
|
||||||
* `cookbooks_path` (string or array) - A list of paths to where cookbooks
|
* `cookbooks_path` (string or array) - A list of paths to where cookbooks
|
||||||
are stored. By default this is "cookbooks", expecting a cookbooks folder
|
are stored. By default this is "cookbooks", expecting a cookbooks folder
|
||||||
|
|
|
@ -0,0 +1,65 @@
|
||||||
|
---
|
||||||
|
page_title: "Chef Zero - Provisioning"
|
||||||
|
sidebar_current: "provisioning-chefzero"
|
||||||
|
---
|
||||||
|
|
||||||
|
# Chef Zero Provisioner
|
||||||
|
|
||||||
|
**Provisioner name: `chef_zero`**
|
||||||
|
|
||||||
|
The Chef Zero provisioner allows you to provision the guest using
|
||||||
|
[Chef](https://www.getchef.com/chef/), specifically with
|
||||||
|
[Chef Zero/local mode](https://docs.getchef.com/ctl_chef_client.html#run-in-local-mode).
|
||||||
|
|
||||||
|
This new provisioner is a middle ground between running a full blown
|
||||||
|
Chef Server and using the limited [Chef Solo](/v2/provisioning/chef_solo.html)
|
||||||
|
provisioner. It runs a local in-memory Chef Server and fakes the validation
|
||||||
|
and client key registration.
|
||||||
|
|
||||||
|
<div class="alert alert-warn">
|
||||||
|
<p>
|
||||||
|
<strong>Warning:</strong> If you're not familiar with Chef and Vagrant already,
|
||||||
|
I recommend starting with the <a href="/v2/provisioning/shell.html">shell
|
||||||
|
provisioner</a>. However, if you're comfortable with Vagrant already, Vagrant
|
||||||
|
is the best way to learn Chef.
|
||||||
|
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
## Options
|
||||||
|
|
||||||
|
This section lists the complete set of available options for the Chef Zero
|
||||||
|
provisioner. More detailed examples of how to use the provisioner are
|
||||||
|
available below this section.
|
||||||
|
|
||||||
|
Note that only the Chef Zero specific options are shown below, but all [Chef
|
||||||
|
Solo options](/v2/provisioning/chef_solo.html), including the [common Chef
|
||||||
|
provisioner options](/v2/provisioning/chef_common.html), are also inherited.
|
||||||
|
|
||||||
|
* `nodes_path` (string) - A path where the Chef nodes are stored. Be default,
|
||||||
|
no node path is set.
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
The Chef Zero provisioner is configured basically the same way as the Chef Solo
|
||||||
|
provisioner. See the [Chef Solo documentations](/v2/provisioning/chef_solo.html)
|
||||||
|
for more information.
|
||||||
|
|
||||||
|
A basic example could look like this:
|
||||||
|
|
||||||
|
```ruby
|
||||||
|
Vagrant.configure("2") do |config|
|
||||||
|
config.vm.provision "chef_zero" do |chef|
|
||||||
|
# Specify the local paths where Chef data is stored
|
||||||
|
chef.cookbooks_path = "cookbooks"
|
||||||
|
chef.roles_path = "roles"
|
||||||
|
chef.nodes_path = "nodes"
|
||||||
|
|
||||||
|
# Add a recipe
|
||||||
|
chef.add_recipe "apache"
|
||||||
|
|
||||||
|
# Or maybe a role
|
||||||
|
chef.add_role "web"
|
||||||
|
end
|
||||||
|
end
|
||||||
|
```
|
Loading…
Reference in New Issue