Configurar un entorno de desarrollo local de WordPress con Vagrant

Si desarrollas con WordPress, es preferible configurar un entorno local en el que hayas instalado un servidor, una herramienta de base de datos y unos cuantos sitios de WordPress junto con otras herramientas que necesites. Esto está bien si sólo trabajas en unos pocos proyectos. Pero cuando se multiplican, surgen los problemas. Y también los quebraderos de cabeza de mantener varios entornos, porque el cliente tiene una configuración diferente a la tuya.

Para solucionar este problema, podemos utilizar lo que llamamosVagrant, una herramienta para trabajar con entornos virtuales. Proporciona una forma fácil de configurar un entorno de desarrollo local con unos pocos comandos, y puedes replicar una configuración completa tantas veces como quieras, con facilidad y sin la molestia de instalar todo manualmente. Para ejecutar Vagrant, necesitas definir un conjunto de reglas. Vagrant configura tu máquina virtual basándose en estas reglas. Para ello, Vagrant necesita dos archivos Vagrantfile, que le dice a Vagrant qué tipo de hardware necesita la máquina virtual, y un archivo de despliegue, que le dice a Vagrant qué hacer en la máquina virtual.

Como Vagrant trabaja con entornos virtuales, necesitas un software de máquina virtual para ejecutar Vagrant. Para nuestros propósitos, utilizaremos el Virtualbox de código abierto.

Instalación de VirtualBox

Dirígete a lapágina de descargas de Virtualbox y descarga el archivo binario correspondiente a tu host invitado. (El host invitado es el sistema operativo desde el que vas a ejecutar tu entorno de desarrollo). Instala Virtualbox.

Instalar Vagrant

Descarga el binario correspondiente a tu sistema operativo desdela página de descargas de Vagrant e instálalo.

Para comprobar si se ha instalado correctamente, escribe el siguiente comando en la línea de comandos de tu sistema operativo.

$ vagrant -v

Instalación del plugin Vagrant Hosts Updater

El pluginvagrant-hostupdater modificará el archivo de hosts de tu SO para que funcionen los dominios configurados por Vagrant. Para instalarlo, ejecuta el siguiente comando

$ vagrant plugin install vagrant-hostsupdater

Reinicia tu SO después de instalar Vagrant/Virtualbox para que no haya problemas de red.

Instalación de Git

Linux

También necesitaremos el control de versiones Git para este tutorial. Si no lo tienes instalado, instálalo con el siguiente comando si tienes una distribución Debian/Ubuntu

$ sudo apt install git

o si tienes Fedora

$ sudo dnf install git

o si tienes CentOS/RHEL

$ sudo yum install git

Comprueba la versión de Git instalada mediante el siguiente comando

$ git --version

Verás algo como

$ git version 2.20.1

Tienes que configurar Git mediante los siguientes comandos.

$ git config --global user.name "Your Name" 
$ git config --global user.email "[email protected]"

Windows

Para instalar Git en Windows, dirígete ala página de descargas de Git e instala el binario.

Mac OS

Si tienes instalado homebrew, puedes instalar Git mediante el siguiente comando.

$ brew install git

o puedes descargar un paquete binario dela página de descargas de Git e instalarlo.

Instalar un conjunto de Vagrant

En lugar de crear una configuración de Vagrant desde cero, utilizaremosVagrant Varying Vagrants(VVV) – una configuración de Vagrant de código abierto destinada específicamente a crear entornos de desarrollo de WordPress. Un VVV estándar configurará tu máquina virtual basada en Ubuntu 18.04 junto con el servidor Nginx, la base de datos MariaDB, PHP, WP-CLI, Node.js, MailHog, Composer, memcached, phpMyAdmin, git y varias otras herramientas. VVV te proporcionará varias instalaciones de WordPress por defecto, siendo una de ellas la última versión de vanguardia para ayudarte a experimentar.

El primer paso es clonar el repositorio Git de VVV en un directorio local de tu sistema.

$ git clone -b master git://github.com/Varying-Vagrant-Vagrants/VVV.git ~/vvv

Aquí estamos clonando la rama maestra del repositorio en el sistema. Si quieres actualizaciones más rápidas, puedes utilizar la rama de desarrollo.

Iniciar VVV

Cambia al directorio donde has clonado VVV.

$ cd vvv

Inicia el entorno Vagrant, que instalará la máquina virtual y configurará todo.

$ vagrant up

Este proceso puede tardar un poco, así que ten paciencia. Es posible que se te pida la contraseña de root durante el proceso, que es necesaria para configurar el archivo de hosts de tu sistema.

Nota para los usuarios de Windows 8/10

Si estás en Windows, puede que te aparezca el siguiente error

==> default: Booting VM... 
There was an error while executing `VBoxManage`, a CLI used by Vagrant 
for controlling VirtualBox. The command and stderr is shown below. 
 
Command: ["startvm", "1fe83aa1-2f23-4ddd-ad77-b7e7e00aabe6", "--type", "headless"] 
 
Stderr: VBoxManage.exe: error: Failed to open/create the internal network 'HostInterfaceNetworking-VirtualBox Host-Only 
Ethernet Adapter #3' (VERR_INTNET_FLT_IF_NOT_FOUND). 
VBoxManage.exe: error: Failed to attach the network LUN (VERR_INTNET_FLT_IF_NOT_FOUND) 
VBoxManage.exe: error: Details: code E_FAIL (0x80004005), component ConsoleWrap, interface IConsole

VirtualBox Host-Only Ethernet Adapter #3

$ vagrant reload --provision

hosts:
  - wpmeta.test

$ vagrant reload --provision

newsite:
    repo: https://github.com/Varying-Vagrant-Vagrants/custom-site-template
    description: "A WordPress subdir multisite install"
    vm_dir: /srv/www/newsite
    local_dir: /home/user/vvv/www/newsite
    branch: master
    nginx_upstream: php
    skip_provisioning: false
    hosts:
      - newsite.test
    custom:
      wp_type: subdirectory

hosts:
    - multisite.test
    - site1.multisite.test
    - site2.multisite.test
  custom:
    wp_type: subdomain

custom: 
     wp_version: nightly

custom:
    db_name: super_secet_db_name

custom:
    site_title: My Awesome Dev Site

$ vagrant reload --provision

howtoforge:
    repo: https://github.com/Varying-Vagrant-Vagrants/custom-site-template
    description: "A WordPress site"
    vm_dir: /srv/www/newsite
    local_dir: /home/user/vvv/www/newsite
    hosts:
      - howtoforge.local

$ cp /var/www/howtoforge/ /home/user/vvv/www/newsite/

$ cd /home/user/vvv/www/newsite
$ mysqldump -u username -p database_name > data-dump.sql

$ vagrant reload --provision

$ vagrant ssh

$ cd /srv/www/newsite 
$ mysql -u root -p newsite < data-dump.sql

$ cd /srv/www/newsite
$ wp core update

$ vagrant halt

$ vagrant box update

$ git pull

$ vagrant up --provision

utilities:
  core:
    - tls-ca
    - phpmyadmin
  java:
    - java7
utility-sources:
  java:
    repo: https://github.com/example/java-utilities.git
    branch: master

java7/
    provision.sh