terraform/website/source/docs/providers/chef/r/node.html.markdown

49 lines
1.6 KiB
Markdown
Raw Normal View History

2015-08-29 18:16:50 +02:00
---
layout: "chef"
page_title: "Chef: chef_node"
sidebar_current: "docs-chef-resource-node"
description: |-
Creates and manages a node in Chef Server.
---
2017-04-10 18:09:04 +02:00
# chef_node
2015-08-29 18:16:50 +02:00
A [node](http://docs.chef.io/nodes.html) is a computer whose
configuration is managed by Chef.
Although this resource allows a node to be registered, it does not actually
configure the computer in question to interact with Chef. In most cases it
is better to use [the `chef` provisioner](/docs/provisioners/chef.html) to
configure the Chef client on a computer and have it register itself with the
Chef server.
## Example Usage
2017-04-10 18:09:04 +02:00
```hcl
2015-08-29 18:16:50 +02:00
resource "chef_node" "example" {
name = "example-environment"
environment_name = "${chef_environment.example.name}"
run_list = ["recipe[example]", "role[app_server]"]
2015-08-29 18:16:50 +02:00
}
```
## Argument Reference
The following arguments are supported:
* `name` - (Required) The unique name to assign to the node.
* `automatic_attributes_json` - (Optional) String containing a JSON-serialized
object containing the automatic attributes for the node.
* `normal_attributes_json` - (Optional) String containing a JSON-serialized
object containing the normal attributes for the node.
* `default_attributes_json` - (Optional) String containing a JSON-serialized
object containing the default attributes for the node.
* `override_attributes_json` - (Optional) String containing a JSON-serialized
object containing the override attributes for the node.
* `run_list` - (Optional) List of strings to set as the
[run list](https://docs.chef.io/run_lists.html) for the node.
## Attributes Reference
This resource exports no further attributes.