Команда: state rm

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

Вы можете использовать tofu state rm в менее распространённой ситуации, когда хотите удалить привязку к существующему удалённому объекту, не уничтожая его предварительно. В результате OpenTofu фактически «забудет» об объекте, хотя тот продолжит существовать в удалённой системе.

Использование​

Использование: tofu state rm [options] ADDRESS...

OpenTofu выполнит поиск в состоянии экземпляров, соответствующих указанному адресу ресурса, и удалит запись о каждом из них, чтобы OpenTofu больше не отслеживал соответствующие удалённые объекты.

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

Эта команда также принимает следующие параметры:

• -dry-run — вывести список всех экземпляров ресурсов, соответствующих указанному адресу, не «забывая» их.

• -lock=false — не блокировать состояние на время выполнения операции. Это опасно, если другие пользователи могут одновременно выполнять команды в той же рабочей области.

• -lock-timeout=DURATION — если блокировка не отключена с помощью -lock=false, указать OpenTofu повторять попытки получения блокировки в течение заданного периода, прежде чем вернуть ошибку. Длительность задаётся числом и буквой единицы времени, например «3s» означает три секунды.

• -var 'NAME=VALUE' — задать значение для одной входной переменной, объявленной в корневом модуле конфигурации. Используйте этот параметр несколько раз, чтобы задать значения нескольких переменных. Дополнительные сведения см. в разделе Входные переменные в командной строке.

• -var-file=FILENAME — задать значения для нескольких входных переменных, объявленных в корневом модуле конфигурации, используя определения из файла «tfvars». Используйте этот параметр несколько раз, чтобы включить значения из нескольких файлов.

Помимо параметров -var и -var-file, есть несколько других способов задать значения входных переменных в корневом модуле. Дополнительные сведения см. в разделе Назначение значений переменным корневого модуля.

Для конфигураций, использующих только бэкенд cloud или бэкенд remote, команда tofu state rm также принимает параметр -ignore-remote-version.

Для конфигураций, использующих только локальное хранилище состояния local, команда tofu state rm также принимает устаревшие параметры -state, -state-out и -backup.

Пример: удаление всех экземпляров ресурса​

В следующем примере OpenTofu «забудет» все экземпляры ресурса packet_device с именем «worker».

$ tofu state rm 'packet_device.worker'

У ресурса, в котором не используются count или for_each, есть только один экземпляр, поэтому такой синтаксис также подходит для выбора этого единственного экземпляра.

Пример: удаление всех экземпляров ресурса в модуле​

Чтобы выбрать ресурс, определённый во вложенном модуле, необходимо указать путь к этому модулю в составе адреса ресурса:

$ tofu state rm 'module.foo.packet_device.worker'

Пример: удаление всех экземпляров всех ресурсов в модуле​

В следующем примере OpenTofu «забудет» все экземпляры, связанные со всеми ресурсами, определёнными во всех экземплярах модуля с именем foo:

$ tofu state rm 'module.foo'

Пример: удаление определённого экземпляра ресурса с помощью count​

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

$ tofu state rm 'packet_device.worker[0]'

В некоторых оболочках квадратные скобки ([, ]) имеют особое значение, поэтому может потребоваться заключить адрес в кавычки или экранировать его, чтобы передать OpenTofu без изменений. Выше приведён типичный синтаксис заключения в кавычки для оболочек Unix.

Пример: удаление определённого экземпляра ресурса с помощью for_each​

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

Однако синтаксис строк предполагает использование кавычек, а символ кавычки часто имеет особое значение в командных оболочках, поэтому необходимо использовать соответствующий синтаксис заключения в кавычки и/или экранирования для используемой оболочки. Например:

Оболочки Unix, например Linux или macOS:

$ tofu state rm 'packet_device.worker["example"]'

Командная строка Windows (cmd.exe):

$ tofu state rm packet_device.worker[\"example\"]

PowerShell:

$ tofu state rm 'packet_device.worker[\"example\"]'