ORCHESTRATOR

Introduction to ORCHSTRATOR (TBD)

INSTALL

First of all install the GEOBOX repo and configure the ALIASES command. Replace ${instance name} with the instance name (APP_NAME in .env file)

git clone git@github.com:webmappsrl/${instance name}.git orchestrator
git flow init

Important NOTE: remember to checkout the develop branch.

cd ${instance name}
bash docker/init-docker.sh
docker exec -u 0 -it php81_${instance name} bash
chown -R 33 storage

Important NOTE: if you have installed XDEBUG you need to create the xdebug.log file on the docker:

docker exec -u 0 -it php81_${instance name} bash
touch /var/log/xdebug.log
chown -R 33 /var/log/

At the end run install command to for this instance

geobox_install ${instance name}

Important NOTE:

• Update your local repository of Geobox following its Aliases instructions. Make sure that you have set the environment variable GEOBOX_PATH correctly.
• Make sure that the version of wm-package of your instance is at leaset 1.1. Use command:

composer update wm/wp-package

Finally to import a fresh copy of database use Geobox restore command:

geobox_dump_restore ${instance name}

Problemi noti

Durante l'esecuzione degli script potrebbero verificarsi problemi di scrittura su certe cartelle, questo perchè di default l'utente dentro il container è www-data (id:33) quando invece nel sistema host l'utente ha id 1000. Ci sono 2 possibili soluzioni:

• Chown/chmod della cartella dove si intende scrivere, eg:

    chown -R 33 storage

  NOTA: per eseguire il comando chown potrebbe essere necessario avere i privilegi di root. In questo caso si deve effettuare l'accesso al cointainer del docker utilizzando lo specifico utente root (-u 0). Questo è valido anche sbloccare la possibilità di scrivere nella cartella /var/log per il funzionamento di Xdedug

• Utilizzare il parametro -u per il comando docker exec così da specificare l'id utente, eg come utente root (utilizzare APP_NAME al posto di $nomeApp): bash docker exec -u 0 -it php81_$nomeApp bash scripts/deploy_dev.sh

Xdebug potrebbe non trovare il file di log configurato nel .ini, quindi generare vari warnings

• creare un file in /var/log/xdebug.log all'interno del container phpfpm. Eseguire un chown www-data /var/log/xdebug.log. Creare questo file solo se si ha esigenze di debug errori xdebug (impossibile analizzare il codice tramite breakpoint) visto che potrebbe crescere esponenzialmente nel tempo