github.com/loicalbertin/terraform@v0.6.15-0.20170626182346-8e2583055467/website/docs/import/index.html.md (about)

     1  ---
     2  layout: "docs"
     3  page_title: "Import"
     4  sidebar_current: "docs-import"
     5  description: |-
     6    Terraform is able to import existing infrastructure. This allows you take
     7    resources you've created by some other means and bring it under Terraform
     8    management.
     9  ---
    10  
    11  # Import
    12  
    13  Terraform is able to import existing infrastructure. This allows you take
    14  resources you've created by some other means and bring it under Terraform
    15  management.
    16  
    17  This is a great way to slowly transition infrastructure to Terraform, or
    18  to be able to be confident that you can use Terraform in the future if it
    19  potentially doesn't support every feature you need today.
    20  
    21  ## Currently State Only
    22  
    23  The current implementation of Terraform import can only import resources
    24  into the [state](/docs/state). It does not generate configuration. A future
    25  version of Terraform will also generate configuration.
    26  
    27  Because of this, prior to running `terraform import` it is necessary to write
    28  manually a `resource` configuration block for the resource, to which the
    29  imported object will be attached.
    30  
    31  While this may seem tedious, it still gives Terraform users an avenue for
    32  importing existing resources. A future version of Terraform will fully generate
    33  configuration, significantly simplifying this process.