README.md

Agenzia per l'Italia Digitale

Repository principale per il sito AgID.

Il portale è sviluppato in Drupal8. Nel repository sono presenti anche le configurazioni per poter avviare il sito web attraverso l'uso di Docker con le immagini di Docker4Drupal fornite da Wodby.

---

Indice

• Installazione
• Contribuire
• Team
• FAQ
• Supporto
• Licenze

---

Installazione in locale

Prerequisiti

Per poter installare il progetto in un ambiente è necessario disporre dei seguenti strumenti/software:

• GIT
• Docker
• Docker Compose

Il progetto è predisposto per essere lanciato attraverso le immagini di Docker4Drupal. E' possibile comunque utilizzare una piattaforma LAMP diversa rispettando i seguenti requisiti:

• PHP >= 7.2
• MariaDB >= 10.1 o MySQL >= 8.0
• Apache >= 2.4
• Solr >= 7.4
• Redis >= 3.2

In questo contesto è necessario inoltre avere installato i seguenti software:

• Composer
• Drush
• DrupalConsole

Nel caso che si utilizzino le immagini di Docker4Drupal questi software sono già presenti all'interno delle immagini stesse.

Avviare il progetto

• Clonare il repository in locale

  git clone https://github.com/AgID/www.agid.gov.it

• Copiare il file .env.example in .env

  Nota: il file .env contiene le configurazioni utilizzate da Docker per eseguire i container

• Per personalizzare ulteriormente l'ambiente docker utilizzato dal portale è possibile sovrascriverne le configurazioni utilizzando docker-compose.override.yml (vedi documentazione). Nel progetto sono già presenti dei template di docker-compose.ovveride.[ENV].yml diversificati per ambienti di utilizzo stage e local

• Avviare i container con il comando make up

  Nota: nel repository è presente un Makefile con all'interno, già pre-configurati per l'utilizzo con l'ambiente Docker fornito nel repository, una serie di comandi per l'interfacciamento sia con Docker che con il sito web Drupal8.

• Installare le dipendenze di composer

# mkdir -p docroot/web/{libraries,core,modules,themes}
chown -R 1000 docroot/web
make exec "composer install --prefer-dist"

• Creare il core Solr:

make solr-core

Importare il dump del database in locale

• Copiare il file default.settings.php in ./docroot/web/sites/default/settings.php

• Copiare il file default.services.yml in ./docroot/web/sites/default/services.yml

• Importare il dump del database make drush "sql-cli < path-to-dump.sql"

Gestire le configurazioni

E' possibile importare le configurazioni presenti nella cartella ./docroot/config/agid usando il comando:

`make drush "cim -y"`

Viceversa per esportare le configurazioni usare:

`make drush "cex -y"`

• Impostare UID=1000 e GID=82 per la directory web.

Annotazioni

Funzionalità

Per l'attivazione automaticata di determinate funzionalità come Config Split, la configurazione del re-indirizzamento delle mail in uscita verso il container Mailhog, ecc... è necessario specificare nell'ambiente PHP la variabile globale ENV_TYPE configurata con i seguenti possibili valori PROD, STAGE e LOC.

Per l'ambiente di produzione

E' necessario configurare direttamente nel settings.php alcune variabili/configurazioni non esportabili nel repository pubblico, come ad esempio i dati di collegamento verso il server mail.