v2.6

Notas de la versión

• Se integra Docker al proyecto
• Se integra Laravel websockets (en fase de pruebas aún)
• Upgrade de Laravel a la versión 6.x
• Instalación de la extensión Xdebug para facilitar el debug de la aplicación

Pre-requisitos para la instalación del ambiente

- Las siguientes instrucciones están hechas solo para entornos de desarrollo basados en GNU/Linux.

- Si ya tienes instalado en tu sistema Docker y Docker-Compose, mira directamente Instalación del ambiente en nuestra maquina local

---

Instalación de Docker y Docker Compose

1. Actualizamos los paquetes del sistema:

$ sudo apt-get update

2. Instale paquetes para permitir que apt use un repositorio sobre HTTPS:

$ sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg-agent \ software-properties-common

3. Agregue la clave GPG oficial de Docker:

$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

4. Use el siguiente comando para configurar el repositorio estable:

$ sudo add-apt-repository \ "deb [arch=amd64] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) \ stable"

5. Actualizamos los paquetes de nuestro sistema:

$ sudo apt-get update

6. Instale la última versión de Docker Engine

$ sudo apt-get install docker-ce docker-ce-cli containerd.io

7. Verifique que Docker Engine - Community esté instalado correctamente ejecutando la imagen hello-world.

$ sudo docker run hello-world

8. Ejecute este comando para descargar la versión estable actual de Docker Compose:

$ sudo curl -L "https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

9. Aplique permisos ejecutables al binario:

$ sudo chmod +x /usr/local/bin/docker-compose

10. Si el comando docker-compose falla después de la instalación, verifique su ruta. También puede crear un enlace simbólico a / usr / bin o cualquier otro directorio en su ruta.

$ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

11. Probamos la instalación:

$ docker-compose --version

---

Instalación del ambiente en nuestra maquina local

1. Creamos un Fork en GitHub del proyecto

2. Clonamos el repositorio de GitHub en nuestra computadora:

$ git clone [email protected]:'nuestro_usuario'/Barrilete.git

3. Configuramos el branch remoto

git remote add barrilete [email protected]:ConradoSM/Barrilete.git

4. Nos traemos todos los branches

git fetch --all

5. Para trabajar siempre partiremos del branch develop

git checkout develop y luego git pull --rebase barrilete develop

6. Corremos el contenedor de docker:

$ docker-compose up -d

7. Instalamos las dependencias de Laravel:

$ docker-compose exec app composer install

8. Generamos el archivo .env

$ cp .env.example .env

9. Si esto es correcto, podemos correr dos comandos mas para adicionar seguridad a nuestra aplicación:

$ docker-compose exec app php artisan key:generate

$ docker-compose exec app php artisan config:cache

$ docker-compose exec app php artisan config:clear

10. Corremos las migraciones y seeders:

$ docker-compose exec app php artisan migrate

$ docker-compose exec app php artisan db:seed

11. Instalamos paquetes de npm

docker-compose exec -u root app npm install

12. Compilación automática de archivos javascript y css durante el desarrollo

docker-compose exec app npm run watch

13. Editamos el archivo etc/hosts agregando la siguiente línea:

127.0.0.1 local.barrilete.com.ar

14. Probamos el sitio:

http://local.barrilete.com.ar