Déployer mon back office sur un serveur

Votre back office peut fonctionner sur votre environnement local, mais dans la majorité des cas, votre application est destinée à être accessible en ligne. Pour ce faire, après avoir acquis un VPS ou un serveur dédié, vous aurez alors la possibilité d'installer back office et ses dépendances sur votre serveur. Vous pouvez alors opter pour une installation manuelle ou via Kamal.

Installer manuellement

Dans un premier temps, il vous faut installer Docker sur votre serveur. Vous trouverez toutes les commandes à lancer pour une installation complète dans le tutoriel officiel (pour Debian). Il est aussi possible d'installer Docker en une ligne via le script officiel :

curl -fsSL https://get.docker.com | sudo sh

Afin de pouvoir gérer Docker en tant qu'utilisateur non root, il est conseillé de suivre les instructions post-installation et de lancer les commandes :

sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker

Enfin, il ne vous reste plus qu'à suivre les instructions du guide de démarrage pour installer l'image Docker.

Installer via Kamal

Lorsque votre back office est disponible localement, vous pouvez également le déployer en ligne une seule commande grâce à Kamal. Pour ce faire, il vous faut cependant renseigner plusieurs variables d'environnement :

Variable	Description
SERVER_HOST	L'adresse de votre serveur, par exemple 192.168.0.1
ENABLE_SSL	Activer ou non le support HTTPS
PROXY_HOST	Le nom de domaine de votre application, par exemple back-office.pro
SSH_USER	L'utilisateur SSH, par défaut root

ℹ️

Vous n'avez pas besoin de renseigner PROXY_HOST si ENABLE_SSL n'est pas renseigné.

Enfin vous pouvez lancer la commande avec les variables correctement renseignées :

docker exec -it back-office-web \
            SERVER_HOST=192.168.0.1 \
            ENABLE_SSL=true \
            PROXY_HOST=back-office.pro \
            SSH_USER=deploy \
            bin/kamal setup