Configuración de Desarrollo Local

El desarrollo es gestionado por Vagrant en Trellis. Nuestro Vagrantfile utiliza el provisionador de Ansible en forma automática para correr el playbook dev.yml. Allí obtendrás una máquina virtual corriendo tu Sitio en WordPress.

  1. Configura los sitios basándose en docs de Sitios WordPress y lea lo relacionado a desarrollo local.
  2. Asegurate de haber editado tanto group_vars/development/wordpress_sites.yml como group_vars/development/vault.yml.
  3. Opcionalmente, configura la dirección IP en vagrant.default.yml para permitir multiples cajas para que corran paralelamente (192.168.50.5 es el predeterminado).
  4. Corra vagrant up (desde el directorio trellis, usualmente el subdirectorio trellis/ del proyecto).

Luego, deje que Vagrant y Ansible hagan su trabajo. Luego de unos 5-10 minutos usted tendrá un servidor funcionando y un sitio de WordPress instalado automáticamente y configurado.

Para acceder a la VM, corra vagrant ssh. Encontrará los sitios en /srv/www/<site name>. Vea la documentación de Vagrant para más comandos.

Tenga en cuenta que cada sitio configurado quedará sincronizado entre tu máquina local (el host) y la Máquina Virtual (VM) de Vagrant. Cualquier cambio que se realice en el host se sincronizará con la VM.

Composer y los comandos WP-CLI necesitan ser ejecutados en la máquina virtual para cualquier modificación luego del provisionamiento. Todas las herramientas de build de Front-End deben ser ejecutadas desde el host y no desde la VM Vagrant.

No es posible montar carpetas encriptadas con Trellis debido a un conflicto con NFS.

Los usuarios de Windows tienen un flujo de trabajo levemente diferente. Vea la documentación para comenzar en Windows.

Instalación de WordPress

Trellis instala WordPress luego del primer vagrant up con admin como el usuario predeterminado. Puedes sobreescribir estos definiendo admin_user, como se menciona en las opciones de los sitios de WordPress.

Re-provisionando

El re-provisionamiente se asume siempre que es una operación segura. Cuando uno hace cambios en la configuración de Trellis, debe provisionar la VM nuevamente para poder aplicar los cambios:

vagrant provision

También es posible provisionar con ciertas etiquetas para correr únicamente los roles necesarios:

SKIP_GALAXY=true ANSIBLE_TAGS=wordpress vagrant provision

Notas acerca de los comandos:

  • SKIP_GALAXY ahorra tiempo debido a que ya tienes alguno de esos roles instalados
  • ANSIBLE_TAGS ejecuta únicamente roles específicos
  • --provision ejecuta el playbook dev.yml y los roles etiquetados como wordpress

Si agregas un nuevo sitio WordPress (o manualmente agregas directorios sincronizados a Vagrant), deberás recargar la VM:

vagrant reload --provision