THP Service - Historial de revisiones

Escleiron en 17:45 2 ene 2026

2026-01-02T17:45:06Z

@@ Línea 39: / Línea 39: @@
 ** En cada arranque del sistema
 * Permite cambiar el estado de THP modificando una única variable
@@ Línea 52: / Línea 51: @@
 * Fácil de auditar
 * Fácil de revertir

Escleiron en 17:43 2 ene 2026

2026-01-02T17:43:47Z

← Revisión anterior		Revisión del 17:43 2 ene 2026
Línea 25:		Línea 25:
	Por este motivo, en muchos entornos empresariales se requiere '''deshabilitar THP de forma persistente'''.		Por este motivo, en muchos entornos empresariales se requiere '''deshabilitar THP de forma persistente'''.

	~~---~~

	== ¿Qué hace este rol? ==		== ¿Qué hace este rol? ==
Línea 41:		Línea 40:
	* Permite cambiar el estado de THP modificando una única variable		* Permite cambiar el estado de THP modificando una única variable

	~~---~~

	== Ventajas del enfoque ==		== Ventajas del enfoque ==
Línea 54:		Línea 53:
	* Fácil de revertir		* Fácil de revertir

	~~---~~

	== Sistemas compatibles ==		== Sistemas compatibles ==
Línea 66:		Línea 65:
	* Existencia de <code>/sys/kernel/mm/transparent_hugepage</code>		* Existencia de <code>/sys/kernel/mm/transparent_hugepage</code>

	~~---~~

	== Variables del rol ==		== Variables del rol ==
Línea 82:		Línea 81:
	</pre>		</pre>

	~~---~~

	=== thp_map ===		=== thp_map ===
Línea 102:		Línea 101:
	Este diseño permite extender el rol fácilmente en el futuro.		Este diseño permite extender el rol fácilmente en el futuro.

	~~---~~

	=== thp_verify ===		=== thp_verify ===
Línea 112:		Línea 111:
	</pre>		</pre>

	~~---~~

	== Ejemplo de uso ==		== Ejemplo de uso ==
Línea 141:		Línea 140:
	* Hardening y buenas prácticas de rendimiento		* Hardening y buenas prácticas de rendimiento

	~~---~~

	== Conceptos que demuestra este rol ==		== Conceptos que demuestra este rol ==
Línea 151:		Línea 150:
	* Buen diseño de roles reutilizables		* Buen diseño de roles reutilizables

	~~---~~

	== Nota final ==		== Nota final ==

Escleiron: /* Rol Ansible: THP Service */

2026-01-02T17:43:15Z

Rol Ansible: THP Service

← Revisión anterior		Revisión del 17:43 2 ene 2026
Línea 11:		Línea 11:
	Repositorio del rol:		Repositorio del rol:
	* https://github.com/Escleiron/Ansible/tree/main/THP_Service		* https://github.com/Escleiron/Ansible/tree/main/THP_Service

	~~---~~

	== ¿Qué son Transparent Huge Pages (THP)? ==		== ¿Qué son Transparent Huge Pages (THP)? ==

Escleiron: Página creada con «== Rol Ansible: THP Service == === Descripción === El rol '''THP Service''' se utiliza para gestionar el estado de '''Transparent Huge Pages (THP)''' en sistemas Linux mediante un único servicio `systemd` de tipo `oneshot`. El objetivo principal del rol es permitir '''habilitar o deshabilitar THP de forma persistente''' utilizando una sola variable de Ansible, sin depender de scripts ad-hoc ni configuraciones manuales en cada arranque del sis…»

2026-01-02T17:43:02Z

Página creada con «== Rol Ansible: THP Service == === Descripción === El rol '''THP Service''' se utiliza para gestionar el estado de '''Transparent Huge Pages (THP)''' en sistemas Linux mediante un único servicio <code>systemd</code> de tipo <code>oneshot</code>. El objetivo principal del rol es permitir '''habilitar o deshabilitar THP de forma persistente''' utilizando una sola variable de Ansible, sin depender de scripts ad-hoc ni configuraciones manuales en cada arranque del sis…»

Página nueva

== Rol Ansible: THP Service ==

=== Descripción ===
El rol '''THP Service''' se utiliza para gestionar el estado de '''Transparent Huge Pages (THP)'''
en sistemas Linux mediante un único servicio <code>systemd</code> de tipo <code>oneshot</code>.

El objetivo principal del rol es permitir '''habilitar o deshabilitar THP de forma persistente'''
utilizando una sola variable de Ansible, sin depender de scripts ad-hoc ni configuraciones manuales
en cada arranque del sistema.

Repositorio del rol:
* https://github.com/Escleiron/Ansible/tree/main/THP_Service

---

== ¿Qué son Transparent Huge Pages (THP)? ==

Transparent Huge Pages es una funcionalidad del kernel Linux que intenta mejorar el rendimiento
utilizando páginas de memoria de mayor tamaño de forma automática.

Aunque puede ser beneficioso en algunos escenarios, en otros (bases de datos, aplicaciones Java,
entornos de baja latencia, clústeres, etc.) puede provocar:
* Latencias impredecibles
* Penalización de rendimiento
* Problemas de estabilidad

Por este motivo, en muchos entornos empresariales se requiere '''deshabilitar THP de forma persistente'''.

---

== ¿Qué hace este rol? ==

Este rol realiza las siguientes acciones:

* Crea un servicio <code>systemd</code> llamado <code>thp-configuration.service</code>
* El servicio se ejecuta una sola vez (<code>oneshot</code>)
* Escribe los valores adecuados en:
** <code>/sys/kernel/mm/transparent_hugepage/enabled</code>
** <code>/sys/kernel/mm/transparent_hugepage/defrag</code>
* Garantiza que la configuración se aplique:
** En tiempo de ejecución
** En cada arranque del sistema
* Permite cambiar el estado de THP modificando una única variable

---

== Ventajas del enfoque ==

Este diseño aporta varias ventajas frente a métodos tradicionales:

* No depende de scripts en <code>/etc/rc.local</code>
* No requiere tareas periódicas (cron)
* Es compatible con <code>systemd</code>
* Es idempotente
* Fácil de auditar
* Fácil de revertir

---

== Sistemas compatibles ==

* RHEL 8
* RHEL 9

Requisitos:
* Acceso como <code>root</code> (uso de <code>become: true</code>)
* Kernel Linux con soporte para THP
* Existencia de <code>/sys/kernel/mm/transparent_hugepage</code>

---

== Variables del rol ==

=== thp_state ===
Define el estado deseado de THP.

Valores posibles:
* <code>enabled</code>
* <code>disabled</code>

Valor por defecto:
<pre>
enabled
</pre>

---

=== thp_map ===
Mapa interno que traduce el estado lógico (<code>enabled</code> / <code>disabled</code>)
a los valores reales que se escriben en el sistema de ficheros <code>/sys</code>.

Valores por defecto:

<syntaxhighlight lang="yaml">
thp_map:
enabled:
enabled: "always"
defrag: "always"
disabled:
enabled: "never"
defrag: "never"
</syntaxhighlight>

Este diseño permite extender el rol fácilmente en el futuro.

---

=== thp_verify ===
Indica si, tras aplicar la configuración, se debe mostrar el estado actual de THP.

Valor por defecto:
<pre>
true
</pre>

---

== Ejemplo de uso ==

Playbook de ejemplo utilizando el rol:

<syntaxhighlight lang="yaml">
- hosts: all
become: true
roles:
- role: transparent_huge_pages_service
vars:
# Descomentar solo una opción
# thp_state: enabled
# thp_state: disabled
</syntaxhighlight>

---

== Cuándo usar este rol ==

Este rol es especialmente útil en los siguientes escenarios:

* Servidores de bases de datos
* Clústeres (Pacemaker, Kubernetes, etc.)
* Sistemas con aplicaciones sensibles a latencia
* Estandarización de configuraciones en grandes entornos
* Hardening y buenas prácticas de rendimiento

---

== Conceptos que demuestra este rol ==

* Uso de <code>systemd oneshot services</code>
* Persistencia de configuraciones del kernel
* Abstracción mediante variables
* Idempotencia en Ansible
* Buen diseño de roles reutilizables

---

== Nota final ==

Este rol no pretende decidir si THP debe estar habilitado o no, sino proporcionar
un mecanismo limpio, controlado y reutilizable para gestionar su estado
de forma coherente en toda la infraestructura.