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.json
e 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 host
tuo 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 sshOptions
campo, ad esempio:
"host": "123.123.123.123",
"sshOptions": { "port": 9876 },
Imposta il username
valore 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 pem
valore 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 pem
linea 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 setupMongo
impostato sul valore predefinito.
Passa appName
al 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_URL
URL 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.json
file, 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.json
file 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.json
senza 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.