testform taint

testform [opciones globales] taint [opciones] <direccion>

El comando testform taint marca manualmente un recurso gestionado como dañado (tainted) en el archivo de estado. Un recurso marcado de esta forma se considera corrompido, parcialmente fallido o necesitado de una reconstrucción completa.

Durante la siguiente ejecución de testform apply, Testform aplicará una operación de reemplazo (-/+), destruyendo el issue remoto actual y creando uno nuevo desde cero.

---

Cuándo Marcar un Recurso con Taint

1. El hilo de comentarios de un Issue en GitHub se volvió ilegible o caótico y se requiere reiniciar su historial de forma limpia.
2. Un issue remoto fue desconfigurado o alterado por una herramienta de automatización externa.
3. Se alteraron propiedades inmutables que exigen recreación obligatoria.

---

Opciones del Comando

Opción	Por Defecto	Descripción
<direccion>	(requerido)	Dirección canónica o etiqueta de identidad del recurso (ej: "login.case.feature.@tc-1").
-allow-missing	false	Si se especifica, el comando finaliza con código 0 incluso si el recurso no existe en el estado.
-lock=false	true	No adquiere un bloqueo de estado durante la operación.
-lock-timeout=0s	0s	Duración para reintentar la adquisición del bloqueo de estado.
-state=path	testform.state	Ruta al archivo de estado a utilizar.

---

Ejemplo de Ejecución Real

# Marcar recurso como dañado
$ testform taint "login.case.feature.@tc-1"
Resource instance login.case.feature.@tc-1 has been marked as tainted.

# Ejecutar plan para verificar el reemplazo
$ testform plan
Testform will perform the following actions:

  # login.case.feature.@tc-1 is tainted, so must be replaced
-/+ resource "testcase" "login_valid" {
      ~ id = 104 -> (known after apply)
    }

Plan: 1 to add, 0 to change, 1 to destroy.

---

Revertir Taint con untaint

Si marcaste un recurso por error, puedes revertir la acción antes de ejecutar apply mediante el comando testform untaint:

$ testform untaint "login.case.feature.@tc-1"
Resource instance login.case.feature.@tc-1 has been successfully untainted.

---

Códigos de Salida

• 0: Estado de taint actualizado exitosamente.
• 1: Dirección del recurso no encontrada en el archivo de estado o fallo al adquirir el bloqueo.