github.com/ves/terraform@v0.8.0-beta2/website/source/docs/state/remote/swift.html.md (about)

     1  ---
     2  layout: "remotestate"
     3  page_title: "Remote State Backend: swift"
     4  sidebar_current: "docs-state-remote-swift"
     5  description: |-
     6    Terraform can store the state remotely, making it easier to version and work with in a team.
     7  ---
     8  
     9  # swift
    10  
    11  Stores the state as an artifact in [Swift](http://docs.openstack.org/developer/swift/).
    12  
    13  -> **Note:** Passing credentials directly via configuration options will
    14  make them included in cleartext inside the persisted state. Use of
    15  environment variables is recommended.
    16  
    17  ## Example Usage
    18  
    19  ```
    20  terraform remote config \
    21    -backend=swift \
    22    -backend-config="path=terraform_state"
    23  ```
    24  
    25  ## Example Referencing
    26  
    27  ```
    28  data "terraform_remote_state" "foo" {
    29    backend = "swift"
    30    config {
    31      path = "terraform_state"
    32    }
    33  }
    34  ```
    35  
    36  ## Configuration variables
    37  
    38  The following configuration options are supported:
    39  
    40   * `auth_url` - (Required) The Identity authentication URL. If omitted, the
    41     `OS_AUTH_URL` environment variable is used.
    42  
    43   * `path` - (Required) The path where to store `terraform.tfstate`.
    44   * `user_name` - (Optional) The Username to login with. If omitted, the
    45     `OS_USERNAME` environment variable is used.
    46  
    47   * `user_id` - (Optional) The User ID to login with. If omitted, the
    48     `OS_USER_ID` environment variable is used.
    49  
    50   * `password` - (Optional) The Password to login with. If omitted, the
    51     `OS_PASSWORD` environment variable is used.
    52  
    53   * `region_name` (Required) - The region in which to store `terraform.tfstate`. If
    54     omitted, the `OS_REGION_NAME` environment variable is used.
    55  
    56   * `tenant_id` (Optional) The ID of the Tenant (Identity v2) or Project
    57     (Identity v3) to login with. If omitted, the `OS_TENANT_ID` or
    58     `OS_PROJECT_ID` environment variables are used.
    59  
    60   * `tenant_name` - (Optional) The Name of the Tenant (Identity v2) or Project
    61     (Identity v3) to login with. If omitted, the `OS_TENANT_NAME` or
    62     `OS_PROJECT_NAME` environment variable are used.
    63  
    64   * `domain_id` - (Optional) The ID of the Domain to scope to (Identity v3). If
    65     If omitted, the following environment variables are checked (in this order):
    66     `OS_USER_DOMAIN_ID`, `OS_PROJECT_DOMAIN_ID`, `OS_DOMAIN_ID`.
    67  
    68   * `domain_name` - (Optional) The Name of the Domain to scope to (Identity v3).
    69     If omitted, the following environment variables are checked (in this order):
    70     `OS_USER_DOMAIN_NAME`, `OS_PROJECT_DOMAIN_NAME`, `OS_DOMAIN_NAME`,
    71     `DEFAULT_DOMAIN`.
    72  
    73   * `insecure` - (Optional) Trust self-signed SSL certificates. If omitted, the
    74     `OS_INSECURE` environment variable is used.
    75  
    76   * `cacert_file` - (Optional) Specify a custom CA certificate when communicating
    77     over SSL. If omitted, the `OS_CACERT` environment variable is used.
    78  
    79   * `cert` - (Optional) Specify client certificate file for SSL client
    80     authentication. If omitted the `OS_CERT` environment variable is used.
    81  
    82   * `key` - (Optional) Specify client private key file for SSL client
    83     authentication. If omitted the `OS_KEY` environment variable is used.