Distribuera en Meteor-applikation på Ubuntu

Den här artikeln går igenom hur du distribuerar din Meteor-app till en Vultr VPS som kör Ubuntu 14.04. Det kan också fungera på andra Linux-distributioner (försök på egen risk).

En genialisk kille vid namn Arunoda Susiripala, som är ganska aktiv i Meteor-gemenskapen, har utvecklat ett distributionsverktyg som heter mupx (förkortning för "Meteor Up X"), vilket gör det extremt enkelt att distribuera din Meteor-applikation till en fjärrserver via ssh. Mupx är efterföljaren till mup. Vi guidar dig genom processen från början till slut. Mup gör det mesta av de tunga lyften, som tur är, så det här kommer bli en bris!

Vårt första steg är att installera mupx. Du kommer att göra detta på din utvecklingsarbetsstation, inte på din VPS-server! Se till att du redan har Node.js installerat och kör:

$ npm install -g mupx

När installationen är klar, gå in i din Meteor-projektmapp, t.ex. /projects/myAppoch kör följande kommandon:

$ mkdir .deploy
$ cd $_
$ mupx init

För de som inte är bekanta med $_syntaxen är det en genväg för det sista argumentet som används i ett kommando. Så i det här fallet cd $_körs som cd .deploy.

Du kommer att se följande utdata:

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

Empty Project Initialized!

Initieringsprocessen skapar två filer mup.jsonoch settings.json. Vi lämnar den senare filen ifred just nu. Varsågod och öppna upp mup.json. När du skriver den här artikeln mup.jsonser standarden ut så här:

{
  // 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
}

Vi måste ändra några saker för att installationsprocessen ska fungera.

Se först till att ställa hostin din VPS IP-adress, till exempel:

"host": "123.123.123.123",

Om du behöver använda ett annat portnummer än standard 22 kan du göra det genom att använda sshOptionsfältet, till exempel:

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

Ställ in usernamevärdet på vilken användare du vill ska äga din Meteor-apps installation. Jag rekommenderar att du tar bort lösenordsraden och använder en SSH-nyckel istället, av säkerhetsskäl. Avkommentera raden med pemvärdet och se till att den pekar på din hemliga SSH-nyckel som motsvarar den offentliga SSH-nyckeln du har installerat på din VPS (i /root/.ssh/authorized_keys). Se till att lägga till ett kommatecken efter lösenordsraden! Om din SSH-nyckel har en lösenfras kopplad till den, ta bort pemraden helt och se till att din SSH-privata nyckel är cachad i en ssh-agent (t.ex. på Mac, ssh-add <path to ssh private key>).

Lämna setupMongoinställt på standardvärdet.

Ändra appNametill namnet på din Meteor-app. I vårat fall:

"appName": "myApp",

... och ange även platsen för appen, i förhållande till denna distributionsmapp:

"app": "..",

Slutligen ställer du ROOT_URLin den angivna webbadressen för din app. Ange uttryckligen ett portnummer till standard HTTP-porten.

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

Det är allt! Spara mup.jsonfilen och kör sedan:

$ mupx setup

Vid denna tidpunkt kommer mupx att ssh till din VPS, installera Docker, ställa in miljön och dra lämpliga Docker-bilder. Distribuera nu din app:

$ mupx deploy

Om du nu går till http://123.123.123.123kommer din app att visa när sidan laddas.

Flerkärnigt stöd

Om din VPS har flera kärnor kan din Meteor-app dra fördel av det. Vi måste bara göra ett par snabba justeringar.

Först måste du installera klusterpaketet. Gå in i mappen för din Meteor-app (i det här exemplet /projects/myApp) och skriv:

$ meteor add meteorhacks:cluster

Redigera nu din mup.jsonfil och ändra avsnittet för miljövariabel så här:

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

Eftersom vi har lagt till ett nytt paket i din app måste du distribuera om.

$ mupx setup && mupx deploy

Om du någonsin vill ändra dina miljövariabler mup.jsonutan att behöva distribuera hela appen, använd helt enkelt kommandot reconfigure. Detta är användbart när det inte gjordes några ändringar i applikationen.

$ mupx reconfig

Grattis, din Meteor-app är nu igång! Dessutom kommer din app att starta automatiskt när din VPS startas om. Håll utkik efter framtida artiklar om Meteor-utbyggnad och -hantering.