Skip to content

Installation

Zielinski Pierre edited this page Oct 17, 2021 · 11 revisions

Docker

L'installation avec Docker est vivement conseillée. Cette section explique l'installation des composants nécessaires, ainsi que l'exécution du projet pour Windows et Ubuntu. Pour plus d'informations sur l'installation des outils Docker, consultez le manuel d'installation de Docker et de Docker Compose.

Installation de Docker sous Ubuntu

1. Installation de Docker
  • Suppressions des anciennes versions de Docker:
sudo apt-get remove docker docker-engine docker.io containerd runc
  • Installations des paquets permettant à apt d'utiliser un dépôt sur HTTPS
sudo apt-get update
sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg \
    lsb-release
  • Ajout de la clé GPG officielle de Docker
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
  • Configuration du dépôt stable.

Remplacez <ARCH> par votre architecture (arm64 ou armhf ou amd64). Utilisez la commande uname -m pour la connaître.

echo \
  "deb [arch=<ARCH> signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  • Installation de Docker
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io
  • (Optionnel) Utilisation de docker sans sudo

Création du groupe utilisateur docker

sudo groupadd docker

Ajout de votre utilisateur à ce groupe

sudo usermod -aG docker $USER
2. Installation de Docker Compose
  • Téléchargement de la version stable de Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
  • Ajout des permissions sur le fichier
sudo chmod +x /usr/local/bin/docker-compose
  • Création du lien symbolique pour rendre la commande disponible
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
  • Déconnectez-vous

Installation de Docker sous Windows:

Exécution du projet

  • Placez vous dans le répertoire ma2_web_technologies

  • Il est vivement conseillé, pour des raisons de sécurité, de modifier les valeurs des variables suivantes dans le fichier umons-lims2/.env ET install/.env:

#name of the database
DB_NAME=umons_lims
#database root password 
DB_ROOT=f5dU7a8UjkgUc0dUd
#database username
DB_USER=uumons_lims
#database user password
DB_PASSWORD=u_litpas21
  • Téléchargements de tous les composants du projet et démarrage des différents services dans le dossier install.
cd /install

docker-compose --env-file ../umons-lims2/.env up

Prenez une petite pause ☕ l'installation met un peu de temps.

Comme expliqué dans l'issue #6 il est nécessaire de relancer l'installation, une fois celle-ci bloquée durant l'installation de php.

Une fois que la ligne

nginx_1  | [INFO  wait] docker-compose-wait - Everything's fine, the application can now start!

apparaît, vous pouvez vous connecter à l'adresse localhost:82 dans votre navigateur préféré ! 😃

Pour arrêter les serveurs: ctrl+c

Commandes utiles
  • Démarrer les services en mode détaché. C'est à dire que les logs n'apparaissent pas dans le terminal et vous pouvez le fermer une fois les services démarrés.
docker-compose -d --env-file ../umons-lims2/.env up
  • Stopper les services
docker-compose stop
  • Redémarrer les services
docker-compose restart

Installation manuelle

Vous pouvez installer Symfony, PHP et un serveur web mais l'utilisation de Docker est conseillée.

Le projet à été réalisé avec:

  • Symfony version 5.2.9
  • PHP version 8.0.7