Skip to content

Héberger StickStorage

Jump to bottom
Johan le stickman edited this page May 5, 2023 · 3 revisions

Essayer sur Stackblitz

Open in Stackblitz

Héberger sur Vercel

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.

  1. Rendez-vous sur le GitHub de StickStorage et cliquer sur le bouton vert "Use this template". Créer un repo

  2. 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) Modifier les infos

  3. Patienter quelques instants pendant que votre repo se génère, vous pourrez ensuite modifier le fichier de configuration.

  4. Rendez-vous maintenant sur Vercel pour créer un nouveau projet à partir de votre repo Modifier les infos

  5. 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.

Héberger localement

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
  1. 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.
  2. Rendez-vous dans le dossier avec cd stickstorage
  3. Installer les dépendances avec npm install
  4. Vous pouvez maintenant modifier la configuration.
  5. 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 :

  1. Installer l'outil avec la commande npm install pm2 --global (les droits root peuvent être requis).
  2. Vous pourrez lancer le serveur avec pm2 start index.js, la commande pm2 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.

Critères d'un VPS

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).
Clone this wiki locally