terraform/website/source/docs/providers/openstack/index.html.markdown

75 lines
2.0 KiB
Markdown
Raw Normal View History

2015-01-08 01:09:25 +01:00
---
layout: "openstack"
page_title: "Provider: OpenStack"
sidebar_current: "docs-openstack-index"
description: |-
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.
---
# OpenStack Provider
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.
Use the navigation to the left to read about the available resources.
## Example Usage
```
# Configure the OpenStack Provider
provider "openstack" {
user_name = "admin"
2015-01-08 01:09:25 +01:00
tenant_name = "admin"
password = "pwd"
auth_url = "http://myauthurl:5000/v2.0"
}
# Create a web server
resource "openstack_compute_instance_v2" "test-server" {
2015-01-08 01:09:25 +01:00
...
}
```
## Configuration Reference
The following arguments are supported:
2015-04-02 18:12:18 +02:00
* `auth_url` - (Required) If omitted, the `OS_AUTH_URL` environment
variable is used.
2015-01-08 01:09:25 +01:00
2015-04-02 18:12:18 +02:00
* `user_name` - (Optional; Required for Identity V2) If omitted, the
`OS_USERNAME` environment variable is used.
2015-01-08 01:09:25 +01:00
* `user_id` - (Optional)
2015-01-08 01:09:25 +01:00
2015-04-02 18:12:18 +02:00
* `password` - (Optional; Required if not using `api_key`) If omitted, the
`OS_PASSWORD` environment variable is used.
* `api_key` - (Optional; Required if not using `password`)
* `domain_id` - (Optional)
* `domain_name` - (Optional)
* `tenant_id` - (Optional)
2015-01-08 01:09:25 +01:00
2015-04-02 18:12:18 +02:00
* `tenant_name` - (Optional) If omitted, the `OS_TENANT_NAME` environment
variable is used.
## Testing
In order to run the Acceptance Tests for development, the following environment
variables must also be set:
* `OS_REGION_NAME` - The region in which to create the server instance.
* `OS_IMAGE_ID` or `OS_IMAGE_NAME` - a UUID or name of an existing image in
Glance.
* `OS_FLAVOR_ID` or `OS_FLAVOR_NAME` - an ID or name of an existing flavor.
* `OS_POOL_NAME` - The name of a Floating IP pool.
* `OS_NETWORK_ID` - The UUID of a network in your test environment.