Retirar un nodo

Hay un comando, y es destructivo. Lee esto antes de ejecutarlo.

Desinstalar

sudo scripts/tc-operator/tc-operator uninstall --config operator.yaml

En esta forma es seguro. Hace lo siguiente:

1. Toma un volcado de la base de datos primero, en /etc/trusted-codes/backup-<marca-de-tiempo>.sql.gz, modo 0600.
2. Cuenta las filas de usuarios reales.
3. Se niega si hay alguna, y te dice dónde está el volcado.

Esa negativa es el resguardo. Desmontar la pila quita los volúmenes de datos, y en un nodo con usuarios reales eso no se puede recuperar de nada que quede en la máquina.

Desinstalar con --purge

sudo scripts/tc-operator/tc-operator uninstall --config operator.yaml --purge

Este es el camino destructivo. Sigue tomando el volcado primero, y después te pide que escribas el nombre del proyecto en el terminal para confirmar. Pasada esa confirmación desmonta la pila con sus volúmenes y quita los certificados y secretos generados.

Qué significa eso en concreto:

• La base de datos desaparece, con cada cuenta, conexión, código y caja fuerte del nodo.
• /etc/trusted-codes/secrets.env se elimina. Con él se va la identidad de federación del nodo y la clave que descifra los datos personales. El volcado de la copia de seguridad que acaba de escribir es ilegible sin ese archivo.
• Se elimina el certificado mTLS. Una instalación futura acuña uno nuevo con una huella nueva, que hay que volver a verificar y admitir.

Así que antes de purgar: copia la copia de seguridad y una copia de secrets.env fuera de la máquina, si hay alguna posibilidad de que quieras recuperar los datos. Copiar solo el volcado te da un archivo que nadie puede leer.

Solo dos comandos de tc-operator te hacen escribir algo de vuelta: este, y rollback. Todo lo demás se ejecuta sin una confirmación escrita, porque todo lo demás solo toca tu propia máquina y es recuperable. Este no lo es.

Retirar un nodo de ensayo local

tc-operator uninstall --local --config operator.yaml --purge

El mismo comando, apuntado al proyecto loopback aislado que crea una instalación con --local. Deja en paz a un nodo real en la misma máquina.

Lo que uninstall no hace

Quita tu nodo de tu máquina. No lo quita del registro.

La entrada de admisión de tu nodo, y el registro central de ella, los quita Trusted Codes — el comando que lo hace es central, y no forma parte en absoluto de la distribución del operador. Si estás retirando un nodo para siempre, avísales, así una instalación futura empieza de cero en vez de chocar con una entrada obsoleta.

Los pares que ya tienen tu nodo en su copia del registro dejan de confiar en él cuando el registro firmado se vuelve a publicar sin él. Eso no es instantáneo, y no es algo que controles desde la máquina.

Si solo quieres dejar de servir algo

Probablemente no quieras uninstall en absoluto.

• Para detener una superficie web: tc-operator service stop <superficie>. El paquete se conserva y un reinicio es rápido. Consulta Ejecutar el nodo.
• Para dejar de aceptar cuentas nuevas: fija auth.registration_mode: closed y recarga.
• Para que otros servidores dejen de colocar invitaciones en tu nodo: el interruptor de corte de entrada en la aplicación de administración, bajo Node Settings. Se puede poner a denegar desde cualquier estado.
• Para salir de la malla sin salir del nodo: desactiva los indicadores de federación en operator.yaml y recarga.

Cada una de estas es reversible. Uninstall no lo es.