github.com/andresvia/terraform@v0.6.15-0.20160412045437-d51c75946785/website/source/docs/providers/openstack/index.html.markdown (about)

     1  ---
     2  layout: "openstack"
     3  page_title: "Provider: OpenStack"
     4  sidebar_current: "docs-openstack-index"
     5  description: |-
     6    The OpenStack provider is used to interact with the many resources supported by OpenStack. The provider needs to be configured with the proper credentials before it can be used.
     7  ---
     8  
     9  # OpenStack Provider
    10  
    11  The OpenStack provider is used to interact with the
    12  many resources supported by OpenStack. The provider needs to be configured
    13  with the proper credentials before it can be used.
    14  
    15  Use the navigation to the left to read about the available resources.
    16  
    17  ## Example Usage
    18  
    19  ```
    20  # Configure the OpenStack Provider
    21  provider "openstack" {
    22      user_name  = "admin"
    23      tenant_name = "admin"
    24      password  = "pwd"
    25      auth_url  = "http://myauthurl:5000/v2.0"
    26  }
    27  
    28  # Create a web server
    29  resource "openstack_compute_instance_v2" "test-server" {
    30      ...
    31  }
    32  ```
    33  
    34  ## Configuration Reference
    35  
    36  The following arguments are supported:
    37  
    38  * `auth_url` - (Required) If omitted, the `OS_AUTH_URL` environment
    39      variable is used.
    40  
    41  * `user_name` - (Optional; Required for Identity V2) If omitted, the
    42      `OS_USERNAME` environment variable is used.
    43  
    44  * `user_id` - (Optional)
    45  
    46  * `password` - (Optional; Required if not using `api_key`) If omitted, the
    47      `OS_PASSWORD` environment variable is used.
    48  
    49  * `api_key` - (Optional; Required if not using `password`)
    50  
    51  * `domain_id` - (Optional) If omitted, the `OS_DOMAIN_ID` environment
    52      variable is used.
    53  
    54  * `domain_name` - (Optional) If omitted, the `OS_DOMAIN_NAME`
    55      environment variable is used.
    56  
    57  * `tenant_id` - (Optional)
    58  
    59  * `tenant_name` - (Optional) If omitted, the `OS_TENANT_NAME` environment
    60      variable is used.
    61  
    62  * `insecure` - (Optional) Explicitly allow the provider to perform
    63      "insecure" SSL requests. If omitted, default value is `false`
    64  
    65  * `endpoint_type` - (Optional) Specify which type of endpoint to use from the
    66      service catalog. It can be set using the OS_ENDPOINT_TYPE environment
    67      variable. If not set, public endpoints is used.
    68  
    69  ## Testing and Development
    70  
    71  In order to run the Acceptance Tests for development, the following environment
    72  variables must also be set:
    73  
    74  * `OS_REGION_NAME` - The region in which to create the server instance.
    75  
    76  * `OS_IMAGE_ID` or `OS_IMAGE_NAME` - a UUID or name of an existing image in
    77      Glance.
    78  
    79  * `OS_FLAVOR_ID` or `OS_FLAVOR_NAME` - an ID or name of an existing flavor.
    80  
    81  * `OS_POOL_NAME` - The name of a Floating IP pool.
    82  
    83  * `OS_NETWORK_ID` - The UUID of a network in your test environment.
    84  
    85  To make development easier, the `builtin/providers/openstack/devstack/deploy.sh`
    86  script will assist in installing and configuring a standardized
    87  [DevStack](http://docs.openstack.org/developer/devstack/) environment along with
    88  Golang, Terraform, and all development dependencies. It will also set the required
    89  environment variables in the `devstack/openrc` file.
    90  
    91  Do not run the `deploy.sh` script on your workstation or any type of production
    92  server. Instead, run the script within a disposable virtual machine.
    93  [Here's](https://github.com/berendt/terraform-configurations) an example of a
    94  Terraform configuration that will create an OpenStack instance and then install and
    95  configure DevStack inside.