命令:state pull
tofu state pull
命令用于手动下载并输出来自 远程状态 的状态。此命令也适用于本地状态。
用法
用法:tofu state pull
此命令从其当前位置下载状态,将本地副本升级到与本地安装的 OpenTofu 兼容的最新状态文件版本,并将原始格式输出到标准输出。
这对于从状态中读取值很有用(可能将此命令与 jq 等工具结合使用)。如果您需要手动修改状态,它也很有用。
您无法使用此命令检查远程状态的 OpenTofu 版本,因为它始终会在输出之前转换为当前 OpenTofu 版本。
注意
OpenTofu 状态文件必须为 UTF-8 格式,且不包含字节顺序标记 (BOM)。对于 Windows 上的 PowerShell,请使用 Set-Content
自动将文件编码为 UTF-8 格式。例如,运行 tofu state pull | sc terraform.tfstate
。
该命令支持以下命令行参数
-
-var 'NAME=VALUE'
- 为配置根模块中声明的单个 输入变量 设置值。多次使用此选项可设置多个变量。有关更多信息,请参阅 命令行上的输入变量。 -
-var-file=FILENAME
- 使用来自 “tfvars” 文件 的定义,为配置根模块中声明的可能多个 输入变量 设置值。多次使用此选项可包含来自多个文件的值。
除了 -var
和 -var-file
选项外,还有其他几种方法可以为根模块中的输入变量设置值。有关更多信息,请参阅 为根模块变量赋值。