Тип бэкенда: local

Тип: расширенный

Локальный бэкенд хранит состояние в локальной файловой системе, блокирует его с помощью системных API и выполняет операции локально.

Пример конфигурации​

terraform {
  backend "local" {
    path = "relative/path/to/terraform.tfstate"
  }
}

Конфигурация источника данных​

data "terraform_remote_state" "foo" {
  backend = "local"

  config = {
    path = "${path.module}/../../terraform.tfstate"
  }
}

Переменные конфигурации​

Поддерживаются следующие параметры конфигурации:

• path — (необязательно) путь к файлу tfstate. По умолчанию используется файл "terraform.tfstate" относительно корневого модуля.
• workspace_dir — (необязательно) путь к рабочим пространствам, отличным от пространства по умолчанию.

Аргументы командной строки​

Для конфигураций, содержащих блок backend "local", или использующих локальный бэкенд по умолчанию из-за отсутствия указания бэкенда, большинство команд, которые считывают или записывают снимки состояния из бэкенда, принимают следующие дополнительные аргументы:

• -state=FILENAME — переопределяет имя файла состояния при чтении предыдущего снимка состояния.

• -state-out=FILENAME — переопределяет имя файла состояния при записи новых снимков состояния.

  Если использовать -state без -state-out, OpenTofu будет использовать имя файла -state и для -state, и для -state-out. Это означает, что OpenTofu перезапишет входной файл, если создаст новый снимок состояния.

• -backup=FILENAME — переопределяет имя файла по умолчанию, которое локальный бэкенд обычно выбирает динамически для создания резервных копий при записи нового состояния.

  Если использовать -state без -backup, OpenTofu будет использовать имя файла -state в качестве префикса для формирования имени файла резервной копии. Можно использовать -backup=- (то есть задать имя файла, состоящее только из символа ASCII-дефиса), чтобы полностью отключить создание резервных копий.

Эти три параметра сохранены для обратной совместимости с прежними сценариями, появившимися до внедрения встроенного удалённого состояния. В таких сценариях пользователи создавали оболочки-скрипты, которые получали предыдущее состояние перед запуском OpenTofu, а затем сохраняли новое состояние после завершения OpenTofu. В этом случае все три аргумента обычно указывали пути в каталоге для временных файлов, используемом только для одной операции.

Поскольку эти старые сценарии появились до внедрения возможности использовать несколько рабочих пространств, настройка этих параметров переопределяет обычное поведение OpenTofu, при котором имя файла состояния выбирается в зависимости от выбранного рабочего пространства. Если использовать все три параметра, выбранное рабочее пространство не повлияет на то, какие имена файлов OpenTofu выберет для файлов состояния. Поэтому, если требуется хранить файлы состояния разных рабочих пространств отдельно, необходимо самостоятельно выбирать разные имена файлов.

Эти три параметра не влияют на конфигурации, в которых выбран другой тип бэкенда.

Мы не рекомендуем использовать эти параметры в новых системах, даже если вы запускаете OpenTofu в автоматизированном режиме. Вместо этого выберите другой бэкенд, поддерживающий удалённое состояние, и настройте его в корневом модуле. Это позволит всем, кто работает с вашей конфигурацией, автоматически получать и сохранять состояние в правильном общем расположении без специальных параметров командной строки.