Distribuire unapplicazione Meteor su Ubuntu

Questo articolo ti guiderà attraverso la distribuzione della tua app Meteor su un VPS Vultr con Ubuntu 14.04. Potrebbe anche funzionare su altre distribuzioni Linux (tentare a proprio rischio).

Un ingegnoso collega di nome Arunoda Susiripala, che è piuttosto attivo nella comunità Meteor, ha sviluppato uno strumento di distribuzione chiamato mupx (abbreviazione di "Meteor Up X"), che rende estremamente facile distribuire l'applicazione Meteor su un server remoto tramite ssh. Mupx è il successore di mup. Ti guideremo attraverso il processo dall'inizio alla fine. Mup fa la maggior parte del sollevamento pesante, per fortuna, quindi sarà un gioco da ragazzi!

Il nostro primo passo è installare mupx. Lo farai sulla tua workstation di sviluppo, non sul tuo server VPS! Assicurati di avere già installato Node.js ed esegui:

$ npm install -g mupx

Al termine dell'installazione, accedere alla cartella del progetto Meteor, ad es /projects/myApp. Ed eseguire i comandi seguenti:

$ mkdir .deploy
$ cd $_
$ mupx init

Per coloro che non hanno familiarità con la $_sintassi, è una scorciatoia per l'ultimo argomento usato in un comando. Quindi, in questo caso, cd $_esegue come cd .deploy.

Vedrai il seguente output:

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

Empty Project Initialized!

Il processo di inizializzazione crea due file mup.jsone settings.json. Lasceremo solo quest'ultimo file in questo momento. Vai avanti e apriti mup.json. Al momento della stesura di questo articolo, l'impostazione predefinita mup.jsonè simile alla seguente:

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

Dobbiamo modificare alcune cose affinché il processo di installazione funzioni.

Innanzitutto, assicurati di impostare il hosttuo indirizzo IP VPS, ad esempio:

"host": "123.123.123.123",

Se è necessario utilizzare un numero di porta diverso da quello predefinito 22, è possibile farlo utilizzando il sshOptionscampo, ad esempio:

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

Imposta il usernamevalore su qualsiasi utente desideri possedere l'installazione dell'app Meteor. Consiglio di rimuovere la riga della password e di utilizzare invece una chiave SSH per motivi di sicurezza. Scomponi la riga con il pemvalore e assicurati che punti alla tua chiave segreta SSH che corrisponde alla chiave pubblica SSH che hai installato sul tuo VPS (in /root/.ssh/authorized_keys). Assicurati di aggiungere una virgola dopo la riga della password! Se alla tua chiave SSH è associata una passphrase, rimuovi completamente la pemlinea e assicurati che la tua chiave privata SSH sia memorizzata nella cache in un agente ssh (ad es. Su Mac, ssh-add <path to ssh private key>).

Lasciare setupMongoimpostato sul valore predefinito.

Passa appNameal nome dell'app Meteor. Nel nostro caso:

"appName": "myApp",

... e imposta anche la posizione dell'app, relativa a questa cartella di distribuzione:

"app": "..",

Infine, imposta l' ROOT_URLURL designato per la tua app. Impostare esplicitamente un numero di porta sulla porta HTTP standard.

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

Questo è tutto! Salvare il mup.jsonfile, quindi eseguire:

$ mupx setup

A questo punto mupx entrerà nel tuo VPS, installerà Docker, configurerà l'ambiente e tirerà le immagini Docker appropriate. Ora distribuisci la tua app:

$ mupx deploy

Ora, se vai a http://123.123.123.123, la tua app mostrerà quando la pagina viene caricata.

Supporto multi-core

Se il tuo VPS ha più core, la tua app Meteor può trarne vantaggio. Dovremo solo fare un paio di rapidi ritocchi.

Innanzitutto, dovrai installare il pacchetto del cluster. Vai nella cartella dell'app Meteor (in questo esempio, /projects/myApp) e digita:

$ meteor add meteorhacks:cluster

Ora modifica il tuo mup.jsonfile e modifica la sezione delle variabili di ambiente in questo modo:

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

Poiché abbiamo aggiunto un nuovo pacchetto alla tua app, dovrai ridistribuire.

$ mupx setup && mupx deploy

Se desideri modificare le variabili di ambiente mup.jsonsenza dover distribuire l'intera app, utilizza semplicemente il comando riconfigura. Ciò è utile quando non sono state apportate modifiche all'applicazione.

$ mupx reconfig

Congratulazioni, la tua app Meteor è ora attiva e funzionante! Inoltre, l'app si avvierà automaticamente ogni volta che il VPS si riavvia. Tieni d'occhio i futuri articoli sulla distribuzione e la gestione di Meteor.