github.com/danp/terraform@v0.9.5-0.20170426144147-39d740081351/website/source/docs/providers/rancher/r/environment.html.md (about)

     1  ---
     2  layout: "rancher"
     3  page_title: "Rancher: rancher_environment"
     4  sidebar_current: "docs-rancher-resource-environment"
     5  description: |-
     6    Provides a Rancher Environment resource. This can be used to create and manage environments on rancher.
     7  ---
     8  
     9  # rancher\_environment
    10  
    11  Provides a Rancher Environment resource. This can be used to create and manage environments on rancher.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  # Create a new Rancher environment
    17  resource "rancher_environment" "default" {
    18    name = "staging"
    19    description = "The staging environment"
    20    orchestration = "cattle"
    21  }
    22  ```
    23  
    24  ## Argument Reference
    25  
    26  The following arguments are supported:
    27  
    28  * `name` - (Required) The name of the environment.
    29  * `description` - (Optional) An environment description.
    30  * `orchestration` - (Optional) Must be one of **cattle**, **swarm**, **mesos** or **kubernetes**. Defaults to **cattle**.
    31  
    32  ## Attributes Reference
    33  
    34  * `id` - The ID of the environment (ie `1a11`) that can be used in other Terraform resources such as Rancher Stack definitions.
    35  
    36  ## Import
    37  
    38  Environments can be imported using their Rancher API ID, e.g.
    39  
    40  ```
    41  $ terraform import rancher_environment.dev 1a15
    42  ```