-
Notifications
You must be signed in to change notification settings - Fork 0
Héberger StickStorage
Ce guide vous permet d'héberger StickStorage sur Vercel à l'aide de GitHub, vous pouvez voir les avantages et inconvénients dans le comparatif. Noter que les instructions pour créer un compte Vercel et GitHub ne sont pas incluses dans ce guide.
Exemple d'instance StickStorage hébergé sur Vercel : storage.johanstickman.com
Remarque : Pour les serveurs web, Vercel utilise les serverless function. Le but est d'allumer un serveur uniquement pour servir une requête, puis de l'éteindre automatiquement après. Le temps requis pour démarrer le serveur reste néanmoins plutôt rapide.
-
Rendez-vous sur le GitHub de StickStorage et cliquer sur le bouton vert "Use this template".
-
Depuis ici, vous pouvez ajouter un nom et une description au repo que vous allez créer. Nous vous conseillons également de le rendre privé, surtout si vous comptez héberger les fichiers localement (même si utiliser Firebase reste à priori meilleur ptdr)
-
Patienter quelques instants pendant que votre repo se génère, vous pourrez ensuite modifier le fichier de configuration.
-
Rendez-vous maintenant sur Vercel pour créer un nouveau projet à partir de votre repo
-
Ne modifier aucune option (appart le nom si vous voulez vraiment), puis cliquer sur "Deploy".
Votre propre instance devrait être déployée sur Vercel, pour effectuer des modifications sur les fichiers vous n'aurez qu'à les effectuer depuis GitHub puisque Vercel détectera les changements.
Ce guide vous permet d'héberger StickStorage sur votre propre appareil, vous pouvez voir les avantages et inconvénients dans le comparatif. Ces instructions ont été faites pour Linux mais peuvent fonctionner sous Windows.
Pour cette méthode vous aurez besoin d'installer :
- NPM et NodeJS v14 ou plus récent
- Git CLI
- Dans un terminal, exécuter la commande
git clone https://github.com/johan-perso/stickstorage.git
pour télécharger tous les fichiers du serveur web. - Rendez-vous dans le dossier avec
cd stickstorage
- Installer les dépendances avec
npm install
- Vous pouvez maintenant modifier la configuration.
- Il vous reste qu'à configurer les redirections de port pour que le serveur web puisse être accessible par tout le monde.
Si vous souhaitez démarrer le serveur temporairement, vous n'avez qu'à utiliser la commande node index.js
. Pour une utilisation en production, il est conseillé d'utiliser un outil tel que PM2 :
- Installer l'outil avec la commande
npm install pm2 --global
(les droits root peuvent être requis). - Vous pourrez lancer le serveur avec
pm2 start index.js
, la commandepm2 stop index.js
vous permettra de l'arrêter.
Noter que le serveur ne redémarre pas automatiquement quand votre appareil redémarre, vous pouvez suivre ces instructions pour le faire.
Si vous comptez utiliser un VPS pour héberger StickStorage, vous devez vous assurer que celui-ci vous autorise les choses suivantes :
- Redirection de port pour le serveur web (de préférence 80, pour ne pas avoir à l'entrée manuellement dans l'URL).
- Accès root (
sudo
) / administrateur. - Un débit et une vitesse de disque assez rapide (si vous comptez héberger les fichiers localement).