导入

OpenTofu 可以导入现有的基础设施资源。此功能允许您将现有资源纳入 OpenTofu 管理。

注意

OpenTofu 支持 import 代码块。与 tofu import 命令不同，您可以使用 import 代码块一次导入多个资源，并且可以在正常的计划和应用工作流程中审查导入内容。详细了解 import 代码块。

仅限状态

警告

OpenTofu 期望每个远程对象绑定到一个唯一的资源地址。您应该将每个远程对象导入到一个 OpenTofu 资源地址。如果您多次导入同一个对象，OpenTofu 可能会出现意外行为。有关更多详细信息，请参阅状态。

tofu import CLI 命令只能将资源导入到状态中。通过 CLI 导入不会生成配置。如果您想为导入的资源生成相应的配置，请改用 import 代码块。

在运行 tofu import 之前，您必须手动为资源编写一个 resource 配置块。资源块描述了 OpenTofu 应将导入的对象映射到哪里。

当您在命令行中使用 OpenTofu 和云后端时，许多命令（如 apply）将在云后端的环境中运行。但是，import 命令在本地运行，因此无法访问来自云后端的信息。要成功执行导入，您可能需要设置与云后端中任何远程工作区变量等效的本地变量。