github.com/erriapo/terraform@v0.6.12-0.20160203182612-0340ea72354f/website/source/docs/providers/terraform/index.html.markdown (about)

     1  ---
     2  layout: "terraform"
     3  page_title: "Provider: Terraform"
     4  sidebar_current: "docs-terraform-index"
     5  description: |-
     6    The Terraform provider is used to access meta data from shared infrastructure.
     7  ---
     8  
     9  # Terraform Provider
    10  
    11  The terraform provider exposes resources to access state meta data
    12  for Terraform outputs from shared infrastructure.
    13  
    14  The terraform provider is what we call a _logical provider_. This has no
    15  impact on how it behaves, but conceptually it is important to understand.
    16  The terraform provider doesn't manage any _physical_ resources; it isn't
    17  creating servers, writing files, etc. It is used to access the outputs
    18  of other Terraform states to be used as inputs for resources.
    19  Examples will explain this best.
    20  
    21  Use the navigation to the left to read about the available resources.
    22  
    23  ## Example Usage
    24  
    25  ```
    26  # Shared infrastructure state stored in Atlas
    27  resource "terraform_remote_state" "vpc" {
    28      backend = "atlas"
    29      config {
    30          path = "hashicorp/vpc-prod"
    31      }
    32  }
    33  
    34  resource "aws_instance" "foo" {
    35      # ...
    36      subnet_id = "${terraform_remote_state.vpc.output.subnet_id}"
    37  }
    38  ```