github.com/adrian-bl/terraform@v0.7.0-rc2.0.20160705220747-de0a34fc3517/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  * `cname_prefix` - (Optional) Prefix to use for the fully qualified DNS name of
    43    the Environment.
    44  * `description` - (Optional) Short description of the Environment
    45  * `tier` - (Optional) Elastic Beanstalk Environment tier. Valid values are `Worker`
    46    or `WebServer`. If tier is left blank `WebServer` will be used.
    47  * `setting` – (Optional) Option settings to configure the new Environment. These
    48    override specific values that are set as defaults. The format is detailed
    49    below in [Option Settings](#option-settings)
    50  * `solution_stack_name` – (Optional) A solution stack to base your environment
    51  off of. Example stacks can be found in the [Amazon API documentation][1]
    52  * `template_name` – (Optional) The name of the Elastic Beanstalk Configuration
    53    template to use in deployment
    54  * `wait_for_ready_timeout` - (Default: "10m") The maximum
    55    [duration](https://golang.org/pkg/time/#ParseDuration) that Terraform should
    56    wait for an Elastic Beanstalk Environment to be in a ready state before timing
    57    out.
    58  * `tags` – (Optional) A set of tags to apply to the Environment. **Note:** at
    59  this time the Elastic Beanstalk API does not provide a programatic way of
    60  changing these tags after initial application
    61  
    62  
    63  ## Option Settings
    64  
    65  Some options can be stack-specific, check [AWS Docs](http://docs.aws.amazon.com/elasticbeanstalk/latest/dg/command-options-general.html)
    66  for supported options and examples.
    67  
    68  The `setting` and `all_settings` mappings support the following format:
    69  
    70  * `namespace` - unique namespace identifying the option's associated AWS resource
    71  * `name` - name of the configuration option
    72  * `value` - value for the configuration option
    73  * `resource` - (Optional) resource name for [scheduled action](http://docs.aws.amazon.com/elasticbeanstalk/latest/dg/command-options-general.html#command-options-general-autoscalingscheduledaction)
    74  
    75  ## Attributes Reference
    76  
    77  The following attributes are exported:
    78  
    79  * `name` - Name of the Elastic Beanstalk Environment.
    80  * `description` - Description of the Elastic Beanstalk Environment.
    81  * `tier` - The environment tier specified.
    82  * `application` – The Elastic Beanstalk Application specified for this environment.
    83  * `setting` – Settings specifically set for this Environment.
    84  * `all_settings` – List of all option settings configured in the Environment. These
    85    are a combination of default settings and their overrides from `setting` in
    86    the configuration.
    87  * `cname` - Fully qualified DNS name for the Environment.
    88  * `autoscaling_groups` - The autoscaling groups used by this environment.
    89  * `instances` - Instances used by this environment.
    90  * `launch_configurations` - Launch configurations in use by this environment.
    91  * `load_balancers` - Elastic load balancers in use by this environment.
    92  * `queues` - SQS queues in use by this environment.
    93  * `triggers` - Autoscaling triggers in use by this environment.
    94  
    95  
    96  
    97  [1]: http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/concepts.platforms.html