Implementer en Meteor-applikation på Ubuntu

Denne artikel vil guide dig gennem implementeringen af ​​din Meteor-app til en Vultr VPS, der kører Ubuntu 14.04. Det kan også virke på andre Linux-distributioner (forsøg på egen risiko).

En genial fyr ved navn Arunoda Susiripala, som er ret aktiv i Meteor-fællesskabet, har udviklet et implementeringsværktøj kaldet mupx (forkortelse for "Meteor Up X"), som gør det ekstremt nemt at implementere din Meteor-applikation til en ekstern server via ssh. Mupx er efterfølgeren til mup. Vi guider dig gennem processen fra start til slut. Mup klarer det meste af de tunge løft, heldigvis, så det bliver en leg!

Vores første skridt er at installere mupx. Du vil gøre dette på din udviklingsarbejdsstation, ikke din VPS-server! Sørg for, at du allerede har Node.js installeret, og kør:

$ npm install -g mupx

Når installationen er fuldført, skal du gå ind i din Meteor-projektmappe, f.eks. /projects/myApp, og køre følgende kommandoer:

$ mkdir .deploy
$ cd $_
$ mupx init

For dem, der ikke er bekendt med $_syntaksen, er det en genvej til det sidste argument, der blev brugt i en kommando. Så i dette tilfælde cd $_udføres som cd .deploy.

Du vil se følgende output:

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

Empty Project Initialized!

Initialiseringsprocessen opretter to filer, mup.jsonog settings.json. Vi lader den sidste fil være i fred lige nu. Gå videre og åben op mup.json. På tidspunktet for skrivning af denne artikel mup.jsonser standarden sådan ud:

{
  // 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 er nødt til at ændre et par ting, for at opsætningsprocessen kan fungere.

Først skal du sørge for at indstille hostdin VPS IP-adresse, for eksempel:

"host": "123.123.123.123",

Hvis du skal bruge et andet portnummer end standard 22, kan du gøre det ved at bruge sshOptionsfeltet, for eksempel:

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

Indstil usernameværdien til den bruger, du vil eje din Meteor-apps installation. Jeg anbefaler at fjerne adgangskodelinjen og bruge en SSH-nøgle i stedet for af sikkerhedsmæssige årsager. Fjern kommentering af linjen med pemværdien, og sørg for, at den peger på din hemmelige SSH-nøgle, der svarer til den offentlige SSH-nøgle, du har installeret på din VPS (i /root/.ssh/authorized_keys). Sørg for at tilføje et komma efter kodeordslinjen! Hvis din SSH-nøgle har en adgangssætning knyttet til sig, skal du fjerne pemlinjen helt og sørge for, at din SSH private nøgle er cachelagret i en ssh-agent (f.eks. på Mac, ssh-add <path to ssh private key>).

Lad være setupMongoindstillet til standardværdien.

Skift appNametil navnet på din Meteor-app. I vores tilfælde:

"appName": "myApp",

... og indstil også appens placering i forhold til denne implementeringsmappe:

"app": "..",

Til sidst skal du indstille ROOT_URLtil den angivne URL for din app. Indstil eksplicit et portnummer til standard HTTP-porten.

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

Det er det! Gem mup.jsonfilen, og kør derefter:

$ mupx setup

På dette tidspunkt vil mupx ssh ind i din VPS, installere Docker, sætte miljøet op og trække de relevante Docker-billeder. Implementer nu din app:

$ mupx deploy

Hvis du nu går til http://123.123.123.123, vil din app vise, når siden indlæses.

Multi-core support

Hvis din VPS har flere kerner, kan din Meteor-app drage fordel af det. Vi bliver bare nødt til at lave et par hurtige justeringer.

Først skal du installere klyngepakken. Gå ind i mappen med din Meteor-app (i dette eksempel /projects/myApp), og skriv:

$ meteor add meteorhacks:cluster

Rediger nu din mup.jsonfil og modificer miljøvariablesektionen sådan:

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

Da vi har tilføjet en ny pakke til din app, bliver du nødt til at geninstallere.

$ mupx setup && mupx deploy

Hvis du nogensinde vil ændre dine miljøvariabler mup.jsonuden at skulle implementere hele appen, skal du blot bruge kommandoen reconfigure. Dette er nyttigt, når der ikke er foretaget nogen applikationsændringer.

$ mupx reconfig

Tillykke, din Meteor-app er nu oppe at køre! Din app starter også automatisk, hver gang din VPS genstarter. Hold øje med fremtidige artikler om Meteor-implementering og -styring.