Mention credentials and docker setup

README.md

@@ -21,20 +21,56 @@ Usiamo Composer  ([e.g](https://www.smashingmagazine.com/2019/03/composer-wordpr
 ``` shell
 apt install composer
 ```
+
 Io ho dovuto installare alcune librerie php extra
 
 ``` shell
 apt install php-xml php-zip
 ```
-Il codice scritto da noi (temi e plugin) si trova nel gruppo @noblogs. Viene tutto rilasciato come pacchetti Composer sul Registry di GitLab.
 
-In questo repository ci sono solo le patch ed i file di configuarazione di composer (al momento, ~8Mb). Il codice vero e proprio di noblogs (l'equivalente di ai/noblogs-wp> per intenderci) abbiamo deciso che non verrà mantenuto in git, dato che viene generato da composer a partire da questo repository.  Lanciando ```composer install``` dovrebbe venire tutto generato nella directory ```app/```.
+Il codice scritto da noi (temi e plugin) si trova nel gruppo
+@noblogs. Viene tutto rilasciato come pacchetti Composer sul Registry
+di GitLab.
+
+In questo repository ci sono solo le patch ed i file di
+configuarazione di composer (al momento, ~8Mb). Il codice vero e
+proprio di noblogs (l'equivalente di ai/noblogs-wp> per intenderci)
+abbiamo deciso che non verrà mantenuto in git, dato che viene generato
+da composer a partire da questo repository.  Lanciando `composer
+install` dovrebbe venire tutto generato nella directory `app/`.
 
 * Per aggiornare le dipendenze di noblogs, il comando da usare è 
 ``` shell
 composer update
 ```
 
+### Set up dell'autenticazione
+
+Siccome alcune dipendenze sono al momento in repository privati,
+composer ha bisogno di autenticarsi con git.autistici.org. Per fare
+ciò bisogna ottenere un *token di autenticazione* (da dentro Gitlab,
+User Settings > Access Tokens, selezionare *read_api*), e poi dare il
+comando:
+
+```shell
+composer config gitlab-token.git.autistici.org $PERSONAL_ACCESS_TOKEN
+```
+
+Questo comando creerà un file *auth.json* con il token: questo file
+verrà ignorato da git perché non va assolutamente committato nel
+repository.
+
+### Utilizzo di Docker
+
+Sfortunatamente la versione di composer in Debian Buster non è
+sufficientemente recente, ma si può usare Docker per eseguire la
+versione giusta, per esempio:
+
+```shell
+docker run --rm --volume $PWD:/data --workdir /data composer:1.10 composer require noblogs/r2db:0.1.7
+```
+
+
 ## Cosa fa composer
 Nel repository c'è un file JSON chiamato ```composer.json```, che descrive
 le dipendenze di Noblogs, più da una certa configurazione alla struttura del suo repository. In questo senso le dipendenze possono essere