github.com/danp/terraform@v0.9.5-0.20170426144147-39d740081351/website/source/docs/providers/terraform-enterprise/index.html.markdown (about)

     1  ---
     2  layout: "terraform-enterprise"
     3  page_title: "Provider: Terraform Enterprise"
     4  sidebar_current: "docs-terraform-enterprise-index"
     5  description: |-
     6    The Terraform Enterprise provider is used to interact with configuration,
     7    artifacts, and metadata managed by the Terraform Enterprise service.
     8  ---
     9  
    10  # Terraform Enterprise Provider
    11  
    12  The Terraform Enterprise provider is used to interact with resources,
    13  configuration, artifacts, and metadata managed by
    14  [Terraform Enterprise](https://www.terraform.io/docs/providers/index.html).
    15  The provider needs to be configured with the proper credentials before it can
    16  be used.
    17  
    18  Use the navigation to the left to read about the available resources.
    19  
    20  ~> **Why is this called "atlas"?** Atlas was previously a commercial offering
    21  from HashiCorp that included a full suite of enterprise products. The products
    22  have since been broken apart into their individual products, like **Terraform
    23  Enterprise**. While this transition is in progress, you may see references to
    24  "atlas" in the documentation. We apologize for the inconvenience.
    25  
    26  ## Example Usage
    27  
    28  ```hcl
    29  # Configure the Terraform Enterprise provider
    30  provider "atlas" {
    31    token = "${var.atlas_token}"
    32  }
    33  
    34  # Fetch an artifact configuration
    35  data "atlas_artifact" "web" {
    36    # ...
    37  }
    38  ```
    39  
    40  ## Argument Reference
    41  
    42  The following arguments are supported:
    43  
    44  * `address` - (Optional) Terraform Enterprise server endpoint. Defaults to
    45    public Terraform Enterprise. This is only required when using an on-premise
    46    deployment of Terraform Enterprise. This can also be specified with the
    47    `ATLAS_ADDRESS` shell environment variable.
    48  
    49  * `token` - (Required) API token. This can also be specified with the
    50    `ATLAS_TOKEN` shell environment variable.