Apéndice: Scotch Box

Lo que sigue es una descripción de cómo instalar el excelente Scotch Box en nuestra computadora, para poder tener un entorno operacional de desarrollo completo para XenForo en unos pocos minutos y con un manojo de comandos.

XenForo tiene un config personalizado de Scotch Box, que provee todo lo necesario para ejecutar XenForo, iincluyendo un depurador y una caché de datos para mejora del rendimiento.

Scotch Box se ejecuta en entornos VirtualBox / Vagrant.

Instalar Scotch Box

Hay que comenzar decidiendo donde se quieren ubicar los archivos del servidor virtual web en la computadora. Se recomienda elegir una ubicación en el directorio de usuario inicial.

En los siguientes ejemplos de ubicaciones se usará un directorio denominado MiServidor, ubicado en la raíz del directorio de usuario e identificado por nuestro nombre {username}:

  • /Users/{username}/MiServidor (Mac)
  • C:\Users\{username}\MiServidor (Windows)
  • /home/{username}/MiServidor (algunas distribuciones Linux)
  • /users/{username}/MiServidor (otras distribuciones Linux)

Una vez elegida la ubicación, síganse estos pasos:

  1. Instalar VirtualBox en nuestra computadora
  2. Instalar Vagrant en nuestra computadora

  3. Utilizando un cliente git, hay que clonar https://github.com/scotch-io/scotch-box en el directorio MiServidor. Utilizando un cliente de comandos en línea con la ubicación de ejemplo de Mac de arriba, el comando sería:

    git clone https://github.com/scotch-io/scotch-box /Users/{username}/MiServidor

  4. Una vez completado el proceso de clonación, hay que descargar este archivo Vagrant personalizado y sobreescribir el archivo Vagrant creado en */Users/{username}/MiServidor/Vagrantfile: Descargar archivo Vagrant personalizado.

  5. Cuando esté en su ubicación el archivo Vagrant personalizado, hay que ejecutar los siguientes comandos:

    cd /Users/{username}/MiServidor vagrant up

Se ha creado la máquina virtual Scotch Box virtual y está lista para utilizarse.

Nota

Scotch Box también provee una versión 'Scotch Box Pro' de su máquina virtual por un razonable precio de adquisición. Si se prefiere ejecutar Scotch Box Pro, hay que acudir a la sección siguiente que describe las diferencias entre configurar y ejecutar Scotch Box y Scotch Box Pro.

¿A donde van los archivos?

Una vez que Scotch Box está listo y ejecutándose, pueden mantenerse los archivos PHP y JS de XenForo en la máquina de alojamiento, permitiendonos utilizar un editor de texto o IDE de nuestra elección mientras la máquina virtual se responsabiliza de compilar y servir estos archivos a través de su servidor web.

Podremos visitar el nuevo servidor web en nuestro navegador web en la siguiente dirección:

http://192.168.33.10

El servidor web extraerá los archivos de los que se servirá

/Users/{username}/MiServidor/public

Si se desea instalar XenForo en http://192.168.33.10/xenforo, habrá que colocar el contenido del directorio upload del paquete de XenForo en /Users/{username}/MiServidor/public/xenforo.

Detener y reiniciar el servidor

Puede detenerse el servidor Scotch Box en cualquier momento, ejecutando

cd /Users/{username}/MiServidor
                vagrant halt

... y se puede reiniciar para ejecutarlo

cd /Users/{username}/MiServidor
                vagrant up

Nota

A pesar de que Vagrant / Scotch Box se apagarán automáticamente al reiniciar nuestra computadora, no se ejecutarán automáticamente al iniciarla de nuevo.

Siempre que se reinicie, será necesario ejecutar de nuevo el comando vagrant up para poder utilizar el servidor.

Documentación oficial

Esta guía deriva de la documentación oficial de Scotch Box que se localiza en https://box.scotch.io

Scotch Box Pro

Cuando Scotch Box básico precise de alguna configuración adicional (como la que se entrega en el archivo Vagrant personalizado), para poder ejecutar XenForo 2, Scotch Box Pro no necesita ninguna configuración adicional y está lista para ejecutar XenForo 2 sin descargar paquetes extra.

Para ejecutar Scotch Box Pro, que hay que adquirir en el sitio web de Scotch Box Pro, hay que ejecutar el comando git clone provisto como parte de las instrucciones que recibiremos tras la adquisición.

Ahora ya se podrá instalar utilizandolas mismas instrucciones de arriba con la sola excepción de que habrá que descargar este archivo personalizado Vagrant en lugar del indicado en las instrucciones de Scotch Box.