github.com/xsb/terraform@v0.6.13-0.20160314145438-fe415c2f09d7/website/source/docs/providers/aws/r/elastic_beanstalk_environment.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_elastic_beanstalk_environment"
     4  sidebar_current: "docs-aws-resource-elastic-beanstalk-environment"
     5  description: |-
     6    Provides an Elastic Beanstalk Environment Resource
     7  ---
     8  
     9  # aws\_elastic\_beanstalk\_<wbr>environment
    10  
    11  Provides an Elastic Beanstalk Environment Resource. Elastic Beanstalk allows 
    12  you to deploy and manage applications in the AWS cloud without worrying about 
    13  the infrastructure that runs those applications.
    14  
    15  Environments are often things such as `development`, `integration`, or 
    16  `production`.
    17  
    18  ## Example Usage
    19  
    20  
    21  ```
    22  resource "aws_elastic_beanstalk_application" "tftest" {
    23    name = "tf-test-name"
    24    description = "tf-test-desc"
    25  }
    26  
    27  resource "aws_elastic_beanstalk_environment" "tfenvtest" {
    28    name = "tf-test-name"
    29    application = "${aws_elastic_beanstalk_application.tftest.name}"
    30    solution_stack_name = "64bit Amazon Linux 2015.03 v2.0.3 running Go 1.4"
    31  }
    32  ```
    33  
    34  ## Argument Reference
    35  
    36  The following arguments are supported:
    37  
    38  * `name` - (Required) A unique name for this Environment. This name is used 
    39    in the application URL
    40  * `application` – (Required) Name of the application that contains the version 
    41    to be deployed
    42  * `description` - (Optional) Short description of the Environment 
    43  * `tier` - (Optional) Elastic Beanstalk Environment tier. Valid values are `Worker` 
    44    or `WebServer`. If tier is left blank `WebServer` will be used.
    45  * `setting` – (Optional) Option settings to configure the new Environment. These
    46    override specific values that are set as defaults. The format is detailed
    47    below in [Option Settings](#option-settings)
    48  * `solution_stack_name` – (Optional) A solution stack to base your environment
    49  off of. Example stacks can be found in the [Amazon API documentation][1]
    50  * `template_name` – (Optional) The name of the Elastic Beanstalk Configuration 
    51    template to use in deployment
    52  * `tags` – (Optional) A set of tags to apply to the Environment. **Note:** at
    53  this time the Elastic Beanstalk API does not provide a programatic way of
    54  changing these tags after initial application
    55  
    56  
    57  <a id="option-settings"></a>
    58  ## Option Settings
    59  
    60  The `setting` and `all_settings` mappings support the following format:
    61  
    62  * `namespace` - (Optional) unique namespace identifying the option's 
    63    associated AWS resource
    64  * `name` - (Optional) name of the configuration option
    65  * `value` - (Optional) value for the configuration option
    66  
    67  ## Attributes Reference
    68  
    69  The following attributes are exported:
    70  
    71  * `name`
    72  * `description`
    73  * `tier` - the environment tier specified. 
    74  * `application` – the application specified
    75  * `setting` – Settings specifically set for this Environment
    76  * `all_settings` – List of all option settings configured in the Environment. These
    77    are a combination of default settings and their overrides from `settings` in
    78    the configuration 
    79  
    80  
    81  [1]: http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/concepts.platforms.html
    82  
    83