Skip to content

docker-laravel.md

Latest commit

 

History

History
147 lines (100 loc) · 4.52 KB

docker-laravel.md

File metadata and controls

147 lines (100 loc) · 4.52 KB
Raw

Docker for Laravel

Obiettivi:

  1. Rendere identici gli ambienti di development
  2. Rendere identico l'ambiente di development e il production
  3. Eseguire la Continous Integration in un ambiente identico a development e production

Uso

Inizia ad usare docker e imparalo poi.

Avviare docker

  1. Spostarsi all'interno della cartella di laradock_[nomeprogetto]
  2. Verificare di avere all'interno della cartella il link simbolico al file .env del progetto nella cartella precedente, altrimenti leggere al paragrafo Impostare riferimento a .env locale
  3. Eseguire:
docker-compose up -d apache2 mysql php-worker

Una volta eseguito dovrebbe essere possibile raggiungere la radice del progetto nel proprio browser all'indirizzo: http://$SERVER_ALIAS:$SERVER_PORT, ad esempio: http://local.project.net:8888. Le variabili SERVER_ALIAS e SERVER_PORT sono definite nel file .env del progetto Laravel

http://local.project.net:8888

Inizializzazione progetto Laravel

Se il progetto Laravel non è configurato per utilizzare docker eseguire le seguenti operazioni:

1. Importare tiknil/laradock

Includere nella root di progetto Laravel il submodule tiknil/laradock specificando la cartella destinazione laradock_[nomeprogetto]:

git submodule add https://github.com/tiknil/laradock.git laradock_[nomeprogetto]

2. Impostare riferimento a .env locale

  1. Spostarsi all'interno della cartella di laradock_[nomeprogetto]
  2. Eseguire il comando:
ln -s ../.env .env

Questo creerà un link virtuale tra l'.env di progetto e le configurazioni dei container in docker.

3. Configurazione .env

  • All'interno del file .env di progetto configurare:
  • DB_HOST=mysql per la connessione al database
  • Valorizzare: SERVER_ALIAS, SERVER_PORT, SERVER_SSL_PORT
  • Valorizzare DB_PORT, DB_DATABASE, DB_PASSWORD e DB_USERNAME

4. Impostazione host personalizzato, ad es: local.project.net

Modificare il file hosts locale (solitamente il percorso è /etc/hosts e serve accedere come sudo per modificare) inserendo:

127.0.0.1	[$SERVER_ALIAS]

ad esempio:

127.0.0.1 local.project.it

Riavviate i container docker e accedete al sito tramite il dominio e la porta che avete configurato.

Docker containers

Avviando docker tramite il comando:

docker-compose up -d apache2 mysql php-worker

Vengono avviati i seguenti container:

- apache2 (configurato con virtual host definito da SERVER_ALIAS e SERVER_PORT / SERVER_SSL_PORT
- mysql (configurato con le variabili DB_*)
- php-worker (che esegue le queue di laravel tramite un job persistente)
- workspace (è un container specifico che fa da storage dei file di progetto. E' il punto centrale, per così dire, dei container del progetto)
- php_fpm (è il container che si preoccupa di gestire l'eseguibile PHP con FPM)

Troubleshooting

Se ci sono problemi di configurazione o altro si consiglia di "distruggere" i container con il comando docker-compose downe forzare il rebuild con docker-compose build --no-cache apache2 mysql php-worker workspace

Eseguire comandi per inizializzazione progetto

Accedere al terminale del "container" che permette l'esecuzione dei comandi sul progetto

docker-compose exec workspace bash

e quindi eseguire tutto quello che serve (se non è già stato fatto in locale):

composer install
php artisan migrate
php artisan db:seed
...

Comandi docker

Per fermare il docker:

docker-compose stop

Per cancellare i docker creati:

docker-compose down

Per rendere attive le modifiche effettuate sui file Dockerfile dei container è necessario eseguire:

 docker-compose build --no-cache [container-name]

il parametro [container-name] è uguale al nome della cartella relativa al container

Utilies

Connettersi al DB MySQL con SequelPro

Semplicemente connessione locale con Host: 127.0.0.1, Username - il valore di DB_USERNAME nel file .env - e pw DB_PASSWORD in .env. Questo vale se la porta configurata per l'accesso a MySql è quella di default (3306). altrimenti è la porta configurata in DB_PORT in .env.

Mostrare il log di un container

Per mostrare nel terminale il log di un container eseguire:

docker logs [image-laradock-name]

L'elenco dei container attivi si ottiene eseguendo:

docker ps

La colonna IMAGE è il parametro da inserire come [image-laradock-name]