Skip to content
This repository was archived by the owner on Dec 5, 2020. It is now read-only.

Files

61 lines (49 loc) · 1.92 KB

index.html.markdown

File metadata and controls

61 lines (49 loc) · 1.92 KB
layout page_title sidebar_current description
chef
Provider: Chef
docs-chef-index
Chef is a systems and cloud infrastructure automation framework.

Chef Provider

Chef is a systems and cloud infrastructure automation framework. The Chef provider allows Terraform to manage various resources that exist within Chef Server.

Use the navigation to the left to read about the available resources.

Example Usage

# Configure the Chef provider
provider "chef" {
  server_url = "https://api.chef.io/organizations/example/"

  # You can set up a "Client" within the Chef Server management console.
  client_name  = "terraform"
  key_material = "${file("chef-terraform.pem")}"
}

# Create a Chef Environment
resource "chef_environment" "production" {
  name = "production"
}

# Create a Chef Role
resource "chef_role" "app_server" {
  name = "app_server"

  run_list = [
    "recipe[terraform]",
  ]
}

Argument Reference

The following arguments are supported:

  • server_url - (Required) The HTTP(S) API URL of the Chef server to use. If the target Chef server supports organizations, use the full URL of the organization you wish to configure. May be provided instead via the CHEF_SERVER_URL environment variable.
  • client_name - (Required) The name of the client account to use when making requests. This must have been already configured on the Chef server. May be provided instead via the CHEF_CLIENT_NAME environment variable.
  • key_material - (Required) The PEM-formatted private key contents belonging to the configured client. This is issued by the server when a new client object is created. May be provided via the CHEF_KEY_MATERIAL environment variable.
  • allow_unverified_ssl - (Optional) Boolean indicating whether to make requests to a Chef server whose SSL certicate cannot be verified. Defaults to false.