Déployer une application Meteor sur Ubuntu

Cet article vous guidera à travers le déploiement de votre application Meteor sur un VPS Vultr exécutant Ubuntu 14.04. Il peut également fonctionner sur d'autres distributions Linux (essayez à vos risques et périls).

Un ingénieux nommé Arunoda Susiripala, qui est très actif dans la communauté Meteor, a développé un outil de déploiement appelé mupx (abréviation de "Meteor Up X"), qui rend extrêmement facile le déploiement de votre application Meteor sur un serveur distant via ssh. Mupx est le successeur de mup. Nous vous guiderons à travers le processus du début à la fin. Mup fait le gros du travail, heureusement, donc ce sera un jeu d'enfant!

Notre première étape consiste à installer mupx. Vous le ferez sur votre poste de travail de développement, pas sur votre serveur VPS! Assurez-vous que Node.js est déjà installé et exécutez:

$ npm install -g mupx

Une fois l'installation terminée, allez dans votre dossier de projet Meteor, par exemple /projects/myApp, et exécutez les commandes suivantes:

$ mkdir .deploy
$ cd $_
$ mupx init

Pour ceux qui ne connaissent pas la $_syntaxe, c'est un raccourci pour le dernier argument utilisé dans une commande. Donc dans ce cas, cd $_s'exécute en tant que cd .deploy.

Vous verrez la sortie suivante:

Meteor Up: Production Quality Meteor Deployments
------------------------------------------------
Configuration file : mup.json
Settings file      : settings.json

Empty Project Initialized!

Le processus d'initialisation crée deux fichiers, mup.jsonet settings.json. Nous laisserons ce dernier fichier seul pour le moment. Allez-y et ouvrez-vous mup.json. Au moment de la rédaction de cet article, la valeur par défaut mup.jsonressemble à ceci:

{
  // Server authentication info
  "servers": [
    {
      "host": "hostname",
      "username": "root",
      "password": "password",
      // or pem file (ssh based authentication)
      // WARNING: Keys protected by a passphrase are not supported
      //"pem": "~/.ssh/id_rsa"
      // Also, for non-standard ssh port use this
      //"sshOptions": { "port" : 49154 },
      // server specific environment variables
      "env": {}
    }
  ],

  // Install MongoDB on the server. Does not destroy the local MongoDB on future setups
  "setupMongo": true,

  // Application name (no spaces).
  "appName": "meteor",

  // Location of app (local directory). This can reference '~' as the users home directory.
  // i.e., "app": "~/Meteor/my-app",
  // This is the same as the line below.
  "app": "/path/to/the/app",

  // Configure environment
  // ROOT_URL must be set to your correct domain (https or http)
  "env": {
    "PORT": 80,
    "ROOT_URL": "http://myapp.com"
  },

  // Meteor Up checks if the app comes online just after the deployment.
  // Before mup checks that, it will wait for the number of seconds configured below.
  "deployCheckWaitTime": 15,

  // show a progress bar while uploading. 
  // Make it false when you deploy using a CI box.
  "enableUploadProgressBar": true
}

Nous devons changer quelques éléments pour que le processus de configuration fonctionne.

Tout d'abord, assurez-vous de définir hostvotre adresse IP VPS, par exemple:

"host": "123.123.123.123",

Si vous devez utiliser un numéro de port autre que le 22 par défaut, vous pouvez le faire en utilisant le sshOptionschamp, par exemple:

"host": "123.123.123.123",
"sshOptions": { "port": 9876 },

Définissez la usernamevaleur de l'utilisateur que vous souhaitez posséder pour l'installation de votre application Meteor. Je recommande de supprimer la ligne de mot de passe et d'utiliser une clé SSH à la place, pour des raisons de sécurité. Décommentez la ligne avec la pemvaleur et assurez-vous qu'elle pointe vers votre clé secrète SSH qui correspond à la clé publique SSH que vous avez installée sur votre VPS (en /root/.ssh/authorized_keys). Assurez-vous d'ajouter une virgule après la ligne de mot de passe! Si votre clé SSH est associée à une phrase secrète, supprimez pementièrement la ligne et assurez-vous que votre clé privée SSH est mise en cache dans un agent ssh (par exemple sur Mac, ssh-add <path to ssh private key>).

Laissez le setupMongoréglage à sa valeur par défaut.

Changez appNamele nom de votre application Meteor. Dans notre cas:

"appName": "myApp",

... et définissez également l'emplacement de l'application par rapport à ce dossier de déploiement:

"app": "..",

Enfin, définissez le ROOT_URLsur l'URL désignée pour votre application. Définissez explicitement un numéro de port sur le port HTTP standard.

// Configure environment
"env": {
  "ROOT_URL": "http://myapp.com",
  "PORT": 80
},

C'est ça! Enregistrez le mup.jsonfichier, puis exécutez:

$ mupx setup

À ce stade, mupx va ssh dans votre VPS, installer Docker, configurer l'environnement et extraire les images Docker appropriées. Déployez maintenant votre application:

$ mupx deploy

Maintenant, si vous allez sur http://123.123.123.123, votre application s'affichera lorsque la page se chargera.

Prise en charge multicœur

Si votre VPS a plusieurs cœurs, votre application Meteor peut en profiter. Nous aurons juste à faire quelques ajustements rapides.

Tout d'abord, vous devrez installer le package de cluster. Allez dans le dossier de votre application Meteor (dans cet exemple, /projects/myApp) et tapez:

$ meteor add meteorhacks:cluster

mup.jsonModifiez maintenant votre fichier et modifiez la section des variables d'environnement comme suit:

// Configure environment
"env": {
  "ROOT_URL": "http://myapp.com",
  "PORT": 80,
  "CLUSTER_WORKERS_COUNT": "auto"
},

Puisque nous avons ajouté un nouveau package à votre application, vous devrez redéployer.

$ mupx setup && mupx deploy

Si vous souhaitez modifier vos variables d'environnement mup.jsonsans avoir à déployer l'ensemble de l'application, utilisez simplement la commande de reconfiguration. Ceci est utile lorsqu'aucune modification d'application n'a été effectuée.

$ mupx reconfig

Félicitations, votre application Meteor est maintenant opérationnelle! De plus, votre application démarre automatiquement à chaque redémarrage de votre VPS. Gardez un œil sur les futurs articles sur le déploiement et la gestion de Meteor.