Table des matières

Parse Server sur Simple Hosting Node.js

Parse Server est la version open-source du service Parse de Facebook. Ce tutoriel vous guidera pour facilement déployer votre propre Parse Server sur une instance Simple Hosting.

Vous aurez besoin de git et ssh installé sur votre ordinateur pour terminer ce tutoriel.

Nous recommandons également d'utiliser Gandi CLI pour gérer facilement votre instance et exécuter des commandes directement à partir de la ligne de commande.

Étape 1 - Créer votre instance Simple Hosting

Avec Gandi CLI :

  $ gandi paas create --name myparse --type nodejsmongodb

Vous aurez besoin d'avoir assez d'argent sur votre compte prépayé pour terminer cette étape, sinon vous pouvez aller sur le site web Gandi.net pour conclure l'achat.

Par le site web Gandi.net :

https://www.gandi.net/hosting/simple?language=nodejs&db=mongodb

Une fois que votre instance est créée, notez le VHOST par défaut (URL de test) qui a été créé pour vous.

Avec Gandi CLI, vous pouvez le récupérer grâce à cette commande :

  $ gandi paas info myparse | grep vhost

Sur le site web, vous trouverez l'URL de test sur la page de gestion de votre instance.

Étape 2 - Preparer votre Parse Server

Parse Server fournit un exemple de projet que nous allons utiliser dans ce tutoriel.

Pour commencer, cloner le dépôt du projet sur votre ordinateur :

  $ git clone https://github.com/ParsePlatform/parse-server-example.git

Entrez dans le répertoire que vous venez de cloner et créez un fichier .nvmrc, que vous utiliserez pour spécifier quelle version de Node.js vous voulez exécuter sur Simple Hosting. Dans ce cas, il s'agit de Node.js 4.3.

  $ cd parse-server-example
  $ echo "4.3" > .nvmrc

Puis, éditez le fichier package.json pour définir les variables d'environnements de votre instance Parse server dans votre script de démarrage:

  "scripts": {
    "start": "APP_ID=theAppId MASTER_KEY=s0m3th1ngth4t1sh4rdt0gu3ss SERVER_URL=http://<randomstring>.test-url.ws/parse node index.js"
  },

Maintenant, ajoutez et validez les fichiers .nvmrc et package.json sur votre branche git.

  $ git add .nvmrc package.json
  $ git commit -m "Spécifier la version de Node et des variables d'environnements"

Étape 3 - Déployer sur votre instance

Commencez par ajouter un emplacement git distant pour attacher votre dépôt git local à celui sur votre instance Simple Hosting.

Ensuite, déployer votre code en deux étapes: effectuer un git push vers votre dépôt distant, puis exécutez la commande deploy depuis ssh pour construire votre projet et placez-le sur votre instance.

Vous aurez juste à répéter ces deux dernières étapes quand vous apporter et déployer des modifications à votre application.

En utilisant Gandi CLI:

  $ gandi paas attach myparse
  $ git push gandi master
  $ gandi deploy

En utilisant simplement git and ssh :

  $ git remote add gandi git+ssh://{id}@git.{dcX}.gpaas.net/default.git
  $ git push gandi master
  $ ssh {id}@git.{dcX}.gpaas.net 'deploy default.git'

Remplacez les valeurs {entre crochet} ci dessus avec celles que vous trouverez sur la page d'administation de votre instance.

Étape 4 - Tester votre Parse Server

Votre Parse Server est maintenant opérationnel sur votre instance Simple Hosting, et vous pouvez accéder à l'API à l'adresse <randomstring>.test-url.ws/parse.

Pour le tester à partir de votre terminal avec CURL, vous pouvez utiliser :

  $ curl -X POST \
    -H "X-Parse-Application-Id: theAppId" \
    -H "Content-Type: application/json" \
    -d '{"hello":"world"}' \
    http://<randomstring>.test-url.ws/parse/classes/Test

Étape 5 - Utilisation réelle

Intégration avec les applications mobiles ou web

Votre serveur Parse peut être utilisé comme n'importe quel serveur Parse.

Il y a une vaste documentation sur "Comment migrer de l'hébergement de Stripe à votre instance auto-hébergé". Vous y trouverez les informations sur comment adapter votre code existant pour commencer à utiliser sur votre instance Simple Hosting à la place du service déprécié.

Il y a aussi de bons exemples sur la façon d'utiliser Parse SDK pour le web et les plates-formes mobiles si vous créez une nouvelle application. Nous recommandons leur consultation, comme cela s'applique à beaucoup de cas d'utilisation des instances Simple Hosting.

Utiliser votre propre domaine avec SSL

Pour activer SSL, vous aurez besoin d'au moins une instance de taille M et s'activer SSL sur l'instance et le VHOST.

  $ gandi paas update myparse --size m --ssl

Si vous voulez créer un certificat, vous devez générer une clé privée sur votre ordinateur et utilisez la commande suivante pour créer le HOST:

  $ gandi vhost update www.exemple.com --ssl --pk /chemin/vers/votre/clé --poll-cert

Si vous possédez déjà un certificat, il suffit de l'ajouter au Cert Store, puis activez SSL sur le VHOST:

  $ gandi certstore create --pk /chemin/vers/votre/clé --crt /chemin/vers/votre/certificat
  $ gandi vhost update www.exemple.com --ssl

Modifiez ensuite la variable d'environnement SERVER_URL dans votre script de démarrage, dans le fichier package.json.

  "scripts": { 
    "start": "APP_ID=theAppId MASTER_KEY=s0m3th1ngth4t1sh4rdt0gu3ss SERVER_URL=https://www.exemple.com/parse node index.js"
  },

Commit, push et deployer vos changements comme précédemment et votre Parse server sera sécurisé !