HOWTO_installation_docker.md 2.63 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140
# Installation du projet avec docker pour les développeurs

## Téléchargement

[Download](https://gitlab.adullact.net/departements-notaires/departements-notaires-v2/repository/archive.zip?ref=master)

## Configuration (facultatif - les fichiers sont créés si non présent lors de l'installation)

Créer les fichiers .env et appli_sf/.env en copiant respectivement les fichiers .env.dist et appli_sf/.env.dist et les modifier si besoin.

Dans le fichier appli_sf/.env :
* APP_ENV doit être assigné avec la valeur "dev"
* DATABASE_URL doit être définie de cette façon : mysqli://DB_USER:DB_PASSWORD@database:3306/DB_NAME\
DB_USER, DB_PASSWORD et DB_NAME sont les mêmes que dans le .env à la racine
* MAILER_DSN doit contenir smtp://mail:1025
* Bien renseigner MAILER_SENDER avec une adresse mail d'envoi

## Installation

```shell script
make install
```

Vérifier la présence et le contenu des fichiers .env et appli_sf/.env. Relancer les conteneurs docker en cas de modification : `make docker-restart`

## Accès aux services

Application web : `http://HTTP_HOSTNAME:HTTP_PORT` ou `http://127.0.0.1:HTTP_PORT`

Client de messagerie : `http://HTTP_HOSTNAME:MAILER_CLIENT_PORT`

\* HTTP_HOSTNAME, HTTP_PORT et MAILER_CLIENT_PORT sont définies dans le .env à la racine

## Initialiser la base données

Créer un nouvel utilisateur : 

```
./bin/console user:add
```

Et importer les données de test :

```
./bin/console import:individus imports/individus.csv
```

## Réinitialiser le projet

Suppression des containers et volumes docker ainsi qu'un effacement des fichiers générés :

```
make clean
```
*/!\ Les fichiers .env et appli_sf/.env ne sont pas supprimés*

## Commandes à connaitre

* Commandes Symfony :

```
./bin/console
```

* Vider les caches Symfony :

```
./bin/console cache:clear
```

* Relancer une installation avec réinitialisation :

```
make reset
```
*Équivalent à `make clean` suivi de `make install`*

*\/!\ Les fichiers .env et appli_sf/.env ne sont pas supprimés. Les supprimer manuellement avant pour une réinitialisation complète*

* Utiliser composer :

```
./bin/composer
```

* Utiliser yarn :

```
./bin/yarn
```

* Compiler les ressources (JS + SCSS)

```
./bin/yarn dev
```

* Activer le "watcher" pour les ressources (JS + SCSS)

```
./bin/yarn watch
```

* Démarrer les conteneurs docker

```
make docker-start
```

* Stopper les conteneurs docker

```
make docker-stop
```

* Redémarrer les conteneurs docker

```
make docker-restart
```

* Détruire les conteneurs docker

```
make docker-kill
```

## Outils d'analyse et de tests du code

* PHP_CodeSniffer :

```
./bin/phpcs
```

* PHPStan :

```
./bin/phpstan
```