Команда: untaint

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

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

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

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

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

Если вы удалили маркер taint с объекта, но позднее выяснили, что он все же был поврежден, можно создать и применить план для его замены, не помечая объект как 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.