github.com/nathanielks/terraform@v0.6.1-0.20170509030759-13e1a62319dc/website/source/docs/providers/chef/r/role.html.markdown (about)

     1  ---
     2  layout: "chef"
     3  page_title: "Chef: chef_role"
     4  sidebar_current: "docs-chef-resource-role"
     5  description: |-
     6    Creates and manages a role in Chef Server.
     7  ---
     8  
     9  # chef\_role
    10  
    11  A [role](http://docs.chef.io/roles.html) is a set of standard configuration
    12  that can apply across multiple nodes that perform the same function.
    13  
    14  ## Example Usage
    15  
    16  ```hcl
    17  resource "chef_role" "example" {
    18    name     = "example-role"
    19    run_list = ["recipe[example]"]
    20  }
    21  ```
    22  
    23  ## Argument Reference
    24  
    25  The following arguments are supported:
    26  
    27  * `name` - (Required) The unique name to assign to the role.
    28  * `description` - (Optional) A human-friendly description of the role.
    29    If not set, a placeholder of "Managed by Terraform" will be set.
    30  * `default_attributes_json` - (Optional) String containing a JSON-serialized
    31    object containing the default attributes for the role.
    32  * `override_attributes_json` - (Optional) String containing a JSON-serialized
    33    object containing the override attributes for the role.
    34  * `run_list` - (Optional) List of strings to set as the
    35    [run list](https://docs.chef.io/run_lists.html) for any nodes that belong
    36    to this role.
    37  
    38  ## Attributes Reference
    39  
    40  This resource exports no further attributes.