mirror of
https://github.com/opentffoundation/opentf.git
synced 2026-02-22 05:01:22 -05:00
a15a6c9657
Signed-off-by: Janos <86970079+janosdebugs@users.noreply.github.com> Signed-off-by: Damian Stasik <920747+damianstasik@users.noreply.github.com> Signed-off-by: Roman Grinovski <roman.grinovski@gmail.com> Co-authored-by: Damian Stasik <920747+damianstasik@users.noreply.github.com> Co-authored-by: Roman Grinovski <roman.grinovski@gmail.com>
28 lines
1.8 KiB
Plaintext
28 lines
1.8 KiB
Plaintext
---
|
|
description: >-
|
|
OpenTofu can import and manage existing infrastructure. This can help you
|
|
transition your infrastructure to OpenTofu.
|
|
---
|
|
|
|
# Import
|
|
|
|
OpenTofu can import existing infrastructure resources. This functionality lets you bring existing resources under OpenTofu management.
|
|
|
|
:::note
|
|
OpenTofu supports `import` blocks. Unlike the `tofu import` command, you can use `import` blocks to import more than one resource at a time, and you can review imports as part of your normal plan and apply workflow. [Learn more about `import` blocks](../../language/import/index.mdx).
|
|
:::
|
|
|
|
## State Only
|
|
|
|
:::warning
|
|
OpenTofu expects that each remote object is bound to a _single_ resource address. You should import each remote object to _one_ OpenTofu resource address. If you import the same object multiple times, OpenTofu may exhibit unwanted behavior. See [State](../../language/state/index.mdx) for more details.
|
|
:::
|
|
|
|
The `tofu import` CLI command can only import resources into the [state](../../language/state/index.mdx). Importing via the CLI does _not_ generate configuration. If you want to generate the accompanying configuration for imported resources, [use the `import` block instead](../../language/import/index.mdx).
|
|
|
|
Before you run `tofu import` you must manually write a `resource` configuration block for the resource. The resource block describes where OpenTofu should map the imported object.
|
|
|
|
## Cloud Backend
|
|
|
|
When you use OpenTofu on the command line with a cloud backend, many commands like `apply` run inside your cloud backend's environment. However, the `import` command runs locally, so it does not have access to information from the cloud backend. To successfully perform an import, you may need to set local variables equivalent to any remote workspace variables in the cloud backend.
|