IntenseWebs/opentofu
3
0
Fork 0
mirror of https://github.com/opentofu/opentofu.git synced 2025-02-25 18:45:20 -06:00
Code Issues Packages Projects Releases Wiki Activity

Expand example explanation

Browse Source 
As mentioned in  #17871 the current example can hide the fact that the module
path plays an important role. The example's explanation is expanded.

Moreover, the verb "attach" is replaced with "map" to make the vocabulary
consistent with the wording in the documentation of the terraform state.
This commit is contained in:
vkatsikaros 2018-04-21 18:49:38 +03:00 committed by Pam Selle
parent cd7c3e4231
commit 22321efa71
1 changed files with 8 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
website/docs/import/usage.html.md
View File

@ -32,19 +32,21 @@ remains constant.
If desired, you can leave the body of the resource block blank for now and If desired, you can leave the body of the resource block blank for now and
return to fill it in once the instance is imported. return to fill it in once the instance is imported.
Now `terraform import` can be run to attach an existing instance to this Now `terraform import` can be run to map an existing instance to this
resource configuration: resource configuration:
```shell ```shell
$ terraform import aws_instance.example i-abcd1234 $ terraform import aws_instance.example i-abcd1234
``` ```
This command locates the AWS instance with ID `i-abcd1234` and attaches This command locates the AWS instance with ID `i-abcd1234`. Then it maps
its existing settings, as described by the EC2 API, to the name the existing settings of the instance, as described by the EC2 API, to the
`aws_instance.example` in the Terraform state. name `aws_instance.example` of a module. In this example the module path
implies that the root module is used. Finally, the mapping is saved in the
Terraform state.
It is also possible to import to resources in child modules and to single It is also possible to import to resources in child modules, using their paths,
instances of a resource with `count` set. See and to single instances of a resource with `count` set. See
[_Resource Addressing_](/docs/internals/resource-addressing.html) for more [_Resource Addressing_](/docs/internals/resource-addressing.html) for more
details on how to specify a target resource. details on how to specify a target resource.