Команда: untaint

В OpenTofu есть маркер «tainted», который используется для отслеживания объектов, которые могут быть повреждены и поэтому должны быть заменены при следующем плане OpenTofu.

OpenTofu автоматически помечает объект как «tainted», если во время многоэтапного действия «create» возникает ошибка, поскольку OpenTofu не может быть уверен, что объект остался в полностью работоспособном состоянии.

Вы также можете вручную пометить объект как «tainted» с помощью устаревшей команды tofu taint, хотя мы больше не рекомендуем такой порядок действий.

Если OpenTofu считает определённый объект помеченным как tainted, но вы установили, что он на самом деле работает правильно и его не нужно заменять, используйте tofu untaint, чтобы удалить с объекта маркер tainted.

Эта команда не изменяет реальные удалённые объекты, но изменяет состояние, чтобы убрать статус tainted.

Если вы удалили с объекта маркер tainted, но позднее обнаружили, что он всё же был неисправен, вы можете создать и применить план для его замены, не помечая объект как tainted повторно, с помощью команды, например, такой:

tofu apply -replace="aws_instance.example[0]"

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

Использование: tofu untaint [options] address

Аргумент address — это адрес ресурса, указывающий на конкретный экземпляр ресурса, который в данный момент помечен как tainted.

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

• -allow-missing — если указан, команда завершится успешно (код выхода 0), даже если ресурс отсутствует. Команда всё ещё может вернуть ошибку в других ситуациях, например, если возникла проблема при чтении или записи состояния.

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

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

• -no-color — отключает последовательности форматирования терминала в выводе. Используйте этот параметр, если запускаете OpenTofu в среде, где вывод отображается системой, не способной интерпретировать форматирование терминала.

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

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

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

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

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