Команда: 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». Используйте этот параметр несколько раз, чтобы включить значения из нескольких файлов.

• -json — включает вывод машиночитаемого JSON-интерфейса.

• -json-into=out.json — формирует тот же вывод, что и -json, но перенаправляет его в файл. Это позволяет одновременно собирать человекочитаемые и машиночитаемые журналы.

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

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

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