Instalación de Laravel Homestead (II)

 

Una vez instalado el software necesario en nuestro ordenador, es el momento de proceder a la instalación del Homestead.

Como ya dije anteriormente, el Homestead se puede instalar de modo global en tu ordenador o por proyectos. Cuando la instalación se realiza de forma global, la configuración de Homestead es común a todos los proyectos que tengas en marcha en tu máquina. Por otro lado, la instalación por proyecto permite que al compartir el código de tu proyecto con otras personas se comparta también la configuración del Vagrant Box de Homestead. De este modo, todos los integrantes en el grupo de trabajo tendrían la misma configuración para las pruebas evitando así problemas de compatibilidad al desarrollar.

Instalación Global

La instalación de forma global se realiza en tres pasos muy sencillos. Se hará en un directorio del home del usuario. Por defecto, se le suele llamar Homestead. Los pasos a seguir son:

• Clonación del repositorio de Homestead. Para eso utilizaremos la herramienta git que ya instalamos en nuestro sistema:

git clone https://github.com/laravel/homestead.git ~/Homestead

El directorio Homestead se creará automáticamente durante el proceso de clonación. No hay que ser superusuario para ejecutar este comando. 

• Después de la clonación hay que hacer el checkout de la rama release, que contiene la última versión estable de Homestead.

cd ~/Homestead

git checkout release 

• Por último sólo resta ejecutar un script en el directorio ~/Homestead para que se cree el fichero de configuración Homestead.yaml.

bash init.sh

Con estos sencillos pasos ya tenemos instalado de forma global el Homestead. Ya sólo nos quedaría configurar para empezar a usarlo.

Instalación por proyecto

En vez de instalar Homestead a nivel global y compartir la misma máquina virtual de Homestead en todos sus proyectos, se puede configurar una instancia de Homestead para cada proyecto que administre. La instalación de Homestead por proyecto puede ser beneficiosa si desea enviar un Vagrantfile con su proyecto, permitiendo que otros que trabajen en el proyecto levantar la máquina Vagrant inmediatamente después de clonar el repositorio.

Para instalar Homestead en su proyecto se ha de utilizar el administrador de paquetes Composer. En primer lugar abrimos una terminal y nos colocamos en el directorio de nuestro proyecto. Una vez allí, ejecutamos:

composer require laravel/homestead --dev

Una vez instalado Homestead en el directorio del proyecto, hay que invocar el comando make de Homestead para generar los fichero Vagrantfile y  Homestead.yaml para nuestro proyecto. Esos archivos se ubicarán en la raíz del proyecto. El comando make configurará automáticamente las directivas sites y folders en el fichero Homestead.yaml:

php vendor/bin/homestead make

Lo siguiente será levantar la máquina Vagrant con el comando vagrant up desde la terminal. Al proyecto se accede con la URL http://homestead.test en el navegador. Hay que recordar que aún se necesitará configurar una entrada en el fichero /etc/hosts para homestead.test.

===============

NOTA: es posible que al levantar la máquina de un error si no tienes creadas las claves SSH. Esto se soluciona ejecutando:

ssh-keygen -t rsa -m PEM -b 4096 -C "myuser@myserver"

Explicación del comando

ssh-keygen = programa usado para crear las claves;

-m PEM = formatea la clave como PEM

-t rsa = tipo de clave que se va a crear; en este caso, en el formato RSA

-b 4096 = número de bits de la clave; en este caso, 4096

-C "myuser@myserver" = comentario que se anexa al final del archivo de clave pública para identificarlo fácilmente. Normalmente, se usa una dirección de correo electrónico como comentario, pero utilice lo que funcione mejor para su infraestructura.

-f ~/.ssh/mykeys/myprivatekey = nombre del archivo de clave privada, si decide no usar el nombre predeterminado. Se genera un archivo de clave pública correspondiente anexo a .pub en el mismo directorio. El directorio debe existir.

-N mypassphrase = frase de contraseña adicional que se usa para acceder al archivo de clave privada.

===============

Ya tenemos instalado Homestead del modo que prefiramos, ya sea de forma global o por proyecto. En el siguiente artículo explicaré la configuración en el fichero Homestead.yaml como último paso de la instalación.

Puedes continuar con el siguiente artículo de la serie siguiendo este enlace: Instalación de Laravel Homestead (III)