# Automatizando WordPress con Puppet: De Mascotas a Ganado

Como dicta la Tercera Ley del SysAdmin: Máxima automatización. Si te encuentras instalando un stack LAMP y configurando la base de datos de WordPress a mano más de una vez, estás perdiendo el tiempo. En la era de la Infraestructura como Código (IaC), los servidores ya no son mascotas a las que cuidamos cuando se enferman; son ganado. Si algo falla, destruimos (`vagrant destroy`) y recreamos (`vagrant up`) en minutos.

En este post, vamos a ver cómo automatizar al 100% el despliegue de un CMS complejo como WordPress utilizando **Puppet (Standalone)** orquestado por **Vagrant**, y cómo resolver un par de dolores de cabeza clásicos en la declaración de recursos.

## El Reto: Cero Intervención Manual

El objetivo es simple pero estricto: al ejecutar `vagrant up`, la máquina virtual debe levantar, instalar Apache, MariaDB, PHP, descargar WordPress, crear la base de datos y configurar el blog para que el primer post sea visible de inmediato en `localhost:8080`. Nada de pantallas de "Setup Wizard".

Para lograr esta magia no interactiva, la herramienta secreta es **WP-CLI**.

## El Módulo de WordPress (La Carnita)

En lugar de pelear con archivos `.tar.gz` extraídos a la fuerza, creamos un módulo en Puppet (`modules/wordpress/manifests/init.pp`) que descarga el binario de WP-CLI y lo usa para inyectar la configuración directamente:

```Puppet
class wordpress {
  
  # 1. Dependencias base
  $wp_packages = ['php', 'php-mysql', 'mariadb-server', 'curl', 'unzip']
  package { $wp_packages:
    ensure => installed,
  }

  service { 'mariadb':
    ensure  => running,
    enable  => true,
    require => Package['mariadb-server'],
  }

  # 2. Preparación de la Base de Datos
  exec { 'create-wp-db':
    command => "/usr/bin/mysql -u root -e \"CREATE DATABASE IF NOT EXISTS wordpress; CREATE USER IF NOT EXISTS 'wp_user'@'localhost' IDENTIFIED BY 'wp_pass'; GRANT ALL PRIVILEGES ON wordpress.* TO 'wp_user'@'localhost'; FLUSH PRIVILEGES;\"",
    unless  => "/usr/bin/mysql -u root -e 'SHOW DATABASES;' | grep wordpress",
    require => Service['mariadb'],
  }

  # 3. Descarga de WP-CLI
  exec { 'download-wp-cli':
    command => '/usr/bin/curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar',
    cwd     => '/tmp',
    creates => '/tmp/wp-cli.phar',
    require => Package['curl'],
  }

  file { '/usr/local/bin/wp':
    ensure  => file,
    source  => '/tmp/wp-cli.phar',
    mode    => '0755',
    require => Exec['download-wp-cli'],
  }

  # 4. Descarga y Configuración del Core de WordPress
  exec { 'download-wordpress':
    command => '/usr/local/bin/wp core download --path=/var/www/html --allow-root',
    creates => '/var/www/html/wp-settings.php',
    require => [File['/usr/local/bin/wp'], Package['php-mysql']],
  }

  exec { 'configure-wordpress':
    command => '/usr/local/bin/wp config create --dbname=wordpress --dbuser=wp_user --dbpass=wp_pass --path=/var/www/html --allow-root',
    creates => '/var/www/html/wp-config.php',
    require => [Exec['download-wordpress'], Exec['create-wp-db']],
  }

  exec { 'install-wordpress':
    command => '/usr/local/bin/wp core install --url="http://localhost:8080" --title="Mi Blog Automatizado" --admin_user="admin" --admin_password="adminpassword" --admin_email="admin@rootzilopochtli.local" --path=/var/www/html --allow-root',
    unless  => '/usr/local/bin/wp core is-installed --path=/var/www/html --allow-root',
    require => Exec['configure-wordpress'],
  }
}
```

## Lecciones de las Trincheras: Errores Comunes en Puppet

Tener el manifiesto no es suficiente. Al integrar este módulo de WordPress con un módulo existente de Apache, es muy probable que te topes con estos dos problemas de arquitectura declarativa:

### 1\. "Race Conditions" (El orden importa)

En Puppet, el orden en el que escribes tus `include` no garantiza el orden de ejecución real. Si Puppet instala los archivos de WordPress pero luego el módulo de Apache sobrescribe el directorio raíz, tu CMS morirá antes de nacer.

La solución: Usar la flecha de encadenamiento (`->`) en tu `default.pp` para forzar a que la clase Apache termine por completo antes de que inicie la de WordPress.

```Puppet
# Forzamos el orden de ejecución estricto
Class['apache'] -> Class['wordpress']
```

### 2\. La Doble Declaración de Recursos (El infame `index.html`)

Puppet es extremadamente estricto: un recurso solo puede ser gestionado por un módulo a la vez. Si el módulo de Apache intenta crear un `/var/www/html/index.html` de bienvenida, y tu módulo de WordPress intenta borrarlo (`ensure => absent`) para darle prioridad al `index.php`, Puppet abortará la compilación marcando un error de doble declaración.

```Puppet
# manifests/default.pp
$document_root = '/var/www/html'

include apache
include wordpress

Class['apache'] -> Class['wordpress']
```

## Conclusión

Aplicar el principio de inmutabilidad en la infraestructura nos libera de tareas repetitivas. Con este *setup*, tienes un entorno LAMP funcional y un CMS productivo levantado de forma declarativa.

Pero esto es solo el principio. Un nodo aislado está bien para empezar, pero en el mundo real operamos infraestructuras distribuidas. En el próximo post, elevaremos la apuesta: pasaremos de la configuración Standalone a orquestar una arquitectura **Puppet Master / Agent** con múltiples nodos y firma automática de certificados SSL.

¿Sueñan los SysAdmins con pingüinos eléctricos? Mientras lo averiguamos, sigan automatizando.
